Rust

ئەم پەڕەیە لە ئینگلیزییەوە وەرگێڕدراوە. ئەگەر هەردووکیان جیاواز بوون، پەڕە ئینگلیزییەکە ڕاستە. پەڕە ئینگلیزییەکە بخوێنەوە

کتێبخانەی Rust کرەیتی lingaraـە لەسەر crates.io. پێویستی بە Rust 1.87 یان نوێترە و لەسەر ژینگەی کارکردنی Tokio کار دەکات. TLS بە شێوەی بنەڕەتی لە rustls ـەوە دێت، یان لە ڕێگەی تایبەتمەندییەکی هەڵبژاردەییەوە لە TLSـی خودی پلاتفۆرمەکە.

لە کرداردا چۆنە

هەموو بانگکردنێک async fnـێکە کە Result دەگەڕێنێتەوە. بۆ هەڵوەشاندنەوەی بانگکردنێک، futureـەکەی فڕێ بدە؛ بۆ هەڵوەشاندنەوەی ستریمێک، ستریمەکە فڕێ بدە.
ستریمێک هەر کە سەرپەڕەکانی وەڵام گەیشتن دەگات، وەک Streamـێک لە ئەنجامەکان. بە .next().await بیخوێنەرەوە.
هەڵەکان یەک enumـی Errorـن بە چوار جۆرەوە. 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

لە کرداردا چۆنە

ئەم پەڕەیە چی دەپێچێتەوە