Renamed argument "params" of query_extended() to "data_binding"

Released as new version 4.2.0
Upgraded neo4j library to 4.4.11

Author: BrainAnnex

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "neoaccess"
-version = "4.1.0"
+version = "4.2.0"
 authors = [
   { name = "Julian West BrainAnnex.org" },
 ]
@@ -21,7 +21,7 @@ classifiers = [
     "Operating System :: OS Independent",
 ]
 dependencies = [
-  "neo4j==4.3.9",
+  "neo4j==4.4.11",
   "numpy~=1.22.4",
   "pandas~=1.4.3",
 ]

requirements.txt

@@ -1,4 +1,4 @@
-neo4j==4.3.9
+neo4j==4.4.11
 numpy==1.22.4
 pandas==1.4.3
 

src/neoaccess/__init__.py

@@ -1,3 +1,3 @@
-__version__ = "4.2.0"       # IN_PROGRESS
+__version__ = "4.2.0"
 
 from .neoaccess import NeoAccess

src/neoaccess/neoaccess.py

@@ -315,8 +315,8 @@ def query(self, q: str, data_binding=None, single_row=False, single_cell="", sin
 
 
 
-    def query_extended(self, q: str, params = None, flatten = False, fields_to_exclude = None) -> [dict]:
-        """ # TODO: rename params to data_binding
+    def query_extended(self, q: str, data_binding = None, flatten = False, fields_to_exclude = None) -> [dict]:
+        """
         Extended version of query(), meant to extract additional info
         for queries that return Graph Data Types,
         i.e. nodes, relationships or paths,
@@ -336,7 +336,7 @@ def query_extended(self, q: str, params = None, flatten = False, fields_to_exclu
             Try running with flatten=True "MATCH (b:boat), (c:car) RETURN b, c" on data like "CREATE (b:boat), (c1:car1), (c2:car2)"
 
         :param q:       A Cypher query
-        :param params:  An optional Cypher dictionary
+        :param data_binding:  An optional Cypher dictionary
                             EXAMPLE, assuming that the cypher string contains the substring "$age":
                                         {'age': 20}
         :param flatten: Flag indicating whether the Graph Data Types need to remain clustered by record,
@@ -358,9 +358,9 @@ def query_extended(self, q: str, params = None, flatten = False, fields_to_exclu
         """
         # Start a new session, use it, and then immediately close it
         with self.driver.session() as new_session:
-            result = new_session.run(q, params)
+            result = new_session.run(q, data_binding)
             if self.profiling:
-                print("-- query_extended() PROFILING ----------\n", q, "\n", params)
+                print("-- query_extended() PROFILING ----------\n", q, "\n", data_binding)
 
             # Note: A neo4j.Result iterable object (printing it, shows an object of type "neo4j.work.result.Result")
             #       See https://neo4j.com/docs/api/python-driver/current/api.html#neo4j.Result
@@ -2213,7 +2213,7 @@ def get_siblings(self, internal_id: int, rel_name: str, rel_dir="OUT") -> [int]:
             raise Exception(f"get_siblings(): unknown value for the `rel_dir` argument ({rel_dir}); "
                             f"allowed values are 'IN' and 'OUT'")
 
-        result = self.query_extended(q, params={"internal_id": internal_id}, flatten=True)
+        result = self.query_extended(q, data_binding={"internal_id": internal_id}, flatten=True)
         return result
 
 
@@ -2258,9 +2258,9 @@ def get_label_properties(self, label:str) -> list:
             RETURN DISTINCT propertyName 
             ORDER BY propertyName
             """
-        params = {'label': label}
+        data_binding = {'label': label}
 
-        return [res['propertyName'] for res in self.query(q, params)]
+        return [res['propertyName'] for res in self.query(q, data_binding)]
 
 
 

tests/test_neoaccess.py

@@ -38,7 +38,7 @@ def test_construction():
     obj1 = neo_access.NeoAccess(url, debug=False)       # Rely on default username/pass
 
     assert obj1.debug is False
-    assert obj1.version() == "4.3.9"    # Test the version of the Neo4j driver (this ought to match the value in requirements.txt)
+    assert obj1.version() == "4.4.11"    # Test the version of the Neo4j driver (this ought to match the value in requirements.txt)
 
 
     # Another way of instantiating the class