lingual 1.1.0

Free and Unlimited Language Translation (Google) API for Rust. Supports Async and Sync.
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

mod deepl;
mod google;
use crate::{
    cfg_blocking, cfg_gen_blocking, cfg_non_blocking, Lang, Translation, TranslationResult,
};
use google::*;
use once_cell::sync::Lazy;

cfg_non_blocking! {
    pub static CLIENT: Lazy<reqwest::Client> = Lazy::new(reqwest::Client::new);
}

cfg_blocking! {
    pub static CLIENT: Lazy<reqwest::blocking::Client> = Lazy::new(reqwest::blocking::Client::new);
}

#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
pub enum Translator {
    #[default]
    /// Uses googles free translation api
    GoogleFree,
}

impl Translator {
    /// returns the translator from the given string
    /// # Arguments
    /// * `s` - The string to parse
    /// * `api_key` - The api key to use for the translator, if any
    /// # Returns
    /// * `Option<Translator>` - The translator from the given string
    pub fn from_str(s: &str, api_key: Option<String>) -> Option<Translator> {
        match (s, api_key) {
            ("google", None) => Some(Translator::GoogleFree),
            _ => None,
        }
    }

    cfg_gen_blocking! {
        pub async fn translate<'a>(
            &'a self,
            text: &'a str,
            from: &'a Lang,
            to: &'a Lang,
        ) -> TranslationResult<Translation<'a>> {
            match self {
                Translator::GoogleFree => google_translate(text, from, to).await,
            }
        }
    }
}