From 265158328552f673280e5f584781ee6b56d8be47 Mon Sep 17 00:00:00 2001 From: Alex Petenchea Date: Mon, 1 Jun 2026 13:06:23 +0800 Subject: [PATCH 1/7] Tasks deprecation --- arangoasync/database.py | 6 ++++++ docs/task.rst | 4 ++++ 2 files changed, 10 insertions(+) diff --git a/arangoasync/database.py b/arangoasync/database.py index c00a584..de7b2c0 100644 --- a/arangoasync/database.py +++ b/arangoasync/database.py @@ -2484,6 +2484,9 @@ async def create_task( ) -> Result[Json]: """Create a new task. + Warning: + Tasks are no longer available in ArangoDB 4.0. + Args: command (str): The JavaScript code to be executed. task_id (str | None): Optional task ID. If not provided, the server will @@ -2542,6 +2545,9 @@ async def delete_task( ) -> Result[bool]: """Delete a server task. + Warning: + Tasks are no longer available in ArangoDB 4.0. + Args: task_id (str): Task ID. ignore_missing (bool): If `True`, do not raise an exception if the diff --git a/docs/task.rst b/docs/task.rst index 2490507..41c1c7d 100644 --- a/docs/task.rst +++ b/docs/task.rst @@ -1,6 +1,10 @@ Tasks ----- +.. warning:: + Tasks are no longer available in ArangoDB 4.0. + + ArangoDB can schedule user-defined Javascript snippets as one-time or periodic (re-scheduled after each execution) tasks. Tasks are executed in the context of the database they are defined in. From a0f100e7a39ac216a6d207b66aea2fb0930e9e38 Mon Sep 17 00:00:00 2001 From: Alex Petenchea Date: Mon, 1 Jun 2026 13:10:09 +0800 Subject: [PATCH 2/7] AQL User Functions deprecation --- arangoasync/aql.py | 9 +++++++++ docs/aql.rst | 4 ++++ 2 files changed, 13 insertions(+) diff --git a/arangoasync/aql.py b/arangoasync/aql.py index 14bbd44..0d1c059 100644 --- a/arangoasync/aql.py +++ b/arangoasync/aql.py @@ -678,6 +678,9 @@ def response_handler(resp: Response) -> Jsons: async def functions(self, namespace: Optional[str] = None) -> Result[Jsons]: """List the registered used-defined AQL functions. + Warning: + AQL User Functions are no longer available in ArangoDB 4.0. + Args: namespace (str | None): Returns all registered AQL user functions from the specified namespace. @@ -718,6 +721,9 @@ async def create_function( ) -> Result[Json]: """Registers a user-defined AQL function (UDF) written in JavaScript. + Warning: + AQL User Functions are no longer available in ArangoDB 4.0. + Args: name (str): Name of the function. code (str): JavaScript code of the function. @@ -756,6 +762,9 @@ async def delete_function( ) -> Result[Json]: """Remove a user-defined AQL function. + Warning: + AQL User Functions are no longer available in ArangoDB 4.0. + Args: name (str): Name of the function. group (bool | None): If set to `True`, the function name is treated diff --git a/docs/aql.rst b/docs/aql.rst index 97d4f6c..5b29f4f 100644 --- a/docs/aql.rst +++ b/docs/aql.rst @@ -90,6 +90,10 @@ See :class:`arangoasync.aql.AQL` for API specification. AQL User Functions ================== +.. warning:: + AQL User Functions are no longer available in ArangoDB 4.0. + + **AQL User Functions** are custom functions you define in Javascript to extend AQL functionality. They are somewhat similar to SQL procedures. From 4192b6f33823cd00850c7a90e8d7a1249b0d4e97 Mon Sep 17 00:00:00 2001 From: Alex Petenchea Date: Mon, 1 Jun 2026 13:15:05 +0800 Subject: [PATCH 3/7] More Tasks deprecation --- arangoasync/database.py | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/arangoasync/database.py b/arangoasync/database.py index de7b2c0..70f22eb 100644 --- a/arangoasync/database.py +++ b/arangoasync/database.py @@ -2429,6 +2429,9 @@ def response_handler(resp: Response) -> Json: async def tasks(self) -> Result[Jsons]: """Fetches all existing tasks from the server. + Warning: + Tasks are no longer available in ArangoDB 4.0. + Returns: list: List of currently active server tasks. @@ -2451,6 +2454,9 @@ def response_handler(resp: Response) -> Jsons: async def task(self, task_id: str) -> Result[Json]: """Return the details of an active server task. + Warning: + Tasks are no longer available in ArangoDB 4.0. + Args: task_id (str) -> Server task ID. From ee367f537f4ae2e276563fd3dff00f41d01a3cb0 Mon Sep 17 00:00:00 2001 From: Alex Petenchea Date: Mon, 1 Jun 2026 13:28:35 +0800 Subject: [PATCH 4/7] Deprecating DB server satistics --- arangoasync/cluster.py | 4 ++++ docs/cluster.rst | 4 ---- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/arangoasync/cluster.py b/arangoasync/cluster.py index fa42ea3..a776b15 100644 --- a/arangoasync/cluster.py +++ b/arangoasync/cluster.py @@ -64,6 +64,10 @@ def response_handler(resp: Response) -> Json: async def statistics(self, db_server: str) -> Result[Json]: """Queries the statistics of the given DB-Server. + Warning: + DB-Server statistics are no longer available in ArangoDB 4.0. + Use :meth:`arangoasync.database.Database.metrics` instead. + Args: db_server (str): The ID of the DB-Server. diff --git a/docs/cluster.rst b/docs/cluster.rst index d5c4908..108c8a6 100644 --- a/docs/cluster.rst +++ b/docs/cluster.rst @@ -24,10 +24,6 @@ and architecture, refer to `ArangoDB Manual`_. # Cluster health health = await cluster.health() - # DB-Server statistics - db_server = "PRMR-2716c9d0-4b22-4c66-ba3d-f9cd3143e52b" - stats = await cluster.statistics(db_server) - # Cluster endpoints endpoints = await cluster.endpoints() From f5a82417032eb3f16042f14bed4b34c67ead92c9 Mon Sep 17 00:00:00 2001 From: Alex Petenchea Date: Mon, 1 Jun 2026 15:40:38 +0800 Subject: [PATCH 5/7] Deprecated route reloading --- arangoasync/database.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/arangoasync/database.py b/arangoasync/database.py index 70f22eb..6545be7 100644 --- a/arangoasync/database.py +++ b/arangoasync/database.py @@ -2921,6 +2921,9 @@ def response_handler(resp: Response) -> None: async def reload_routing(self) -> None: """Reload the routing information. + Warning: + Route reloading is no longer available in ArangoDB 4.0. + Raises: ServerReloadRoutingError: If the operation fails. From c41b93c4e8c95b0ce4172ad8421ef861bb561d89 Mon Sep 17 00:00:00 2001 From: Alex Petenchea Date: Mon, 1 Jun 2026 15:45:22 +0800 Subject: [PATCH 6/7] Deprecated foxx --- arangoasync/database.py | 3 +++ arangoasync/foxx.py | 6 +++++- docs/foxx.rst | 4 ++++ 3 files changed, 12 insertions(+), 1 deletion(-) diff --git a/arangoasync/database.py b/arangoasync/database.py index 6545be7..64b43f2 100644 --- a/arangoasync/database.py +++ b/arangoasync/database.py @@ -234,6 +234,9 @@ def cluster(self) -> Cluster: def foxx(self) -> Foxx: """Return Foxx API wrapper. + Warning: + Foxx microservice features are no longer available in ArangoDB 4.0. + Returns: arangoasync.foxx.Foxx: Foxx API wrapper. """ diff --git a/arangoasync/foxx.py b/arangoasync/foxx.py index 0b068da..6432626 100644 --- a/arangoasync/foxx.py +++ b/arangoasync/foxx.py @@ -34,7 +34,11 @@ class Foxx: - """Foxx API wrapper.""" + """Foxx API wrapper. + + Warning: + Foxx microservice features are no longer available in ArangoDB 4.0. + """ def __init__(self, executor: ApiExecutor) -> None: self._executor = executor diff --git a/docs/foxx.rst b/docs/foxx.rst index 91e3423..4ce4a4e 100644 --- a/docs/foxx.rst +++ b/docs/foxx.rst @@ -1,6 +1,10 @@ Foxx ---- +.. warning:: + Foxx microservice features are no longer available in ArangoDB 4.0. + + **Foxx** is a microservice framework which lets you define custom HTTP endpoints that extend ArangoDB's REST API. For more information, refer to `ArangoDB Manual`_. From c883c371b11878b21209db0714e82e6f37b169eb Mon Sep 17 00:00:00 2001 From: Alex Petenchea Date: Mon, 1 Jun 2026 16:05:58 +0800 Subject: [PATCH 7/7] Deprecate more actions --- arangoasync/database.py | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/arangoasync/database.py b/arangoasync/database.py index 64b43f2..24796be 100644 --- a/arangoasync/database.py +++ b/arangoasync/database.py @@ -2944,6 +2944,9 @@ def response_handler(resp: Response) -> None: async def echo(self, body: Optional[Json] = None) -> Result[Json]: """Return an object with the servers request information. + Warning: + Request echoing is no longer available in ArangoDB 4.0. + Args: body (dict | None): Optional body of the request. @@ -2970,6 +2973,9 @@ def response_handler(resp: Response) -> Json: async def execute(self, command: str) -> Result[Any]: """Execute raw Javascript command on the server. + Warning: + Javascript command execution is no longer available in ArangoDB 4.0. + Args: command (str): Javascript command to execute.