Rust

دا پاڼه له انګلیسي ژبې ژباړل شوې ده. که دواړه سره توپیر ولري، انګلیسي پاڼه سمه ده. انګلیسي پاڼه ولولئ

د Rust کتابتون په crates.io کې د lingara کرېټ دی. دا Rust 1.87 یا نوي ته اړتیا لري او د Tokio د چلېدو په چاپېریال کې چلېږي. TLS په ډیفالټ ډول له rustls راځي، یا د یوې اختیاري ځانګړنې له لارې د پلاتفورم له خپل TLS.

په عمل کې څنګه دی

هر کال یو async fn دی چې Result بېرته ورکوي. د کال د لغوه کولو لپاره، د هغه future پرېږدئ؛ د جریان د لغوه کولو لپاره، جریان پرېږدئ.
جریان هغه وخت رسېږي چې د ځواب سرلیکونه ورسېږي، د پایلو د یوه Stream په توګه. هغه په .next().await ولولئ.
تېروتنې یو Error enum دی چې څلور ډولونه لري. Error::retry_after هغه انتظار بېرته ورکوي چې API ویلی، که وي.
کلاینټ په Client::builder() جوړ کړئ. د اړیکو د یوه حوض د شریکولو لپاره، خپل reqwest::Client ورکړئ، خو هغه کلاینټ ته هېڅ ټولیز مهلت مه ورکوئ، ګنې اوږده جریانونه به نیمګړي پرې کړي. د یوه کال لپاره د وروستۍ نېټې ټاکلو لپاره، هغه په tokio::time::timeout کې ونغاړئ.

لاندې بېلګې کرېټ نصبوي، یو کلاینټ جوړوي، د لغتونو یو لېست په جریان کې راوړي او یوه تېروتنه اداره کوي.

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

په عمل کې څنګه دی

دا پاڼه څه رانغاړي