Crate deeplx

deeplx is a Rust package for unlimited DeepL translation.

Overview

deeplx provides a convenient interface for interacting with DeepL.

By default, deeplx includes proxy support. This can be controlled by the proxy feature. If you wish to disable proxy support, you can opt out of the default features in your Cargo.toml:

[dependencies]
deeplx = { version = "1", default-features = false }

When the proxy feature is enabled (default), you can specify a proxy when creating a new DeepLX instance:

use deeplx::{Config, DeepLX};

let translator = DeepLX::new(Config {
    proxy: Some("http://pro.xy".to_string()),
    ..Default::default()
});

When the impersonate feature is enabled, it will use rquest instead of reqwest as the HTTP client. This allows for mimicking the browser’s version, headers, and TLS settings.

[dependencies]
deeplx = { version = "1", features = ["impersonate"] }

The core structure of this library is DeepLX, through which you can:

• Create a new translation client instance using DeepLX::new.
• Perform text translations with DeepLX::translate, automatically detecting the source language if needed, and retrieving both a primary translation and multiple alternative translations.

In addition, the library defines several data structures for representing requests and responses from DeepL’s API, ensuring consistency with OwO-Network/DeepLX:

• DeepLXTranslationResult: Represents the translation result including status code, source and target languages, translated text, and any alternative translations.

By maintaining consistency with the OwO-Network/DeepLX, this project aims to provide a familiar and straightforward experience for users looking to integrate DeepL translations into their Rust applications.

Example

use deeplx::{Config, DeepLX};

#[tokio::main]
async fn main() {
    let translator = DeepLX::new(Config {   // If proxy enabled, with proxy
        proxy: Some("http://pro.xy".to_string()),
        ..Default::default()
    });
    // let translator = DeepLX::new(Config::default());    // Otherwise
    match translator
        .translate("auto", "zh", "Hello, world!", None, None)
        .await
    {
        Ok(res) => println!("Translated: {}", res.data),
        Err(e) => eprintln!("{}", e),
    }
}

Structs

Config

Configuration settings for the DeepLX translation client.

DeepLX

The main entry point for interacting with the DeepL translation service.

DeepLXTranslationResult

A structure representing the final result of a translation.