meilisearch-python-sdk 4.7.2__py3-none-any.whl → 4.9.0__py3-none-any.whl

meilisearch_python_sdk/_client.py

@@ -689,6 +689,9 @@ class AsyncClient(BaseClient):
                 del q["limit"]
                 del q["offset"]
 
+            if query.media is None:
+                del q["media"]
+
             processed_queries.append(q)
 
         if federation:
@@ -1058,7 +1061,7 @@ class AsyncClient(BaseClient):
 
         Examples
             >>> from meilisearch_python_sdk import AsyncClient
-            >>> >>> documents = [
+            >>> documents = [
             >>>     {"id": 1, "title": "Movie 1", "genre": "comedy"},
             >>>     {"id": 2, "title": "Movie 2", "genre": "drama"},
             >>> ]
@@ -1075,6 +1078,56 @@ class AsyncClient(BaseClient):
             raise_for_status=raise_for_status,
         )
 
+    # No cover because it requires multiple instances of Meilisearch
+    async def transfer_documents(  # pragma: no cover
+        self,
+        url: str,
+        *,
+        api_key: str | None = None,
+        payload_size: str | None = None,
+        indexes: JsonMapping | None = None,
+    ) -> TaskInfo:
+        """Transfer settings and documents from one Meilisearch instance to another.
+
+        Args:
+            url: Where to send our settings and documents.
+            api_key: The API key with the rights to send the requests. Usually the master key of
+                the remote machine. Defaults to None.
+            payload_size: Human readable size defining the size of the payloads to send. Defaults
+                to 50 MiB.
+            indexes: A set of patterns of matching the indexes you want to export. Defaults to all
+                indexes without filter.
+
+        Returns:
+            The details of the task.
+
+        Raises:
+            MeilisearchCommunicationError: If there was an error communicating with the server.
+            MeilisearchApiError: If the Meilisearch API returned an error.
+            MeilisearchTimeoutError: If the connection times out.
+
+        Examples
+            >>> from meilisearch_python_sdk import AsyncClient
+            >>> async with Client("http://localhost.com", "masterKey") as client:
+            >>>     await index.transfer_documents(
+            >>>         "https://another-instance.com", api_key="otherMasterKey"
+            >>>     )
+        """
+        payload: JsonDict = {"url": url}
+
+        if api_key:
+            payload["apiKey"] = api_key
+
+        if payload:
+            payload["payloadSize"] = payload_size
+
+        if indexes:
+            payload["indexes"] = indexes
+
+        response = await self._http_requests.post(url, body=payload)
+
+        return TaskInfo(**response.json())
+
 
 class Client(BaseClient):
     """client to connect to the Meilisearch API."""
@@ -1968,7 +2021,7 @@ class Client(BaseClient):
 
         Examples
             >>> from meilisearch_python_sdk import Client
-            >>> >>> documents = [
+            >>> documents = [
             >>>     {"id": 1, "title": "Movie 1", "genre": "comedy"},
             >>>     {"id": 2, "title": "Movie 2", "genre": "drama"},
             >>> ]
@@ -1985,6 +2038,54 @@ class Client(BaseClient):
             raise_for_status=raise_for_status,
         )
 
+    # No cover because it requires multiple instances of Meilisearch
+    def transfer_documents(  # pragma: no cover
+        self,
+        url: str,
+        *,
+        api_key: str | None = None,
+        payload_size: str | None = None,
+        indexes: JsonMapping | None = None,
+    ) -> TaskInfo:
+        """Transfer settings and documents from one Meilisearch instance to another.
+
+        Args:
+            url: Where to send our settings and documents.
+            api_key: The API key with the rights to send the requests. Usually the master key of
+                the remote machine. Defaults to None.
+            payload_size: Human readable size defining the size of the payloads to send. Defaults
+                to 50 MiB.
+            indexes: A set of patterns of matching the indexes you want to export. Defaults to all
+                indexes without filter.
+
+        Returns:
+            The details of the task.
+
+        Raises:
+            MeilisearchCommunicationError: If there was an error communicating with the server.
+            MeilisearchApiError: If the Meilisearch API returned an error.
+            MeilisearchTimeoutError: If the connection times out.
+
+        Examples
+            >>> from meilisearch_python_sdk import Client
+            >>> client = Client("http://localhost.com", "masterKey")
+            >>> index.transfer_documents("https://another-instance.com", api_key="otherMasterKey")
+        """
+        payload: JsonDict = {"url": url}
+
+        if api_key:
+            payload["apiKey"] = api_key
+
+        if payload:
+            payload["payloadSize"] = payload_size
+
+        if indexes:
+            payload["indexes"] = indexes
+
+        response = self._http_requests.post(url, body=payload)
+
+        return TaskInfo(**response.json())
+
 
 def _build_offset_limit_url(base: str, offset: int | None, limit: int | None) -> str:
     if offset is not None and limit is not None:

meilisearch_python_sdk/_version.py

@@ -1 +1 @@
-VERSION = "4.7.2"
+VERSION = "4.9.0"

meilisearch_python_sdk/index.py

@@ -725,6 +725,7 @@ class AsyncIndex(_BaseIndex):
         hybrid: Hybrid | None = None,
         locales: list[str] | None = None,
         retrieve_vectors: bool | None = None,
+        media: JsonMapping | None = None,
     ) -> SearchResults:
         """Search the index.
 
@@ -786,6 +787,13 @@ class AsyncIndex(_BaseIndex):
             locales: Specifies the languages for the search. This parameter can only be used with
                 Milisearch >= v1.10.0. Defaults to None letting the Meilisearch pick.
             retrieve_vectors: Return document vector data with search result.
+            media: The content of media is used as if it were a document to generate request
+                fragments from the searchFragments parameter. Defaults to None. This parameter can
+                only be used with Meilisearch >= v1.16.0. In order to use this feature in
+                Meilisearch v1.16.0 you first need to enable the feature by sending a PATCH request
+                to /experimental-features with { "multimodal": true }. Because this feature is
+                experimental it may be removed or updated causing breaking changes in this library
+                without a major version bump so use with caution.
 
         Returns:
             Results of the search
@@ -830,6 +838,7 @@ class AsyncIndex(_BaseIndex):
             ranking_score_threshold=ranking_score_threshold,
             locales=locales,
             retrieve_vectors=retrieve_vectors,
+            media=media,
         )
         search_url = f"{self._base_url_with_uid}/search"
 
@@ -1349,6 +1358,7 @@ class AsyncIndex(_BaseIndex):
         fields: list[str] | None = None,
         filter: Filter | None = None,
         retrieve_vectors: bool = False,
+        sort: str | None = None,
     ) -> DocumentsInfo:
         """Get a batch documents from the index.
 
@@ -1362,6 +1372,7 @@ class AsyncIndex(_BaseIndex):
             retrieve_vectors: If set to True the vectors will be returned with each document.
                 Defaults to False. Note: This parameter can only be
                 used with Meilisearch >= v1.13.0
+            sort: Attribute by which to sort the results. Defaults to None.
 
         Returns:
             Documents info.
@@ -1382,6 +1393,9 @@ class AsyncIndex(_BaseIndex):
             "limit": limit,
         }
 
+        if sort:
+            parameters["sort"] = sort
+
         if retrieve_vectors:
             parameters["retrieveVectors"] = "true"
 
@@ -5151,6 +5165,7 @@ class Index(_BaseIndex):
         hybrid: Hybrid | None = None,
         locales: list[str] | None = None,
         retrieve_vectors: bool | None = None,
+        media: JsonMapping | None = None,
     ) -> SearchResults:
         """Search the index.
 
@@ -5212,6 +5227,13 @@ class Index(_BaseIndex):
             locales: Specifies the languages for the search. This parameter can only be used with
                 Milisearch >= v1.10.0. Defaults to None letting the Meilisearch pick.
             retrieve_vectors: Return document vector data with search result.
+            media: The content of media is used as if it were a document to generate request
+                fragments from the searchFragments parameter. Defaults to None. This parameter can
+                only be used with Meilisearch >= v1.16.0. In order to use this feature in
+                Meilisearch v1.16.0 you first need to enable the feature by sending a PATCH request
+                to /experimental-features with { "multimodal": true }. Because this feature is
+                experimental it may be removed or updated causing breaking changes in this library
+                without a major version bump so use with caution.
 
         Returns:
             Results of the search
@@ -5256,6 +5278,7 @@ class Index(_BaseIndex):
             ranking_score_threshold=ranking_score_threshold,
             locales=locales,
             retrieve_vectors=retrieve_vectors,
+            media=media,
         )
 
         if self._pre_search_plugins:
@@ -5584,6 +5607,7 @@ class Index(_BaseIndex):
         fields: list[str] | None = None,
         filter: Filter | None = None,
         retrieve_vectors: bool = False,
+        sort: str | None = None,
     ) -> DocumentsInfo:
         """Get a batch documents from the index.
 
@@ -5597,6 +5621,7 @@ class Index(_BaseIndex):
             retrieve_vectors: If set to True the vectors will be returned with each document.
                 Defaults to False. Note: This parameter can only be
                 used with Meilisearch >= v1.13.0
+            sort: Attribute by which to sort the results. Defaults to None.
 
         Returns:
             Documents info.
@@ -5617,6 +5642,9 @@ class Index(_BaseIndex):
             "limit": limit,
         }
 
+        if sort:
+            parameters["sort"] = sort
+
         if retrieve_vectors:
             parameters["retrieveVectors"] = "true"
 
@@ -5633,6 +5661,7 @@ class Index(_BaseIndex):
             parameters["fields"] = fields
 
         parameters["filter"] = filter
+
         response = self._http_requests.post(f"{self._documents_url}/fetch", body=parameters)
 
         return DocumentsInfo(**response.json())
@@ -8390,6 +8419,7 @@ def _process_search_parameters(
     locales: list[str] | None = None,
     retrieve_vectors: bool | None = None,
     exhaustive_facet_count: bool | None = None,
+    media: JsonMapping | None = None,
 ) -> JsonDict:
     if attributes_to_retrieve is None:
         attributes_to_retrieve = ["*"]
@@ -8444,6 +8474,9 @@ def _process_search_parameters(
     if exhaustive_facet_count is not None:
         body["exhaustivefacetCount"] = exhaustive_facet_count
 
+    if media is not None:
+        body["media"] = media
+
     return body
 
 

meilisearch_python_sdk/models/search.py

@@ -6,7 +6,7 @@ from camel_converter.pydantic_base import CamelBase
 from pydantic import Field, field_validator
 
 from meilisearch_python_sdk.errors import MeilisearchError
-from meilisearch_python_sdk.types import Filter, JsonDict
+from meilisearch_python_sdk.types import Filter, JsonDict, JsonMapping
 
 T = TypeVar("T")
 
@@ -71,6 +71,7 @@ class SearchParams(CamelBase):
     hybrid: Hybrid | None = None
     locales: list[str] | None = None
     retrieve_vectors: bool | None = None
+    media: JsonMapping | None = None
 
     @field_validator("ranking_score_threshold", mode="before")  # type: ignore[attr-defined]
     @classmethod
@@ -94,6 +95,7 @@ class SearchResults(CamelBase, Generic[T]):
     page: int | None = None
     hits_per_page: int | None = None
     semantic_hit_count: int | None = None
+    query_vector: list[float] | None = None
 
 
 class SearchResultsWithUID(SearchResults, Generic[T]):

meilisearch_python_sdk/models/settings.py

@@ -3,8 +3,8 @@ from __future__ import annotations
 from enum import Enum
 from typing import Literal
 
-import pydantic
 from camel_converter.pydantic_base import CamelBase
+from pydantic import field_validator, model_validator
 
 from meilisearch_python_sdk.types import JsonDict
 
@@ -26,7 +26,7 @@ class Faceting(CamelBase):
     max_values_per_facet: int
     sort_facet_values_by: dict[str, str] | None = None
 
-    @pydantic.field_validator("sort_facet_values_by")  # type: ignore[attr-defined]
+    @field_validator("sort_facet_values_by")  # type: ignore[attr-defined]
     @classmethod
     def validate_facet_order(cls, v: dict[str, str] | None) -> dict[str, str] | None:
         if not v:  # pragma: no cover
@@ -96,6 +96,15 @@ class RestEmbedder(CamelBase):
     request: JsonDict
     response: JsonDict
     binary_quantized: bool | None = None
+    indexing_fragments: JsonDict | None = None
+    search_fragment: JsonDict | None = None
+
+    @model_validator(mode="after")
+    def check_document_template(self) -> RestEmbedder:
+        if self.indexing_fragments is not None and self.document_template is not None:
+            raise ValueError("document_template must be None when indexing_fragments is set")
+
+        return self
 
 
 class UserProvidedEmbedder(CamelBase):

{meilisearch_python_sdk-4.7.2.dist-info → meilisearch_python_sdk-4.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meilisearch-python-sdk
-Version: 4.7.2
+Version: 4.9.0
 Summary: A Python client providing both async and sync support for the Meilisearch API
 Project-URL: repository, https://github.com/sanders41/meilisearch-python-sdk
 Project-URL: homepage, https://github.com/sanders41/meilisearch-python-sdk

{meilisearch_python_sdk-4.7.2.dist-info → meilisearch_python_sdk-4.9.0.dist-info}/RECORD

@@ -1,13 +1,13 @@
 meilisearch_python_sdk/__init__.py,sha256=SB0Jlm6FwT13J9xasZKseZzTWBk0hkfe1CWyWmIIZnE,258
 meilisearch_python_sdk/_batch.py,sha256=Hbt-M8Lt8ZDZqcKToUMzUd5zvT-gku709er4pRlvXWk,5065
-meilisearch_python_sdk/_client.py,sha256=KsQkSoZEAnXK2H0QWc-tOOczOAE8kuLUssxmd5j9dS4,77379
+meilisearch_python_sdk/_client.py,sha256=bsGEST8aBJVMsul-RIKWutCAVjKh8Gx0ReCuwvSL7oA,81093
 meilisearch_python_sdk/_http_requests.py,sha256=O3M3n-t1jAKwccWowPbk-HPD3ExtHq8a3XhnZT5facs,6746
 meilisearch_python_sdk/_task.py,sha256=QgVcqMlZdURRS_oYpB_bTBa5dvT3Sp_-O0-s6TqAxHk,12485
 meilisearch_python_sdk/_utils.py,sha256=NoCDxJPhjABeuSxFTNCih585UDWdXEUBD_FvdgtScQw,1539
-meilisearch_python_sdk/_version.py,sha256=Zt3blf3grzBfdS51dr-gmLIruUhL0rGHx7IXjJqi54o,18
+meilisearch_python_sdk/_version.py,sha256=bmQkTABtlbDMSgjET7LUES-O4ujaN2we_yeOqP1woIA,18
 meilisearch_python_sdk/decorators.py,sha256=njMn40P-qOzKGGQLCDpsBKWyj2ai10s4XG4IUBSHoD4,8674
 meilisearch_python_sdk/errors.py,sha256=RNNHXtXLBiCVZaLM2MeKKs9RbRuE-SLRttiPeVAEXgA,2133
-meilisearch_python_sdk/index.py,sha256=7yZV7wuGpY0h3n6670cedH4nTIRNzU124aVT-YyPlLY,347496
+meilisearch_python_sdk/index.py,sha256=1hKuVPQPH1bpQ_3DrnihpypMZk5ZZok0-pU3RjO0Sfo,349340
 meilisearch_python_sdk/json_handler.py,sha256=c1rGKzYlE0dGfLygQjPqVUNfQkN1JvafBGmIx31JW8g,2044
 meilisearch_python_sdk/plugins.py,sha256=YySzTuVr4IrogTgrP8q-gZPsew8TwedopjWnTj5eV48,3607
 meilisearch_python_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -18,11 +18,11 @@ meilisearch_python_sdk/models/client.py,sha256=nefi6ViSaSd_mtopRAhM9tzzepwChFJUk
 meilisearch_python_sdk/models/documents.py,sha256=eT3FHrPND-g2IzNRyOHQApTTJ1WbFcGlqgxZ6aKrRgI,247
 meilisearch_python_sdk/models/health.py,sha256=hvruti7ylsk7bAh8RPOhTPcRrjx6MPgdkDFX9vZ5Qks,95
 meilisearch_python_sdk/models/index.py,sha256=WLQOi3_HChko134FkRU1H3_cJjhHJCFclcx4oDBlqHU,1228
-meilisearch_python_sdk/models/search.py,sha256=ZySZyA18QuJavz82gK7Kkqfp0fIxWVervCw24W6bToA,3487
-meilisearch_python_sdk/models/settings.py,sha256=inmP9PbjrgLVq0_9z3750Enhri3PX0lLj2HTLytWAt4,5323
+meilisearch_python_sdk/models/search.py,sha256=U3ph1GW9Xkbw33pIlGDa7rlTGsdvqahjRJjPxUou8n8,3581
+meilisearch_python_sdk/models/settings.py,sha256=3UdJWbrXfTrwvzu3Gq-aY1fDmAejysSz7yRQ-7yXCwQ,5736
 meilisearch_python_sdk/models/task.py,sha256=JVYF46ylD-XwqVVNq2offhLOkljaGxPyRVuF6PwLOBU,2174
 meilisearch_python_sdk/models/version.py,sha256=YDu-aj5H-d6nSaWRTXzlwWghmZAoiknaw250UyEd48I,215
-meilisearch_python_sdk-4.7.2.dist-info/METADATA,sha256=N_ZlULj05-wdmIV9GvxoS8Z5jvZp94HFOs0m3-s8jiA,9763
-meilisearch_python_sdk-4.7.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meilisearch_python_sdk-4.7.2.dist-info/licenses/LICENSE,sha256=xVzevI1TrlKfM0plmJ7vfK1Muu0V9n-dGE8RnDrOFlM,1069
-meilisearch_python_sdk-4.7.2.dist-info/RECORD,,
+meilisearch_python_sdk-4.9.0.dist-info/METADATA,sha256=eMfrNaOBiXcGZHYREUf0xUpS5oZjFbd9OjonqoqSQ_E,9763
+meilisearch_python_sdk-4.9.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meilisearch_python_sdk-4.9.0.dist-info/licenses/LICENSE,sha256=xVzevI1TrlKfM0plmJ7vfK1Muu0V9n-dGE8RnDrOFlM,1069
+meilisearch_python_sdk-4.9.0.dist-info/RECORD,,