pyneoinstance 4.0.1__tar.gz → 4.0.2__tar.gz

{pyneoinstance-4.0.1/pyneoinstance.egg-info → pyneoinstance-4.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyneoinstance
-Version: 4.0.1
+Version: 4.0.2
 Summary: Handle Neo4j read and write transactions and provide methods for performing graph EDA
 Author-email: "Jose A. Alvarado-Guzman" <jose.alvarado-guzman@neo4j.com>
 License: GNU GENERAL PUBLIC LICENSE
@@ -795,7 +795,7 @@ This YAML file can then be loaded in Python and this information can be retrieve
 ```python
 from pyneoinstance import load_yaml_file
 
-config = load_yaml_file(configuration.yaml)
+config = load_yaml_file('configuration.yaml')
 db_info = config['db_info']
 graph = Neo4jInstance(db_info['uri'], db_info['user'], db_info['password'])
 ```
@@ -1038,5 +1038,6 @@ Open `schema.html` in your browser to explore the schema interactively.
 ## More detailed examples
 
 For more detailed examples please refer to the following articles:
-* Data ingestion: [PyNeoInstance: A User-Friendly Python Library for Neo4j](https://medium.com/@a-gilmore/pyneoinstance-a-user-friendly-python-library-for-neo4j-dbefa3117bb2).
+* Data Ingestion: [PyNeoInstance: A User-Friendly Python Library for Neo4j](https://medium.com/@a-gilmore/pyneoinstance-a-user-friendly-python-library-for-neo4j-dbefa3117bb2).
 * Graph EDA: [Performing graph EDA with the PyNeoInstance Python Package](https://medium.com/@jose.alvarado-guzman/0c0f6f230aa9)
+* ETL Best Practices: [Python & Neo4j: ETL Best Practices](https://medium.com/@jose.alvarado-guzman/python-neo4j-etl-best-practices-83265ee201d6)

{pyneoinstance-4.0.1 → pyneoinstance-4.0.2}/README.md

@@ -93,7 +93,7 @@ This YAML file can then be loaded in Python and this information can be retrieve
 ```python
 from pyneoinstance import load_yaml_file
 
-config = load_yaml_file(configuration.yaml)
+config = load_yaml_file('configuration.yaml')
 db_info = config['db_info']
 graph = Neo4jInstance(db_info['uri'], db_info['user'], db_info['password'])
 ```
@@ -336,5 +336,6 @@ Open `schema.html` in your browser to explore the schema interactively.
 ## More detailed examples
 
 For more detailed examples please refer to the following articles:
-* Data ingestion: [PyNeoInstance: A User-Friendly Python Library for Neo4j](https://medium.com/@a-gilmore/pyneoinstance-a-user-friendly-python-library-for-neo4j-dbefa3117bb2).
+* Data Ingestion: [PyNeoInstance: A User-Friendly Python Library for Neo4j](https://medium.com/@a-gilmore/pyneoinstance-a-user-friendly-python-library-for-neo4j-dbefa3117bb2).
 * Graph EDA: [Performing graph EDA with the PyNeoInstance Python Package](https://medium.com/@jose.alvarado-guzman/0c0f6f230aa9)
+* ETL Best Practices: [Python & Neo4j: ETL Best Practices](https://medium.com/@jose.alvarado-guzman/python-neo4j-etl-best-practices-83265ee201d6)

{pyneoinstance-4.0.1 → pyneoinstance-4.0.2}/pyneoinstance/__init__.py

@@ -1,5 +1,5 @@
 from .database.neo4jdbms import Neo4jInstance
 from .fileload.loadyaml import load_yaml_file
 
-__version__ = '4.0.1'
+__version__ = '4.0.2'
 __all__ = ['Neo4jInstance', 'load_yaml_file']

{pyneoinstance-4.0.1 → pyneoinstance-4.0.2}/pyneoinstance/database/neo4jdbms.py

@@ -28,6 +28,7 @@ from .context import get_logger, get_batches, get_columns_diff
 
 _NODE_LABEL_RE = re.compile(r"\(:?(\w*)\)")
 _REL_TYPE_RE = re.compile(r"\[:?(\w*)\]")
+_IMPLICIT_TX_RE = re.compile(r"\bIN\s+TRANSACTIONS\b", re.IGNORECASE)
 
 def _get_driver(neo_info : Dict[str, str]):
     try:
@@ -750,15 +751,18 @@ class Neo4jInstance:
                        parameters: Optional[Dict[str, Any]] = None
                       ):
         params = parameters or {}
+        kwargs = dict(params)
+        if rows is not None:
+            kwargs['rows'] = rows
         try:
-            if rows is not None:
-                results = session.execute_write(
-                    _write_transaction_function, query,
-                    rows = rows, **params).counters.__dict__
+            if _IMPLICIT_TX_RE.search(query):
+                # 'CALL { ... } IN TRANSACTIONS' is only valid in an implicit
+                # (auto-commit) transaction, so it can't go through execute_write.
+                results = session.run(query, **kwargs).consume().counters.__dict__
             else:
                 results = session.execute_write(
                     _write_transaction_function, query,
-                    **params).counters.__dict__
+                    **kwargs).counters.__dict__
         except ServiceUnavailable as exception:
             raise ServiceUnavailable() from exception
         except ClientError as exception:

{pyneoinstance-4.0.1 → pyneoinstance-4.0.2/pyneoinstance.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyneoinstance
-Version: 4.0.1
+Version: 4.0.2
 Summary: Handle Neo4j read and write transactions and provide methods for performing graph EDA
 Author-email: "Jose A. Alvarado-Guzman" <jose.alvarado-guzman@neo4j.com>
 License: GNU GENERAL PUBLIC LICENSE
@@ -795,7 +795,7 @@ This YAML file can then be loaded in Python and this information can be retrieve
 ```python
 from pyneoinstance import load_yaml_file
 
-config = load_yaml_file(configuration.yaml)
+config = load_yaml_file('configuration.yaml')
 db_info = config['db_info']
 graph = Neo4jInstance(db_info['uri'], db_info['user'], db_info['password'])
 ```
@@ -1038,5 +1038,6 @@ Open `schema.html` in your browser to explore the schema interactively.
 ## More detailed examples
 
 For more detailed examples please refer to the following articles:
-* Data ingestion: [PyNeoInstance: A User-Friendly Python Library for Neo4j](https://medium.com/@a-gilmore/pyneoinstance-a-user-friendly-python-library-for-neo4j-dbefa3117bb2).
+* Data Ingestion: [PyNeoInstance: A User-Friendly Python Library for Neo4j](https://medium.com/@a-gilmore/pyneoinstance-a-user-friendly-python-library-for-neo4j-dbefa3117bb2).
 * Graph EDA: [Performing graph EDA with the PyNeoInstance Python Package](https://medium.com/@jose.alvarado-guzman/0c0f6f230aa9)
+* ETL Best Practices: [Python & Neo4j: ETL Best Practices](https://medium.com/@jose.alvarado-guzman/python-neo4j-etl-best-practices-83265ee201d6)

{pyneoinstance-4.0.1 → pyneoinstance-4.0.2}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyneoinstance"
-version = "4.0.1"
+version = "4.0.2"
 description = "Handle Neo4j read and write transactions and provide methods for performing graph EDA"
 readme = "README.md"
 authors = [{ name = "Jose A. Alvarado-Guzman",email = "jose.alvarado-guzman@neo4j.com" }]

{pyneoinstance-4.0.1 → pyneoinstance-4.0.2}/test/test_neo4jdb.py

@@ -97,6 +97,20 @@ class TestWriteMethods(unittest.TestCase):
         self.assertEqual(
             {'nodes_created': 1, 'labels_added': 2, 'properties_set': 4}, result)
 
+    def test_execute_write_query_in_transactions(self):
+        """Test a query with 'CALL { ... } IN TRANSACTIONS', which requires
+        an implicit transaction rather than the managed transaction used by
+        execute_write_query for regular queries."""
+        query = """
+            UNWIND range(1, 3) AS i
+            CALL (i) {
+                CREATE (:Actor {id: i})
+            } IN TRANSACTIONS OF 1 ROWS
+        """
+        result = self.graph.execute_write_query(query, self.db)
+        self.assertEqual(
+            {'nodes_created': 3, 'labels_added': 3, 'properties_set': 3}, result)
+
 
 class TestReadAndEdaMethods(unittest.TestCase):
     """Test read and EDA methods. Data is loaded once for the entire class."""