Merge pull request #6 from tilde-nlp/feature/language_directions

Add language direction option

Tilde.Translation.Example.Dotnet/Program.cs

@@ -7,4 +7,4 @@
 
 await tester.TranslateTextAsync();
 await tester.TranslateDocumentAsync("./Document/ExampleDocument.txt", "./Document/ExampleDocumentResult.txt");
-await tester.GetEnginesAsync();
+await tester.GetEnginesAsync();await tester.GetLanguageDirectionsAsync();

Tilde.Translation.Example.Dotnet/Tilde.Translation.Example.Dotnet.csproj

@@ -5,6 +5,7 @@
  <TargetFramework>net8.0</TargetFramework>
  <ImplicitUsings>enable</ImplicitUsings>
  <Nullable>enable</Nullable>
+ <LangVersion>latest</LangVersion>
  </PropertyGroup>
 
  <ItemGroup>

Tilde.Translation.Example.Framework/Program.cs

@@ -11,11 +11,12 @@ internal class Program
  static async Task Main(string[] args)
  {
  var apiKey = "";
- var tester = new Tilde.Translation.Example.Lib.TranslateTester(apiKey);
+ var tester = new Lib.TranslateTester(apiKey);
 
  await tester.TranslateTextAsync();
  await tester.TranslateDocumentAsync("./Document/ExampleDocument.txt", "./Document/ExampleDocumentResult.txt");
  await tester.GetEnginesAsync();
+ await tester.GetLanguageDirectionsAsync();
  }
  }
 }

Tilde.Translation.Example.Lib/Tilde.Translation.Example.Lib.csproj

@@ -2,8 +2,13 @@
 
  <PropertyGroup>
  <TargetFramework>netstandard2.0</TargetFramework>
+ <LangVersion>latest</LangVersion>
  </PropertyGroup>
 
+ <ItemGroup>
+ <PackageReference Include="Microsoft.Bcl.AsyncInterfaces" Version="8.0.0" />
+ </ItemGroup>
+
  <ItemGroup>
  <ProjectReference Include="..\Tilde.Translation\Tilde.Translation.csproj" />
  </ItemGroup>

Tilde.Translation.Example.Lib/TranslateTester.cs

@@ -21,7 +21,8 @@ public TranslateTester(string apiKey, string serverUrl = "https://translate.tild
  AppInfo = new AppInfo()
  {
  AppName = "my-app",
- AppVersion = "1.0.0"
+ AppVersion = "1.0.0",
+ AppId = "Tilde|test"
  },
  ServerUrl = serverUrl
  };
@@ -31,6 +32,7 @@ public TranslateTester(string apiKey, string serverUrl = "https://translate.tild
 
  public async Task TranslateTextAsync()
  {
+ Console.WriteLine("Translating text");
  try
  {
  var translation = await translator.TranslateTextAsync("First sentence", "en", "lv");
@@ -43,10 +45,14 @@ public async Task TranslateTextAsync()
  {
  Console.WriteLine(ex.Message);
  }
+
+ Console.WriteLine("Text translation completed");
  }
 
  public async Task TranslateDocumentAsync(string sourceDocumentPath, string targetDocumentPath)
  {
+ Console.WriteLine("Translating document");
+
  // Specify file to translate 
  var sourceDocument = new FileInfo(sourceDocumentPath);
 
@@ -63,6 +69,8 @@ public async Task TranslateDocumentAsync(string sourceDocumentPath, string targe
  var fileStream = File.Create(targetDocumentPath);
  await translator.TranslateDocumentResultAsync(documentHandle, fileStream);
  fileStream.Close();
+
+ Console.WriteLine("Document translation completed");
  }
 
  public async Task GetEnginesAsync()
@@ -72,5 +80,13 @@ public async Task GetEnginesAsync()
  Console.WriteLine(engines.First().SourceLanguages.First()); // "en"
  Console.WriteLine(engines.First().TargetLanguages.First()); // "lv"
  }
+
+ public async Task GetLanguageDirectionsAsync()
+ {
+ await foreach (var languageDirection in translator.GetLanguageDirections())
+ {
+ Console.WriteLine($"{languageDirection.SourceLanguage} -> {languageDirection.TargetLanguage} | {languageDirection.EngineId} ({languageDirection.EngineName})");
+ }
+ }
  }
 }

Tilde.Translation/Models/Engine/LanguageDirection.cs

@@ -0,0 +1,45 @@
+// Copyright 2024 Tilde SIA (https://tilde.ai/)
+// Use of this source code is governed by an MIT
+// license that can be found in the LICENSE file.
+using Tilde.Translation.Enums.Engine;
+
+namespace Tilde.Translation.Models.Engine
+{
+ public class LanguageDirection
+ {
+ /// <summary>
+ /// Engine id
+ /// </summary>
+ public Guid EngineId { get; internal set; }
+
+ /// <summary>
+ /// Engine name
+ /// </summary>
+ public string EngineName { get; internal set; }
+
+ /// <summary>
+ /// Source language code
+ /// </summary>
+ public string SourceLanguage { get; internal set; }
+
+ /// <summary>
+ /// Target language code
+ /// </summary>
+ public string TargetLanguage { get; internal set; }
+
+ /// <summary>
+ /// Domain
+ /// </summary>
+ public string? Domain { get; internal set; }
+
+ /// <summary>
+ /// Supports term collections 
+ /// </summary>
+ public bool SupportsTermCollections { get; internal set; }
+
+ /// <summary>
+ /// Engine vendor
+ /// </summary>
+ public Vendor EngineVendor { get; internal set; }
+ }
+}

Tilde.Translation/Tilde.Translation.csproj

@@ -5,7 +5,7 @@
  <Description>Official dotnet library for the Tilde translation API</Description>
  <PackageTags>tilde;translation;translator;translate;api;i18n;language;</PackageTags>
  <!-- Change only <Version> tag, other tags will be autogenerated on build -->
- <Version>1.0.11.0</Version>
+ <Version>1.1.0.0</Version>
  <TargetFrameworks>net6.0;net7.0;net8.0;netstandard2.0;netstandard2.1;net462;net472;net48;net481;</TargetFrameworks>
  <LangVersion>latest</LangVersion>
  <ImplicitUsings>enable</ImplicitUsings>
@@ -44,7 +44,7 @@
  <None Include="../icon.png" Pack="true" PackagePath="" />
  </ItemGroup>
  <Import Project="$(MSBuildProjectDirectory)/BuildTargets/UpdateVersion.targets" />
- <Target Name="BeforeBuild2" BeforeTargets="BeforeBuild">
+ <Target Condition=" '$(Configuration)' != 'Debug' " Name="BeforeBuild2" BeforeTargets="BeforeBuild">
  <Message Importance="High" Text="Running Update version script" />
  <UpdateVersion />
  <Message Importance="High" Text="Version update completed" />

Tilde.Translation/Translator.cs

@@ -4,12 +4,14 @@
 
 using System.Net.Http;
 using System.Net.Http.Headers;
+using System.Runtime.CompilerServices;
 using System.Text;
 using System.Text.Json;
 using Tilde.Translation.Exceptions;
 using Tilde.Translation.Internal;
 using Tilde.Translation.Models;
 using Tilde.Translation.Models.Document;
+using Tilde.Translation.Models.Engine;
 
 namespace Tilde.Translation
 {
@@ -467,6 +469,77 @@ public async Task TranslateDocumentResultAsync(
  return result!.Engines;
  }
 
+ /// <summary>
+ /// Get available language directions
+ /// </summary>
+ /// <param name="sourceLanguageCode"></param>
+ /// <param name="cancellationToken"></param>
+ /// <returns></returns>
+ public async IAsyncEnumerable<LanguageDirection> GetLanguageDirections(
+ string? sourceLanguageCode = null,
+ [EnumeratorCancellation] CancellationToken cancellationToken = default
+ )
+ {
+ var engines = await GetEnginesAsync(cancellationToken);
+
+ foreach (var engine in engines)
+ {
+ if (engine.Domains != null && engine.Domains.Count > 0)
+ {
+ foreach (var domain in engine.Domains)
+ {
+ foreach (var sourceLanguage in domain.Value.Languages)
+ {
+ // Filter by source language
+ if (sourceLanguageCode != null && sourceLanguage.Key != sourceLanguageCode)
+ {
+ continue;
+ }
+
+ foreach (var targetLanguage in sourceLanguage.Value)
+ {
+ yield return new LanguageDirection()
+ {
+ Domain = engine.Domain,
+ EngineVendor = engine.EngineVendor,
+ EngineId = engine.Id,
+ EngineName = engine.Name,
+ SupportsTermCollections = engine.SupportsTermCollections,
+ SourceLanguage = sourceLanguage.Key,
+ TargetLanguage = targetLanguage
+ };
+ }
+ }
+ }
+ }
+ else
+ {
+ foreach (var sourceLanguage in engine.SourceLanguages)
+ {
+ // Filter by source language
+ if (sourceLanguageCode != null && sourceLanguage != sourceLanguageCode)
+ {
+ continue;
+ }
+
+ foreach (var targetLanguage in engine.TargetLanguages)
+ {
+ yield return new LanguageDirection()
+ {
+ Domain = engine.Domain,
+ EngineVendor = engine.EngineVendor,
+ EngineId = engine.Id,
+ EngineName = engine.Name,
+ SupportsTermCollections = engine.SupportsTermCollections,
+ SourceLanguage = sourceLanguage,
+ TargetLanguage = targetLanguage
+ };
+ }
+ }
+ }
+ }
+ }
+
  /// <summary>
  /// Get library version
  /// </summary>