python-arango 8.2.1__tar.gz → 8.2.3__tar.gz

{python_arango-8.2.1 → python_arango-8.2.3}/.circleci/config.yml

@@ -11,10 +11,10 @@ workflows:
           name:  Python (<< matrix.python_version >>) - ArangoDB (<< matrix.arangodb_license >>, << matrix.arangodb_version >> << matrix.arangodb_config >>)
           matrix:
             parameters:
-              python_version: ["3.9", "3.10", "3.11", "3.12"]
+              python_version: ["3.10", "3.11", "3.12"]
               arangodb_config: ["single", "cluster"]
-              arangodb_license: ["community", "enterprise"]
-              arangodb_version: ["3.11", "latest"]
+              arangodb_license: ["enterprise"]
+              arangodb_version: ["latest"]
 
 jobs:
   lint:

{python_arango-8.2.1 → python_arango-8.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-arango
-Version: 8.2.1
+Version: 8.2.3
 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>

{python_arango-8.2.1 → python_arango-8.2.3}/arango/aql.py

@@ -17,6 +17,7 @@ from arango.exceptions import (
     AQLQueryClearError,
     AQLQueryExecuteError,
     AQLQueryExplainError,
+    AQLQueryHistoryError,
     AQLQueryKillError,
     AQLQueryListError,
     AQLQueryRulesGetError,
@@ -627,6 +628,23 @@ class AQL(ApiGroup):
 
         return self._execute(request, response_handler)
 
+    def history(self) -> Result[Json]:
+        """Return recently executed AQL queries (admin only).
+
+        :return: AQL query history.
+        :rtype: dict
+        :raise arango.exceptions.AQLQueryHistoryError: If retrieval fails.
+        """
+        request = Request(method="get", endpoint="/_admin/server/aql-queries")
+
+        def response_handler(resp: Response) -> Json:
+            if not resp.is_success:
+                raise AQLQueryHistoryError(resp, request)
+            res: Json = resp.body["result"]
+            return res
+
+        return self._execute(request, response_handler)
+
     def functions(self) -> Result[Jsons]:
         """List the AQL functions defined in the database.
 

{python_arango-8.2.1 → python_arango-8.2.3}/arango/backup.py

@@ -33,7 +33,7 @@ class Backup(ApiGroup):  # pragma: no cover
         :type backup_id: str
         :return: Backup details.
         :rtype: dict
-        :raise arango.exceptions.BackupGetError: If delete fails.
+        :raise arango.exceptions.BackupGetError: If the operation fails.
         """
         request = Request(
             method="post",

{python_arango-8.2.1 → python_arango-8.2.3}/arango/cluster.py

@@ -261,7 +261,7 @@ class Cluster(ApiGroup):  # pragma: no cover
 
         :return: List of endpoints.
         :rtype: [str]
-        :raise arango.exceptions.ServerEndpointsError: If retrieval fails.
+        :raise arango.exceptions.ClusterEndpointsError: If retrieval fails.
         """
         request = Request(method="get", endpoint="/_api/cluster/endpoints")
 

{python_arango-8.2.1 → python_arango-8.2.3}/arango/collection.py

@@ -537,10 +537,18 @@ class Collection(ApiGroup):
     def load(self) -> Result[bool]:
         """Load the collection into memory.
 
+        .. note::
+            The load function is deprecated from version 3.8.0 onwards and is a
+            no-op from version 3.9.0 onwards. It should no longer be used, as it
+            may be removed in a future version of ArangoDB.
+
         :return: True if collection was loaded successfully.
         :rtype: bool
         :raise arango.exceptions.CollectionLoadError: If operation fails.
         """
+        m = "The load function is deprecated from version 3.8.0 onwards and is a no-op from version 3.9.0 onwards."  # noqa: E501
+        warn(m, DeprecationWarning, stacklevel=2)
+
         request = Request(method="put", endpoint=f"/_api/collection/{self.name}/load")
 
         def response_handler(resp: Response) -> bool:
@@ -553,10 +561,18 @@ class Collection(ApiGroup):
     def unload(self) -> Result[bool]:
         """Unload the collection from memory.
 
+        .. note::
+            The unload function is deprecated from version 3.8.0 onwards and is a
+            no-op from version 3.9.0 onwards. It should no longer be used, as it
+            may be removed in a future version of ArangoDB.
+
         :return: True if collection was unloaded successfully.
         :rtype: bool
         :raise arango.exceptions.CollectionUnloadError: If operation fails.
         """
+        m = "The unload function is deprecated from version 3.8.0 onwards and is a no-op from version 3.9.0 onwards."  # noqa: E501
+        warn(m, DeprecationWarning, stacklevel=2)
+
         request = Request(method="put", endpoint=f"/_api/collection/{self.name}/unload")
 
         def response_handler(resp: Response) -> bool:

{python_arango-8.2.1 → python_arango-8.2.3}/arango/database.py

@@ -27,6 +27,7 @@ from arango.exceptions import (
     AsyncJobListError,
     CollectionCreateError,
     CollectionDeleteError,
+    CollectionKeyGeneratorsError,
     CollectionListError,
     DatabaseCompactError,
     DatabaseCreateError,
@@ -43,7 +44,9 @@ from arango.exceptions import (
     PermissionListError,
     PermissionResetError,
     PermissionUpdateError,
+    ServerAPICallsError,
     ServerAvailableOptionsGetError,
+    ServerCheckAvailabilityError,
     ServerCurrentOptionsGetError,
     ServerDetailsError,
     ServerEchoError,
@@ -444,7 +447,7 @@ class Database(ApiGroup):
         :type force: bool
         :return: Server license.
         :rtype: dict
-        :raise arango.exceptions.ServerLicenseError: If retrieval fails.
+        :raise arango.exceptions.ServerLicenseSetError: If retrieval fails.
         """
         request = Request(
             method="put",
@@ -461,6 +464,26 @@ class Database(ApiGroup):
 
         return self._execute(request, response_handler)
 
+    def api_calls(self) -> Result[Json]:
+        """Return recent API calls (admin only).
+
+        :return: API calls history.
+        :rtype: dict
+        :raise arango.exceptions.ServerAPICallsError: If retrieval fails.
+        """
+        request = Request(
+            method="get",
+            endpoint="/_admin/server/api-calls",
+        )
+
+        def response_handler(resp: Response) -> Json:
+            if not resp.is_success:
+                raise ServerAPICallsError(resp, request)
+            res: Json = resp.body["result"]
+            return res
+
+        return self._execute(request, response_handler)
+
     def status(self) -> Result[Json]:
         """Return ArangoDB server status.
 
@@ -480,6 +503,25 @@ class Database(ApiGroup):
 
         return self._execute(request, response_handler)
 
+    def check_availability(self) -> Result[str]:
+        """Return ArangoDB server availability mode.
+
+        :return: Server availability mode ("readonly" or "default").
+        :rtype: str
+        :raise arango.exceptions.ServerCheckAvailabilityError: If retrieval fails.
+        """
+        request = Request(
+            method="get",
+            endpoint="/_admin/server/availability",
+        )
+
+        def response_handler(resp: Response) -> str:
+            if not resp.is_success:
+                raise ServerCheckAvailabilityError(resp, request)
+            return str(resp.body["mode"])
+
+        return self._execute(request, response_handler)
+
     def compact(
         self,
         change_level: Optional[bool] = None,
@@ -1068,6 +1110,7 @@ class Database(ApiGroup):
 
         :return: Server metrics in Prometheus format.
         :rtype: str
+        :raise arango.exceptions.ServerMetricsError: If operation fails.
         """
         request = Request(method="get", endpoint="/_admin/metrics/v2")
 
@@ -1623,6 +1666,23 @@ class Database(ApiGroup):
 
         return self._execute(request, response_handler)
 
+    def key_generators(self) -> Result[List[str]]:
+        """Returns the available key generators for collections.
+
+        :return: List of available key generators.
+        :rtype: [str]
+        :raise arango.exceptions.CollectionKeyGeneratorsError: If retrieval fails.
+        """  # noqa: E501
+        request = Request(method="get", endpoint="/_api/key-generators")
+
+        def response_handler(resp: Response) -> List[str]:
+            if not resp.is_success:
+                raise CollectionKeyGeneratorsError(resp, request)
+            result: List[str] = resp.body["keyGenerators"]
+            return result
+
+        return self._execute(request, response_handler)
+
     ####################
     # Graph Management #
     ####################

{python_arango-8.2.1 → python_arango-8.2.3}/arango/exceptions.py

@@ -121,6 +121,10 @@ class AQLQueryTrackingGetError(ArangoServerError):
     """Failed to retrieve AQL tracking properties."""
 
 
+class AQLQueryHistoryError(ArangoServerError):
+    """Failed to retrieve recent AQL queries."""
+
+
 class AQLQueryTrackingSetError(ArangoServerError):
     """Failed to configure AQL tracking properties."""
 
@@ -298,6 +302,10 @@ class CollectionTruncateError(ArangoServerError):
     """Failed to truncate collection."""
 
 
+class CollectionKeyGeneratorsError(ArangoServerError):
+    """Failed to retrieve key generators."""
+
+
 class CollectionLoadError(ArangoServerError):
     """Failed to load collection."""
 
@@ -634,6 +642,10 @@ class ServerDetailsError(ArangoServerError):
     """Failed to retrieve server details."""
 
 
+class ServerAPICallsError(ArangoServerError):
+    """Failed to retrieve recent API calls."""
+
+
 class ServerLicenseGetError(ArangoServerError):
     """Failed to retrieve server license."""
 
@@ -650,6 +662,10 @@ class ServerTimeError(ArangoServerError):
     """Failed to retrieve server system time."""
 
 
+class ServerCheckAvailabilityError(ArangoServerError):
+    """Failed to retrieve server availability mode."""
+
+
 class ServerEchoError(ArangoServerError):
     """Failed to retrieve details on last request."""
 

{python_arango-8.2.1 → python_arango-8.2.3}/arango/request.py

@@ -12,7 +12,7 @@ def normalize_headers(
     if driver_flags is not None:
         for flag in driver_flags:
             flags = flags + flag + ";"
-    driver_version = "8.2.1"
+    driver_version = "8.2.3"
     driver_header = "python-arango/" + driver_version + " (" + flags + ")"
     normalized_headers: Headers = {
         "charset": "utf-8",

{python_arango-8.2.1 → python_arango-8.2.3}/docs/foxx.rst

@@ -83,9 +83,9 @@ information, refer to `ArangoDB manual`_.
     foxx.readme(service_mount)
     foxx.swagger(service_mount)
     foxx.download(service_mount)
-    foxx.commit(service_mount)
+    foxx.commit()
     foxx.scripts(service_mount)
-    foxx.run_script(service_mount, 'setup', [])
+    foxx.run_script(service_mount, 'setup', {})
     foxx.run_tests(service_mount, reporter='xunit', output_format='xml')
 
     # Delete a service.

{python_arango-8.2.1 → python_arango-8.2.3}/python_arango.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-arango
-Version: 8.2.1
+Version: 8.2.3
 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>

{python_arango-8.2.1 → python_arango-8.2.3}/starter.sh

@@ -8,8 +8,8 @@
 # Example:
 #   ./starter.sh cluster enterprise 3.12.5
 
-setup="${1:-single}"
-license="${2:-community}"
+setup="${1:-cluster}"
+license="${2:-enterprise}"
 version="${3:-latest}"
 
 extra_ports=""