Add examples for configuring transactions (#550) (#552)

* Add examples for configuring transactions

Co-authored-by: Robsdedude <[email protected]>

Author: gjmwoods

tests/integration/examples/test_transaction_metadata_config_example.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python
+# -*- encoding: utf-8 -*-
+
+# Copyright (c) "Neo4j"
+# Neo4j Sweden AB [http://neo4j.com]
+#
+# This file is part of Neo4j.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from neo4j import unit_of_work, Query
+
+
+# python -m pytest tests/integration/examples/test_transaction_metadata_config_example.py -s -v
+
+# tag::transaction-metadata-config[]
+@unit_of_work(timeout=5, metadata={"applicationId": "123"})
+def create_person(tx, name):
+    return tx.run(
+        "CREATE (a:Person {name: $name}) RETURN id(a)", name=name
+    ).single().value()
+
+
+def add_person(driver, name):
+    with driver.session() as session:
+        return session.write_transaction(create_person, name)
+# end::transaction-metadata-config[]
+
+
+class TransactionMetadataConfigExample:
+
+    def __init__(self, driver):
+        self.driver = driver
+
+    def add_person(self, name):
+        return add_person(self.driver, name)
+
+
+def test_example(bolt_driver):
+    eg = TransactionMetadataConfigExample(bolt_driver)
+    with eg.driver.session() as session:
+        session.run("MATCH (_) DETACH DELETE _")
+        eg.add_person("Alice")
+        n = session.run("MATCH (a:Person) RETURN count(a)").single().value()
+        assert n == 1

tests/integration/examples/test_transaction_timeout_config_example.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python
+# -*- encoding: utf-8 -*-
+
+# Copyright (c) "Neo4j"
+# Neo4j Sweden AB [http://neo4j.com]
+#
+# This file is part of Neo4j.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from neo4j import unit_of_work, Query
+
+
+# python -m pytest tests/integration/examples/test_transaction_timeout_config_example.py -s -v
+
+# tag::transaction-timeout-config[]
+@unit_of_work(timeout=5)
+def create_person(tx, name):
+    return tx.run(
+        "CREATE (a:Person {name: $name}) RETURN id(a)", name=name
+    ).single().value()
+
+
+def add_person(driver, name):
+    with driver.session() as session:
+        return session.write_transaction(create_person, name)
+# end::transaction-timeout-config[]
+
+
+class TransactionTimeoutConfigExample:
+
+    def __init__(self, driver):
+        self.driver = driver
+
+    def add_person(self, name):
+        return add_person(self.driver, name)
+
+
+def test_example(bolt_driver):
+    eg = TransactionTimeoutConfigExample(bolt_driver)
+    with eg.driver.session() as session:
+        session.run("MATCH (_) DETACH DELETE _")
+        eg.add_person("Alice")
+        n = session.run("MATCH (a:Person) RETURN count(a)").single().value()
+        assert n == 1