Compare commits
No commits in common. "main" and "v1.1.1" have entirely different histories.
18
.github/README.md
vendored
18
.github/README.md
vendored
@ -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
1
.github/SECURITY.md
vendored
@ -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
3
.github/errors.md
vendored
@ -1,3 +0,0 @@
|
|||||||
# errors module
|
|
||||||
|
|
||||||
Module for dealing with errors.
|
|
||||||
4
.github/workflows/codecov_workflow.yml
vendored
4
.github/workflows/codecov_workflow.yml
vendored
@ -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 }}
|
||||||
|
|||||||
4
.github/workflows/dependencies.yml
vendored
4
.github/workflows/dependencies.yml
vendored
@ -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
|
||||||
|
|||||||
2
.github/workflows/label.yml
vendored
2
.github/workflows/label.yml
vendored
@ -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 }}"
|
||||||
|
|||||||
@ -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>"
|
||||||
]
|
]
|
||||||
|
|||||||
@ -1 +1 @@
|
|||||||
pre-commit==4.1.0; python_version>='3.8'
|
pre-commit==3.4.0; python_version>='3.8'
|
||||||
|
|||||||
@ -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![]));
|
||||||
}
|
}
|
||||||
|
|||||||
@ -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)
|
||||||
}
|
}
|
||||||
|
|||||||
102
src/lib.rs
102
src/lib.rs
@ -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)
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|||||||
26
tests/lib.rs
26
tests/lib.rs
@ -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"
|
|
||||||
);
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user