meilisearch-python-sdk 2.12.1__py3-none-any.whl → 3.0.1__py3-none-any.whl

meilisearch_python_sdk/index.py

@@ -1,14 +1,13 @@
 from __future__ import annotations
 
 import asyncio
-import json
+from collections.abc import Generator, MutableMapping, Sequence
 from csv import DictReader
 from datetime import datetime
 from functools import cached_property, partial
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Generator, Literal, MutableMapping, Sequence
+from typing import TYPE_CHECKING, Any, Literal
 from urllib.parse import urlencode
-from warnings import warn
 
 import aiofiles
 from camel_converter import to_snake
@@ -16,8 +15,9 @@ from httpx import AsyncClient, Client
 
 from meilisearch_python_sdk._http_requests import AsyncHttpRequests, HttpRequests
 from meilisearch_python_sdk._task import async_wait_for_task, wait_for_task
-from meilisearch_python_sdk._utils import is_pydantic_2, iso_to_date_time, use_task_groups
+from meilisearch_python_sdk._utils import iso_to_date_time, use_task_groups
 from meilisearch_python_sdk.errors import InvalidDocumentError, MeilisearchError
+from meilisearch_python_sdk.json_handler import BuiltinHandler, OrjsonHandler, UjsonHandler
 from meilisearch_python_sdk.models.documents import DocumentsInfo
 from meilisearch_python_sdk.models.index import IndexStats
 from meilisearch_python_sdk.models.search import (
@@ -71,6 +71,7 @@ class _BaseIndex:
         primary_key: str | None = None,
         created_at: str | datetime | None = None,
         updated_at: str | datetime | None = None,
+        json_handler: BuiltinHandler | OrjsonHandler | UjsonHandler | None = None,
     ):
         self.uid = uid
         self.primary_key = primary_key
@@ -81,6 +82,7 @@ class _BaseIndex:
         self._documents_url = f"{self._base_url_with_uid}/documents"
         self._stats_url = f"{self._base_url_with_uid}/stats"
         self._settings_url = f"{self._base_url_with_uid}/settings"
+        self._json_handler = json_handler if json_handler else BuiltinHandler()
 
     def __str__(self) -> str:
         return f"{type(self).__name__}(uid={self.uid}, primary_key={self.primary_key}, created_at={self.created_at}, updated_at={self.updated_at})"
@@ -110,6 +112,7 @@ class AsyncIndex(_BaseIndex):
         created_at: str | datetime | None = None,
         updated_at: str | datetime | None = None,
         plugins: AsyncIndexPlugins | None = None,
+        json_handler: BuiltinHandler | OrjsonHandler | UjsonHandler | None = None,
     ):
         """Class initializer.
 
@@ -122,10 +125,14 @@ class AsyncIndex(_BaseIndex):
             created_at: The date and time the index was created. Defaults to None.
             updated_at: The date and time the index was last updated. Defaults to None.
             plugins: Optional plugins can be provided to extend functionality.
+            json_handler: The module to use for json operations. The options are BuiltinHandler
+                (uses the json module from the standard library), OrjsonHandler (uses orjson), or
+                UjsonHandler (uses ujson). Note that in order use orjson or ujson the corresponding
+                extra needs to be included. Default: BuiltinHandler.
         """
-        super().__init__(uid, primary_key, created_at, updated_at)
+        super().__init__(uid, primary_key, created_at, updated_at, json_handler=json_handler)
         self.http_client = http_client
-        self._http_requests = AsyncHttpRequests(http_client)
+        self._http_requests = AsyncHttpRequests(http_client, json_handler=self._json_handler)
         self.plugins = plugins
 
     @cached_property
@@ -631,6 +638,7 @@ class AsyncIndex(_BaseIndex):
         wait: bool = True,
         timeout_in_ms: int | None = None,
         plugins: AsyncIndexPlugins | None = None,
+        json_handler: BuiltinHandler | OrjsonHandler | UjsonHandler | None = None,
     ) -> Self:
         """Creates a new index.
 
@@ -655,6 +663,10 @@ class AsyncIndex(_BaseIndex):
                 MeilisearchTimeoutError. `None` can also be passed to wait indefinitely. Be aware that
                 if the `None` option is used the wait time could be very long. Defaults to None.
             plugins: Optional plugins can be provided to extend functionality.
+            json_handler: The module to use for json operations. The options are BuiltinHandler
+                (uses the json module from the standard library), OrjsonHandler (uses orjson), or
+                UjsonHandler (uses ujson). Note that in order use orjson or ujson the corresponding
+                extra needs to be included. Default: BuiltinHandler.
 
         Returns:
 
@@ -677,10 +689,13 @@ class AsyncIndex(_BaseIndex):
             payload = {"primaryKey": primary_key, "uid": uid}
 
         url = "indexes"
-        http_request = AsyncHttpRequests(http_client)
+        handler = json_handler if json_handler else BuiltinHandler()
+        http_request = AsyncHttpRequests(http_client, json_handler=handler)
         response = await http_request.post(url, payload)
         await async_wait_for_task(
-            http_client, response.json()["taskUid"], timeout_in_ms=timeout_in_ms
+            http_client,
+            response.json()["taskUid"],
+            timeout_in_ms=timeout_in_ms,
         )
 
         index_response = await http_request.get(f"{url}/{uid}")
@@ -692,6 +707,7 @@ class AsyncIndex(_BaseIndex):
             created_at=index_dict["createdAt"],
             updated_at=index_dict["updatedAt"],
             plugins=plugins,
+            json_handler=json_handler,
         )
 
         if settings:
@@ -743,7 +759,7 @@ class AsyncIndex(_BaseIndex):
         highlight_pre_tag: str = "<em>",
         highlight_post_tag: str = "</em>",
         crop_marker: str = "...",
-        matching_strategy: str = "all",
+        matching_strategy: Literal["all", "last", "frequency"] = "last",
         hits_per_page: int | None = None,
         page: int | None = None,
         attributes_to_search_on: list[str] | None = None,
@@ -769,13 +785,14 @@ class AsyncIndex(_BaseIndex):
             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.
-            show_matches_position: Defines whether an object that contains information about the matches should be
-                returned or not. Defaults to False.
+            show_matches_position: Defines whether an object that contains information about the
+                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`.
                 Defaults to ...
-            matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to `all`.
+            matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to
+                `last`.
             hits_per_page: Sets the number of results returned per page.
             page: Sets the specific results page to fetch.
             attributes_to_search_on: List of field names. Allow search over a subset of searchable
@@ -1001,7 +1018,7 @@ class AsyncIndex(_BaseIndex):
         highlight_pre_tag: str = "<em>",
         highlight_post_tag: str = "</em>",
         crop_marker: str = "...",
-        matching_strategy: Literal["all", "last", "frequency"] = "all",
+        matching_strategy: Literal["all", "last", "frequency"] = "last",
         hits_per_page: int | None = None,
         page: int | None = None,
         attributes_to_search_on: list[str] | None = None,
@@ -1028,13 +1045,14 @@ class AsyncIndex(_BaseIndex):
             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.
-            show_matches_position: Defines whether an object that contains information about the matches should be
-                returned or not. Defaults to False.
+            show_matches_position: Defines whether an object that contains information about the
+                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`.
                 Defaults to ...
-            matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to `all`.
+            matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to
+                `last`.
             hits_per_page: Sets the number of results returned per page.
             page: Sets the specific results page to fetch.
             attributes_to_search_on: List of field names. Allow search over a subset of searchable
@@ -1400,7 +1418,6 @@ class AsyncIndex(_BaseIndex):
         primary_key: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Add documents to the index.
 
@@ -1410,8 +1427,6 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -1469,11 +1484,7 @@ class AsyncIndex(_BaseIndex):
                             )
                         )
 
-                tasks.append(
-                    self._http_requests.post(
-                        url, documents, compress=compress, serializer=serializer
-                    )
-                )
+                tasks.append(self._http_requests.post(url, documents, compress=compress))
 
                 responses = await asyncio.gather(*tasks)
                 result = TaskInfo(**responses[-1].json())
@@ -1509,9 +1520,7 @@ class AsyncIndex(_BaseIndex):
                         )
 
                 response_coroutine = tg.create_task(
-                    self._http_requests.post(
-                        url, documents, compress=compress, serializer=serializer
-                    )
+                    self._http_requests.post(url, documents, compress=compress)
                 )
 
             response = await response_coroutine
@@ -1529,9 +1538,7 @@ class AsyncIndex(_BaseIndex):
 
             return result
 
-        response = await self._http_requests.post(
-            url, documents, compress=compress, serializer=serializer
-        )
+        response = await self._http_requests.post(url, documents, compress=compress)
 
         result = TaskInfo(**response.json())
         if self._post_add_documents_plugins:
@@ -1554,7 +1561,6 @@ class AsyncIndex(_BaseIndex):
         batch_size: int = 1000,
         primary_key: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Adds documents in batches to reduce RAM usage with indexing.
 
@@ -1566,8 +1572,6 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -1591,16 +1595,14 @@ class AsyncIndex(_BaseIndex):
         """
         if not use_task_groups():
             batches = [
-                self.add_documents(x, primary_key, compress=compress, serializer=serializer)
+                self.add_documents(x, primary_key, compress=compress)
                 for x in _batch(documents, batch_size)
             ]
             return await asyncio.gather(*batches)
 
         async with asyncio.TaskGroup() as tg:  # type: ignore[attr-defined]
             tasks = [
-                tg.create_task(
-                    self.add_documents(x, primary_key, compress=compress, serializer=serializer)
-                )
+                tg.create_task(self.add_documents(x, primary_key, compress=compress))
                 for x in _batch(documents, batch_size)
             ]
 
@@ -1615,7 +1617,6 @@ class AsyncIndex(_BaseIndex):
         csv_delimiter: str | None = None,
         combine_documents: bool = True,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Load all json files from a directory and add the documents to the index.
 
@@ -1632,8 +1633,6 @@ class AsyncIndex(_BaseIndex):
             combine_documents: If set to True this will combine the documents from all the files
                 before indexing them. Defaults to True.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -1661,7 +1660,9 @@ class AsyncIndex(_BaseIndex):
             all_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = await _async_load_documents_from_file(path, csv_delimiter)
+                    documents = await _async_load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     all_documents.append(documents)
 
             _raise_on_no_documents(all_documents, document_type, directory_path)
@@ -1669,9 +1670,7 @@ class AsyncIndex(_BaseIndex):
             loop = asyncio.get_running_loop()
             combined = await loop.run_in_executor(None, partial(_combine_documents, all_documents))
 
-            response = await self.add_documents(
-                combined, primary_key, compress=compress, serializer=serializer
-            )
+            response = await self.add_documents(combined, primary_key, compress=compress)
 
             return [response]
 
@@ -1679,11 +1678,11 @@ class AsyncIndex(_BaseIndex):
             add_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = await _async_load_documents_from_file(path, csv_delimiter)
+                    documents = await _async_load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     add_documents.append(
-                        self.add_documents(
-                            documents, primary_key, compress=compress, serializer=serializer
-                        )
+                        self.add_documents(documents, primary_key, compress=compress)
                     )
 
             _raise_on_no_documents(add_documents, document_type, directory_path)
@@ -1705,19 +1704,15 @@ class AsyncIndex(_BaseIndex):
             all_results = []
             for i, path in enumerate(directory.iterdir()):
                 if path.suffix == f".{document_type}":
-                    documents = await _async_load_documents_from_file(path, csv_delimiter)
+                    documents = await _async_load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     if i == 0:
-                        all_results = [
-                            await self.add_documents(
-                                documents, compress=compress, serializer=serializer
-                            )
-                        ]
+                        all_results = [await self.add_documents(documents, compress=compress)]
                     else:
                         tasks.append(
                             tg.create_task(
-                                self.add_documents(
-                                    documents, primary_key, compress=compress, serializer=serializer
-                                )
+                                self.add_documents(documents, primary_key, compress=compress)
                             )
                         )
 
@@ -1736,7 +1731,6 @@ class AsyncIndex(_BaseIndex):
         csv_delimiter: str | None = None,
         combine_documents: bool = True,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Load all json files from a directory and add the documents to the index in batches.
 
@@ -1755,8 +1749,6 @@ class AsyncIndex(_BaseIndex):
             combine_documents: If set to True this will combine the documents from all the files
                 before indexing them. Defaults to True.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -1785,7 +1777,7 @@ class AsyncIndex(_BaseIndex):
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
                     documents = await _async_load_documents_from_file(
-                        path, csv_delimiter=csv_delimiter
+                        path, csv_delimiter=csv_delimiter, json_handler=self._json_handler
                     )
                     all_documents.append(documents)
 
@@ -1799,7 +1791,6 @@ class AsyncIndex(_BaseIndex):
                 batch_size=batch_size,
                 primary_key=primary_key,
                 compress=compress,
-                serializer=serializer,
             )
 
         responses: list[TaskInfo] = []
@@ -1807,14 +1798,15 @@ class AsyncIndex(_BaseIndex):
         add_documents = []
         for path in directory.iterdir():
             if path.suffix == f".{document_type}":
-                documents = await _async_load_documents_from_file(path, csv_delimiter)
+                documents = await _async_load_documents_from_file(
+                    path, csv_delimiter, json_handler=self._json_handler
+                )
                 add_documents.append(
                     self.add_documents_in_batches(
                         documents,
                         batch_size=batch_size,
                         primary_key=primary_key,
                         compress=compress,
-                        serializer=serializer,
                     )
                 )
 
@@ -1837,7 +1829,6 @@ class AsyncIndex(_BaseIndex):
         primary_key: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Add documents to the index from a json file.
 
@@ -1847,8 +1838,6 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -1870,12 +1859,12 @@ class AsyncIndex(_BaseIndex):
             >>>     index = client.index("movies")
             >>>     await index.add_documents_from_file(file_path)
         """
-        documents = await _async_load_documents_from_file(file_path)
-
-        return await self.add_documents(
-            documents, primary_key=primary_key, compress=compress, serializer=serializer
+        documents = await _async_load_documents_from_file(
+            file_path, json_handler=self._json_handler
         )
 
+        return await self.add_documents(documents, primary_key=primary_key, compress=compress)
+
     async def add_documents_from_file_in_batches(
         self,
         file_path: Path | str,
@@ -1884,7 +1873,6 @@ class AsyncIndex(_BaseIndex):
         primary_key: str | None = None,
         csv_delimiter: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Adds documents form a json file in batches to reduce RAM usage with indexing.
 
@@ -1898,8 +1886,6 @@ class AsyncIndex(_BaseIndex):
             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.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -1921,14 +1907,15 @@ class AsyncIndex(_BaseIndex):
             >>>     index = client.index("movies")
             >>>     await index.add_documents_from_file_in_batches(file_path)
         """
-        documents = await _async_load_documents_from_file(file_path, csv_delimiter)
+        documents = await _async_load_documents_from_file(
+            file_path, csv_delimiter, json_handler=self._json_handler
+        )
 
         return await self.add_documents_in_batches(
             documents,
             batch_size=batch_size,
             primary_key=primary_key,
             compress=compress,
-            serializer=serializer,
         )
 
     async def add_documents_from_raw_file(
@@ -1938,7 +1925,6 @@ class AsyncIndex(_BaseIndex):
         *,
         csv_delimiter: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Directly send csv or ndjson files to Meilisearch without pre-processing.
 
@@ -1954,8 +1940,6 @@ class AsyncIndex(_BaseIndex):
             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.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -2013,7 +1997,7 @@ class AsyncIndex(_BaseIndex):
             data = await f.read()
 
         response = await self._http_requests.post(
-            url, body=data, content_type=content_type, compress=compress, serializer=serializer
+            url, body=data, content_type=content_type, compress=compress
         )
 
         return TaskInfo(**response.json())
@@ -2024,7 +2008,6 @@ class AsyncIndex(_BaseIndex):
         primary_key: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Update documents in the index.
 
@@ -2034,8 +2017,6 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -2130,9 +2111,7 @@ class AsyncIndex(_BaseIndex):
                         )
 
                 response_coroutine = tg.create_task(
-                    self._http_requests.put(
-                        url, documents, compress=compress, serializer=serializer
-                    )
+                    self._http_requests.put(url, documents, compress=compress)
                 )
 
             response = await response_coroutine
@@ -2151,9 +2130,7 @@ class AsyncIndex(_BaseIndex):
 
             return result
 
-        response = await self._http_requests.put(
-            url, documents, compress=compress, serializer=serializer
-        )
+        response = await self._http_requests.put(url, documents, compress=compress)
         result = TaskInfo(**response.json())
         if self._post_update_documents_plugins:
             post = await AsyncIndex._run_plugins(
@@ -2175,7 +2152,6 @@ class AsyncIndex(_BaseIndex):
         batch_size: int = 1000,
         primary_key: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Update documents in batches to reduce RAM usage with indexing.
 
@@ -2189,8 +2165,6 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -2214,7 +2188,7 @@ class AsyncIndex(_BaseIndex):
         """
         if not use_task_groups():
             batches = [
-                self.update_documents(x, primary_key, compress=compress, serializer=serializer)
+                self.update_documents(x, primary_key, compress=compress)
                 for x in _batch(documents, batch_size)
             ]
             return await asyncio.gather(*batches)
@@ -2235,7 +2209,6 @@ class AsyncIndex(_BaseIndex):
         csv_delimiter: str | None = None,
         combine_documents: bool = True,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Load all json files from a directory and update the documents.
 
@@ -2252,8 +2225,6 @@ class AsyncIndex(_BaseIndex):
             combine_documents: If set to True this will combine the documents from all the files
                 before indexing them. Defaults to True.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -2281,7 +2252,9 @@ class AsyncIndex(_BaseIndex):
             all_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = await _async_load_documents_from_file(path, csv_delimiter)
+                    documents = await _async_load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     all_documents.append(documents)
 
             _raise_on_no_documents(all_documents, document_type, directory_path)
@@ -2289,20 +2262,18 @@ class AsyncIndex(_BaseIndex):
             loop = asyncio.get_running_loop()
             combined = await loop.run_in_executor(None, partial(_combine_documents, all_documents))
 
-            response = await self.update_documents(
-                combined, primary_key, compress=compress, serializer=serializer
-            )
+            response = await self.update_documents(combined, primary_key, compress=compress)
             return [response]
 
         if not use_task_groups():
             update_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = await _async_load_documents_from_file(path, csv_delimiter)
+                    documents = await _async_load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     update_documents.append(
-                        self.update_documents(
-                            documents, primary_key, compress=compress, serializer=serializer
-                        )
+                        self.update_documents(documents, primary_key, compress=compress)
                     )
 
             _raise_on_no_documents(update_documents, document_type, directory_path)
@@ -2323,19 +2294,17 @@ class AsyncIndex(_BaseIndex):
             results = []
             for i, path in enumerate(directory.iterdir()):
                 if path.suffix == f".{document_type}":
-                    documents = await _async_load_documents_from_file(path, csv_delimiter)
+                    documents = await _async_load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     if i == 0:
                         results = [
-                            await self.update_documents(
-                                documents, primary_key, compress=compress, serializer=serializer
-                            )
+                            await self.update_documents(documents, primary_key, compress=compress)
                         ]
                     else:
                         tasks.append(
                             tg.create_task(
-                                self.update_documents(
-                                    documents, primary_key, compress=compress, serializer=serializer
-                                )
+                                self.update_documents(documents, primary_key, compress=compress)
                             )
                         )
 
@@ -2353,7 +2322,6 @@ class AsyncIndex(_BaseIndex):
         csv_delimiter: str | None = None,
         combine_documents: bool = True,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Load all json files from a directory and update the documents.
 
@@ -2372,8 +2340,6 @@ class AsyncIndex(_BaseIndex):
             combine_documents: If set to True this will combine the documents from all the files
                 before indexing them. Defaults to True.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -2401,7 +2367,9 @@ class AsyncIndex(_BaseIndex):
             all_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = await _async_load_documents_from_file(path, csv_delimiter)
+                    documents = await _async_load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     all_documents.append(documents)
 
             _raise_on_no_documents(all_documents, document_type, directory_path)
@@ -2414,7 +2382,6 @@ class AsyncIndex(_BaseIndex):
                 batch_size=batch_size,
                 primary_key=primary_key,
                 compress=compress,
-                serializer=serializer,
             )
 
         if not use_task_groups():
@@ -2423,14 +2390,15 @@ class AsyncIndex(_BaseIndex):
             update_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = await _async_load_documents_from_file(path, csv_delimiter)
+                    documents = await _async_load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     update_documents.append(
                         self.update_documents_in_batches(
                             documents,
                             batch_size=batch_size,
                             primary_key=primary_key,
                             compress=compress,
-                            serializer=serializer,
                         )
                     )
 
@@ -2452,14 +2420,15 @@ class AsyncIndex(_BaseIndex):
             tasks = []
             for i, path in enumerate(directory.iterdir()):
                 if path.suffix == f".{document_type}":
-                    documents = await _async_load_documents_from_file(path, csv_delimiter)
+                    documents = await _async_load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     if i == 0:
                         results = await self.update_documents_in_batches(
                             documents,
                             batch_size=batch_size,
                             primary_key=primary_key,
                             compress=compress,
-                            serializer=serializer,
                         )
                     else:
                         tasks.append(
@@ -2469,7 +2438,6 @@ class AsyncIndex(_BaseIndex):
                                     batch_size=batch_size,
                                     primary_key=primary_key,
                                     compress=compress,
-                                    serializer=serializer,
                                 )
                             )
                         )
@@ -2485,7 +2453,6 @@ class AsyncIndex(_BaseIndex):
         csv_delimiter: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Add documents in the index from a json file.
 
@@ -2497,8 +2464,6 @@ class AsyncIndex(_BaseIndex):
             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.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -2518,12 +2483,12 @@ class AsyncIndex(_BaseIndex):
             >>>     index = client.index("movies")
             >>>     await index.update_documents_from_file(file_path)
         """
-        documents = await _async_load_documents_from_file(file_path, csv_delimiter)
-
-        return await self.update_documents(
-            documents, primary_key=primary_key, compress=compress, serializer=serializer
+        documents = await _async_load_documents_from_file(
+            file_path, csv_delimiter, json_handler=self._json_handler
         )
 
+        return await self.update_documents(documents, primary_key=primary_key, compress=compress)
+
     async def update_documents_from_file_in_batches(
         self,
         file_path: Path | str,
@@ -2531,7 +2496,6 @@ class AsyncIndex(_BaseIndex):
         batch_size: int = 1000,
         primary_key: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Updates documents form a json file in batches to reduce RAM usage with indexing.
 
@@ -2543,8 +2507,6 @@ class AsyncIndex(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -2564,14 +2526,15 @@ class AsyncIndex(_BaseIndex):
             >>>     index = client.index("movies")
             >>>     await index.update_documents_from_file_in_batches(file_path)
         """
-        documents = await _async_load_documents_from_file(file_path)
+        documents = await _async_load_documents_from_file(
+            file_path, json_handler=self._json_handler
+        )
 
         return await self.update_documents_in_batches(
             documents,
             batch_size=batch_size,
             primary_key=primary_key,
             compress=compress,
-            serializer=serializer,
         )
 
     async def update_documents_from_raw_file(
@@ -2581,7 +2544,6 @@ class AsyncIndex(_BaseIndex):
         csv_delimiter: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Directly send csv or ndjson files to Meilisearch without pre-processing.
 
@@ -2597,8 +2559,6 @@ class AsyncIndex(_BaseIndex):
             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.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -2656,7 +2616,7 @@ class AsyncIndex(_BaseIndex):
             data = await f.read()
 
         response = await self._http_requests.put(
-            url, body=data, content_type=content_type, compress=compress, serializer=serializer
+            url, body=data, content_type=content_type, compress=compress
         )
 
         return TaskInfo(**response.json())
@@ -3078,16 +3038,7 @@ class AsyncIndex(_BaseIndex):
             >>>     index = client.index("movies")
             >>>     await index.update_settings(new_settings)
         """
-        if is_pydantic_2():
-            body_dict = {k: v for k, v in body.model_dump(by_alias=True).items() if v is not None}  # type: ignore[attr-defined]
-        else:  # pragma: no cover
-            warn(
-                "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            body_dict = {k: v for k, v in body.dict(by_alias=True).items() if v is not None}  # type: ignore[attr-defined]
-
+        body_dict = {k: v for k, v in body.model_dump(by_alias=True).items() if v is not None}
         response = await self._http_requests.patch(self._settings_url, body_dict, compress=compress)
 
         return TaskInfo(**response.json())
@@ -3812,23 +3763,11 @@ class AsyncIndex(_BaseIndex):
             >>>     TypoTolerance(enabled=False)
             >>>     await index.update_typo_tolerance()
         """
-        if is_pydantic_2():
-            response = await self._http_requests.patch(
-                f"{self._settings_url}/typo-tolerance",
-                typo_tolerance.model_dump(by_alias=True),
-                compress=compress,
-            )  # type: ignore[attr-defined]
-        else:  # pragma: no cover
-            warn(
-                "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            response = await self._http_requests.patch(
-                f"{self._settings_url}/typo-tolerance",
-                typo_tolerance.dict(by_alias=True),
-                compress=compress,
-            )  # type: ignore[attr-defined]
+        response = await self._http_requests.patch(
+            f"{self._settings_url}/typo-tolerance",
+            typo_tolerance.model_dump(by_alias=True),
+            compress=compress,
+        )
 
         return TaskInfo(**response.json())
 
@@ -3902,21 +3841,11 @@ class AsyncIndex(_BaseIndex):
             >>>     index = client.index("movies")
             >>>     await index.update_faceting(faceting=Faceting(max_values_per_facet=100))
         """
-        if is_pydantic_2():
-            response = await self._http_requests.patch(
-                f"{self._settings_url}/faceting",
-                faceting.model_dump(by_alias=True),
-                compress=compress,
-            )  # type: ignore[attr-defined]
-        else:  # pragma: no cover
-            warn(
-                "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            response = await self._http_requests.patch(
-                f"{self._settings_url}/faceting", faceting.dict(by_alias=True), compress=compress
-            )  # type: ignore[attr-defined]
+        response = await self._http_requests.patch(
+            f"{self._settings_url}/faceting",
+            faceting.model_dump(by_alias=True),
+            compress=compress,
+        )
 
         return TaskInfo(**response.json())
 
@@ -3991,21 +3920,11 @@ class AsyncIndex(_BaseIndex):
             >>>     index = client.index("movies")
             >>>     await index.update_pagination(settings=Pagination(max_total_hits=123))
         """
-        if is_pydantic_2():
-            response = await self._http_requests.patch(
-                f"{self._settings_url}/pagination",
-                settings.model_dump(by_alias=True),
-                compress=compress,
-            )  # type: ignore[attr-defined]
-        else:  # pragma: no cover
-            warn(
-                "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            response = await self._http_requests.patch(
-                f"{self._settings_url}/pagination", settings.dict(by_alias=True), compress=compress
-            )  # type: ignore[attr-defined]
+        response = await self._http_requests.patch(
+            f"{self._settings_url}/pagination",
+            settings.model_dump(by_alias=True),
+            compress=compress,
+        )
 
         return TaskInfo(**response.json())
 
@@ -4479,19 +4398,9 @@ class AsyncIndex(_BaseIndex):
         """
         payload = {}
         for key, embedder in embedders.embedders.items():
-            if is_pydantic_2():
-                payload[key] = {
-                    k: v for k, v in embedder.model_dump(by_alias=True).items() if v is not None
-                }  # type: ignore[attr-defined]
-            else:  # pragma: no cover
-                warn(
-                    "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                    DeprecationWarning,
-                    stacklevel=2,
-                )
-                payload[key] = {
-                    k: v for k, v in embedder.dict(by_alias=True).items() if v is not None
-                }  # type: ignore[attr-defined]
+            payload[key] = {
+                k: v for k, v in embedder.model_dump(by_alias=True).items() if v is not None
+            }
 
         response = await self._http_requests.patch(
             f"{self._settings_url}/embedders", payload, compress=compress
@@ -4606,6 +4515,7 @@ class Index(_BaseIndex):
         created_at: str | datetime | None = None,
         updated_at: str | datetime | None = None,
         plugins: IndexPlugins | None = None,
+        json_handler: BuiltinHandler | OrjsonHandler | UjsonHandler | None = None,
     ):
         """Class initializer.
 
@@ -4618,10 +4528,14 @@ class Index(_BaseIndex):
             created_at: The date and time the index was created. Defaults to None.
             updated_at: The date and time the index was last updated. Defaults to None.
             plugins: Optional plugins can be provided to extend functionality.
+            json_handler: The module to use for json operations. The options are BuiltinHandler
+                (uses the json module from the standard library), OrjsonHandler (uses orjson), or
+                UjsonHandler (uses ujson). Note that in order use orjson or ujson the corresponding
+                extra needs to be included. Default: BuiltinHandler.
         """
-        super().__init__(uid, primary_key, created_at, updated_at)
+        super().__init__(uid, primary_key, created_at, updated_at, json_handler=json_handler)
         self.http_client = http_client
-        self._http_requests = HttpRequests(http_client)
+        self._http_requests = HttpRequests(http_client, json_handler=self._json_handler)
         self.plugins = plugins
 
     @cached_property
@@ -5001,6 +4915,7 @@ class Index(_BaseIndex):
         wait: bool = True,
         timeout_in_ms: int | None = None,
         plugins: IndexPlugins | None = None,
+        json_handler: BuiltinHandler | OrjsonHandler | UjsonHandler | None = None,
     ) -> Self:
         """Creates a new index.
 
@@ -5025,6 +4940,10 @@ class Index(_BaseIndex):
                 MeilisearchTimeoutError. `None` can also be passed to wait indefinitely. Be aware that
                 if the `None` option is used the wait time could be very long. Defaults to None.
             plugins: Optional plugins can be provided to extend functionality.
+            json_handler: The module to use for json operations. The options are BuiltinHandler
+                (uses the json module from the standard library), OrjsonHandler (uses orjson), or
+                UjsonHandler (uses ujson). Note that in order use orjson or ujson the corresponding
+                extra needs to be included. Default: BuiltinHandler.
 
         Returns:
 
@@ -5047,7 +4966,8 @@ class Index(_BaseIndex):
             payload = {"primaryKey": primary_key, "uid": uid}
 
         url = "indexes"
-        http_request = HttpRequests(http_client)
+        handler = json_handler if json_handler else BuiltinHandler()
+        http_request = HttpRequests(http_client, handler)
         response = http_request.post(url, payload)
         wait_for_task(http_client, response.json()["taskUid"], timeout_in_ms=timeout_in_ms)
         index_response = http_request.get(f"{url}/{uid}")
@@ -5059,6 +4979,7 @@ class Index(_BaseIndex):
             created_at=index_dict["createdAt"],
             updated_at=index_dict["updatedAt"],
             plugins=plugins,
+            json_handler=json_handler,
         )
 
         if settings:
@@ -5108,7 +5029,7 @@ class Index(_BaseIndex):
         highlight_pre_tag: str = "<em>",
         highlight_post_tag: str = "</em>",
         crop_marker: str = "...",
-        matching_strategy: Literal["all", "last", "frequency"] = "all",
+        matching_strategy: Literal["all", "last", "frequency"] = "last",
         hits_per_page: int | None = None,
         page: int | None = None,
         attributes_to_search_on: list[str] | None = None,
@@ -5134,13 +5055,14 @@ class Index(_BaseIndex):
             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.
-            show_matches_position: Defines whether an object that contains information about the matches should be
-                returned or not. Defaults to False.
+            show_matches_position: Defines whether an object that contains information about the
+                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`.
                 Defaults to ...
-            matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to `all`.
+            matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to
+                `last`.
             hits_per_page: Sets the number of results returned per page.
             page: Sets the specific results page to fetch.
             attributes_to_search_on: List of field names. Allow search over a subset of searchable
@@ -5274,7 +5196,7 @@ class Index(_BaseIndex):
         highlight_pre_tag: str = "<em>",
         highlight_post_tag: str = "</em>",
         crop_marker: str = "...",
-        matching_strategy: str = "all",
+        matching_strategy: Literal["all", "last", "frequency"] = "last",
         hits_per_page: int | None = None,
         page: int | None = None,
         attributes_to_search_on: list[str] | None = None,
@@ -5301,13 +5223,14 @@ class Index(_BaseIndex):
             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.
-            show_matches_position: Defines whether an object that contains information about the matches should be
-                returned or not. Defaults to False.
+            show_matches_position: Defines whether an object that contains information about the
+                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`.
                 Defaults to ...
-            matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to `all`.
+            matching_strategy: Specifies the matching strategy Meilisearch should use. Defaults to
+                `last`.
             hits_per_page: Sets the number of results returned per page.
             page: Sets the specific results page to fetch.
             attributes_to_search_on: List of field names. Allow search over a subset of searchable
@@ -5578,7 +5501,6 @@ class Index(_BaseIndex):
         primary_key: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Add documents to the index.
 
@@ -5588,8 +5510,6 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -5626,9 +5546,7 @@ class Index(_BaseIndex):
             if pre.get("document_result"):
                 documents = pre["document_result"]
 
-        response = self._http_requests.post(
-            url, documents, compress=compress, serializer=serializer
-        )
+        response = self._http_requests.post(url, documents, compress=compress)
         result = TaskInfo(**response.json())
         if self._post_add_documents_plugins:
             post = Index._run_plugins(self._post_add_documents_plugins, Event.POST, result=result)
@@ -5644,7 +5562,6 @@ class Index(_BaseIndex):
         batch_size: int = 1000,
         primary_key: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Adds documents in batches to reduce RAM usage with indexing.
 
@@ -5656,8 +5573,6 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -5680,7 +5595,7 @@ class Index(_BaseIndex):
             >>> index.add_documents_in_batches(documents)
         """
         return [
-            self.add_documents(x, primary_key, compress=compress, serializer=serializer)
+            self.add_documents(x, primary_key, compress=compress)
             for x in _batch(documents, batch_size)
         ]
 
@@ -5693,7 +5608,6 @@ class Index(_BaseIndex):
         csv_delimiter: str | None = None,
         combine_documents: bool = True,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Load all json files from a directory and add the documents to the index.
 
@@ -5710,8 +5624,6 @@ class Index(_BaseIndex):
             combine_documents: If set to True this will combine the documents from all the files
                 before indexing them. Defaults to True.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -5739,28 +5651,26 @@ class Index(_BaseIndex):
             all_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = _load_documents_from_file(path, csv_delimiter)
+                    documents = _load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     all_documents.append(documents)
 
             _raise_on_no_documents(all_documents, document_type, directory_path)
 
             combined = _combine_documents(all_documents)
 
-            response = self.add_documents(
-                combined, primary_key, compress=compress, serializer=serializer
-            )
+            response = self.add_documents(combined, primary_key, compress=compress)
 
             return [response]
 
         responses = []
         for path in directory.iterdir():
             if path.suffix == f".{document_type}":
-                documents = _load_documents_from_file(path, csv_delimiter)
-                responses.append(
-                    self.add_documents(
-                        documents, primary_key, compress=compress, serializer=serializer
-                    )
+                documents = _load_documents_from_file(
+                    path, csv_delimiter, json_handler=self._json_handler
                 )
+                responses.append(self.add_documents(documents, primary_key, compress=compress))
 
         _raise_on_no_documents(responses, document_type, directory_path)
 
@@ -5776,7 +5686,6 @@ class Index(_BaseIndex):
         csv_delimiter: str | None = None,
         combine_documents: bool = True,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Load all json files from a directory and add the documents to the index in batches.
 
@@ -5795,8 +5704,6 @@ class Index(_BaseIndex):
             combine_documents: If set to True this will combine the documents from all the files
                 before indexing them. Defaults to True.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -5824,7 +5731,9 @@ class Index(_BaseIndex):
             all_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = _load_documents_from_file(path, csv_delimiter=csv_delimiter)
+                    documents = _load_documents_from_file(
+                        path, csv_delimiter=csv_delimiter, json_handler=self._json_handler
+                    )
                     all_documents.append(documents)
 
             _raise_on_no_documents(all_documents, document_type, directory_path)
@@ -5836,20 +5745,20 @@ class Index(_BaseIndex):
                 batch_size=batch_size,
                 primary_key=primary_key,
                 compress=compress,
-                serializer=serializer,
             )
 
         responses: list[TaskInfo] = []
         for path in directory.iterdir():
             if path.suffix == f".{document_type}":
-                documents = _load_documents_from_file(path, csv_delimiter)
+                documents = _load_documents_from_file(
+                    path, csv_delimiter, json_handler=self._json_handler
+                )
                 responses.extend(
                     self.add_documents_in_batches(
                         documents,
                         batch_size=batch_size,
                         primary_key=primary_key,
                         compress=compress,
-                        serializer=serializer,
                     )
                 )
 
@@ -5863,7 +5772,6 @@ class Index(_BaseIndex):
         primary_key: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Add documents to the index from a json file.
 
@@ -5873,8 +5781,6 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -5896,11 +5802,9 @@ class Index(_BaseIndex):
             >>> index = client.index("movies")
             >>> index.add_documents_from_file(file_path)
         """
-        documents = _load_documents_from_file(file_path)
+        documents = _load_documents_from_file(file_path, json_handler=self._json_handler)
 
-        return self.add_documents(
-            documents, primary_key=primary_key, compress=compress, serializer=serializer
-        )
+        return self.add_documents(documents, primary_key=primary_key, compress=compress)
 
     def add_documents_from_file_in_batches(
         self,
@@ -5910,7 +5814,6 @@ class Index(_BaseIndex):
         primary_key: str | None = None,
         csv_delimiter: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Adds documents form a json file in batches to reduce RAM usage with indexing.
 
@@ -5924,8 +5827,6 @@ class Index(_BaseIndex):
             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.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -5947,14 +5848,15 @@ class Index(_BaseIndex):
             >>> index = client.index("movies")
             >>> index.add_documents_from_file_in_batches(file_path)
         """
-        documents = _load_documents_from_file(file_path, csv_delimiter)
+        documents = _load_documents_from_file(
+            file_path, csv_delimiter, json_handler=self._json_handler
+        )
 
         return self.add_documents_in_batches(
             documents,
             batch_size=batch_size,
             primary_key=primary_key,
             compress=compress,
-            serializer=serializer,
         )
 
     def add_documents_from_raw_file(
@@ -5964,7 +5866,6 @@ class Index(_BaseIndex):
         *,
         csv_delimiter: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Directly send csv or ndjson files to Meilisearch without pre-processing.
 
@@ -5980,8 +5881,6 @@ class Index(_BaseIndex):
             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.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -6039,7 +5938,7 @@ class Index(_BaseIndex):
             data = f.read()
 
         response = self._http_requests.post(
-            url, body=data, content_type=content_type, compress=compress, serializer=serializer
+            url, body=data, content_type=content_type, compress=compress
         )
 
         return TaskInfo(**response.json())
@@ -6050,7 +5949,6 @@ class Index(_BaseIndex):
         primary_key: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Update documents in the index.
 
@@ -6060,8 +5958,6 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -6098,7 +5994,7 @@ class Index(_BaseIndex):
             if pre.get("document_result"):
                 documents = pre["document_result"]
 
-        response = self._http_requests.put(url, documents, compress=compress, serializer=serializer)
+        response = self._http_requests.put(url, documents, compress=compress)
         result = TaskInfo(**response.json())
         if self._post_update_documents_plugins:
             post = Index._run_plugins(
@@ -6116,7 +6012,6 @@ class Index(_BaseIndex):
         batch_size: int = 1000,
         primary_key: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Update documents in batches to reduce RAM usage with indexing.
 
@@ -6130,8 +6025,6 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -6154,7 +6047,7 @@ class Index(_BaseIndex):
             >>> index.update_documents_in_batches(documents)
         """
         return [
-            self.update_documents(x, primary_key, compress=compress, serializer=serializer)
+            self.update_documents(x, primary_key, compress=compress)
             for x in _batch(documents, batch_size)
         ]
 
@@ -6167,7 +6060,6 @@ class Index(_BaseIndex):
         csv_delimiter: str | None = None,
         combine_documents: bool = True,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Load all json files from a directory and update the documents.
 
@@ -6184,8 +6076,6 @@ class Index(_BaseIndex):
             combine_documents: If set to True this will combine the documents from all the files
                 before indexing them. Defaults to True.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -6213,27 +6103,25 @@ class Index(_BaseIndex):
             all_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = _load_documents_from_file(path, csv_delimiter)
+                    documents = _load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     all_documents.append(documents)
 
             _raise_on_no_documents(all_documents, document_type, directory_path)
 
             combined = _combine_documents(all_documents)
 
-            response = self.update_documents(
-                combined, primary_key, compress=compress, serializer=serializer
-            )
+            response = self.update_documents(combined, primary_key, compress=compress)
             return [response]
 
         responses = []
         for path in directory.iterdir():
             if path.suffix == f".{document_type}":
-                documents = _load_documents_from_file(path, csv_delimiter)
-                responses.append(
-                    self.update_documents(
-                        documents, primary_key, compress=compress, serializer=serializer
-                    )
+                documents = _load_documents_from_file(
+                    path, csv_delimiter, json_handler=self._json_handler
                 )
+                responses.append(self.update_documents(documents, primary_key, compress=compress))
 
         _raise_on_no_documents(responses, document_type, directory_path)
 
@@ -6249,7 +6137,6 @@ class Index(_BaseIndex):
         csv_delimiter: str | None = None,
         combine_documents: bool = True,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Load all json files from a directory and update the documents.
 
@@ -6268,8 +6155,6 @@ class Index(_BaseIndex):
             combine_documents: If set to True this will combine the documents from all the files
                 before indexing them. Defaults to True.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -6297,7 +6182,9 @@ class Index(_BaseIndex):
             all_documents = []
             for path in directory.iterdir():
                 if path.suffix == f".{document_type}":
-                    documents = _load_documents_from_file(path, csv_delimiter)
+                    documents = _load_documents_from_file(
+                        path, csv_delimiter, json_handler=self._json_handler
+                    )
                     all_documents.append(documents)
 
             _raise_on_no_documents(all_documents, document_type, directory_path)
@@ -6309,21 +6196,21 @@ class Index(_BaseIndex):
                 batch_size=batch_size,
                 primary_key=primary_key,
                 compress=compress,
-                serializer=serializer,
             )
 
         responses: list[TaskInfo] = []
 
         for path in directory.iterdir():
             if path.suffix == f".{document_type}":
-                documents = _load_documents_from_file(path, csv_delimiter)
+                documents = _load_documents_from_file(
+                    path, csv_delimiter, json_handler=self._json_handler
+                )
                 responses.extend(
                     self.update_documents_in_batches(
                         documents,
                         batch_size=batch_size,
                         primary_key=primary_key,
                         compress=compress,
-                        serializer=serializer,
                     )
                 )
 
@@ -6338,7 +6225,6 @@ class Index(_BaseIndex):
         csv_delimiter: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Add documents in the index from a json file.
 
@@ -6350,8 +6236,6 @@ class Index(_BaseIndex):
             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.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -6371,12 +6255,12 @@ class Index(_BaseIndex):
             >>> index = client.index("movies")
             >>> index.update_documents_from_file(file_path)
         """
-        documents = _load_documents_from_file(file_path, csv_delimiter)
-
-        return self.update_documents(
-            documents, primary_key=primary_key, compress=compress, serializer=serializer
+        documents = _load_documents_from_file(
+            file_path, csv_delimiter, json_handler=self._json_handler
         )
 
+        return self.update_documents(documents, primary_key=primary_key, compress=compress)
+
     def update_documents_from_file_in_batches(
         self,
         file_path: Path | str,
@@ -6384,7 +6268,6 @@ class Index(_BaseIndex):
         batch_size: int = 1000,
         primary_key: str | None = None,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> list[TaskInfo]:
         """Updates documents form a json file in batches to reduce RAM usage with indexing.
 
@@ -6396,8 +6279,6 @@ class Index(_BaseIndex):
             primary_key: The primary key of the documents. This will be ignored if already set.
                 Defaults to None.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -6417,14 +6298,13 @@ class Index(_BaseIndex):
             >>> index = client.index("movies")
             >>> index.update_documents_from_file_in_batches(file_path)
         """
-        documents = _load_documents_from_file(file_path)
+        documents = _load_documents_from_file(file_path, json_handler=self._json_handler)
 
         return self.update_documents_in_batches(
             documents,
             batch_size=batch_size,
             primary_key=primary_key,
             compress=compress,
-            serializer=serializer,
         )
 
     def update_documents_from_raw_file(
@@ -6434,7 +6314,6 @@ class Index(_BaseIndex):
         csv_delimiter: str | None = None,
         *,
         compress: bool = False,
-        serializer: type[json.JSONEncoder] | None = None,
     ) -> TaskInfo:
         """Directly send csv or ndjson files to Meilisearch without pre-processing.
 
@@ -6450,8 +6329,6 @@ class Index(_BaseIndex):
             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.
             compress: If set to True the data will be sent in gzip format. Defaults to False.
-            serializer: A custom JSONEncode to handle serializing fields that the build in
-                json.dumps cannot handle, for example UUID and datetime. Defaults to None.
 
         Returns:
 
@@ -6509,7 +6386,7 @@ class Index(_BaseIndex):
             data = f.read()
 
         response = self._http_requests.put(
-            url, body=data, content_type=content_type, compress=compress, serializer=serializer
+            url, body=data, content_type=content_type, compress=compress
         )
 
         return TaskInfo(**response.json())
@@ -6769,16 +6646,7 @@ class Index(_BaseIndex):
             >>> index = client.index("movies")
             >>> index.update_settings(new_settings)
         """
-        if is_pydantic_2():
-            body_dict = {k: v for k, v in body.model_dump(by_alias=True).items() if v is not None}  # type: ignore[attr-defined]
-        else:  # pragma: no cover
-            warn(
-                "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            body_dict = {k: v for k, v in body.dict(by_alias=True).items() if v is not None}  # type: ignore[attr-defined]
-
+        body_dict = {k: v for k, v in body.model_dump(by_alias=True).items() if v is not None}
         response = self._http_requests.patch(self._settings_url, body_dict, compress=compress)
 
         return TaskInfo(**response.json())
@@ -7492,23 +7360,11 @@ class Index(_BaseIndex):
             >>> TypoTolerance(enabled=False)
             >>> index.update_typo_tolerance()
         """
-        if is_pydantic_2():
-            response = self._http_requests.patch(
-                f"{self._settings_url}/typo-tolerance",
-                typo_tolerance.model_dump(by_alias=True),
-                compress=compress,
-            )  # type: ignore[attr-defined]
-        else:  # pragma: no cover
-            warn(
-                "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            response = self._http_requests.patch(
-                f"{self._settings_url}/typo-tolerance",
-                typo_tolerance.dict(by_alias=True),
-                compress=compress,
-            )  # type: ignore[attr-defined]
+        response = self._http_requests.patch(
+            f"{self._settings_url}/typo-tolerance",
+            typo_tolerance.model_dump(by_alias=True),
+            compress=compress,
+        )
 
         return TaskInfo(**response.json())
 
@@ -7582,21 +7438,11 @@ class Index(_BaseIndex):
             >>> index = client.index("movies")
             >>> index.update_faceting(faceting=Faceting(max_values_per_facet=100))
         """
-        if is_pydantic_2():
-            response = self._http_requests.patch(
-                f"{self._settings_url}/faceting",
-                faceting.model_dump(by_alias=True),
-                compress=compress,
-            )  # type: ignore[attr-defined]
-        else:  # pragma: no cover
-            warn(
-                "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            response = self._http_requests.patch(
-                f"{self._settings_url}/faceting", faceting.dict(by_alias=True), compress=compress
-            )  # type: ignore[attr-defined]
+        response = self._http_requests.patch(
+            f"{self._settings_url}/faceting",
+            faceting.model_dump(by_alias=True),
+            compress=compress,
+        )
 
         return TaskInfo(**response.json())
 
@@ -7671,21 +7517,11 @@ class Index(_BaseIndex):
             >>> index = client.index("movies")
             >>> index.update_pagination(settings=Pagination(max_total_hits=123))
         """
-        if is_pydantic_2():
-            response = self._http_requests.patch(
-                f"{self._settings_url}/pagination",
-                settings.model_dump(by_alias=True),
-                compress=compress,
-            )  # type: ignore[attr-defined]
-        else:  # pragma: no cover
-            warn(
-                "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            response = self._http_requests.patch(
-                f"{self._settings_url}/pagination", settings.dict(by_alias=True), compress=compress
-            )  # type: ignore[attr-defined]
+        response = self._http_requests.patch(
+            f"{self._settings_url}/pagination",
+            settings.model_dump(by_alias=True),
+            compress=compress,
+        )
 
         return TaskInfo(**response.json())
 
@@ -8153,19 +7989,9 @@ class Index(_BaseIndex):
         """
         payload = {}
         for key, embedder in embedders.embedders.items():
-            if is_pydantic_2():
-                payload[key] = {
-                    k: v for k, v in embedder.model_dump(by_alias=True).items() if v is not None
-                }  # type: ignore[attr-defined]
-            else:  # pragma: no cover
-                warn(
-                    "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                    DeprecationWarning,
-                    stacklevel=2,
-                )
-                payload[key] = {
-                    k: v for k, v in embedder.dict(by_alias=True).items() if v is not None
-                }  # type: ignore[attr-defined]
+            payload[key] = {
+                k: v for k, v in embedder.model_dump(by_alias=True).items() if v is not None
+            }
 
         response = self._http_requests.patch(
             f"{self._settings_url}/embedders", payload, compress=compress
@@ -8241,6 +8067,8 @@ class Index(_BaseIndex):
 async def _async_load_documents_from_file(
     file_path: Path | str,
     csv_delimiter: str | None = None,
+    *,
+    json_handler: BuiltinHandler | OrjsonHandler | UjsonHandler,
 ) -> list[dict[Any, Any]]:
     if isinstance(file_path, str):
         file_path = Path(file_path)
@@ -8267,11 +8095,11 @@ async def _async_load_documents_from_file(
 
     if file_path.suffix == ".ndjson":
         with open(file_path) as f:  # noqa: ASYNC101 ASYNC230
-            return [await loop.run_in_executor(None, partial(json.loads, x)) for x in f]
+            return [await loop.run_in_executor(None, partial(json_handler.loads, x)) for x in f]
 
     async with aiofiles.open(file_path, mode="r") as f:  # type: ignore
         data = await f.read()  # type: ignore
-        documents = await loop.run_in_executor(None, partial(json.loads, data))
+        documents = await loop.run_in_executor(None, partial(json_handler.loads, data))
 
         if not isinstance(documents, list):
             raise InvalidDocumentError("Meilisearch requires documents to be in a list")
@@ -8310,6 +8138,8 @@ def _plugin_has_method(
 def _load_documents_from_file(
     file_path: Path | str,
     csv_delimiter: str | None = None,
+    *,
+    json_handler: BuiltinHandler | OrjsonHandler | UjsonHandler,
 ) -> list[dict[Any, Any]]:
     if isinstance(file_path, str):
         file_path = Path(file_path)
@@ -8333,11 +8163,11 @@ def _load_documents_from_file(
 
     if file_path.suffix == ".ndjson":
         with open(file_path) as f:
-            return [json.loads(x) for x in f]
+            return [json_handler.loads(x) for x in f]
 
     with open(file_path) as f:
         data = f.read()
-        documents = json.loads(data)
+        documents = json_handler.loads(data)
 
         if not isinstance(documents, list):
             raise InvalidDocumentError("Meilisearch requires documents to be in a list")
@@ -8370,7 +8200,7 @@ def _process_search_parameters(
     highlight_pre_tag: str = "<em>",
     highlight_post_tag: str = "</em>",
     crop_marker: str = "...",
-    matching_strategy: str = "all",
+    matching_strategy: Literal["all", "last", "frequency"] = "last",
     hits_per_page: int | None = None,
     page: int | None = None,
     attributes_to_search_on: list[str] | None = None,
@@ -8419,15 +8249,7 @@ def _process_search_parameters(
         body["vector"] = vector
 
     if hybrid:
-        if is_pydantic_2():
-            body["hybrid"] = hybrid.model_dump(by_alias=True)  # type: ignore[attr-defined]
-        else:  # pragma: no cover
-            warn(
-                "The use of Pydantic less than version 2 is depreciated and will be removed in a future release",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            body["hybrid"] = hybrid.dict(by_alias=True)  # type: ignore[attr-defined]
+        body["hybrid"] = hybrid.model_dump(by_alias=True)
 
     return body