Ver 1.4.5 (#3)

Author: antonchi

Demo/Demo.cs

@@ -8,34 +8,124 @@
 namespace Demo
 {
 
-    public static class Demo
+    public class Demo
     {
-        public const string API_KEY = "muGX5Bi8olr2m40WA2IPv8pEz4WNs19i";
+        Intento intento;
+        IntentoAiTextTranslate translate;
 
-        public static string TranslateSync (string text, string from="en", string to="zh", string provider = null)
+        public Demo(string apikey)
         {
-            var intento = IntentoSDK.Intento.Create(API_KEY);
-            var translate = intento.Ai.Text.Translate;
-            dynamic result = translate.Fulfill(text, to, from: from, provider: provider);
-            return (string)result.results[0]; 
+            intento = Intento.Create(apikey);
+            translate = intento.Ai.Text.Translate;
         }
 
-        public static List<string> TranslateSyncList(List<string> text, string from = "en", string to = "zh", string provider = null)
+        /// <summary>
+        /// Translation of one text segment with waiting for the result
+        /// </summary>
+        /// <param name="text">text to translate</param>
+        /// <param name="from">from language code</param>
+        /// <param name="to">to language code</param>
+        /// <param name="provider">provider id</param>
+        /// <returns></returns>
+        public string TranslateAsyncAndWaitResult(string text, string from="en", string to="zh", string provider=null)
         {
-            var intento = IntentoSDK.Intento.Create(API_KEY);
-            var translate = intento.Ai.Text.Translate;
-            dynamic result = translate.Fulfill(text, to, from: from, provider: provider);
-            IEnumerable<string> res = result.results.Values<string>();
+            dynamic result = translate.Fulfill(text, to, from: from, provider: provider, async:true, wait_async:true);
+            if (result.error != null)
+            {
+                // Error processing
+            }
+            return (string)result.response[0].results[0]; 
+        }
+
+        /// <summary>
+        /// Translation of a list of text segments with waiting for the result
+        /// </summary>
+        /// <param name="text">text to translate</param>
+        /// <param name="from">from language code</param>
+        /// <param name="to">to language code</param>
+        /// <param name="provider">provider id</param>
+        /// <returns></returns>
+        public List<string> TranslateAsyncListAndWaitResult(List<string> text, string from = "en", string to = "zh", string provider = "ai.text.translate.google.translate_api.v3")
+        {
+            dynamic result = translate.Fulfill(text, to, from: from, provider: provider, async: true, wait_async: true);
+            if (result.error != null)
+            {
+                // Error processing
+            }
+            IEnumerable<string> res = result.response[0].results.Values<string>();
             return res.ToList();
         }
 
-        public static IEnumerable<string> ProviderNames()
+        /// <summary>
+        /// Translation of one segment and return ID of the translation task
+        /// </summary>
+        /// <param name="text">text to translate</param>
+        /// <param name="from">from language code</param>
+        /// <param name="to">to language code</param>
+        /// <param name="provider">provider id</param>
+        /// <returns></returns>
+        public string TranslateAsync(string text, string from = "en", string to = "zh", string provider=null)
+        {
+            dynamic result = translate.Fulfill(text, to, from: from, provider: provider, async: true, wait_async: false);
+            return (string)result.id;
+        }
+
+        /// <summary>
+        /// Wait for the results of the asynchronous translation job
+        /// </summary>
+        /// <param name="text">text to translate</param>
+        /// <param name="from">from language code</param>
+        /// <param name="to">to language code</param>
+        /// <param name="provider">provider id</param>
+        /// <returns></returns>
+        public List<string> WaitAsyncJob(string job_id, int delay)
+        {
+            dynamic result = intento.WaitAsyncJob(job_id, delay: delay);
+            if (result.done != null)
+            {
+                bool done = (bool)result.done;
+                if (!done)
+                    // Result not ready yet
+                    return null;
+            }
+
+
+            if (result.error != null)
+            {
+                // Error processing
+            }
+            IEnumerable<string> res = result.response[0].results.Values<string>();
+            return res.ToList();
+        }
+
+        public IEnumerable<string> ProviderNames()
         {
-            var translate = IntentoSDK.Intento.Create(API_KEY).Ai.Text.Translate;
             IList<dynamic> providers_raw = translate.Providers();
             var provider_names = providers_raw.Select(i => (string)i.name);
             return provider_names;
         }
 
+        public static void Main(string[] args)
+        {
+            // In this Demo, Intento ApiKey is taken from the environment
+            Demo demo = new Demo(Environment.GetEnvironmentVariable("APIKEY"));
+
+            // Simplest use with one segment
+            string result1 = demo.TranslateAsyncAndWaitResult("Translation example");
+
+            // Several segments with the indication of the language pair and provider
+            List<string> result2 = demo.TranslateAsyncListAndWaitResult(new List<string> { "Translation example", "One more example" }, to:"ru", provider: "ai.text.translate.deepl.api");
+
+            // Own waiting cycle. Please do not call WaitAsyncJob more than once every 2-3 seconds. 
+            // It is recommended to specify 0 in the delay parameter.
+            string job_id = demo.TranslateAsync("Asynchronous translation");
+            List<string> res;
+            while ((res = demo.WaitAsyncJob(job_id, -1)) == null)
+            { }
+
+        }
+
+
     }
+
 }

Demo/Demo.csproj

@@ -5,7 +5,7 @@
     <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
     <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
     <ProjectGuid>{2A9CFF8D-AC5B-40BC-9111-04D54A47017D}</ProjectGuid>
-    <OutputType>Library</OutputType>
+    <OutputType>Exe</OutputType>
     <AppDesignerFolder>Properties</AppDesignerFolder>
     <RootNamespace>Demo</RootNamespace>
     <AssemblyName>Demo</AssemblyName>
@@ -29,6 +29,9 @@
     <ErrorReport>prompt</ErrorReport>
     <WarningLevel>4</WarningLevel>
   </PropertyGroup>
+  <PropertyGroup>
+    <StartupObject />
+  </PropertyGroup>
   <ItemGroup>
     <Reference Include="System" />
     <Reference Include="System.Core" />

Intento.cs

@@ -167,13 +167,15 @@ async public Task<dynamic> WaitAsyncJobAsync(string asyncId, int delay = 0)
             List<int> delays;
             int n = 0;
 
-            if (delay == 0)
+            if (delay == -1)
+                delays = new List<int> { 0 };
+            else if (delay == 0)
                 delays = CalcDelays(400);
             else
                 delays = CalcDelays(delay);
 
             delay = delays[0];
-            while (DateTime.Now < dt.AddSeconds(delay))
+            do
             {
                 Log(string.Format("WaitAsyncJobAsync-loop: {0} - {1}ms", asyncId, delay));
                 Thread.Sleep(delay);
@@ -188,7 +190,7 @@ async public Task<dynamic> WaitAsyncJobAsync(string asyncId, int delay = 0)
                 if (n < delays.Count)
                     delay = delays[n];
                 Log(string.Format("WaitAsyncJobAsync-loop2: {0} - {1}ms", asyncId, delay));
-            }
+            } while (DateTime.Now < dt.AddSeconds(delay));
 
             // Timeout
             dynamic json = new JObject();

IntentoSDK.csproj

@@ -81,9 +81,7 @@
     <Content Include="ILMerge\License.txt" />
     <Content Include="Newtonsoft\Newtonsoft.Json.dll" />
   </ItemGroup>
-  <ItemGroup>
-    <Folder Include="Demo\" />
-  </ItemGroup>
+  <ItemGroup />
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
   <PropertyGroup>
     <PostBuildEvent>

README.md

@@ -10,3 +10,8 @@ To get more information check out [the site](https://inten.to/).
 [API User Manual](https://github.com/intento/intento-api)
 
 In case you don't have a key to use Intento API, please register here [console.inten.to](https://console.inten.to)
+
+To compile the project, you may need to turn off the signing of the resulting DLL.
+
+You will find a demo of using this SDK in the Demo project of this solution. 
+

RevisionHistory.cs

@@ -47,5 +47,8 @@ namespace IntentoSDK
     // - bug in Fulfill parameter
     // 1.4.4: 2020-04-15
     // - special_headers parameter in Fulfill
+    // 1.4.5: 2020-08-11
+    // - Extended demo
+    // - -1 as a special value for delay parameter of WaitAsyncJob
 
 }