Rust

Ev rûpel ji Îngilîzî hatiye wergerandin. Heke her du ji hev cuda bin, rûpela Îngilîzî rast e. Rûpela Îngilîzî bixwîne

Pirtûkxaneya Rust crate-a lingara ye li ser crates.io. Ew Rust 1.87 an nûtir hewce dike û li ser runtime-a Tokio dixebite. TLS bi xweber ji rustls tê, an bi rêya feature-ekê ji TLS-a platformê bi xwe.

Çawa tê bikaranîn

Her bang async fn-ek e ku Result vedigerîne. Ji bo betalkirina bangekê, future-a wê drop bike; ji bo betalkirina herikînê, herikînê drop bike.
Herikînek hema ku sernivîsên bersivê bigihîjin digihîje, wek Stream-eke encaman. Wê bi .next().await bixwîne.
Xeletî enum-eke Error ya bi çar guhertoyan e. Error::retry_after sekinandina ku API gotiye vedigerîne, heke hebe.
Xerîdarekî bi Client::builder() ava bike. Ji bo parvekirina hewza girêdanan, reqwest::Client-a xwe bide wê, lê sînorê demê yê giştî nede wî xerîdarî, an na ew ê herikînên dirêj qut bike. Ji bo dema dawî li ser bangekê, wê di tokio::time::timeout de bipêçe.

Mînakên li jêr crate-ê saz dikin, xerîdarekî diafirînin, lîsteyeke ferhengê diherikînin û xeletiyekê birêve dibin.

Rust

cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-thread

Rust

use lingara::Client;

let client = Client::builder()
    .client_credentials(std::env::var("LINGARA_CLIENT_ID")?, std::env::var("LINGARA_CLIENT_SECRET")?)
    .build()?;

Rust

use lingara::models::{GenerateVocabularyEvent, VocabRequest};
use std::num::NonZeroU8;

let request = VocabRequest { level: 2, source_lang: "en".into(), target_lang: "zh".into(), count: NonZeroU8::new(8) };
let mut stream = client.generate_vocabulary(&request).await?;
while let Some(event) = stream.next().await {
    if let GenerateVocabularyEvent::Item(item) = event? {
        println!("{} {}", item.word, item.translation);
    }
}

Rust

use lingara::Error;

let result = client.get_usage().await;
if let Some(wait) = result.as_ref().err().and_then(Error::retry_after) {
    eprintln!("the API asks you to retry after {wait:?}");
}
match result {
    Ok(usage) => println!("{} allowance rows", usage.allowance.len()),
    // A refusal from the API: status, code (stable) and message (localised).
    Err(Error::Api(e)) => eprintln!("{} {} {}", e.status, e.code, e.message),
    // The token endpoint refused the credentials or the scopes.
    Err(Error::OAuth(e)) => eprintln!("{} {} {}", e.status, e.error, e.description.unwrap_or_default()),
    Err(Error::Maintenance(_)) => eprintln!("the API is under maintenance"),
    // No usable answer: connect, tls, reset, timeout, and so on.
    Err(Error::Transport(e)) => eprintln!("transport: {}", e.kind),
    Err(other) => return Err(other.into()),
}

Rust

Çawa tê bikaranîn

Ev rûpel çi dipêçe