Rust

這頁係對英文翻譯過來个。若係兩片無共樣，以英文頁為準。看英文頁

Rust 函式庫係 crates.io 頂高个 lingara crate。佢愛 Rust 1.87 抑係較新个版本，在 Tokio 執行環境頂高行。TLS 預設由 rustls 提供，也做得透過一隻 feature 改用平台自家个 TLS。

用起來仰般

每隻呼叫都係一隻 async fn，回傳 Result。想愛取消呼叫，就放忒佢个 future；想愛取消串流，就放忒該隻串流。
回應標頭一到，串流就跈等到，形式係一隻由結果組成个 Stream。用 .next().await 來讀佢。
錯誤係一隻有四隻變體个 Error 列舉。若係 API 講明愛等幾久，Error::retry_after 就會回傳該隻時間。
用 Client::builder() 來建構用戶端。想愛共用連線池，做得交分佢你自家个 reqwest::Client，毋過毋好同該隻用戶端設總逾時，毋然佢會將長个串流斬短。想愛同單一隻呼叫設截止時間，就用 tokio::time::timeout 包等佢。

下背个範例會安裝 crate、建立用戶端、用串流拿一份詞彙清單，還有處理錯誤。

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

用起來仰般

這頁包裝个內容