meilisearch-python-sdk 5.1.0__py3-none-any.whl → 5.3.0__py3-none-any.whl

meilisearch_python_sdk/index.py

@@ -562,7 +562,7 @@ class AsyncIndex(_BaseIndex):
         return self
 
     async def fetch_info(self) -> Self:
-        """Gets the infromation about the index.
+        """Gets the information about the index.
 
         Returns:
             An instance of the AsyncIndex containing the retrieved information.
@@ -757,7 +757,7 @@ class AsyncIndex(_BaseIndex):
             attributes_to_retrieve: Attributes to display in the returned documents.
                 Defaults to ["*"].
             attributes_to_crop: Attributes whose values have to be cropped. Defaults to None.
-            crop_length: The maximun number of words to display. Defaults to 200.
+            crop_length: The maximum number of words to display. Defaults to 200.
             attributes_to_highlight: Attributes whose values will contain highlighted matching terms.
                 Defaults to None.
             sort: Attributes by which to sort the results. Defaults to None.
@@ -765,7 +765,7 @@ class AsyncIndex(_BaseIndex):
                 matches should be returned or not. Defaults to False.
             highlight_pre_tag: The opening tag for highlighting text. Defaults to <em>.
             highlight_post_tag: The closing tag for highlighting text. Defaults to </em>
-            crop_marker: Marker to display when the number of words excedes the `crop_length`.
+            crop_marker: Marker to display when the number of words exceeds the `crop_length`.
                 Defaults to ...
             matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to
                 `last`.
@@ -1036,7 +1036,7 @@ class AsyncIndex(_BaseIndex):
             attributes_to_retrieve: Attributes to display in the returned documents.
                 Defaults to ["*"].
             attributes_to_crop: Attributes whose values have to be cropped. Defaults to None.
-            crop_length: The maximun number of words to display. Defaults to 200.
+            crop_length: The maximum number of words to display. Defaults to 200.
             attributes_to_highlight: Attributes whose values will contain highlighted matching terms.
                 Defaults to None.
             sort: Attributes by which to sort the results. Defaults to None.
@@ -1044,7 +1044,7 @@ class AsyncIndex(_BaseIndex):
                 matches should be returned or not. Defaults to False.
             highlight_pre_tag: The opening tag for highlighting text. Defaults to <em>.
             highlight_post_tag: The closing tag for highlighting text. Defaults to </em>
-            crop_marker: Marker to display when the number of words excedes the `crop_length`.
+            crop_marker: Marker to display when the number of words exceeds the `crop_length`.
                 Defaults to ...
             matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to
                 `last`.
@@ -1372,6 +1372,7 @@ class AsyncIndex(_BaseIndex):
     async def get_documents(
         self,
         *,
+        ids: list[str] | None = None,
         offset: int = 0,
         limit: int = 20,
         fields: list[str] | None = None,
@@ -1382,6 +1383,7 @@ class AsyncIndex(_BaseIndex):
         """Get a batch documents from the index.
 
         Args:
+            ids: Array of document primary keys to retrieve. Defaults to None (Gets all documents).
             offset: Number of documents to skip. Defaults to 0.
             limit: Maximum number of documents returnedd. Defaults to 20.
             fields: Document attributes to show. If this value is None then all
@@ -1418,7 +1420,7 @@ class AsyncIndex(_BaseIndex):
         if retrieve_vectors:
             parameters["retrieveVectors"] = "true"
 
-        if not filter:
+        if not filter and not ids:
             if fields:
                 parameters["fields"] = ",".join(fields)
 
@@ -1432,6 +1434,9 @@ class AsyncIndex(_BaseIndex):
 
         parameters["filter"] = filter
 
+        if ids:
+            parameters["ids"] = ids
+
         response = await self._http_requests.post(f"{self._documents_url}/fetch", body=parameters)
 
         return DocumentsInfo(**response.json())
@@ -1663,8 +1668,8 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             document_type: The type of document being added. Accepted types are json, csv, and
-                ndjson. For csv files the first row of the document should be a header row contining
-                the field names, and ever for should have a title.
+                ndjson. For csv files the first row of the document should be a header row
+                containing the field names, and ever for should have a title.
             csv_delimiter: A single ASCII character to specify the delimiter for csv files. This
                 can only be used if the file is a csv file. Defaults to comma.
             combine_documents: If set to True this will combine the documents from all the files
@@ -1827,7 +1832,7 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             document_type: The type of document being added. Accepted types are json, csv, and
-                ndjson. For csv files the first row of the document should be a header row contining
+                ndjson. For csv files the first row of the document should be a header row containing
                 the field names, and ever for should have a title.
             csv_delimiter: A single ASCII character to specify the delimiter for csv files. This
                 can only be used if the file is a csv file. Defaults to comma.
@@ -2350,7 +2355,7 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             document_type: The type of document being added. Accepted types are json, csv, and
-                ndjson. For csv files the first row of the document should be a header row contining
+                ndjson. For csv files the first row of the document should be a header row containing
                 the field names, and ever for should have a title.
             csv_delimiter: A single ASCII character to specify the delimiter for csv files. This
                 can only be used if the file is a csv file. Defaults to comma.
@@ -2462,7 +2467,7 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             document_type: The type of document being added. Accepted types are json, csv, and
-                ndjson. For csv files the first row of the document should be a header row contining
+                ndjson. For csv files the first row of the document should be a header row containing
                 the field names, and ever for should have a title.
             csv_delimiter: A single ASCII character to specify the delimiter for csv files. This
                 can only be used if the file is a csv file. Defaults to comma.
@@ -2907,7 +2912,7 @@ class AsyncIndex(_BaseIndex):
             MeilisearchApiError: If the Meilisearch API returned an error.
 
         Examples
-            >>> from meilisearch_pyrhon_sdk import AsyncClient
+            >>> from meilisearch_python_sdk import AsyncClient
             >>> async with AsyncClient("http://localhost.com", "masterKey") as client:
             >>>     index = client.index("movies")
             >>>     await index.delete_documents_by_filter("genre=horor"))
@@ -4952,9 +4957,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.compact()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.compact()
         """
         response = self._http_requests.post(f"{self._base_url_with_uid}/compact")
         return TaskInfo(**response.json())
@@ -4971,9 +4976,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.delete()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.delete()
         """
         response = self._http_requests.delete(self._base_url_with_uid)
         return TaskInfo(**response.json())
@@ -4990,9 +4995,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.delete_if_exists()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.delete_if_exists()
         """
         response = self.delete()
         status = wait_for_task(self.http_client, response.task_uid, timeout_in_ms=100000)
@@ -5016,9 +5021,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> updated_index = index.update()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     updated_index = index.update()
         """
         payload = {"primaryKey": primary_key}
         response = self._http_requests.patch(self._base_url_with_uid, payload)
@@ -5028,7 +5033,7 @@ class Index(_BaseIndex):
         return self
 
     def fetch_info(self) -> Self:
-        """Gets the infromation about the index.
+        """Gets the information about the index.
 
         Returns:
             An instance of the AsyncIndex containing the retrieved information.
@@ -5039,9 +5044,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index_info = index.fetch_info()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index_info = index.fetch_info()
         """
         response = self._http_requests.get(self._base_url_with_uid)
         index_dict = response.json()
@@ -5062,9 +5067,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> primary_key = index.get_primary_key()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     primary_key = index.get_primary_key()
         """
         info = self.fetch_info()
         return info.primary_key
@@ -5121,8 +5126,8 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = index.create(client, "movies")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = index.create(client, "movies")
         """
         if not primary_key:
             payload = {"uid": uid}
@@ -5166,9 +5171,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> stats = index.get_stats()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     stats = index.get_stats()
         """
         response = self._http_requests.get(self._stats_url)
 
@@ -5216,7 +5221,7 @@ class Index(_BaseIndex):
             attributes_to_retrieve: Attributes to display in the returned documents.
                 Defaults to ["*"].
             attributes_to_crop: Attributes whose values have to be cropped. Defaults to None.
-            crop_length: The maximun number of words to display. Defaults to 200.
+            crop_length: The maximum number of words to display. Defaults to 200.
             attributes_to_highlight: Attributes whose values will contain highlighted matching terms.
                 Defaults to None.
             sort: Attributes by which to sort the results. Defaults to None.
@@ -5224,7 +5229,7 @@ class Index(_BaseIndex):
                 matches should be returned or not. Defaults to False.
             highlight_pre_tag: The opening tag for highlighting text. Defaults to <em>.
             highlight_post_tag: The closing tag for highlighting text. Defaults to </em>
-            crop_marker: Marker to display when the number of words excedes the `crop_length`.
+            crop_marker: Marker to display when the number of words exceeds the `crop_length`.
                 Defaults to ...
             matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to
                 `last`.
@@ -5282,9 +5287,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> search_results = index.search("Tron")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     search_results = index.search("Tron")
         """
         if ranking_score_threshold:
             _validate_ranking_score_threshold(ranking_score_threshold)
@@ -5401,7 +5406,7 @@ class Index(_BaseIndex):
             attributes_to_retrieve: Attributes to display in the returned documents.
                 Defaults to ["*"].
             attributes_to_crop: Attributes whose values have to be cropped. Defaults to None.
-            crop_length: The maximun number of words to display. Defaults to 200.
+            crop_length: The maximum number of words to display. Defaults to 200.
             attributes_to_highlight: Attributes whose values will contain highlighted matching terms.
                 Defaults to None.
             sort: Attributes by which to sort the results. Defaults to None.
@@ -5409,7 +5414,7 @@ class Index(_BaseIndex):
                 matches should be returned or not. Defaults to False.
             highlight_pre_tag: The opening tag for highlighting text. Defaults to <em>.
             highlight_post_tag: The closing tag for highlighting text. Defaults to </em>
-            crop_marker: Marker to display when the number of words excedes the `crop_length`.
+            crop_marker: Marker to display when the number of words exceeds the `crop_length`.
                 Defaults to ...
             matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to
                 `last`.
@@ -5453,13 +5458,13 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> search_results = index.search(
-            >>>     "Tron",
-            >>>     facet_name="genre",
-            >>>     facet_query="Sci-fi"
-            >>> )
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     search_results = index.search(
+            >>>         "Tron",
+            >>>         facet_name="genre",
+            >>>         facet_query="Sci-fi"
+            >>>     )
         """
         if ranking_score_threshold:
             _validate_ranking_score_threshold(ranking_score_threshold)
@@ -5572,9 +5577,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> search_results = index.search_similar_documents("123")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     search_results = index.search_similar_documents("123")
         """
         payload = {
             "id": id,
@@ -5621,9 +5626,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> document = index.get_document("1234")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     document = index.get_document("1234")
         """
         parameters: JsonDict = {}
 
@@ -5640,6 +5645,7 @@ class Index(_BaseIndex):
     def get_documents(
         self,
         *,
+        ids: list[str] | None = None,
         offset: int = 0,
         limit: int = 20,
         fields: list[str] | None = None,
@@ -5650,6 +5656,7 @@ class Index(_BaseIndex):
         """Get a batch documents from the index.
 
         Args:
+            ids: Array of document primary keys to retrieve. Defaults to None (Gets all documents).
             offset: Number of documents to skip. Defaults to 0.
             limit: Maximum number of documents returnedd. Defaults to 20.
             fields: Document attributes to show. If this value is None then all
@@ -5671,9 +5678,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> documents = index.get_documents()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     documents = index.get_documents()
         """
         parameters: JsonDict = {
             "offset": offset,
@@ -5686,7 +5693,7 @@ class Index(_BaseIndex):
         if retrieve_vectors:
             parameters["retrieveVectors"] = "true"
 
-        if not filter:
+        if not filter and not ids:
             if fields:
                 parameters["fields"] = ",".join(fields)
 
@@ -5700,6 +5707,9 @@ class Index(_BaseIndex):
 
         parameters["filter"] = filter
 
+        if ids:
+            parameters["ids"] = ids
+
         response = self._http_requests.post(f"{self._documents_url}/fetch", body=parameters)
 
         return DocumentsInfo(**response.json())
@@ -5732,9 +5742,9 @@ class Index(_BaseIndex):
             >>>     {"id": 1, "title": "Movie 1", "genre": "comedy"},
             >>>     {"id": 2, "title": "Movie 2", "genre": "drama"},
             >>> ]
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.add_documents(documents)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.add_documents(documents)
         """
         if primary_key:
             url = _build_encoded_url(self._documents_url, {"primaryKey": primary_key})
@@ -5791,9 +5801,9 @@ class Index(_BaseIndex):
             >>>     {"id": 1, "title": "Movie 1", "genre": "comedy"},
             >>>     {"id": 2, "title": "Movie 2", "genre": "drama"},
             >>> ]
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.add_documents_in_batches(documents)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.add_documents_in_batches(documents)
         """
         return [
             self.add_documents(x, primary_key, compress=compress)
@@ -5817,7 +5827,7 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             document_type: The type of document being added. Accepted types are json, csv, and
-                ndjson. For csv files the first row of the document should be a header row contining
+                ndjson. For csv files the first row of the document should be a header row containing
                 the field names, and ever for should have a title.
             csv_delimiter: A single ASCII character to specify the delimiter for csv files. This
                 can only be used if the file is a csv file. Defaults to comma.
@@ -5838,9 +5848,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> directory_path = Path("/path/to/directory/containing/files")
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.add_documents_from_directory(directory_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.add_documents_from_directory(directory_path)
         """
         directory = Path(directory_path) if isinstance(directory_path, str) else directory_path
 
@@ -5893,7 +5903,7 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             document_type: The type of document being added. Accepted types are json, csv, and
-                ndjson. For csv files the first row of the document should be a header row contining
+                ndjson. For csv files the first row of the document should be a header row containing
                 the field names, and ever for should have a title.
             csv_delimiter: A single ASCII character to specify the delimiter for csv files. This
                 can only be used if the file is a csv file. Defaults to comma.
@@ -5914,9 +5924,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> directory_path = Path("/path/to/directory/containing/files")
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.add_documents_from_directory_in_batches(directory_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.add_documents_from_directory_in_batches(directory_path)
         """
         directory = Path(directory_path) if isinstance(directory_path, str) else directory_path
 
@@ -5987,9 +5997,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> file_path = Path("/path/to/file.json")
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.add_documents_from_file(file_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.add_documents_from_file(file_path)
         """
         documents = _load_documents_from_file(file_path, json_handler=self._json_handler)
 
@@ -6029,9 +6039,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> file_path = Path("/path/to/file.json")
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.add_documents_from_file_in_batches(file_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.add_documents_from_file_in_batches(file_path)
         """
         documents = _load_documents_from_file(
             file_path, csv_delimiter, json_handler=self._json_handler
@@ -6080,9 +6090,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> file_path = Path("/path/to/file.csv")
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.add_documents_from_raw_file(file_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.add_documents_from_raw_file(file_path)
         """
         upload_path = Path(file_path) if isinstance(file_path, str) else file_path
         if not upload_path.exists():
@@ -6148,9 +6158,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.edit_documents("doc.title = `${doc.title.to_upper()}`")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.edit_documents("doc.title = `${doc.title.to_upper()}`")
         """
         url = f"{self._documents_url}/edit"
         payload: JsonDict = {"function": function}
@@ -6193,9 +6203,9 @@ class Index(_BaseIndex):
             >>>     {"id": 1, "title": "Movie 1", "genre": "comedy"},
             >>>     {"id": 2, "title": "Movie 2", "genre": "drama"},
             >>> ]
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_documents(documents)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_documents(documents)
         """
         if primary_key:
             url = _build_encoded_url(self._documents_url, {"primaryKey": primary_key})
@@ -6256,9 +6266,9 @@ class Index(_BaseIndex):
             >>>     {"id": 1, "title": "Movie 1", "genre": "comedy"},
             >>>     {"id": 2, "title": "Movie 2", "genre": "drama"},
             >>> ]
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_documents_in_batches(documents)
+            >>> with Client("http://localhost.com", "masterKey") client:
+            >>>     index = client.index("movies")
+            >>>     index.update_documents_in_batches(documents)
         """
         return [
             self.update_documents(x, primary_key, compress=compress)
@@ -6282,7 +6292,7 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             document_type: The type of document being added. Accepted types are json, csv, and
-                ndjson. For csv files the first row of the document should be a header row contining
+                ndjson. For csv files the first row of the document should be a header row containing
                 the field names, and ever for should have a title.
             csv_delimiter: A single ASCII character to specify the delimiter for csv files. This
                 can only be used if the file is a csv file. Defaults to comma.
@@ -6303,9 +6313,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> directory_path = Path("/path/to/directory/containing/files")
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_documents_from_directory(directory_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_documents_from_directory(directory_path)
         """
         directory = Path(directory_path) if isinstance(directory_path, str) else directory_path
 
@@ -6357,8 +6367,8 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             document_type: The type of document being added. Accepted types are json, csv, and
-                ndjson. For csv files the first row of the document should be a header row contining
-                the field names, and ever for should have a title.
+                ndjson. For csv files the first row of the document should be a header row
+                containing the field names, and ever for should have a title.
             csv_delimiter: A single ASCII character to specify the delimiter for csv files. This
                 can only be used if the file is a csv file. Defaults to comma.
             combine_documents: If set to True this will combine the documents from all the files
@@ -6378,9 +6388,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> directory_path = Path("/path/to/directory/containing/files")
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_documents_from_directory_in_batches(directory_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_documents_from_directory_in_batches(directory_path)
         """
         directory = Path(directory_path) if isinstance(directory_path, str) else directory_path
 
@@ -6453,9 +6463,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> file_path = Path("/path/to/file.json")
-            >>> client = Client("http://localhost.com", "masterKey") as client:
-            >>> index = client.index("movies")
-            >>> index.update_documents_from_file(file_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_documents_from_file(file_path)
         """
         documents = _load_documents_from_file(
             file_path, csv_delimiter, json_handler=self._json_handler
@@ -6492,9 +6502,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> file_path = Path("/path/to/file.json")
-            >>> client = Client("http://localhost.com", "masterKey") as client:
-            >>> index = client.index("movies")
-            >>> index.update_documents_from_file_in_batches(file_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_documents_from_file_in_batches(file_path)
         """
         documents = _load_documents_from_file(file_path, json_handler=self._json_handler)
 
@@ -6541,9 +6551,9 @@ class Index(_BaseIndex):
             >>> from pathlib import Path
             >>> from meilisearch_python_sdk import Client
             >>> file_path = Path("/path/to/file.csv")
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_documents_from_raw_file(file_path)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_documents_from_raw_file(file_path)
         """
         upload_path = Path(file_path) if isinstance(file_path, str) else file_path
         if not upload_path.exists():
@@ -6600,9 +6610,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.delete_document("1234")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.delete_document("1234")
         """
         if self._pre_delete_document_plugins:
             Index._run_plugins(
@@ -6633,9 +6643,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.delete_documents(["1234", "5678"])
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.delete_documents(["1234", "5678"])
         """
         if self._pre_delete_documents_plugins:
             Index._run_plugins(self._pre_delete_documents_plugins, Event.PRE, ids=ids)
@@ -6666,9 +6676,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.delete_documents_by_filter("genre=horor"))
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.delete_documents_by_filter("genre=horor"))
         """
         if self._pre_delete_documents_by_filter_plugins:
             Index._run_plugins(
@@ -6705,14 +6715,14 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.delete_documents_in_batches_by_filter(
-            >>>     [
-            >>>         "genre=horor"),
-            >>>         "release_date=1520035200"),
-            >>>     ]
-            >>> )
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.delete_documents_in_batches_by_filter(
+            >>>         [
+            >>>             "genre=horor"),
+            >>>             "release_date=1520035200"),
+            >>>         ]
+            >>>     )
         """
         return [self.delete_documents_by_filter(filter) for filter in filters]
 
@@ -6728,9 +6738,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.delete_all_document()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.delete_all_document()
         """
         if self._pre_delete_all_documents_plugins:
             Index._run_plugins(self._pre_delete_all_documents_plugins, Event.PRE)
@@ -6758,9 +6768,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> settings = index.get_settings()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     settings = index.get_settings()
         """
         response = self._http_requests.get(self._settings_url)
         response_json = response.json()
@@ -6810,9 +6820,9 @@ class Index(_BaseIndex):
             >>>    displayed_attributes=["title", "description", "genre", "release_date"],
             >>>    sortable_attributes=["title", "release_date"],
             >>> )
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_settings(new_settings)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_settings(new_settings)
         """
         body_dict = {
             k: v
@@ -6835,9 +6845,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_settings()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_settings()
         """
         response = self._http_requests.delete(self._settings_url)
 
@@ -6855,9 +6865,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> ranking_rules = index.get_ranking_rules()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     ranking_rules = index.get_ranking_rules()
         """
         response = self._http_requests.get(f"{self._settings_url}/ranking-rules")
 
@@ -6889,9 +6899,9 @@ class Index(_BaseIndex):
             >>>      "release_date:desc",
             >>>      "rank:desc",
             >>> ],
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_ranking_rules(ranking_rules)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_ranking_rules(ranking_rules)
         """
         response = self._http_requests.put(
             f"{self._settings_url}/ranking-rules", ranking_rules, compress=compress
@@ -6911,9 +6921,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_ranking_rules()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_ranking_rules()
         """
         response = self._http_requests.delete(f"{self._settings_url}/ranking-rules")
 
@@ -6932,9 +6942,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> distinct_attribute = index.get_distinct_attribute()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     distinct_attribute = index.get_distinct_attribute()
         """
         response = self._http_requests.get(f"{self._settings_url}/distinct-attribute")
 
@@ -6959,9 +6969,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_distinct_attribute("url")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_distinct_attribute("url")
         """
         response = self._http_requests.put(
             f"{self._settings_url}/distinct-attribute", body, compress=compress
@@ -6981,9 +6991,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_distinct_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_distinct_attributes()
         """
         response = self._http_requests.delete(f"{self._settings_url}/distinct-attribute")
 
@@ -7001,9 +7011,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> searchable_attributes = index.get_searchable_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     searchable_attributes = index.get_searchable_attributes()
         """
         response = self._http_requests.get(f"{self._settings_url}/searchable-attributes")
 
@@ -7025,9 +7035,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_searchable_attributes(["title", "description", "genre"])
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_searchable_attributes(["title", "description", "genre"])
         """
         response = self._http_requests.put(
             f"{self._settings_url}/searchable-attributes", body, compress=compress
@@ -7047,9 +7057,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_searchable_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_searchable_attributes()
         """
         response = self._http_requests.delete(f"{self._settings_url}/searchable-attributes")
 
@@ -7067,9 +7077,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> displayed_attributes = index.get_displayed_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     displayed_attributes = index.get_displayed_attributes()
         """
         response = self._http_requests.get(f"{self._settings_url}/displayed-attributes")
 
@@ -7091,11 +7101,11 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_displayed_attributes(
-            >>>     ["title", "description", "genre", "release_date"]
-            >>> )
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_displayed_attributes(
+            >>>         ["title", "description", "genre", "release_date"]
+            >>>     )
         """
         response = self._http_requests.put(
             f"{self._settings_url}/displayed-attributes", body, compress=compress
@@ -7115,9 +7125,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_displayed_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_displayed_attributes()
         """
         response = self._http_requests.delete(f"{self._settings_url}/displayed-attributes")
 
@@ -7135,9 +7145,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> stop_words = index.get_stop_words()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     stop_words = index.get_stop_words()
         """
         response = self._http_requests.get(f"{self._settings_url}/stop-words")
 
@@ -7162,9 +7172,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_stop_words(["the", "a", "an"])
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_stop_words(["the", "a", "an"])
         """
         response = self._http_requests.put(
             f"{self._settings_url}/stop-words", body, compress=compress
@@ -7184,9 +7194,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_stop_words()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_stop_words()
         """
         response = self._http_requests.delete(f"{self._settings_url}/stop-words")
 
@@ -7204,9 +7214,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> synonyms = index.get_synonyms()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     synonyms = index.get_synonyms()
         """
         response = self._http_requests.get(f"{self._settings_url}/synonyms")
 
@@ -7230,11 +7240,11 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey") as client:
-            >>> index = client.index("movies")
-            >>> index.update_synonyms(
-            >>>     {"wolverine": ["xmen", "logan"], "logan": ["wolverine"]}
-            >>> )
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_synonyms(
+            >>>         {"wolverine": ["xmen", "logan"], "logan": ["wolverine"]}
+            >>>     )
         """
         response = self._http_requests.put(
             f"{self._settings_url}/synonyms", body, compress=compress
@@ -7254,9 +7264,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_synonyms()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_synonyms()
         """
         response = self._http_requests.delete(f"{self._settings_url}/synonyms")
 
@@ -7274,9 +7284,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> filterable_attributes = index.get_filterable_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     filterable_attributes = index.get_filterable_attributes()
         """
         response = self._http_requests.get(f"{self._settings_url}/filterable-attributes")
 
@@ -7317,9 +7327,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_filterable_attributes(["genre", "director"])
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_filterable_attributes(["genre", "director"])
         """
         payload: list[str | JsonDict] = []
 
@@ -7347,9 +7357,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_filterable_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_filterable_attributes()
         """
         response = self._http_requests.delete(f"{self._settings_url}/filterable-attributes")
 
@@ -7367,9 +7377,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> sortable_attributes = index.get_sortable_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     sortable_attributes = index.get_sortable_attributes()
         """
         response = self._http_requests.get(f"{self._settings_url}/sortable-attributes")
 
@@ -7393,9 +7403,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_sortable_attributes(["title", "release_date"])
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_sortable_attributes(["title", "release_date"])
         """
         response = self._http_requests.put(
             f"{self._settings_url}/sortable-attributes", sortable_attributes, compress=compress
@@ -7415,9 +7425,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_sortable_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_sortable_attributes()
         """
         response = self._http_requests.delete(f"{self._settings_url}/sortable-attributes")
 
@@ -7435,9 +7445,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> sortable_attributes = index.get_typo_tolerance()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     sortable_attributes = index.get_typo_tolerance()
         """
         response = self._http_requests.get(f"{self._settings_url}/typo-tolerance")
 
@@ -7461,10 +7471,10 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> TypoTolerance(enabled=False)
-            >>> index.update_typo_tolerance()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     TypoTolerance(enabled=False)
+            >>>     index.update_typo_tolerance()
         """
         response = self._http_requests.patch(
             f"{self._settings_url}/typo-tolerance",
@@ -7486,9 +7496,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_typo_tolerance()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_typo_tolerance()
         """
         response = self._http_requests.delete(f"{self._settings_url}/typo-tolerance")
 
@@ -7506,9 +7516,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> faceting = index.get_faceting()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     faceting = index.get_faceting()
         """
         response = self._http_requests.get(f"{self._settings_url}/faceting")
 
@@ -7530,9 +7540,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_faceting(faceting=Faceting(max_values_per_facet=100))
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_faceting(faceting=Faceting(max_values_per_facet=100))
         """
         response = self._http_requests.patch(
             f"{self._settings_url}/faceting",
@@ -7554,9 +7564,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_faceting()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_faceting()
         """
         response = self._http_requests.delete(f"{self._settings_url}/faceting")
 
@@ -7574,9 +7584,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> pagination_settings = index.get_pagination()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     pagination_settings = index.get_pagination()
         """
         response = self._http_requests.get(f"{self._settings_url}/pagination")
 
@@ -7599,9 +7609,9 @@ class Index(_BaseIndex):
         Examples
             >>> from meilisearch_python_sdk import Client
             >>> from meilisearch_python_sdk.models.settings import Pagination
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_pagination(settings=Pagination(max_total_hits=123))
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_pagination(settings=Pagination(max_total_hits=123))
         """
         response = self._http_requests.patch(
             f"{self._settings_url}/pagination",
@@ -7623,9 +7633,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_pagination()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_pagination()
         """
         response = self._http_requests.delete(f"{self._settings_url}/pagination")
 
@@ -7643,9 +7653,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> separator_token_settings = index.get_separator_tokens()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     separator_token_settings = index.get_separator_tokens()
         """
         response = self._http_requests.get(f"{self._settings_url}/separator-tokens")
 
@@ -7669,9 +7679,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_separator_tokens(separator_tokenes=["|", "/")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_separator_tokens(separator_tokenes=["|", "/")
         """
         response = self._http_requests.put(
             f"{self._settings_url}/separator-tokens", separator_tokens, compress=compress
@@ -7691,9 +7701,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_separator_tokens()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_separator_tokens()
         """
         response = self._http_requests.delete(f"{self._settings_url}/separator-tokens")
 
@@ -7711,9 +7721,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> non_separator_token_settings = index.get_non_separator_tokens()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     non_separator_token_settings = index.get_non_separator_tokens()
         """
         response = self._http_requests.get(f"{self._settings_url}/non-separator-tokens")
 
@@ -7737,9 +7747,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_non_separator_tokens(non_separator_tokens=["@", "#")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_non_separator_tokens(non_separator_tokens=["@", "#")
         """
         response = self._http_requests.put(
             f"{self._settings_url}/non-separator-tokens", non_separator_tokens, compress=compress
@@ -7759,9 +7769,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_non_separator_tokens()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_non_separator_tokens()
         """
         response = self._http_requests.delete(f"{self._settings_url}/non-separator-tokens")
 
@@ -7779,9 +7789,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> search_cutoff_ms_settings = index.get_search_cutoff_ms()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     search_cutoff_ms_settings = index.get_search_cutoff_ms()
         """
         response = self._http_requests.get(f"{self._settings_url}/search-cutoff-ms")
 
@@ -7803,9 +7813,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_search_cutoff_ms(100)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_search_cutoff_ms(100)
         """
         response = self._http_requests.put(
             f"{self._settings_url}/search-cutoff-ms", search_cutoff_ms, compress=compress
@@ -7825,9 +7835,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_search_cutoff_ms()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_search_cutoff_ms()
         """
         response = self._http_requests.delete(f"{self._settings_url}/search-cutoff-ms")
 
@@ -7845,9 +7855,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> word_dictionary = index.get_word_dictionary()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     word_dictionary = index.get_word_dictionary()
         """
         response = self._http_requests.get(f"{self._settings_url}/dictionary")
 
@@ -7869,9 +7879,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_word_dictionary(dictionary=["S.O.S", "S.O")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_word_dictionary(dictionary=["S.O.S", "S.O")
         """
         response = self._http_requests.put(
             f"{self._settings_url}/dictionary", dictionary, compress=compress
@@ -7891,9 +7901,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_word_dictionary()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_word_dictionary()
         """
         response = self._http_requests.delete(f"{self._settings_url}/dictionary")
 
@@ -7911,9 +7921,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> proximity_precision = index.get_proximity_precision()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     proximity_precision = index.get_proximity_precision()
         """
         response = self._http_requests.get(f"{self._settings_url}/proximity-precision")
 
@@ -7938,9 +7948,9 @@ class Index(_BaseIndex):
         Examples
             >>> from meilisearch_python_sdk import Client
             >>> from meilisearch_python_sdk.models.settings import ProximityPrecision
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_proximity_precision(ProximityPrecision.BY_ATTRIBUTE)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_proximity_precision(ProximityPrecision.BY_ATTRIBUTE)
         """
         response = self._http_requests.put(
             f"{self._settings_url}/proximity-precision",
@@ -7962,9 +7972,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_proximity_precision()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_proximity_precision()
         """
         response = self._http_requests.delete(f"{self._settings_url}/proximity-precision")
 
@@ -7982,9 +7992,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> embedders = await index.get_embedders()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     embedders = await index.get_embedders()
         """
         response = self._http_requests.get(f"{self._settings_url}/embedders")
 
@@ -8007,11 +8017,11 @@ class Index(_BaseIndex):
         Examples
             >>> from meilisearch_python_sdk import Client
             >>> from meilisearch_python_sdk.models.settings import Embedders, UserProvidedEmbedder
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_embedders(
-            >>>     Embedders(embedders={dimensions=512)})
-            >>> )
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_embedders(
+            >>>         Embedders(embedders={dimensions=512)})
+            >>>     )
         """
         payload = {}
         for key, embedder in embedders.embedders.items():
@@ -8040,9 +8050,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = AsyncClient("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_embedders()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_embedders()
         """
         response = self._http_requests.delete(f"{self._settings_url}/embedders")
 
@@ -8060,9 +8070,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import AsyncClient
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> localized_attributes = await index.get_localized_attributes()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     localized_attributes = await index.get_localized_attributes()
         """
         response = self._http_requests.get(f"{self._settings_url}/localized-attributes")
 
@@ -8092,12 +8102,12 @@ class Index(_BaseIndex):
             >>> from meilisearch_python_sdk.models.settings import LocalizedAttributes
             >>>
             >>>
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_localized_attributes([
-            >>>     LocalizedAttributes(locales=["eng", "spa"], attribute_patterns=["*"]),
-            >>>     LocalizedAttributes(locales=["ita"], attribute_patterns=["*_it"]),
-            >>> ])
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_localized_attributes([
+            >>>         LocalizedAttributes(locales=["eng", "spa"], attribute_patterns=["*"]),
+            >>>         LocalizedAttributes(locales=["ita"], attribute_patterns=["*_it"]),
+            >>>     ])
         """
         payload = [x.model_dump(by_alias=True) for x in localized_attributes]
         response = self._http_requests.put(
@@ -8138,9 +8148,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> facet_search = await index.get_facet_search()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     facet_search = await index.get_facet_search()
         """
         response = self._http_requests.get(f"{self._settings_url}/facet-search")
 
@@ -8162,9 +8172,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_facet_search(True)
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_facet_search(True)
         """
         response = self._http_requests.put(
             f"{self._settings_url}/facet-search",
@@ -8186,9 +8196,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> await index.reset_facet_search()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     await index.reset_facet_search()
         """
         response = self._http_requests.delete(f"{self._settings_url}/facet-search")
 
@@ -8206,9 +8216,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> prefix_search = index.get_prefix_search()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     prefix_search = index.get_prefix_search()
         """
         response = self._http_requests.get(f"{self._settings_url}/prefix-search")
 
@@ -8235,9 +8245,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.update_prefix_search("disabled")
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.update_prefix_search("disabled")
         """
         response = self._http_requests.put(
             f"{self._settings_url}/prefix-search",
@@ -8259,9 +8269,9 @@ class Index(_BaseIndex):
 
         Examples
             >>> from meilisearch_async_client import Client
-            >>> client = Client("http://localhost.com", "masterKey")
-            >>> index = client.index("movies")
-            >>> index.reset_prefix_search()
+            >>> with Client("http://localhost.com", "masterKey") as client:
+            >>>     index = client.index("movies")
+            >>>     index.reset_prefix_search()
         """
         response = self._http_requests.delete(f"{self._settings_url}/prefix-search")