python-arango-async 0.0.3__tar.gz → 0.0.5__tar.gz

{python_arango_async-0.0.3 → python_arango_async-0.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-arango-async
-Version: 0.0.3
+Version: 0.0.5
 Summary: Async Python Driver for ArangoDB
 Author-email: Alexandru Petenchea <alexandru.petenchea@arangodb.com>, Anthony Mahanna <anthony.mahanna@arangodb.com>
 Maintainer-email: Alexandru Petenchea <alexandru.petenchea@arangodb.com>, Anthony Mahanna <anthony.mahanna@arangodb.com>
@@ -39,7 +39,7 @@ Requires-Dist: sphinx_rtd_theme>=2.0; extra == "dev"
 Requires-Dist: types-setuptools; extra == "dev"
 Dynamic: license-file
 
-![Logo](docs/static/logo.png)
+![Logo](https://raw.githubusercontent.com/arangodb/python-arango-async/refs/heads/main/docs/static/logo.png)
 
 [![CircleCI](https://dl.circleci.com/status-badge/img/gh/arangodb/python-arango-async/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/arangodb/python-arango-async/tree/main)
 [![CodeQL](https://github.com/arangodb/python-arango-async/actions/workflows/codeql.yaml/badge.svg)](https://github.com/arangodb/python-arango-async/actions/workflows/codeql.yaml)
@@ -114,7 +114,67 @@ async def main():
             student_names = []
             async for doc in cursor:
                 student_names.append(doc["name"])
+```
+
+Another example with [graphs](https://docs.arangodb.com/stable/graphs/):
 
+```python
+async def main():
+    from arangoasync import ArangoClient
+    from arangoasync.auth import Auth
+
+    # Initialize the client for ArangoDB.
+    async with ArangoClient(hosts="http://localhost:8529") as client:
+        auth = Auth(username="root", password="passwd")
+
+        # Connect to "test" database as root user.
+        db = await client.db("test", auth=auth)
+
+        # Get the API wrapper for graph "school".
+        if await db.has_graph("school"):
+            graph = db.graph("school")
+        else:
+            graph = await db.create_graph("school")
+
+        # Create vertex collections for the graph.
+        students = await graph.create_vertex_collection("students")
+        lectures = await graph.create_vertex_collection("lectures")
+
+        # Create an edge definition (relation) for the graph.
+        edges = await graph.create_edge_definition(
+            edge_collection="register",
+            from_vertex_collections=["students"],
+            to_vertex_collections=["lectures"]
+        )
+
+        # Insert vertex documents into "students" (from) vertex collection.
+        await students.insert({"_key": "01", "full_name": "Anna Smith"})
+        await students.insert({"_key": "02", "full_name": "Jake Clark"})
+        await students.insert({"_key": "03", "full_name": "Lisa Jones"})
+
+        # Insert vertex documents into "lectures" (to) vertex collection.
+        await lectures.insert({"_key": "MAT101", "title": "Calculus"})
+        await lectures.insert({"_key": "STA101", "title": "Statistics"})
+        await lectures.insert({"_key": "CSC101", "title": "Algorithms"})
+
+        # Insert edge documents into "register" edge collection.
+        await edges.insert({"_from": "students/01", "_to": "lectures/MAT101"})
+        await edges.insert({"_from": "students/01", "_to": "lectures/STA101"})
+        await edges.insert({"_from": "students/01", "_to": "lectures/CSC101"})
+        await edges.insert({"_from": "students/02", "_to": "lectures/MAT101"})
+        await edges.insert({"_from": "students/02", "_to": "lectures/STA101"})
+        await edges.insert({"_from": "students/03", "_to": "lectures/CSC101"})
+
+        # Traverse the graph in outbound direction, breath-first.
+        query = """
+            FOR v, e, p IN 1..3 OUTBOUND 'students/01' GRAPH 'school'
+            OPTIONS { bfs: true, uniqueVertices: 'global' }
+            RETURN {vertex: v, edge: e, path: p}
+            """
+
+        async with await db.aql.execute(query) as cursor:
+            async for doc in cursor:
+                print(doc)
 ```
 
 Please see the [documentation](https://python-arango-async.readthedocs.io/en/latest/) for more details.

{python_arango_async-0.0.3 → python_arango_async-0.0.5}/README.md

@@ -1,4 +1,4 @@
-![Logo](docs/static/logo.png)
+![Logo](https://raw.githubusercontent.com/arangodb/python-arango-async/refs/heads/main/docs/static/logo.png)
 
 [![CircleCI](https://dl.circleci.com/status-badge/img/gh/arangodb/python-arango-async/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/arangodb/python-arango-async/tree/main)
 [![CodeQL](https://github.com/arangodb/python-arango-async/actions/workflows/codeql.yaml/badge.svg)](https://github.com/arangodb/python-arango-async/actions/workflows/codeql.yaml)
@@ -73,7 +73,67 @@ async def main():
             student_names = []
             async for doc in cursor:
                 student_names.append(doc["name"])
+```
+
+Another example with [graphs](https://docs.arangodb.com/stable/graphs/):
 
+```python
+async def main():
+    from arangoasync import ArangoClient
+    from arangoasync.auth import Auth
+
+    # Initialize the client for ArangoDB.
+    async with ArangoClient(hosts="http://localhost:8529") as client:
+        auth = Auth(username="root", password="passwd")
+
+        # Connect to "test" database as root user.
+        db = await client.db("test", auth=auth)
+
+        # Get the API wrapper for graph "school".
+        if await db.has_graph("school"):
+            graph = db.graph("school")
+        else:
+            graph = await db.create_graph("school")
+
+        # Create vertex collections for the graph.
+        students = await graph.create_vertex_collection("students")
+        lectures = await graph.create_vertex_collection("lectures")
+
+        # Create an edge definition (relation) for the graph.
+        edges = await graph.create_edge_definition(
+            edge_collection="register",
+            from_vertex_collections=["students"],
+            to_vertex_collections=["lectures"]
+        )
+
+        # Insert vertex documents into "students" (from) vertex collection.
+        await students.insert({"_key": "01", "full_name": "Anna Smith"})
+        await students.insert({"_key": "02", "full_name": "Jake Clark"})
+        await students.insert({"_key": "03", "full_name": "Lisa Jones"})
+
+        # Insert vertex documents into "lectures" (to) vertex collection.
+        await lectures.insert({"_key": "MAT101", "title": "Calculus"})
+        await lectures.insert({"_key": "STA101", "title": "Statistics"})
+        await lectures.insert({"_key": "CSC101", "title": "Algorithms"})
+
+        # Insert edge documents into "register" edge collection.
+        await edges.insert({"_from": "students/01", "_to": "lectures/MAT101"})
+        await edges.insert({"_from": "students/01", "_to": "lectures/STA101"})
+        await edges.insert({"_from": "students/01", "_to": "lectures/CSC101"})
+        await edges.insert({"_from": "students/02", "_to": "lectures/MAT101"})
+        await edges.insert({"_from": "students/02", "_to": "lectures/STA101"})
+        await edges.insert({"_from": "students/03", "_to": "lectures/CSC101"})
+
+        # Traverse the graph in outbound direction, breath-first.
+        query = """
+            FOR v, e, p IN 1..3 OUTBOUND 'students/01' GRAPH 'school'
+            OPTIONS { bfs: true, uniqueVertices: 'global' }
+            RETURN {vertex: v, edge: e, path: p}
+            """
+
+        async with await db.aql.execute(query) as cursor:
+            async for doc in cursor:
+                print(doc)
 ```
 
 Please see the [documentation](https://python-arango-async.readthedocs.io/en/latest/) for more details.

{python_arango_async-0.0.3 → python_arango_async-0.0.5}/arangoasync/aql.py

@@ -597,7 +597,7 @@ class AQL:
         def response_handler(resp: Response) -> Json:
             if not resp.is_success:
                 raise AQLQueryExplainError(resp, request)
-            return self.deserializer.loads(resp.raw_body)
+            return Response.format_body(self.deserializer.loads(resp.raw_body))
 
         return await self._executor.execute(request, response_handler)
 
@@ -625,7 +625,7 @@ class AQL:
         def response_handler(resp: Response) -> Json:
             if not resp.is_success:
                 raise AQLQueryValidateError(resp, request)
-            return self.deserializer.loads(resp.raw_body)
+            return Response.format_body(self.deserializer.loads(resp.raw_body))
 
         return await self._executor.execute(request, response_handler)
 
@@ -719,7 +719,7 @@ class AQL:
         def response_handler(resp: Response) -> Json:
             if not resp.is_success:
                 raise AQLFunctionCreateError(resp, request)
-            return self.deserializer.loads(resp.raw_body)
+            return Response.format_body(self.deserializer.loads(resp.raw_body))
 
         return await self._executor.execute(request, response_handler)
 
@@ -760,6 +760,6 @@ class AQL:
             if not resp.is_success:
                 if not (resp.status_code == HTTP_NOT_FOUND and ignore_missing):
                     raise AQLFunctionDeleteError(resp, request)
-            return self.deserializer.loads(resp.raw_body)
+            return Response.format_body(self.deserializer.loads(resp.raw_body))
 
         return await self._executor.execute(request, response_handler)