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

1
.github/SECURITY.md vendored
View File

@ -7,7 +7,6 @@
| `v1.0.0` | :white_check_mark: |
| `v1.1.0` | :white_check_mark: |
| `v1.1.1` | :white_check_mark: |
| `v1.2.0` | :white_check_mark: |
## 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:
build:
runs-on: ubuntu-latest
steps:
- name: Upload coverage reports to Codecov
uses: codecov/codecov-action@v4
env:
CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
- name: Upload coverage reports to Codecov
uses: codecov/codecov-action@v3
env:
CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

View File

@ -18,7 +18,7 @@ jobs:
steps:
- uses: actions/checkout@v4
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v5
uses: actions/setup-python@v4
with:
python-version: ${{ matrix.python-version }}
- name: Install dependencies from txt files
@ -43,4 +43,4 @@ jobs:
if: ${{ github.event_name != 'push' }}
- name: Dependency Review
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
steps:
- uses: actions/labeler@v5
- uses: actions/labeler@v4
with:
repo-token: "${{ secrets.GITHUB_TOKEN }}"

View File

@ -1,7 +1,7 @@
[package]
name = "localizer-rs"
description = "Localizer helps localize (translate) your rust applications using json files."
version = "1.2.0"
version = "1.1.1"
authors = [
"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!(
"{:}",
localizer_rs::t!(
config,
config.t(
"error",
"details" = "Something went wrong when trying to do stuff"
vec![("details", "Something went wrong when trying to do stuff")]
)
);
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
// Version: 1.1.1
@ -67,31 +66,7 @@ pub struct Error {
pub exit_code: i32,
}
/// Display implementation for the error object.
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 {
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
// Version: 1.2.0
// Version: 1.1.1
// Copyright (c) 2023-present ElBe Development.
@ -159,7 +159,8 @@ impl Config {
}
}
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());
}
}
@ -225,49 +226,15 @@ impl Config {
///
/// # See also
///
/// - [`t!()`]
/// - [`Config`]
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.
///
/// # Parameters
///
/// - `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 {
fn translate<T>(&self, key: &str, mut arguments: Vec<(&str, &str)>) -> String
where
T: serde::Serialize + for<'de> serde::Deserialize<'de>,
{
let mut colors: Vec<(&str, &str)> = vec![
// Formatting codes
("end", "\x1b[0m"),
@ -338,8 +305,8 @@ impl Config {
};
let reader: BufReader<File> = BufReader::new(file);
let json: serde_json::Value = match serde_json::to_value::<serde_json::Value>(
match serde_json::from_reader::<BufReader<File>, serde_json::Value>(reader) {
let json: serde_json::Value = match serde_json::to_value::<T>(
match serde_json::from_reader::<BufReader<File>, T>(reader) {
Ok(value) => value,
Err(_error) => {
let error: errors::Error = errors::Error::new(
@ -399,50 +366,3 @@ impl Config {
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
// Version: 1.2.0
// Version: 1.1.1
// Copyright (c) 2023-present ElBe Development.
@ -80,18 +80,6 @@ mod tests {
#[test]
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 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"
);
}
#[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"
);
}
}