feat(csharp): guides

Author: Fluf22

docs/guides/csharp/src/program.cs

@@ -1,4 +1,6 @@
-public class Program
+namespace Algolia;
+
+public static class Program
 {
   public static void Main() { }
 }

templates/csharp/guides/ingestion/pushSetup.mustache

@@ -1,33 +1,34 @@
+namespace Algolia;
+
 using System;
 using System.Text.Json;
 using System.Collections.Generic;
 
 {{> snippets/import}}
 
 using Action = Algolia.Search.Models.Ingestion.Action;
-using static Algolia.Search.Models.Ingestion.PushTaskRecords;
 
 class PushSetup
 {
-    public static async Task Main(string[] args)
+    async Task Main(string[] args)
     {
-        string jsonContent = File.ReadAllText("records.json");
+      try
+      {
+        var jsonContent = await File.ReadAllTextAsync("records.json");
 
         var records = JsonSerializer.Deserialize<List<PushTaskRecords>>(jsonContent);
 
         // use the region matching your applicationID
         {{> snippets/init}}
 
-        try
-        {
-            // setting `watch` to `true` will make the call synchronous
-            var resp = {{#dynamicSnippet}}pushSetup{{/dynamicSnippet}};
-
-            Console.WriteLine(resp);
-        }
-        catch (Exception e)
-        {
-            Console.WriteLine(e.Message);
-        }
+        // setting `watch` to `true` will make the call synchronous
+        var resp = {{#dynamicSnippet}}pushSetup{{/dynamicSnippet}};
+
+        Console.WriteLine(resp);
+      }
+      catch (Exception e)
+      {
+          Console.WriteLine(e.Message);
+      }
     }
 }

templates/csharp/guides/search/deleteMultipleIndices.mustache

@@ -0,0 +1,47 @@
+namespace Algolia;
+
+using System;
+using System.Text.Json;
+using System.Net.Http;
+using System.Collections.Generic;
+
+{{> snippets/import}}
+
+class DeleteMultipleIndices {
+
+  async Task Main(string[] args)
+  {
+
+    // You need an API key with `deleteIndex`
+    try {
+      {{> snippets/init}}
+
+      // List all indices
+      var indices = {{#dynamicSnippet}}listIndicesSimple{{/dynamicSnippet}};
+
+      // Primary indices don't have a `primary` key
+      var primaryIndices = indices.Items.Where(item => item.Primary == null).ToList();
+      var replicaIndices = indices.Items.Where(item => item.Primary != null).ToList();
+
+      // Delete primary indices first
+      if (primaryIndices.Count > 0)
+      {
+          var requests = primaryIndices
+            .Select(index => new MultipleBatchRequest(Search.Models.Search.Action.Delete, index.Name)).ToList();
+          {{#dynamicSnippet}}deleteMultipleIndicesPrimary{{/dynamicSnippet}};
+          Console.WriteLine("Deleted primary indices.");
+      }
+
+      // Now, delete replica indices
+      if (replicaIndices.Count > 0)
+      {
+          var requests = replicaIndices
+            .Select(index => new MultipleBatchRequest(Search.Models.Search.Action.Delete, index.Name)).ToList();
+          {{#dynamicSnippet}}deleteMultipleIndicesReplica{{/dynamicSnippet}};
+          Console.WriteLine("Deleted replica indices.");
+      }
+    } catch (Exception e) {
+          Console.WriteLine(e.Message);
+    }
+  }
+}

templates/csharp/guides/search/saveObjectsChunks.mustache

@@ -0,0 +1,31 @@
+namespace Algolia;
+
+using System;
+using System.Text.Json;
+using System.Net.Http;
+using System.Collections.Generic;
+
+{{> snippets/import}}
+
+class SaveObjectsChunks {
+
+  async Task Main(string[] args)
+  {
+
+    try {
+      {{> snippets/init}}
+      var jsonContent = await File.ReadAllTextAsync("actors.json");
+      var records = JsonSerializer.Deserialize<List<Dictionary<string, object>>>(jsonContent);
+
+      const int chunkSize = 10000;
+
+      for (var beginIndex = 0; beginIndex < records?.Count; beginIndex += chunkSize)
+      {
+        var chunk = records.Slice(beginIndex, Math.Min(beginIndex + chunkSize, records.Count));
+        {{#dynamicSnippet}}saveObjectsChunks{{/dynamicSnippet}};
+      }
+    } catch (Exception e) {
+      Console.WriteLine(e.Message);
+    }
+  }
+}

templates/csharp/guides/search/saveObjectsMCM.mustache

@@ -0,0 +1,39 @@
+namespace Algolia;
+
+using System;
+using System.Text.Json;
+using System.Net.Http;
+using System.Collections.Generic;
+
+{{> snippets/import}}
+
+class SaveObjectsMcm {
+
+  private readonly List<Dictionary<string, object>> playlists = []; // Your records
+
+  private static List<Dictionary<string, string>> GetAllAppIdConfigurations()
+  {
+    return [/* A list of your MCM AppID/ApiKey pairs */];
+  }
+
+  async Task Main(string[] args)
+  {
+
+    // Fetch from your own data storage and with your own code
+    // the list of application IDs and API keys to target each cluster
+    var configurations = GetAllAppIdConfigurations();
+
+    // Send the records to each cluster
+    foreach (var config in configurations)
+    {
+      try
+      {
+        var client = new SearchClient(new SearchConfig(config.GetValueOrDefault("appID", ""), config.GetValueOrDefault("apiKey", "")));
+        {{#dynamicSnippet}}saveObjectsPlaylists{{/dynamicSnippet}};
+      } catch (Exception e)
+      {
+        Console.WriteLine(e.Message);
+      }
+    }
+  }
+}

templates/csharp/guides/search/saveObjectsModified.mustache

@@ -0,0 +1,42 @@
+namespace Algolia;
+
+using System;
+using System.Text.Json;
+using System.Net.Http;
+using System.Collections.Generic;
+
+{{> snippets/import}}
+
+class SaveObjectsModified {
+
+  async Task Main(string[] args)
+  {
+
+    try {
+      {{> snippets/init}}
+
+      var jsonContent = await File.ReadAllTextAsync("products.json");
+      var products = JsonSerializer.Deserialize<List<Dictionary<string, object>>>(jsonContent);
+
+      var records = products?.Select(product =>
+      {
+        var reference = product.GetValueOrDefault("product_reference", "") as string;
+        var suffixes = new List<string>();
+
+        for (var i = reference!.Length; i > 1; i--)
+        {
+          suffixes.Add(reference[i..]);
+        }
+
+        return new Dictionary<string, object>(product)
+        {
+          ["suffixes"] = suffixes
+        };
+      }).ToList();
+
+      {{#dynamicSnippet}}saveObjectsRecords{{/dynamicSnippet}};
+    } catch (Exception e) {
+      Console.WriteLine(e.Message);
+    }
+  }
+}

templates/csharp/guides/search/saveObjectsMovies.mustache

@@ -1,3 +1,5 @@
+namespace Algolia;
+
 using System;
 using System.Text.Json;
 using System.Net.Http;
@@ -7,7 +9,7 @@ using System.Collections.Generic;
 
 class SaveObjectsMovies
 {
-    public static async Task Main(string[] args)
+    async Task Main(string[] args)
     {
         // read json file from url
         var url = "https://dashboard.algolia.com/api/1/sample_datasets?type=movie";

templates/csharp/guides/search/saveObjectsPublicUser.mustache

@@ -0,0 +1,24 @@
+namespace Algolia;
+
+using System;
+using System.Text.Json;
+using System.Net.Http;
+using System.Collections.Generic;
+
+{{> snippets/import}}
+
+class SaveObjectsPublicUser {
+
+  private static readonly List<Dictionary<string, object>> playlists = []; // Your records
+
+  async Task Main(string[] args)
+  {
+
+    try {
+      {{> snippets/init}}
+      {{#dynamicSnippet}}saveObjectsPlaylistsWithUserIDPublic{{/dynamicSnippet}};
+    } catch (Exception e) {
+      Console.WriteLine(e.Message);
+    }
+  }
+}

templates/csharp/guides/search/savePopularRecords.mustache

@@ -0,0 +1,40 @@
+namespace Algolia;
+
+using System;
+using System.Text.Json;
+using System.Net.Http;
+using System.Collections.Generic;
+
+{{> snippets/import}}
+
+class SavePopularRecords {
+
+  async Task Main(string[] args)
+  {
+
+    try {
+      {{> snippets/init}}
+      var records = new List<Dictionary<string, object>>();
+
+      var hits = await client.BrowseObjectsAsync<Hit>("<YOUR_INDEX_NAME>", new BrowseParamsObject());
+
+      foreach (var hit in hits)
+      {
+        var props = hit.AdditionalProperties ?? new Dictionary<string, object>();
+        var nbFollowers = props["nbFollowers"] as int? ?? 0;
+        records.Add(
+          new Dictionary<string, object>
+          {
+            ["twitterHandle"] = props["twitterHandle"],
+            ["nbFollowers"] = nbFollowers,
+            ["isPopular"] = nbFollowers >= 1_000_000
+          }
+          );
+      }
+
+      {{#dynamicSnippet}}saveObjectsRecords{{/dynamicSnippet}};
+    } catch (Exception e) {
+      Console.WriteLine(e.Message);
+    }
+  }
+}

templates/csharp/guides/search/searchRecentlyPublishedBooks.mustache

@@ -0,0 +1,30 @@
+namespace Algolia;
+
+using System;
+using System.Text.Json;
+using System.Net.Http;
+using System.Collections.Generic;
+
+{{> snippets/import}}
+
+class SearchRecentlyPublishedBooks {
+
+  async Task Main(string[] args)
+  {
+
+    try {
+      {{> snippets/init}}
+      var dateTimestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
+      var searchParams = new SearchParams(new SearchParamsObject
+          {
+              Query = "<YOUR_SEARCH_QUERY>",
+              Filters = $"date_timestamp > {dateTimestamp}"
+          }
+      );
+
+      {{#dynamicSnippet}}searchWithSearchParams{{/dynamicSnippet}};
+    } catch (Exception e) {
+      Console.WriteLine(e.Message);
+    }
+  }
+}