guides: add missing snippets to docs (#4391)

Co-authored-by: Thomas Raffray <[email protected]>

Author: shortcuts

generators/src/main/java/com/algolia/codegen/cts/tests/Snippet.java

@@ -12,7 +12,6 @@
 public class Snippet {
 
   public String testName;
-  public boolean isSnippet;
 
   public String method;
   public Map<String, Object> parameters;
@@ -21,7 +20,6 @@ public class Snippet {
   public Snippet(String method, String testName, Map<String, Object> parameters) {
     this.method = method;
     this.testName = testName;
-    this.isSnippet = true;
     this.parameters = parameters;
   }
 
@@ -32,7 +30,6 @@ public String toString() {
     StringBuilder sb = new StringBuilder();
     sb.append("class Request {\n");
     sb.append("    testName: ").append(testName).append("\n");
-    sb.append("    isSnippet").append(isSnippet).append("\n");
     sb.append("    method: ").append(method).append("\n");
     sb.append("    parameters: ").append(parameters).append("\n");
     sb.append("    requestOptions: ").append(requestOptions).append("\n");

generators/src/main/java/com/algolia/codegen/cts/tests/SnippetsGenerator.java

@@ -101,12 +101,7 @@ public void run(Map<String, CodegenModel> models, Map<String, CodegenOperation>
         continue;
       }
 
-      List<Snippet> ops = Arrays.stream(snippets.get(operationId)).filter(r -> r.isSnippet).toList();
-      if (ops.size() == 0) {
-        // default to the first test
-        ops = List.of(snippets.get(operationId)[0]);
-      }
-
+      List<Snippet> ops = Arrays.stream(snippets.get(operationId)).toList();
       List<Map<String, Object>> tests = new ArrayList<>();
 
       for (int i = 0; i < ops.size(); i++) {

templates/csharp/snippets/import.mustache

@@ -1,2 +1,3 @@
 using Algolia.Search.Clients;
+using Algolia.Search.Http;
 using Algolia.Search.Models.{{clientPrefix}};

templates/java/snippets/import.mustache

@@ -1,2 +1,3 @@
 import com.algolia.api.{{client}};
-import com.algolia.model.{{import}}.*;
+import com.algolia.model.{{import}}.*;
+import com.algolia.config.*;

templates/kotlin/snippets/import.mustache

@@ -1,4 +1,9 @@
 import com.algolia.client.api.{{client}}
+import com.algolia.client.configuration.*
+import com.algolia.client.transport.*
 {{#isSearchClient}}
 import com.algolia.client.extensions.*
-{{/isSearchClient}}
+{{/isSearchClient}}
+{{#isCompositionClient}}
+import com.algolia.client.model.{{import}}.RequestBody
+{{/isCompositionClient}}

templates/python/partial_api_args.mustache

@@ -1,7 +1,7 @@
 (
         self,
         {{#allParams}}
-        {{paramName}}: {{#isModel}}Union[{{/isModel}}{{#isArray}}{{#items.isModel}}Union[{{/items.isModel}}{{/isArray}}{{#isEnumRef}}Union[{{/isEnumRef}}{{{vendorExtensions.x-py-typing}}}{{#isModel}}, dict[str, Any]]{{/isModel}}{{#isEnumRef}}, str]{{/isEnumRef}}{{#isArray}}{{#items.isModel}}, list[dict[str, Any]]]{{/items.isModel}}{{/isArray}}{{^required}} = None{{/required}},
+        {{paramName}}: {{#isModel}}Union[{{/isModel}}{{#isArray}}{{#items.isEnumRef}}Union[list[str], {{/items.isEnumRef}}{{#items.isModel}}Union[{{/items.isModel}}{{/isArray}}{{#isEnumRef}}Union[{{/isEnumRef}}{{{vendorExtensions.x-py-typing}}}{{#isModel}}, dict[str, Any]]{{/isModel}}{{#isEnumRef}}, str]{{/isEnumRef}}{{#isArray}}{{#items.isEnumRef}}]{{/items.isEnumRef}}{{#items.isModel}}, {{#isQueryParam}}list[str], {{/isQueryParam}} list[dict[str, Any]]]{{/items.isModel}}{{/isArray}}{{^required}} = None{{/required}},
         {{/allParams}}
         request_options: Optional[Union[dict, RequestOptions]] = None
     )

templates/python/snippets/import.mustache

@@ -1,2 +1,3 @@
 from algoliasearch.{{{import}}}.client import {{#lambda.pascalcase}}{{{client}}}{{/lambda.pascalcase}}
-from algoliasearch.{{{import}}}.client import {{#lambda.pascalcase}}{{{client}}}Sync{{/lambda.pascalcase}}
+from algoliasearch.{{{import}}}.client import {{#lambda.pascalcase}}{{{client}}}Sync{{/lambda.pascalcase}}
+from json import loads

templates/scala/snippets/import.mustache

@@ -1,4 +1,5 @@
 import algoliasearch.api.{{client}}
+import algoliasearch.config.*
 {{#isSearchClient}}
 import algoliasearch.extension.SearchClientExtensions
 {{/isSearchClient}}

tests/CTS/requests/ingestion/listAuthentications.json

@@ -16,9 +16,7 @@
         "basic",
         "algolia"
       ],
-      "platform": [
-        "none"
-      ],
+      "platform": ["none"],
       "sort": "createdAt",
       "order": "asc"
     },

tests/CTS/requests/search/batch.json

@@ -1,7 +1,6 @@
 [
   {
     "testName": "addObject",
-    "isSnippet": true,
     "parameters": {
       "indexName": "<YOUR_INDEX_NAME>",
       "batchWriteParams": {
@@ -48,7 +47,6 @@
   },
   {
     "testName": "clear",
-    "isSnippet": true,
     "parameters": {
       "indexName": "<YOUR_INDEX_NAME>",
       "batchWriteParams": {
@@ -79,7 +77,6 @@
   },
   {
     "testName": "delete",
-    "isSnippet": true,
     "parameters": {
       "indexName": "<YOUR_INDEX_NAME>",
       "batchWriteParams": {
@@ -110,7 +107,6 @@
   },
   {
     "testName": "deleteObject",
-    "isSnippet": true,
     "parameters": {
       "indexName": "<YOUR_INDEX_NAME>",
       "batchWriteParams": {
@@ -141,7 +137,6 @@
   },
   {
     "testName": "partialUpdateObject",
-    "isSnippet": true,
     "parameters": {
       "indexName": "<YOUR_INDEX_NAME>",
       "batchWriteParams": {
@@ -172,7 +167,6 @@
   },
   {
     "testName": "partialUpdateObjectNoCreate",
-    "isSnippet": true,
     "parameters": {
       "indexName": "<YOUR_INDEX_NAME>",
       "batchWriteParams": {
@@ -203,7 +197,6 @@
   },
   {
     "testName": "updateObject",
-    "isSnippet": true,
     "parameters": {
       "indexName": "<YOUR_INDEX_NAME>",
       "batchWriteParams": {