Adding GTranslate project

Need GTranslate project added in order to make a single executable.

Author: David-Maisonave

.gitignore

@@ -259,4 +259,6 @@ paket-files/
 # Python Tools for Visual Studio (PTVS)
 __pycache__/
 *.pyc
-GTranslate/
+
+# Other files and folders
+

GTranslate/Entities/MicrosoftAuthTokenInfo.cs

@@ -0,0 +1,26 @@
+namespace GTranslate;
+
+/// <summary>
+/// Represents a Microsoft Authorization token.
+/// </summary>
+public sealed class MicrosoftAuthTokenInfo
+{
+    internal MicrosoftAuthTokenInfo(string token, string region)
+    {
+        Token = token;
+        Region = region;
+    }
+
+    /// <summary>
+    /// Gets the token.
+    /// </summary>
+    public string Token { get; }
+
+    /// <summary>
+    /// Gets the region of this token.
+    /// </summary>
+    public string Region { get; }
+
+    /// <inheritdoc/>
+    public override string ToString() => Token;
+}

GTranslate/Entities/MicrosoftVoice.cs

@@ -0,0 +1,50 @@
+using System.Diagnostics;
+
+namespace GTranslate;
+
+/// <summary>
+/// Represents a TTS voice in Microsoft Translator.
+/// </summary>
+[DebuggerDisplay($"{{{nameof(DebuggerDisplay)},nq}}")]
+public class MicrosoftVoice
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="MicrosoftVoice"/> class.
+    /// </summary>
+    /// <param name="displayName">The display name of the voice.</param>
+    /// <param name="shortName">The short name of the voice.</param>
+    /// <param name="gender">The gender of the voice.</param>
+    /// <param name="locale">The locale of the voice.</param>
+    public MicrosoftVoice(string displayName, string shortName, string gender, string locale)
+    {
+        DisplayName = displayName;
+        Gender = gender;
+        ShortName = shortName;
+        Locale = locale;
+    }
+
+    /// <summary>
+    /// Gets the display name of this voice.
+    /// </summary>
+    public string DisplayName { get; }
+
+    /// <summary>
+    /// Gets the short name of this voice.
+    /// </summary>
+    public string ShortName { get; }
+
+    /// <summary>
+    /// Gets the gender of this voice.
+    /// </summary>
+    public string Gender { get; }
+
+    /// <summary>
+    /// Gets the locale of this voice.
+    /// </summary>
+    public string Locale { get; }
+
+    /// <inheritdoc/>
+    public override string ToString() => $"{nameof(DisplayName)}: '{DisplayName}', {nameof(Locale)}: '{Locale}'";
+
+    private string DebuggerDisplay => ToString();
+}

GTranslate/Extensions/JsonElementExtensions.cs

@@ -0,0 +1,41 @@
+using System.Diagnostics.CodeAnalysis;
+using System.Linq;
+using System.Text.Json;
+
+namespace GTranslate.Extensions;
+
+internal static class JsonElementExtensions
+{
+    public static JsonElement FirstOrDefault(this JsonElement element)
+        => element.ValueKind == JsonValueKind.Array ? element.EnumerateArray().FirstOrDefault() : default;
+
+    public static JsonElement ElementAtOrDefault(this JsonElement element, int index)
+        => element.ValueKind == JsonValueKind.Array ? element.EnumerateArray().ElementAtOrDefault(index) : default;
+
+    public static JsonElement LastOrDefault(this JsonElement element)
+        => element.ValueKind == JsonValueKind.Array ? element.EnumerateArray().LastOrDefault() : default;
+
+    public static JsonElement GetPropertyOrDefault(this JsonElement element, string propertyName)
+        => element.ValueKind == JsonValueKind.Object && element.TryGetProperty(propertyName, out var value) ? value : default;
+
+    [return: NotNullIfNotNull("defaultValue")]
+    public static string? GetStringOrDefault(this JsonElement element, string? defaultValue = null)
+        => element.ValueKind is JsonValueKind.String or JsonValueKind.Null ? element.GetString() ?? defaultValue : defaultValue;
+
+    public static int GetInt32OrDefault(this JsonElement element, int defaultValue = default)
+        => element.ValueKind == JsonValueKind.Number && element.TryGetInt32(out int value) ? value : defaultValue;
+
+    public static bool TryGetInt32(this JsonElement element, string propertyName, out int value)
+    {
+        value = 0;
+        var prop = element.GetPropertyOrDefault(propertyName);
+        return prop.ValueKind == JsonValueKind.Number && prop.TryGetInt32(out value);
+    }
+
+    public static bool TryGetSingle(this JsonElement element, string propertyName, out float value)
+    {
+        value = 0;
+        var prop = element.GetPropertyOrDefault(propertyName);
+        return prop.ValueKind == JsonValueKind.Number && prop.TryGetSingle(out value);
+    }
+}

GTranslate/Extensions/ReadOnlySequenceExtensions.cs

@@ -0,0 +1,35 @@
+using System;
+using System.Buffers;
+using System.IO;
+
+namespace GTranslate.Extensions;
+
+internal static class ReadOnlySequenceExtensions
+{
+    public static ReadOnlySequence<byte> AsReadOnlySequence(this ReadOnlyMemory<byte>[] chunks) => AsReadOnlySequence(chunks.AsSpan());
+
+    public static ReadOnlySequence<byte> AsReadOnlySequence(this ReadOnlySpan<ReadOnlyMemory<byte>> chunks)
+    {
+        if (chunks.Length == 0)
+        {
+            throw new ArgumentException("Byte array is empty.", nameof(chunks));
+        }
+
+        if (chunks.Length == 1)
+        {
+            return new ReadOnlySequence<byte>(chunks[0]);
+        }
+
+        var start = new MemorySegment<byte>(chunks[0]);
+        var end = start.Append(chunks[1]);
+
+        for (int i = 2; i < chunks.Length; i++)
+        {
+            end = end.Append(chunks[i]);
+        }
+
+        return new ReadOnlySequence<byte>(start, 0, end, end.Memory.Length);
+    }
+
+    public static Stream AsStream(this ReadOnlySequence<byte> readOnlySequence) => new ReadOnlySequenceStream(readOnlySequence);
+}

GTranslate/Extensions/StringExtensions.cs

@@ -0,0 +1,44 @@
+using System;
+using System.Collections.Generic;
+
+namespace GTranslate.Extensions;
+
+internal static class StringExtensions
+{
+    private static readonly char[] _separators = { '\t', '\r', '\n', ' ' };
+
+    // Splits a text into lines of max. 200 chars without breaking words (if possible)
+    // This algorithm is not as accurate as the one Google uses, but it's good enough
+    // Google prioritizes maintaining the structure of sentences rather than minimizing the number of requests
+    public static IEnumerable<ReadOnlyMemory<char>> SplitWithoutWordBreaking(this string text, int maxLength = 200)
+    {
+        string[] split = text.Split(_separators, StringSplitOptions.RemoveEmptyEntries);
+        var current = string.Join(" ", split).AsMemory();
+
+        while (!current.IsEmpty)
+        {
+            int index = -1;
+            int length;
+
+            if (current.Length <= maxLength)
+            {
+                length = current.Length;
+            }
+            else
+            {
+                index = current.Slice(0, maxLength).Span.LastIndexOf(' ');
+                length = index == -1 ? maxLength : index;
+            }
+
+            var line = current.Slice(0, length);
+            // skip a single space if there's one
+            if (index != -1)
+            {
+                length++;
+            }
+
+            current = current.Slice(length, current.Length - length);
+            yield return line;
+        }
+    }
+}

GTranslate/GTranslate.csproj

@@ -0,0 +1,33 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <Version>2.1</Version>
+	<LangVersion>10</LangVersion>
+	<TargetFrameworks>net7.0-windows</TargetFrameworks>
+    <Authors>d4n3436</Authors>
+    <Description>A collection of free translation APIs (Google Translate, Bing Translator, Microsoft Translator and Yandex.Translate). Currently supports translation, transliteration, language detection and text-to-speech.</Description>
+    <NeutralLanguage>en</NeutralLanguage>
+    <PackageTags>translator;translator-api;translation;translation-api;tts;text-to-speech</PackageTags>
+    <PackageLicenseExpression>MIT</PackageLicenseExpression>
+    <PackageProjectUrl>https://github.com/d4n3436/GTranslate</PackageProjectUrl>
+    <RepositoryUrl>https://github.com/d4n3436/GTranslate</RepositoryUrl>
+    <PackageReleaseNotes>https://github.com/d4n3436/GTranslate/releases</PackageReleaseNotes>
+    <Copyright>Copyright ©2021 d4n3436</Copyright>
+    <IncludeSymbols>true</IncludeSymbols>
+    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <Nullable>enable</Nullable>
+    <ProduceReferenceAssembly>True</ProduceReferenceAssembly>
+    <EnforceCodeStyleInBuild>True</EnforceCodeStyleInBuild>
+    <EnableNETAnalyzers>True</EnableNETAnalyzers>
+    <BaseOutputPath>$(SolutionDir)TranslateFileNames\bin\</BaseOutputPath>
+  </PropertyGroup>
+  <PropertyGroup>
+  	<SuppressNETCoreSdkPreviewMessage>true</SuppressNETCoreSdkPreviewMessage>
+  </PropertyGroup>	
+  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net7.0-windows|AnyCPU'">
+    <NoWarn>1701;1702;</NoWarn>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net7.0-windows|AnyCPU'">
+    <NoWarn>1701;1702;</NoWarn>
+  </PropertyGroup>
+</Project>

GTranslate/ILanguage.cs

@@ -0,0 +1,22 @@
+namespace GTranslate;
+
+/// <summary>
+/// Represents a language.
+/// </summary>
+public interface ILanguage
+{
+    /// <summary>
+    /// Gets the name of this language.
+    /// </summary>
+    string Name { get; }
+
+    /// <summary>
+    /// Gets the ISO 639-1 code of this language.
+    /// </summary>
+    string ISO6391 { get; }
+
+    /// <summary>
+    /// Gets the ISO 639-3 code of this language.
+    /// </summary>
+    string ISO6393 { get; }
+}

GTranslate/ILanguageDictionary.cs

@@ -0,0 +1,28 @@
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+
+namespace GTranslate;
+
+/// <summary>
+/// Represents a dictionary of languages.
+/// </summary>
+/// <typeparam name="TCode">The type of codes (or keys) associated with a language.</typeparam>
+/// <typeparam name="TLanguage">The type of values that implements <see cref="ILanguage"/>.</typeparam>
+public interface ILanguageDictionary<TCode, TLanguage> : IReadOnlyDictionary<TCode, TLanguage>
+    where TLanguage : ILanguage
+{
+    /// <summary>
+    /// Gets a language from a language code.
+    /// </summary>
+    /// <param name="code">The language code.</param>
+    /// <returns>The language, or default{TCode} if the language was not found.</returns>
+    TLanguage GetLanguage(TCode code);
+
+    /// <summary>
+    /// Tries to get a language from a language code, name or alias.
+    /// </summary>
+    /// <param name="code">The language code.</param>
+    /// <param name="language">The language, if found.</param>
+    /// <returns><see langword="true"/> if the language was found, otherwise <see langword="false"/>.</returns>
+    bool TryGetLanguage(TCode code, [MaybeNullWhen(false)] out TLanguage language);
+}

GTranslate/Internal/BingCredentials.cs

@@ -0,0 +1,19 @@
+using System;
+
+namespace GTranslate;
+
+internal readonly struct BingCredentials
+{
+    public BingCredentials(string token, long key, Guid impressionGuid)
+    {
+        Token = token;
+        Key = key;
+        ImpressionGuid = impressionGuid;
+    }
+
+    public string Token { get; }
+
+    public long Key { get; }
+
+    public Guid ImpressionGuid { get; }
+}