I18nError for Rust

此库提供了一种方便的方法，在 Rust 中定义和管理支持国际化的错误消息。

安装

将以下内容添加到您的 Cargo.toml

[dependencies]
i18n_error = "0.1"
rust-i18n = "3"

然后，运行 cargo build 来安装依赖项。

示例

use i18n_error::{I18nError, LanguageCode, ToI18nString};

#[macro_use]
extern crate rust_i18n;

rust_i18n::i18n!("locales");

#[derive(I18nError)]
#[i18n_language_codes(En, Fr)]
enum UseCaseError {
    #[i18n_key("error.UseCaseError.AuthorizationError")]
    Authorization,
    #[i18n_delegate]
    Domain(DomainError),
}


#[derive(I18nError)]
#[i18n_language_codes(En, Fr)]
enum DomainError {
    #[i18n_key("error.DomainError.ResourceNotFound")]
    ResourceNotFound,
}

fn main() {
    let error = UseCaseError::Authorization;
    assert_eq!(error.to_i18n_string(LanguageCode::En), "You do not have permission.".to_string());
    assert_eq!(error.to_i18n_string(LanguageCode::Fr), "Vous n'avez pas la permission.".to_string());

    let error = UseCaseError::Domain(DomainError::ResourceNotFound);
    assert_eq!(error.to_i18n_string(LanguageCode::En), "Resource not found.".to_string());
    assert_eq!(error.to_i18n_string(LanguageCode::Fr), "Ressource non trouvée.".to_string());
}

1. i18n 准备
   1. 在 /locales 目录中创建区域文件。有关详细信息，请参阅 rust-i18n。
   2. 在 lib.rs 或 main.rs 文件中加载 rust-i18n。
2. 定义错误结构或枚举
   1. 使用 #[derive(I18nError)] 来派生必要的特质。
3. 设置语言代码
   1. 使用 #[i18n_language_codes(En, Fr)] 指定支持的语言。
   2. 基于 ISO 639-1 的 LanguageCode。有关详细信息，请参阅 rust-i18n/LanguageCode。
4. 定义错误变体
   1. 使用 #[i18n_key("{key of message in locale file}")] 将错误变体映射到区域文件中的消息。
   2. 这允许从区域文件生成错误消息。
5. 委托错误消息生成
   1. 如果您想将错误消息的生成委托给内部错误，请使用 #[i18n_delegate]。
   2. 内部错误也必须使用 #[derive(I18nError)] 定义。
   3. 这允许从内部错误生成错误信息。

"error":
  "UseCaseError":
    "AuthorizationError": "You do not have permission."

#[derive(I18nError)]
#[i18n_language_codes(En, Fr)]
enum UseCaseError {
    #[i18n_delegate]
    Domain(DomainError),
}

#[derive(I18nError)]
#[i18n_language_codes(En, Fr)]
enum DomainError {
    #[i18n_key("error.DomainError.ResourceNotFound")]
    ResourceNotFound,
}

enum DomainError {
    ResourceNotFound,
}

error[E0599]: no method named `to_i18n_string` found for reference `&DomainError` in the current scope
  --> src/lib.rs:28:14
   |
28 |     #[derive(I18nError)]
   |              ^^^^^^^^^ method not found in `&DomainError`
   |
   = help: items from traits can only be used if the trait is implemented and in scope
   = note: the following trait defines an item `to_i18n_string`, perhaps you need to implement it:
           candidate #1: `ToI18nString`
   = note: this error originates in the derive macro `I18nError` (in Nightly builds, run with -Z macro-backtrace for more info)

rustcE0599