translators 0.1.2

Free Google Translator, Deepl without API key and limits.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

[crates-badge]: https://img.shields.io/crates/v/translators
[crates-url]: https://crates.io/crates/translators
[license-badge]: https://img.shields.io/github/license/charl1e7/rust-translators?style=flat&color=%230096FF


# translators [![Crates.io][crates-badge]][crates-url] ![License][license-badge]


`translators` is an *async/sync* library for **Google Translator**, **Deepl** (soon) with **no API key** and **no limits**. It also includes support for **proxy**.

**Questions**:
* **There are no limits?**  Yes, I tested the translation of a book exceeding 1 million characters and uploaded the raw string into a single function without any issues.
* **What translation services are supported?** Supports Google Translate and will soon Deepl.

**Features flags**
* `google` - add support google-translate
* `tokio-async` - add support async

# Examples

* [google-translate](https://github.com/charl1e7/rust-translators/tree/main/examples/google)
### 1. Async example
```rust
use translators::{GoogleTranslator, Translator};

#[tokio::main]
async fn main() {
    let google_trans = GoogleTranslator::default();
    let res = google_trans
        .translate_async("Hello, world!", "", "es")
        .await
        .unwrap();
    println!("{res}");
}
```

Add to the dependency:
```rust
[dependencies]
translators = { version = "0.1.2", features = ["google", "tokio-async"] }
tokio = { version = "1.38.0", features = ["rt-multi-thread"] }
```

### 2. Sync example

```rust
use translators::{GoogleTranslator, Translator};

fn main() {
    let google_trans = GoogleTranslator::default();
    let res = google_trans
        .translate_sync("Hello, world!", "", "es")
        .unwrap();
    println!("{res}");
}
```

Add to the dependency:
```rust
[dependencies]
translators = { version = "0.1.2", features = ["google"] }
```

### 3. Proxy example

```rust
use translators::{GoogleTranslator, Translator};

fn main() {
    let google_trans = GoogleTranslator{
        timeout: 35, // How long to wait for a request
        delay: 0, // delay between each request
        proxy_address: Some("http://0.0.0.0:8080".to_string()), // or https or socks4 or socks5
    };
    let res = google_trans
        .translate_sync("Hello, world!", "", "es")
        .unwrap();
    println!("{res}");
}
```

Add to the dependency:
```rust
[dependencies]
translators = { version = "0.1.2", features = ["google"] }
```

## What's New in Version 0.1.2


- **New feature flag "tokio-async"**
- **Asynchronous request paralleling**
- **Fixed the text slice**

# Additional Information


For more details, guides, and advanced usage, please refer to the [examples](https://github.com/charl1e7/rust-translators/tree/main/examples) and [official documentation](https://crates.io/crates/translators).