Lusamine.GTranslate 1.3.1

Lusamine.GTranslate

A .NET client for the Google Translate API, a C# port of py-googletrans.

Installation

dotnet add package Lusamine.GTranslate

Quick start

using Lusamine.GTranslate;

using var translator = new Translator();

Translate a single string

Translated result = await translator.TranslateAsync("안녕하세요.", dest: "en");

Console.WriteLine(result.Text);          // Hello.
Console.WriteLine(result.Src);           // ko
Console.WriteLine(result.Pronunciation); // Annyeonghaseyo.

Translate a batch

IReadOnlyList<Translated> results = await translator.TranslateManyAsync(
    ["hello", "world", "goodbye"], dest: "ko");

foreach (var r in results)
    Console.WriteLine($"{r.Origin} → {r.Text}");
// hello   → 안녕하세요
// world   → 세계
// goodbye → 잘 가요

Detect language

Detected detected = await translator.DetectAsync("これは日本語です");

Console.WriteLine(detected.Lang);       // ja
Console.WriteLine(detected.Confidence); // 0.98...

Detect a batch

IReadOnlyList<Detected> results = await translator.DetectManyAsync(
    ["Hello", "Bonjour", "привет"]);

Language codes

Pass BCP-47 codes ("en", "zh-cn", "pt"), full language names ("english", "chinese (simplified)"), or locale strings ("en_US"). Use "auto" as the source to let Google detect it.

// By code
await translator.TranslateAsync("Hello", src: "en", dest: "ja");

// By name (case-insensitive)
await translator.TranslateAsync("Hello", src: "ENGLISH", dest: "iRiSh");

// Auto-detect source
await translator.TranslateAsync("Bonjour", dest: "en");

Browse all supported languages:

foreach (var (code, name) in Languages.All)
    Console.WriteLine($"{code}: {name}");

Constructor options

// Use the webapp endpoint (slower, requires token fetch)
using var translator = new Translator(
    serviceUrls: ["translate.google.com"],
    raiseException: true);

// Provide your own HttpClient
using var translator = new Translator(httpClient: myHttpClient);

Disposal

Translator implements both IDisposable and IAsyncDisposable. When you supply your own HttpClient it is not disposed. Only the internally created one is.

// Synchronous
using var translator = new Translator();

// Asynchronous
await using var translator = new Translator();

License

MIT