python-arango 8.3.4__tar.gz → 8.3.5__tar.gz

{python_arango-8.3.4 → python_arango-8.3.5}/.circleci/config.yml

@@ -37,12 +37,19 @@ workflows:
               arangodb_image: ["arangodb/enterprise:3.12"]
               arangodb_conf_version: ["3.12"]
       - integration-test:
-          name: ArangoDB (enterprise-preview, 4.0-nightly << matrix.arangodb_config >>)
+          name: ArangoDB (core-preview, 4.0-nightly << matrix.arangodb_config >>)
+          matrix:
+            parameters:
+              arangodb_config: [ "single", "cluster" ]
+              arangodb_image: [ "arangodb/core-preview:4.0-nightly" ]
+              arangodb_conf_version: [ "4.0" ]
+      - integration-test:
+          name: ArangoDB (enterprise-preview, 3.12-nightly << matrix.arangodb_config >>)
           matrix:
             parameters:
               arangodb_config: ["single", "cluster"]
-              arangodb_image: ["arangodb/enterprise-preview:4.0-nightly"]
-              arangodb_conf_version: ["4.0"]
+              arangodb_image: ["arangodb/enterprise-preview:3.12-nightly"]
+              arangodb_conf_version: ["3.12"]
 
 jobs:
   lint:

{python_arango-8.3.4 → python_arango-8.3.5}/.github/workflows/codeql.yaml

@@ -3,8 +3,6 @@ name: CodeQL
 on:
   pull_request:
     branches: [main]
-  schedule:
-    - cron: '21 2 * * 3'
 
 jobs:
   analyze:
@@ -16,10 +14,10 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v7
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@v2
+        uses: github/codeql-action/init@v4
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v2
+        uses: github/codeql-action/analyze@v4

python_arango-8.3.5/.github/workflows/docs.yaml

@@ -0,0 +1,47 @@
+name: Docs
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    name: Docs
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: Fetch all tags and branches
+        run: git fetch --prune --unshallow
+
+      - name: Create ArangoDB Docker container
+        run: >
+          docker create --name arango -p 8529:8529 -e ARANGO_ROOT_PASSWORD=passwd -v "$(pwd)/tests/static/":/tests/static
+          arangodb/enterprise:latest --server.jwt-secret-keyfile=/tests/static/keyfile --vector-index=true
+
+      - name: Start ArangoDB Docker container
+        run: docker start arango
+
+      - name: Wait for ArangoDB
+        run: |
+          for _ in {1..30}; do
+            if curl --fail --silent --user root:passwd http://localhost:8529/_api/version > /dev/null; then
+              exit 0
+            fi
+            sleep 1
+          done
+          docker logs arango
+          exit 1
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: pip install .[dev]
+
+      - name: Run Sphinx doctest
+        run: python -m sphinx -b doctest docs docs/_build

{python_arango-8.3.4 → python_arango-8.3.5}/.github/workflows/pypi.yaml

@@ -3,13 +3,6 @@ name: Upload to PyPI
 on:
   release:
     types: [published]
-  workflow_dispatch:
-    inputs:
-      debug_enabled:
-        type: boolean
-        description: Debug with tmate
-        required: false
-        default: false
 
 jobs:
   upload:
@@ -17,19 +10,14 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
-
-      - name: Fetch all tags and branches
-        run: git fetch --prune --unshallow
-
-      - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/checkout@v7
         with:
-          python-version: "3.10"
+          fetch-depth: 0
+          fetch-tags: true
 
-      - name: Debug with tmate
-        uses: mxschmitt/action-tmate@v3
-        if: ${{ github.event_name == 'workflow_dispatch' && inputs.debug_enabled }}
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
 
       - name: Install dependencies
         run: |

{python_arango-8.3.4/python_arango.egg-info → python_arango-8.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-arango
-Version: 8.3.4
+Version: 8.3.5
 Summary: Python Driver for ArangoDB
 Author-email: Joohwan Oh <joohwan.oh@outlook.com>
 Maintainer-email: Joohwan Oh <joohwan.oh@outlook.com>, Alexandru Petenchea <alex.petenchea@gmail.com>, Anthony Mahanna <anthony.mahanna@arangodb.com>
@@ -33,7 +33,6 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -48,7 +47,7 @@ Requires-Dist: requests_toolbelt
 Requires-Dist: PyJWT>=2.10.0
 Requires-Dist: packaging>=23.1
 Provides-Extra: dev
-Requires-Dist: black==26.1.0; extra == "dev"
+Requires-Dist: black==26.5.1; extra == "dev"
 Requires-Dist: flake8==7.3.0; extra == "dev"
 Requires-Dist: isort==5.10.1; extra == "dev"
 Requires-Dist: mypy==1.15.0; extra == "dev"
@@ -89,7 +88,7 @@ If you're interested in using asyncio, please check [python-arango-async](https:
 ## Requirements
 
 - ArangoDB version 3.11+
-- Python version 3.9+
+- Python version 3.10+
 
 ## Installation
 

{python_arango-8.3.4 → python_arango-8.3.5}/README.md

@@ -24,7 +24,7 @@ If you're interested in using asyncio, please check [python-arango-async](https:
 ## Requirements
 
 - ArangoDB version 3.11+
-- Python version 3.9+
+- Python version 3.10+
 
 ## Installation
 

{python_arango-8.3.4 → python_arango-8.3.5}/arango/collection.py

@@ -1274,17 +1274,29 @@ class Collection(ApiGroup):
     # Index Management #
     ####################
 
-    def indexes(self) -> Result[Jsons]:
+    def indexes(
+        self, with_stats: bool = False, with_hidden: bool = False
+    ) -> Result[Jsons]:
         """Return the collection indexes.
 
+        :param with_stats: Whether to include figures and estimates in the result.
+        :type with_stats: bool
+        :param with_hidden: Whether to include hidden indexes in the result.
+        :type with_hidden: bool
         :return: Collection indexes.
         :rtype: [dict]
         :raise arango.exceptions.IndexListError: If retrieval fails.
         """
+        params: Params = {"collection": self.name}
+        if with_stats:
+            params["withStats"] = True
+        if with_hidden:
+            params["withHidden"] = True
+
         request = Request(
             method="get",
             endpoint="/_api/index",
-            params={"collection": self.name},
+            params=params,
         )
 
         def response_handler(resp: Response) -> Jsons:

{python_arango-8.3.4 → python_arango-8.3.5}/arango/connection.py

@@ -120,8 +120,7 @@ class BaseConnection:
         else:
             resp.body = resp.raw_body
 
-        http_ok = 200 <= resp.status_code < 300
-        resp.is_success = http_ok and resp.error_code is None
+        resp.is_success = 200 <= resp.status_code < 300
         return resp
 
     def process_request(

{python_arango-8.3.4 → python_arango-8.3.5}/arango/formatter.py

@@ -73,6 +73,8 @@ def format_index(body: Json, formatter: bool = True) -> Json:
         result["cacheEnabled"] = body["cacheEnabled"]
     if "legacyPolygons" in body:
         result["legacyPolygons"] = body["legacyPolygons"]
+    if "figures" in body:
+        result["figures"] = body["figures"]
     if "estimates" in body:
         result["estimates"] = body["estimates"]
     if "analyzer" in body:
@@ -123,6 +125,8 @@ def format_index(body: Json, formatter: bool = True) -> Json:
         result["error_message"] = body["errorMessage"]
     if "trainingState" in body:
         result["training_state"] = body["trainingState"]
+    if "shards" in body:
+        result["shards"] = body["shards"]
 
     return verify_format(body, result)
 

python_arango-8.3.5/arango/version.py

@@ -0,0 +1 @@
+__version__ = "8.3.5"

{python_arango-8.3.4 → python_arango-8.3.5}/docs/foxx.rst

@@ -13,7 +13,7 @@ information, refer to `ArangoDB manual`_.
 
 **Example:**
 
-.. testcode::
+.. code-block:: python
 
     from arango import ArangoClient
 

{python_arango-8.3.4 → python_arango-8.3.5}/docs/index.rst

@@ -13,7 +13,7 @@ Requirements
 =============
 
 - ArangoDB version 3.11+
-- Python version 3.9+
+- Python version 3.10+
 
 Installation
 ============

{python_arango-8.3.4 → python_arango-8.3.5}/docs/indexes.rst

@@ -62,4 +62,43 @@ on fields ``_from`` and ``_to``. For more information on indexes, refer to
     # Delete the last index from the collection.
     cities.delete_index(index['id'])
 
+    # Insert documents with vector embeddings.
+    cities.insert_many([
+        {
+            '_key': f'city{i}',
+            'continent': f'continent{i}',
+            'country': f'country{i}',
+            'population': i,
+            'coordinates': [float(i % 180), float(i % 90)],
+            'x': float(i),
+            'y': float(i),
+            'embedding': [float(i), float(i % 7), float(i % 11), 1.0],
+        }
+        for i in range(100)
+    ])
+
+    # Let ArangoDB determine the number of vector-index centroids.
+    vector_index = cities.add_index({
+        'type': 'vector',
+        'fields': ['embedding'],
+        'name': 'vector_index',
+        'params': {
+            'metric': 'cosine',
+            'dimension': 4,
+        },
+    })
+
+    # Index creation may succeed even if vector training fails.
+    if vector_index.get('trainingState') != 'ready':
+        raise RuntimeError(
+            vector_index.get('errorMessage', 'Vector index is not ready')
+        )
+
+Omitted or scaling-object ``nLists``, ``numberOfDocsPerCentroid``, factory
+placeholders such as ``IVF{},Flat``, and successful-but-unusable creation
+behavior require ArangoDB 3.12.10 or later. A successful creation response
+means that the index exists, but callers should check ``trainingState`` before
+using it. If training fails permanently, the state is ``"unusable"`` and
+``errorMessage`` describes the failure.
+
 See :ref:`StandardCollection` for API specification.

{python_arango-8.3.4 → python_arango-8.3.5}/pyproject.toml

@@ -26,7 +26,6 @@ classifiers = [
     "Natural Language :: English",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -47,7 +46,7 @@ version = { attr = "arango.version.__version__" }
 
 [project.optional-dependencies]
 dev = [
-    "black==26.1.0",
+    "black==26.5.1",
     "flake8==7.3.0",
     "isort==5.10.1",
     "mypy==1.15.0",

{python_arango-8.3.4 → python_arango-8.3.5/python_arango.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-arango
-Version: 8.3.4
+Version: 8.3.5
 Summary: Python Driver for ArangoDB
 Author-email: Joohwan Oh <joohwan.oh@outlook.com>
 Maintainer-email: Joohwan Oh <joohwan.oh@outlook.com>, Alexandru Petenchea <alex.petenchea@gmail.com>, Anthony Mahanna <anthony.mahanna@arangodb.com>
@@ -33,7 +33,6 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -48,7 +47,7 @@ Requires-Dist: requests_toolbelt
 Requires-Dist: PyJWT>=2.10.0
 Requires-Dist: packaging>=23.1
 Provides-Extra: dev
-Requires-Dist: black==26.1.0; extra == "dev"
+Requires-Dist: black==26.5.1; extra == "dev"
 Requires-Dist: flake8==7.3.0; extra == "dev"
 Requires-Dist: isort==5.10.1; extra == "dev"
 Requires-Dist: mypy==1.15.0; extra == "dev"
@@ -89,7 +88,7 @@ If you're interested in using asyncio, please check [python-arango-async](https:
 ## Requirements
 
 - ArangoDB version 3.11+
-- Python version 3.9+
+- Python version 3.10+
 
 ## Installation
 

{python_arango-8.3.4 → python_arango-8.3.5}/python_arango.egg-info/SOURCES.txt

@@ -42,7 +42,6 @@ arango/typings.py
 arango/utils.py
 arango/version.py
 arango/wal.py
-ci/conftest.py
 docs/Makefile
 docs/admin.rst
 docs/analyzer.rst

{python_arango-8.3.4 → python_arango-8.3.5}/python_arango.egg-info/requires.txt

@@ -5,7 +5,7 @@ PyJWT>=2.10.0
 packaging>=23.1
 
 [dev]
-black==26.1.0
+black==26.5.1
 flake8==7.3.0
 isort==5.10.1
 mypy==1.15.0

{python_arango-8.3.4 → python_arango-8.3.5}/python_arango.egg-info/scm_file_list.json

@@ -40,7 +40,6 @@
     "arango/utils.py",
     "arango/version.py",
     "arango/wal.py",
-    "ci/conftest.py",
     "docs/Makefile",
     "docs/admin.rst",
     "docs/analyzer.rst",

python_arango-8.3.5/python_arango.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "8.3.5",
+  "distance": 0,
+  "node": "ga90d0b72830ee6a7db388833e77110a53fe59708",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-08-31"
+}

{python_arango-8.3.4 → python_arango-8.3.5}/starter.sh

@@ -8,8 +8,8 @@
 #   ./starter.sh [single|cluster] [image[:tag]]
 # Example:
 #   ./starter.sh cluster enterprise 3.12.4
-#   ./starter.sh single enterprise-preview 4.0-nightly
-#   ./starter.sh single arangodb/enterprise-preview:4.0-nightly
+#   ./starter.sh single core-preview 4.0-nightly
+#   ./starter.sh single arangodb/enterprise-preview:3.12-nightly
 
 setup="${1:-single}"
 image="${2:-community}"

python_arango-8.3.4/.github/workflows/docs.yaml

@@ -1,103 +0,0 @@
-name: Docs
-
-on:
-  pull_request:
-  workflow_dispatch:
-    inputs:
-      debug_enabled:
-        type: boolean
-        description: Debug with tmate
-        required: false
-        default: false
-
-jobs:
-  # This has been migrated to CircleCI
-  # test:
-  #   runs-on: ubuntu-latest
-
-  #   strategy:
-  #     fail-fast: false
-  #     matrix:
-  #       python_version: ["3.10"] #["3.8", "3.9", "3.10", "3.11", "3.12"]
-  #       arangodb_config: ["single", "cluster"]
-  #       arangodb_license: ["community", "enterprise"]
-  #       arangodb_version: ["3.10.10", "3.11.4", "latest"]
-
-  #   name: Test (${{ matrix.python_version }}:${{ matrix.arangodb_config }}:${{ matrix.arangodb_license }}:${{ matrix.arangodb_version }})
-
-  #   steps:
-  #     - name: Checkout code
-  #       uses: actions/checkout@v4
-
-  #     - name: Set up Python
-  #       uses: actions/setup-python@v4
-  #       with:
-  #         python-version: ${{ matrix.python_version }}
-
-  #     - name: Setup ArangoDB
-  #       run: |
-  #         chmod +x starter.sh
-  #         ./starter.sh ${{ matrix.arangodb_config }} ${{ matrix.arangodb_license }} ${{ matrix.arangodb_version }}
-
-  #     - name: Install Dependencies
-  #       run: pip install -e .[dev]
-
-  #     - name: List Docker Containers
-  #       run: docker ps -a
-
-  #     - name: Pytest
-  #       run: |
-  #         args=("--host" "localhost" "--port=8529")
-
-  #         if [ ${{ matrix.arangodb_config }} = "cluster" ]; then
-  #           args+=("--cluster" "--port=8539" "--port=8549")
-  #         fi
-
-  #         if [ ${{ matrix.arangodb_license }} = "enterprise" ]; then
-  #           args+=("--enterprise")
-  #         fi
-
-  #         echo "Running pytest with args: ${args[@]}"
-  #         pytest --cov=arango --cov-report=xml "${args[@]}"
-
-  docs:
-    runs-on: ubuntu-latest
-
-    name: Docs
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Fetch all tags and branches
-        run: git fetch --prune --unshallow
-
-      - name: Create ArangoDB Docker container
-        run: >
-          docker create --name arango -p 8529:8529 -e ARANGO_ROOT_PASSWORD=passwd -v "$(pwd)/tests/static/":/tests/static
-          arangodb/arangodb:latest --server.jwt-secret-keyfile=/tests/static/keyfile
-
-      - name: Start ArangoDB Docker container
-        run: docker start arango
-
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: '3.10'
-
-      - name: Debug with tmate
-        uses: mxschmitt/action-tmate@v3
-        if: ${{ github.event_name == 'workflow_dispatch' && inputs.debug_enabled }}
-
-      - name: Run pre-commit checks
-        uses: pre-commit/action@v3.0.0
-
-      - name: Install dependencies
-        run: pip install .[dev]
-
-      - name: Run Sphinx doctest
-        run: python -m sphinx -b doctest docs docs/_build
-
-      # No longer needed as this is handled by Read the Docs
-      #- name: Generate Sphinx HTML
-      #  run: python -m sphinx -b html -W docs docs/_build

python_arango-8.3.4/arango/version.py

@@ -1 +0,0 @@
-__version__ = "8.3.4"

python_arango-8.3.4/ci/conftest.py

@@ -1 +0,0 @@
-from tests.conftest import *  # noqa: F401,F403

python_arango-8.3.4/python_arango.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "8.3.4",
-  "distance": 0,
-  "node": "ga0e06656116c8188cd58aefa5c0766d67bc65d11",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-08-25"
-}