meilisearch-python-sdk 3.5.1__tar.gz → 3.6.1__tar.gz

meilisearch_python_sdk-3.5.1/.github/workflows/pypi_publish.yaml → meilisearch_python_sdk-3.6.1/.github/workflows/docs_publish.yml

@@ -1,4 +1,4 @@
-name: PyPi Publish
+name: Docs Publish
 on:
   release:
     types:
@@ -11,19 +11,14 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install uv
-        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: ${{ env.PYTHON_VERSION }}
       - name: Install Dependencies
         run: uv sync --frozen --all-extras
-      - name: Build and publish package
-        env:
-          TWINE_USERNAME: __token__
-          TWINE_PASSWORD: "${{ secrets.PYPI_API_KEY }}"
-        run: |
-          uvx --from build pyproject-build --installer uv
-          uvx twine upload dist/*
       - name: Deploy Docs
         run: uv run mkdocs gh-deploy --force

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/.github/workflows/nightly_testing.yml

@@ -5,7 +5,6 @@ on:
     # Set with UTC time
     - cron: "0 5 * * *"
 env:
-  UV_CACHE_DIR: /tmp/.uv-cache
   PYTHON_VERSION: "3.12"
 jobs:
   random-test-order:
@@ -15,26 +14,18 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install uv
-        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: install Just
         uses: taiki-e/install-action@just
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: ${{ env.PYTHON_VERSION }}
-      - name: Restore uv cache
-        uses: actions/cache@v4
-        with:
-          path: ${{ env.UV_CACHE_DIR }}
-          key: uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-          restore-keys: |
-            uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-            uv-${{ runner.os }}
       - name: Install Dependencies
         run: |
           just install
           uv pip install pytest-randomly
       - name: Test with pytest in random order
         run: just test-ci
-      - name: Minimize uv cache
-        run: uv cache prune --ci

meilisearch_python_sdk-3.6.1/.github/workflows/pypi_publish.yml

@@ -0,0 +1,29 @@
+name: PyPi Publish
+on:
+  release:
+    types:
+      - published
+env:
+  PYTHON_VERSION: "3.12"
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      # For PyPI's trusted publishing.
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      - name: Install Dependencies
+        run: uv sync --frozen --all-extras
+      - name: Build package
+        run: uv build
+      - name: Publish package
+        run: uv publish

meilisearch_python_sdk-3.5.1/.github/workflows/testing.yaml → meilisearch_python_sdk-3.6.1/.github/workflows/testing.yml

@@ -6,7 +6,6 @@ on:
       - main
   pull_request:
 env:
-  UV_CACHE_DIR: /tmp/.uv-cache
   PYTHON_VERSION: "3.9"
 jobs:
   linting:
@@ -16,25 +15,17 @@ jobs:
       - name: install Just
         uses: taiki-e/install-action@just
       - name: Install uv
-        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: ${{ env.PYTHON_VERSION }}
-      - name: Restore uv cache
-        uses: actions/cache@v4
-        with:
-          path: ${{ env.UV_CACHE_DIR }}
-          key: uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-          restore-keys: |
-            uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-            uv-${{ runner.os }}
       - name: Install Dependencies
         run: just install
       - name: mypy check
         run: just mypy
-      - name: Minimize uv cache
-        run: uv cache prune --ci
 
   parallel-testing:
     strategy:
@@ -47,19 +38,13 @@ jobs:
       - name: install Just
         uses: taiki-e/install-action@just
       - name: Install uv
-        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Restore uv cache
-        uses: actions/cache@v4
-        with:
-          path: ${{ env.UV_CACHE_DIR }}
-          key: uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-          restore-keys: |
-            uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-            uv-${{ runner.os }}
       - name: Install Dependencies
         run: just install
       - name: Test with pytest
@@ -69,8 +54,6 @@ jobs:
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true
-      - name: Minimize uv cache
-        run: uv cache prune --ci
 
   parallel-testing-http2:
     strategy:
@@ -83,19 +66,13 @@ jobs:
       - name: install Just
         uses: taiki-e/install-action@just
       - name: Install uv
-        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Restore uv cache
-        uses: actions/cache@v4
-        with:
-          path: ${{ env.UV_CACHE_DIR }}
-          key: uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-          restore-keys: |
-            uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-            uv-${{ runner.os }}
       - name: Install Dependencies
         run: just install
       - name: Install truststore
@@ -117,8 +94,6 @@ jobs:
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true
-      - name: Minimize uv cache
-        run: uv cache prune --ci
 
   no-parallel-testing:
     strategy:
@@ -131,19 +106,13 @@ jobs:
       - name: install Just
         uses: taiki-e/install-action@just
       - name: Install uv
-        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Restore uv cache
-        uses: actions/cache@v4
-        with:
-          path: ${{ env.UV_CACHE_DIR }}
-          key: uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-          restore-keys: |
-            uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-            uv-${{ runner.os }}
       - name: Install Dependencies
         run: just install
       - name: Test with pytest
@@ -153,8 +122,6 @@ jobs:
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true
-      - name: Minimize uv cache
-        run: uv cache prune --ci
 
   no-parallel-testing-http2:
     strategy:
@@ -167,19 +134,13 @@ jobs:
       - name: install Just
         uses: taiki-e/install-action@just
       - name: Install uv
-        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Restore uv cache
-        uses: actions/cache@v4
-        with:
-          path: ${{ env.UV_CACHE_DIR }}
-          key: uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-          restore-keys: |
-            uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-            uv-${{ runner.os }}
       - name: Install Dependencies
         run: just install
       - name: Install truststore
@@ -201,8 +162,6 @@ jobs:
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true
-      - name: Minimize uv cache
-        run: uv cache prune --ci
   example-testing:
     strategy:
       fail-fast: false
@@ -228,22 +187,14 @@ jobs:
       - name: install Just
         uses: taiki-e/install-action@just
       - name: Install uv
-        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: "3.11"
-      - name: Restore uv cache
-        uses: actions/cache@v4
-        with:
-          path: ${{ env.UV_CACHE_DIR }}
-          key: uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-          restore-keys: |
-            uv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
-            uv-${{ runner.os }}
       - name: Install Dependencies
         run: just install
       - name: Test Docs Build
         run: just build-docs
-      - name: Minimize uv cache
-        run: uv cache prune --ci

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/.pre-commit-config.yaml

@@ -9,12 +9,12 @@ repos:
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.11.2
+    rev: v1.13.0
     hooks:
       - id: mypy
-        additional_dependencies: [pydantic, types-aiofiles, types-ujson]
+        additional_dependencies: [pydantic, orjson, types-aiofiles, types-ujson]
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.9
+    rev: v0.7.2
     hooks:
       - id: ruff
         args: [--fix, --exit-non-zero-on-fix]

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: meilisearch-python-sdk
-Version: 3.5.1
+Version: 3.6.1
 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
@@ -41,7 +41,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Requires-Dist: aiofiles>=0.7
-Requires-Dist: camel-converter>=1.0.0
+Requires-Dist: camel-converter[pydantic]>=1.0.0
 Requires-Dist: eval-type-backport>=0.2.0; python_version < '3.10'
 Requires-Dist: httpx[http2]>=0.17
 Requires-Dist: pydantic>=2.0.0

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/docker-compose.https.yml

@@ -9,4 +9,11 @@ services:
     volumes:
       - ./meilisearch.key:/meilisearch.key
       - ./meilisearch.crt:/meilisearch.crt
-    command: ["meilisearch", "--ssl-cert-path", "/meilisearch.crt", "--ssl-key-path", "/meilisearch.key"]
+    command:
+      [
+        "meilisearch",
+        "--ssl-cert-path",
+        "/meilisearch.crt",
+        "--ssl-key-path",
+        "/meilisearch.key",
+      ]

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/examples/requirements.txt

@@ -1,4 +1,4 @@
 ../.[all]
-fastapi==0.115.0
+fastapi==0.115.4
 pytest==8.3.3
 pytest-asyncio==0.24.0

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/justfile

@@ -18,23 +18,23 @@
 @ruff-format:
   uv run ruff format meilisearch_python_sdk tests examples
 
-@test:
-  -uv run pytest -x
+@test *args="":
+  -uv run pytest {{args}}
 
-@test-http2:
-  -uv run pytest -x --http2
+@test-http2 *args="":
+  -uv run pytest --http2 {{args}}
 
-@test-parallel:
-  -uv run pytest -n auto -x -m "not no_parallel"
+@test-parallel *args="":
+  -uv run pytest -n auto -m "not no_parallel" {{args}}
 
-@test-no-parallel:
-  -uv run pytest -x -m "no_parallel"
+@test-no-parallel *args="":
+  -uv run pytest -m "no_parallel" {{args}}
 
-@test-parallel-http2:
-  -uv run pytest -n auto -x -m "not no_parallel" --http2
+@test-parallel-http2 *args="":
+  -uv run pytest -n auto -m "not no_parallel" --http2 {{args}}
 
-@test-no-parallel-http2:
-  -uv run pytest -x -m "no_parallel" --http2
+@test-no-parallel-http2 *args="":
+  -uv run pytest -m "no_parallel" --http2 {{args}}
 
 @test-ci: start-meilisearch-detached && stop-meilisearch
   uv run pytest --cov=meilisearch_python_sdk --cov-report=xml
@@ -86,5 +86,8 @@
 @lock:
   uv lock
 
+@lock-upgrade:
+  uv lock --upgrade
+
 @benchmark: start-meilisearch-detached && stop-meilisearch
   -uv run benchmark/run_benchmark.py

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/meilisearch_python_sdk/_client.py

@@ -24,6 +24,7 @@ from meilisearch_python_sdk.models.health import Health
 from meilisearch_python_sdk.models.index import IndexInfo
 from meilisearch_python_sdk.models.search import (
     Federation,
+    FederationMerged,
     SearchParams,
     SearchResultsFederated,
     SearchResultsWithUID,
@@ -587,7 +588,7 @@ class AsyncClient(BaseClient):
         self,
         queries: list[SearchParams],
         *,
-        federation: Federation | None = None,
+        federation: Federation | FederationMerged | None = None,
         hits_type: Any = JsonDict,
     ) -> list[SearchResultsWithUID] | SearchResultsFederated:
         """Multi-index search.
@@ -628,10 +629,18 @@ class AsyncClient(BaseClient):
         else:
             processed_queries = [x.model_dump(by_alias=True) for x in queries]
 
+        if federation:
+            federation_payload = federation.model_dump(by_alias=True)
+            if federation.facets_by_index is None:
+                del federation_payload["facetsByIndex"]
+
+        else:
+            federation_payload = None
+
         response = await self._http_requests.post(
             url,
             body={
-                "federation": federation.model_dump(by_alias=True) if federation else None,
+                "federation": federation_payload,
                 "queries": processed_queries,
             },
         )
@@ -1396,7 +1405,7 @@ class Client(BaseClient):
         self,
         queries: list[SearchParams],
         *,
-        federation: Federation | None = None,
+        federation: Federation | FederationMerged | None = None,
         hits_type: Any = JsonDict,
     ) -> list[SearchResultsWithUID] | SearchResultsFederated:
         """Multi-index search.
@@ -1437,10 +1446,18 @@ class Client(BaseClient):
         else:
             processed_queries = [x.model_dump(by_alias=True) for x in queries]
 
+        if federation:
+            federation_payload = federation.model_dump(by_alias=True)
+            if federation.facets_by_index is None:
+                del federation_payload["facetsByIndex"]
+
+        else:
+            federation_payload = None
+
         response = self._http_requests.post(
             url,
             body={
-                "federation": federation.model_dump(by_alias=True) if federation else None,
+                "federation": federation_payload,
                 "queries": processed_queries,
             },
         )

meilisearch_python_sdk-3.6.1/meilisearch_python_sdk/_version.py

@@ -0,0 +1 @@
+VERSION = "3.6.1"

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/meilisearch_python_sdk/index.py

@@ -3079,7 +3079,11 @@ class AsyncIndex(_BaseIndex):
             >>>     index = client.index("movies")
             >>>     await index.update_settings(new_settings)
         """
-        body_dict = {k: v for k, v in body.model_dump(by_alias=True).items() if v is not None}
+        body_dict = {
+            k: v
+            for k, v in body.model_dump(by_alias=True, exclude_none=True).items()
+            if v is not None
+        }
         response = await self._http_requests.patch(self._settings_url, body_dict, compress=compress)
 
         return TaskInfo(**response.json())
@@ -4270,7 +4274,9 @@ class AsyncIndex(_BaseIndex):
         payload = {}
         for key, embedder in embedders.embedders.items():
             payload[key] = {
-                k: v for k, v in embedder.model_dump(by_alias=True).items() if v is not None
+                k: v
+                for k, v in embedder.model_dump(by_alias=True, exclude_none=True).items()
+                if v is not None
             }
 
         response = await self._http_requests.patch(
@@ -6498,7 +6504,11 @@ class Index(_BaseIndex):
             >>> index = client.index("movies")
             >>> index.update_settings(new_settings)
         """
-        body_dict = {k: v for k, v in body.model_dump(by_alias=True).items() if v is not None}
+        body_dict = {
+            k: v
+            for k, v in body.model_dump(by_alias=True, exclude_none=True).items()
+            if v is not None
+        }
         response = self._http_requests.patch(self._settings_url, body_dict, compress=compress)
 
         return TaskInfo(**response.json())
@@ -7672,7 +7682,9 @@ class Index(_BaseIndex):
         payload = {}
         for key, embedder in embedders.embedders.items():
             payload[key] = {
-                k: v for k, v in embedder.model_dump(by_alias=True).items() if v is not None
+                k: v
+                for k, v in embedder.model_dump(by_alias=True, exclude_none=True).items()
+                if v is not None
             }
 
         response = self._http_requests.patch(

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/meilisearch_python_sdk/models/client.py

@@ -23,7 +23,7 @@ class ClientStats(CamelBase):
 class _KeyBase(CamelBase):
     uid: str
     name: str | None = None
-    description: str
+    description: str | None = None
     actions: list[str]
     indexes: list[str]
     expires_at: datetime | None = None
@@ -59,7 +59,7 @@ class Key(_KeyBase):
 
 class KeyCreate(CamelBase):
     name: str | None = None
-    description: str
+    description: str | None = None
     actions: list[str]
     indexes: list[str]
     expires_at: datetime | None = None

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/meilisearch_python_sdk/models/search.py

@@ -24,12 +24,24 @@ class FacetSearchResults(CamelBase):
 
 class Hybrid(CamelBase):
     semantic_ratio: float
-    embedder: str | None = None
+    embedder: str
+
+
+class MergeFacets(CamelBase):
+    max_values_per_facet: int
 
 
 class Federation(CamelBase):
     limit: int = 20
     offset: int = 0
+    facets_by_index: dict[str, list[str]] | None = None
+
+
+class FederationMerged(CamelBase):
+    limit: int = 20
+    offset: int = 0
+    facets_by_index: dict[str, list[str]] | None = None
+    merge_facets: MergeFacets | None
 
 
 class SearchParams(CamelBase):
@@ -99,6 +111,7 @@ class SearchResultsFederated(CamelBase, Generic[T]):
     page: int | None = None
     hits_per_page: int | None = None
     semantic_hit_count: int | None = None
+    facets_by_index: JsonDict | None = None
 
 
 class SimilarSearchResults(CamelBase, Generic[T]):

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/meilisearch_python_sdk/models/settings.py

@@ -49,18 +49,20 @@ class Distribution(CamelBase):
 class OpenAiEmbedder(CamelBase):
     source: str = "openAi"
     url: str | None = None
-    model: str | None = None  # Defaults to text-embedding-ada-002
-    dimensions: int | None = None  # Uses the model default
-    api_key: str | None = None  # Can be provided through a CLI option or environment variable
+    model: str | None = None
+    dimensions: int | None = None
+    api_key: str | None = None
     document_template: str | None = None
+    document_template_max_bytes: int | None = None
     distribution: Distribution | None = None
 
 
 class HuggingFaceEmbedder(CamelBase):
     source: str = "huggingFace"
-    model: str | None = None  # Defaults to BAAI/bge-base-en-v1.5
+    model: str | None = None
     revision: str | None = None
     document_template: str | None = None
+    document_template_max_bytes: int | None = None
     distribution: Distribution | None = None
 
 
@@ -71,6 +73,7 @@ class OllamaEmbedder(CamelBase):
     model: str
     dimensions: int | None = None
     document_template: str | None = None
+    document_template_max_bytes: int | None = None
     distribution: Distribution | None = None
 
 
@@ -80,6 +83,7 @@ class RestEmbedder(CamelBase):
     api_key: str | None = None
     dimensions: int
     document_template: str | None = None
+    document_template_max_bytes: int | None = None
     distribution: Distribution | None = None
     headers: JsonDict | None = None
     request: JsonDict

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/pyproject.toml

@@ -25,7 +25,7 @@ classifiers=[
 dynamic = ["version"]
 dependencies = [
   "aiofiles>=0.7",
-  "camel-converter>=1.0.0",
+  "camel-converter[pydantic]>=1.0.0",
   # allows pydantic to use pipe instead of Union
   "eval-type-backport>=0.2.0; python_version < '3.10'",
   "httpx[http2]>=0.17",
@@ -38,23 +38,23 @@ orjson = ["orjson>=3.10.6"]
 ujson = ["ujson>=5.10.0"]
 all = ["orjson", "ujson"]
 
-[tool.uv]
-dev-dependencies = [
-  "mkdocs==1.6.0",
-  "mkdocs-material==9.5.32",
-  "mkdocstrings[python]==0.25.2",
-  "mypy==1.11.1",
-  "pre-commit==4.0.0",
-  "pytest==8.3.2",
-  "pytest-cov==5.0.0",
+[dependency-groups]
+dev = [
+  "mkdocs==1.6.1",
+  "mkdocs-material==9.5.43",
+  "mkdocstrings[python]==0.26.2",
+  "mypy[faster-cache]==1.13.0",
+  "pre-commit==4.0.1",
+  "pytest==8.3.3",
+  "pytest-cov==6.0.0",
   "pytest-asyncio==0.24.0",
   "pytest-xdist==3.6.1",
-  "ruff==0.6.2",
+  "ruff==0.7.2",
   "types-aiofiles==24.1.0.20240626",
   "typing-extensions==4.12.2",
   "types-ujson==5.10.0.20240515",
-  "meilisearch==0.31.5",
-  "rich==13.7.1",
+  "meilisearch==0.31.6",
+  "rich==13.9.3",
 ]
 
 [tool.hatch.version]

{meilisearch_python_sdk-3.5.1 → meilisearch_python_sdk-3.6.1}/tests/test_async_index_plugins.py

@@ -112,7 +112,13 @@ class TaskInfoPlugin:
     PRE_EVENT = False
 
     async def run_plugin(self, event: AsyncEvent, **kwargs: Any) -> TaskInfo:
-        return TaskInfo(task_uid=1, status="succeeded", type="test", enqueued_at=datetime.now())
+        return TaskInfo(
+            task_uid=1,
+            status="succeeded",
+            type="test",
+            task_type="test",
+            enqueued_at=datetime.now(),
+        )
 
 
 class PrePlugin: