Compare commits

..

No commits in common. "main" and "v1.1.1" have entirely different histories.
main ... v1.1.1

12 changed files with 40 additions and 164 deletions

18
.github/README.md vendored
View File

@ -39,19 +39,25 @@ To use localizer-rs, you need a directory (eg. `translations`) with your transla
1. Import the localizer-rs crate: 1. Import the localizer-rs crate:
```rust,ignore ```rust,ignore
use localizer_rs; use localizer_rs;
``` ```
2. Create a new config object: 2. Create a new config object:
```rust,ignore ```rust,ignore
let config = localizer_rs::Config::new("translations", "en");
let config = localizer_rs::Config::new("DIRECTORY NAME", "LANGUAGE NAME");
``` ```
3. Translate your text: 3. Translate your text:
```rust,ignore ```rust,ignore
localizer_rs::t!(config, "key", "placeholder" ="value");
config.t("key", vec!["placeholder", "value"]);
``` ```
## Example ## Example
@ -59,27 +65,33 @@ To use localizer-rs, you need a directory (eg. `translations`) with your transla
With the following `en.json` file. With the following `en.json` file.
```json ```json
{ {
"error": "{{color.red}}{{bold}}Error:{{end}} Something went wrong: {{details}}." "error": "{{color.red}}{{bold}}Error:{{end}} Something went wrong: {{details}}."
} }
``` ```
And the following rust code. And the following rust code.
```rust,ignore ```rust,ignore
use localizer_rs; use localizer_rs;
fn main() { fn main() {
let config: localizer_rs::Config = localizer_rs::Config::new("translations", "en"); let config: localizer_rs::Config = localizer_rs::Config::new("translations", "en");
println!("{:}", localizer_rs::t!(config, "error", "details" = "Path not found")); println!("{:}", config.t("error", vec![("details", "Path not found")]));
} }
``` ```
You will get the following output: You will get the following output:
```bash ```bash
Error: Something went wrong: Path not found. Error: Something went wrong: Path not found.
``` ```
Where `Error:` is red and bold. Where `Error:` is red and bold.

1
.github/SECURITY.md vendored
View File

@ -7,7 +7,6 @@
| `v1.0.0` | :white_check_mark: | | `v1.0.0` | :white_check_mark: |
| `v1.1.0` | :white_check_mark: | | `v1.1.0` | :white_check_mark: |
| `v1.1.1` | :white_check_mark: | | `v1.1.1` | :white_check_mark: |
| `v1.2.0` | :white_check_mark: |
## Reporting a Vulnerability ## Reporting a Vulnerability

3
.github/errors.md vendored
View File

@ -1,3 +0,0 @@
# errors module
Module for dealing with errors.

View File

@ -6,9 +6,7 @@ on:
jobs: jobs:
build: build:
runs-on: ubuntu-latest
steps:
- name: Upload coverage reports to Codecov - name: Upload coverage reports to Codecov
uses: codecov/codecov-action@v4 uses: codecov/codecov-action@v3
env: env:
CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }} CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

View File

@ -18,7 +18,7 @@ jobs:
steps: steps:
- uses: actions/checkout@v4 - uses: actions/checkout@v4
- name: Set up Python ${{ matrix.python-version }} - name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v5 uses: actions/setup-python@v4
with: with:
python-version: ${{ matrix.python-version }} python-version: ${{ matrix.python-version }}
- name: Install dependencies from txt files - name: Install dependencies from txt files
@ -43,4 +43,4 @@ jobs:
if: ${{ github.event_name != 'push' }} if: ${{ github.event_name != 'push' }}
- name: Dependency Review - name: Dependency Review
if: ${{ github.event_name != 'push' }} if: ${{ github.event_name != 'push' }}
uses: actions/dependency-review-action@v4 uses: actions/dependency-review-action@v3

View File

@ -20,6 +20,6 @@ jobs:
pull-requests: write pull-requests: write
steps: steps:
- uses: actions/labeler@v5 - uses: actions/labeler@v4
with: with:
repo-token: "${{ secrets.GITHUB_TOKEN }}" repo-token: "${{ secrets.GITHUB_TOKEN }}"

View File

@ -1,7 +1,7 @@
[package] [package]
name = "localizer-rs" name = "localizer-rs"
description = "Localizer helps localize (translate) your rust applications using json files." description = "Localizer helps localize (translate) your rust applications using json files."
version = "1.2.0" version = "1.1.1"
authors = [ authors = [
"ElBe-Plaq <elbe.dev.plaq@gmail.com>" "ElBe-Plaq <elbe.dev.plaq@gmail.com>"
] ]

View File

@ -1 +1 @@
pre-commit==4.1.0; python_version>='3.8' pre-commit==3.4.0; python_version>='3.8'

View File

@ -5,16 +5,15 @@ fn main() {
println!( println!(
"{:}", "{:}",
localizer_rs::t!( config.t(
config,
"error", "error",
"details" = "Something went wrong when trying to do stuff" vec![("details", "Something went wrong when trying to do stuff")]
) )
); );
println!( println!(
"{:}", "{:}",
localizer_rs::t!(config, "success", "balance" = "$10", "user" = "John Doe") config.t("success", vec![("balance", "$10"), ("user", "John Doe")])
); );
println!("{:}", localizer_rs::t!(config, "all")); println!("{:}", config.t("all", vec![]));
} }

View File

@ -1,4 +1,3 @@
#![doc = include_str!("../.github/errors.md")]
// localizer-rs errors // localizer-rs errors
// Version: 1.1.1 // Version: 1.1.1
@ -67,31 +66,7 @@ pub struct Error {
pub exit_code: i32, pub exit_code: i32,
} }
/// Display implementation for the error object.
impl fmt::Display for Error { impl fmt::Display for Error {
/// Format implementation for the error object.
///
/// # Parameters
///
/// - `self`: The error object.
/// - `f`: The [`fmt::Formatter`] to use.
///
/// # Returns
///
/// A [`fmt::Result`] containing the formatted error message.
///
/// # Examples
///
/// ```rust
/// # use localizer_rs;
/// # let error = localizer_rs::errors::Error::new("name", "description", 1);
/// println!("{}", error);
/// ```
///
/// # See also
///
/// - [`fmt::Display`]
/// - [`Error`]
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
write!(f, "\x1b[31;1m{}\x1b[0m: {}", self.name, self.description) write!(f, "\x1b[31;1m{}\x1b[0m: {}", self.name, self.description)
} }

View File

@ -1,6 +1,6 @@
#![doc = include_str!("../.github/README.md")] #[doc = include_str!("../.github/README.md")]
// localizer-rs // localizer-rs
// Version: 1.2.0 // Version: 1.1.1
// Copyright (c) 2023-present ElBe Development. // Copyright (c) 2023-present ElBe Development.
@ -159,7 +159,8 @@ impl Config {
} }
} }
Err(_error) => { Err(_error) => {
let error: errors::Error = errors::Error::new("OS Error", "Could not open path", 2); let error: errors::Error =
errors::Error::new("OS Error", "Could not open path", 2);
error.raise(format!("Path: {:?}\nDetails: {}", str_path, _error).as_str()); error.raise(format!("Path: {:?}\nDetails: {}", str_path, _error).as_str());
} }
} }
@ -225,49 +226,15 @@ impl Config {
/// ///
/// # See also /// # See also
/// ///
/// - [`t!()`]
/// - [`Config`] /// - [`Config`]
pub fn t(&self, key: &str, arguments: Vec<(&str, &str)>) -> String { pub fn t(&self, key: &str, arguments: Vec<(&str, &str)>) -> String {
return self.translate(key, arguments); return self.translate::<serde_json::Value>(key, arguments);
} }
/// Translates the specified key in the language specified in the config. fn translate<T>(&self, key: &str, mut arguments: Vec<(&str, &str)>) -> String
/// where
/// # Parameters T: serde::Serialize + for<'de> serde::Deserialize<'de>,
/// {
/// - `self`: The config object.
/// - `key`: The key to translate to.
/// - `arguments`: The arguments to replace.
///
/// # Returns
///
/// A `String` containing the translated value.
///
/// # Raises
///
/// This method throws an exception and exits if
///
/// - The translation file could not be found
/// - The translation file could not be opened
/// - The translation file could not be parsed
/// - The parsed json could not be converted to a json value
/// - The converted json could not be indexed
///
/// # Examples
///
/// ```rust
/// # use localizer_rs;
/// # let config: localizer_rs::Config = localizer_rs::Config::new("examples/translations", "en");
/// config.translate("test", vec![]);
/// ```
///
/// # See also
///
/// - [`t!()`]
/// - [`Config`]
/// - [`Config::t()`]
/// - [`serde_json`]
pub fn translate(&self, key: &str, mut arguments: Vec<(&str, &str)>) -> String {
let mut colors: Vec<(&str, &str)> = vec![ let mut colors: Vec<(&str, &str)> = vec![
// Formatting codes // Formatting codes
("end", "\x1b[0m"), ("end", "\x1b[0m"),
@ -338,8 +305,8 @@ impl Config {
}; };
let reader: BufReader<File> = BufReader::new(file); let reader: BufReader<File> = BufReader::new(file);
let json: serde_json::Value = match serde_json::to_value::<serde_json::Value>( let json: serde_json::Value = match serde_json::to_value::<T>(
match serde_json::from_reader::<BufReader<File>, serde_json::Value>(reader) { match serde_json::from_reader::<BufReader<File>, T>(reader) {
Ok(value) => value, Ok(value) => value,
Err(_error) => { Err(_error) => {
let error: errors::Error = errors::Error::new( let error: errors::Error = errors::Error::new(
@ -399,50 +366,3 @@ impl Config {
return result; return result;
} }
} }
/// Translates the specified key in the language specified in the config.
///
/// # Parameters
///
/// - `config`: The config object.
/// - `key`: The key to translate to.
/// - `arguments`: Optional parameter. The arguments to replace. Has to be of type `"name" = "value"`.
///
/// # Returns
///
/// A `String` containing the translated value.
///
/// # Examples
///
/// ```rust
/// # use localizer_rs;
/// # let config: localizer_rs::Config = localizer_rs::Config::new("examples/translations", "en");
/// localizer_rs::t!(config, "test");
/// localizer_rs::t!(config, "test", "variable" = "content");
/// ```
///
/// # See also
///
/// - [`Config`]
/// - [`Config::t()`]
#[macro_export]
macro_rules! t {
($config:expr, $key:expr) => {
{
$config.t($key, vec![])
}
};
($config:expr, $key:expr, $($argument_name:literal = $argument_value:literal),* $(,)?) => {
{
let mut arguments: Vec<(&str, &str)> = vec![];
$(
arguments.push(($argument_name, $argument_value));
)*
$config.t($key, arguments)
}
};
}

View File

@ -1,5 +1,5 @@
// localizer-rs tests // localizer-rs tests
// Version: 1.2.0 // Version: 1.1.1
// Copyright (c) 2023-present ElBe Development. // Copyright (c) 2023-present ElBe Development.
@ -80,18 +80,6 @@ mod tests {
#[test] #[test]
fn test_translate() { fn test_translate() {
let config: localizer_rs::Config = localizer_rs::Config::new("examples/translations", "en");
let translation: String =
config.translate("error", vec![("details", "Something went wrong")]);
assert_eq!(
translation.as_str(),
"\x1b[31m\x1b[1mError:\x1b[0m Something went wrong"
);
}
#[test]
fn test_translate_t() {
let config: localizer_rs::Config = localizer_rs::Config::new("examples/translations", "en"); let config: localizer_rs::Config = localizer_rs::Config::new("examples/translations", "en");
let translation: String = config.t("error", vec![("details", "Something went wrong")]); let translation: String = config.t("error", vec![("details", "Something went wrong")]);
@ -100,16 +88,4 @@ mod tests {
"\x1b[31m\x1b[1mError:\x1b[0m Something went wrong" "\x1b[31m\x1b[1mError:\x1b[0m Something went wrong"
); );
} }
#[test]
fn test_translate_macro() {
let config: localizer_rs::Config = localizer_rs::Config::new("examples/translations", "en");
let translation: String =
localizer_rs::t!(config, "error", "details" = "Something went wrong");
assert_eq!(
translation.as_str(),
"\x1b[31m\x1b[1mError:\x1b[0m Something went wrong"
);
}
} }