async_translate/
lib.rs

1//! # async-translate
2//!
3//! 一个支持并发的翻译库，目前支持 OpenAI 和微软翻译服务。
4//!
5//! ## 功能特性
6//!
7//! - 支持 OpenAI 翻译接口
8//!   - 支持自定义 base URL、模型、API Key
9//!   - 支持多 API Key 配置，每个 Key 单独计算并发数和 RPM
10//!   - RPM 和并发数可选配置，具备默认数值
11//! - 支持微软翻译接口
12//!   - 自动获取临时认证token，无需配置API密钥
13//!   - 支持并发操作
14//! - 统一的翻译接口，易于扩展
15//! - 类型安全的语言标识符支持
16//! - 可配置的超时和重试机制
17//!
18//! ## 使用方法
19//!
20//! ```rust,no_run
21//! use async_translate::{TranslationManager, OpenAITranslator, OpenAIConfig, MicrosoftTranslator, MicrosoftConfig, LanguageIdentifier, TranslateOptions};
22//! use std::time::Duration;
23//!
24//! #[tokio::main]
25//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
26//!     // 创建翻译管理器
27//!     let mut manager = TranslationManager::new();
28//!
29//!     // 配置 OpenAI 翻译器
30//!     let openai_config = OpenAIConfig {
31//!         base_url: "https://api.openai.com/v1".to_string(),
32//!         model: "gpt-3.5-turbo".to_string(),
33//!         api_keys: vec!["your-openai-api-key".to_string()],
34//!         rpm_limit: 60,
35//!         concurrent_limit: 10,
36//!         system_prompt: None,
37//!     };
38//!     let openai_translator = Box::new(OpenAITranslator::new(openai_config));
39//!     manager.add_translator("openai", openai_translator);
40//!
41//!     // 配置微软翻译器（自动获取认证token）
42//!     let microsoft_config = MicrosoftConfig {
43//!         endpoint: None,  // 使用默认端点
44//!         api_key: None,   // 使用自动认证
45//!         concurrent_limit: 10,
46//!     };
47//!     let microsoft_translator = Box::new(MicrosoftTranslator::new(microsoft_config));
48//!     manager.add_translator("microsoft", microsoft_translator);
49//!
50//!     // 执行翻译
51//!     let text = "Hello, world!";
52//!     let target_lang: LanguageIdentifier = "zh".parse().unwrap();
53//!
54//!     // 基本翻译（使用默认配置）
55//!     let result = manager.translate("openai", text, &target_lang, None).await?;
56//!     println!("OpenAI Translation: {}", result);
57//!
58//!     // 带配置的翻译
59//!     let options = TranslateOptions::default()
60//!         .timeout(Duration::from_secs(60))
61//!         .max_retries(5);
62//!     let result = manager.translate_with_options("microsoft", text, &target_lang, None, &options).await?;
63//!     println!("Microsoft Translation: {}", result);
64//!
65//!     Ok(())
66//! }
67//! ```
68
69pub mod error;
70pub mod manager;
71pub mod microsoft;
72pub mod openai;
73pub mod options;
74pub mod translator;
75
76pub use error::TranslationError;
77pub use manager::TranslationManager;
78pub use microsoft::{MicrosoftConfig, MicrosoftTranslator};
79pub use openai::{OpenAIConfig, OpenAITranslator};
80pub use options::TranslateOptions;
81pub use translator::Translator;
82
83// 导出语言标识符类型
84pub use unic_langid::LanguageIdentifier;
async_translate/lib.rs

async_translate/
lib.rs
