cypher-graphdb 0.7.2__tar.gz → 0.8.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (344) hide show
  1. cypher_graphdb-0.8.0/CHANGELOG.md +55 -0
  2. {cypher_graphdb-0.7.2/src/cypher_graphdb.egg-info → cypher_graphdb-0.8.0}/PKG-INFO +7 -4
  3. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/README.md +3 -2
  4. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/Taskfile.yml +17 -0
  5. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/bulk-and-indexes.md +47 -3
  6. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/connecting.md +36 -6
  7. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/getting-started.md +1 -1
  8. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/index.md +1 -1
  9. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/queries.md +18 -0
  10. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/pyproject.toml +4 -1
  11. cypher_graphdb-0.8.0/scripts/bench_bolt.py +60 -0
  12. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/__init__.py +3 -1
  13. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backend.py +125 -9
  14. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agebulkwriter.py +198 -40
  15. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agegraphdb.py +123 -23
  16. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/ageserializer.py +8 -4
  17. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agesqlbuilder.py +64 -36
  18. cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/__init__.py +13 -0
  19. cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/backend.py +387 -0
  20. cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/neo4j_transport.py +178 -0
  21. cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/pymgclient_transport.py +166 -0
  22. cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/transport.py +80 -0
  23. cypher_graphdb-0.8.0/src/cypher_graphdb/backends/memgraph/memgraphdb.py +70 -0
  24. cypher_graphdb-0.8.0/src/cypher_graphdb/backends/neo4j/__init__.py +9 -0
  25. cypher_graphdb-0.8.0/src/cypher_graphdb/backends/neo4j/neo4jdb.py +74 -0
  26. cypher_graphdb-0.8.0/src/cypher_graphdb/bulk_refs.py +85 -0
  27. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/_host.py +3 -0
  28. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/cyphergraphdb.py +56 -13
  29. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/indexing.py +157 -9
  30. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/pagination_mixin.py +14 -8
  31. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/stream_mixin.py +3 -2
  32. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherparser.py +52 -4
  33. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/exceptions.py +35 -1
  34. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/schema/core.py +5 -3
  35. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/settings.py +7 -6
  36. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/connection_utils.py +5 -1
  37. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0/src/cypher_graphdb.egg-info}/PKG-INFO +7 -4
  38. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/SOURCES.txt +12 -1
  39. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/requires.txt +3 -1
  40. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/scm_file_list.json +12 -1
  41. cypher_graphdb-0.8.0/src/cypher_graphdb.egg-info/scm_version.json +8 -0
  42. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/conftest.py +57 -2
  43. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_basic_operations.py +31 -21
  44. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_create_or_merge.py +1 -1
  45. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_cypher_query_builder.py +11 -11
  46. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_cypher_query_writes.py +6 -6
  47. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_example.py +3 -3
  48. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_expand.py +6 -6
  49. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_indexes_and_bulk.py +557 -43
  50. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_mass_delete.py +11 -11
  51. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_parameters.py +12 -12
  52. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_query_execution_error.py +4 -4
  53. cypher_graphdb-0.8.0/tests/integration/test_query_timeouts.py +64 -0
  54. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_read_only_mode.py +1 -1
  55. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_streaming.py +13 -6
  56. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_age_serializer.py +10 -3
  57. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_age_sqlbuilder.py +54 -0
  58. cypher_graphdb-0.8.0/tests/unit/test_bulk_refs.py +85 -0
  59. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherparser.py +10 -0
  60. cypher_graphdb-0.8.0/tests/unit/test_max_path_length.py +64 -0
  61. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_model_inheritance.py +17 -0
  62. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_query_execution_error.py +34 -2
  63. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_query_timeout.py +34 -23
  64. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_settings.py +2 -2
  65. cypher_graphdb-0.8.0/uv.lock +1602 -0
  66. cypher_graphdb-0.7.2/CHANGELOG.md +0 -19
  67. cypher_graphdb-0.7.2/src/cypher_graphdb/backends/memgraph/memgraphdb.py +0 -850
  68. cypher_graphdb-0.7.2/src/cypher_graphdb/backends/memgraph/memgraphrowfactories.py +0 -235
  69. cypher_graphdb-0.7.2/src/cypher_graphdb.egg-info/scm_version.json +0 -8
  70. cypher_graphdb-0.7.2/uv.lock +0 -1356
  71. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.env.age.example +0 -0
  72. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.env.example +0 -0
  73. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.env.memgraph.example +0 -0
  74. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.github/workflows/audit.yml +0 -0
  75. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.github/workflows/ci.yml +0 -0
  76. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.github/workflows/publish.yml +0 -0
  77. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.github/workflows/release.yml +0 -0
  78. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.gitignore +0 -0
  79. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.pre-commit-config.yaml +0 -0
  80. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/AGENTS.md +0 -0
  81. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/CONTRIBUTING.md +0 -0
  82. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/ENGINEERING-STANDARDS.md +0 -0
  83. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/LICENSE.md +0 -0
  84. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/NOTICE +0 -0
  85. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/README.md +0 -0
  86. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/adr/0001-explicit-model-providers.md +0 -0
  87. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/adr/index.md +0 -0
  88. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/cli-prompt-parsing.md +0 -0
  89. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/duckdb-migration.md +0 -0
  90. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/falkordb-integration.md +0 -0
  91. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/fluent-cypher-query-builder.md +0 -0
  92. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/format-registry.md +0 -0
  93. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/hierarchical-export-format.md +0 -0
  94. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/index.md +0 -0
  95. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/model-provider-isolation.md +0 -0
  96. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/model-provider-label-collision.md +0 -0
  97. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/multiple-statement-execution.md +0 -0
  98. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/packaging-and-extras.md +0 -0
  99. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/parameterized-queries-for-typed-models.md +0 -0
  100. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/query-result-immutable-design.md +0 -0
  101. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/read-only-mode.md +0 -0
  102. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/stateless-multi-graph-support.md +0 -0
  103. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/cli.md +0 -0
  104. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/import-export.md +0 -0
  105. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/typed-models.md +0 -0
  106. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/scripts/release.config.sh +0 -0
  107. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/scripts/release.sh +0 -0
  108. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/scripts/verify.sh +0 -0
  109. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/setup.cfg +0 -0
  110. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/__main__.py +0 -0
  111. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/_extras.py +0 -0
  112. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/args.py +0 -0
  113. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backendprovider.py +0 -0
  114. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/__init__.py +0 -0
  115. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/__init__.py +0 -0
  116. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agerowfactories.py +0 -0
  117. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agesearch.py +0 -0
  118. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agtype.py +0 -0
  119. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agtype_parser.py +0 -0
  120. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/memgraph/__init__.py +0 -0
  121. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cardinality.py +0 -0
  122. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/__init__.py +0 -0
  123. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/app.py +0 -0
  124. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/banner.py +0 -0
  125. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/command_manager.py +0 -0
  126. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/command_map.py +0 -0
  127. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/command_registry.py +0 -0
  128. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commandposition.py +0 -0
  129. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/__init__.py +0 -0
  130. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/add_graph_command.py +0 -0
  131. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/apply_config_command.py +0 -0
  132. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/base_command.py +0 -0
  133. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/clear_graph_command.py +0 -0
  134. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/commit_command.py +0 -0
  135. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/connect_command.py +0 -0
  136. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/create_edge_command.py +0 -0
  137. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/create_graph_command.py +0 -0
  138. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/create_linked_node_command.py +0 -0
  139. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/create_node_command.py +0 -0
  140. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/delete_graphobj_command.py +0 -0
  141. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/disconnect_command.py +0 -0
  142. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/drop_graph_command.py +0 -0
  143. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_backends_command.py +0 -0
  144. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_graphs_command.py +0 -0
  145. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_indexes_command.py +0 -0
  146. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_labels_command.py +0 -0
  147. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_models_command.py +0 -0
  148. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_parsed_query_command.py +0 -0
  149. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_schema_command.py +0 -0
  150. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_statistics_command.py +0 -0
  151. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/execute_cypher_command.py +0 -0
  152. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/execute_file_command.py +0 -0
  153. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/exit_command.py +0 -0
  154. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/export_graph_command.py +0 -0
  155. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/fetch_all_command.py +0 -0
  156. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/fetch_edges_command.py +0 -0
  157. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/fetch_nodes_command.py +0 -0
  158. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/format_output_command.py +0 -0
  159. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/get_command.py +0 -0
  160. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/gid_command.py +0 -0
  161. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/graph_exists_command.py +0 -0
  162. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/graph_op_command.py +0 -0
  163. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/graph_to_tree_command.py +0 -0
  164. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/help_command.py +0 -0
  165. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/import_graph_command.py +0 -0
  166. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/last_result_op_command.py +0 -0
  167. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/load_models_command.py +0 -0
  168. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/resolve_edges_command.py +0 -0
  169. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/rollback_command.py +0 -0
  170. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/search_command.py +0 -0
  171. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/set_command.py +0 -0
  172. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/sql_command.py +0 -0
  173. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/update_graphobj_command.py +0 -0
  174. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/use_graph_command.py +0 -0
  175. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/completer.py +0 -0
  176. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/config.py +0 -0
  177. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/exporter.py +0 -0
  178. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/file_executor.py +0 -0
  179. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/graphdata.py +0 -0
  180. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/graphdb.py +0 -0
  181. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/_overview.md +0 -0
  182. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/_template.md +0 -0
  183. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/add_graph.md +0 -0
  184. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/exit.md +0 -0
  185. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/export_graph.md +0 -0
  186. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/import_graph.md +0 -0
  187. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/last_result.md +0 -0
  188. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help.py +0 -0
  189. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/importer.py +0 -0
  190. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/prompt.py +0 -0
  191. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/promptgrammar.py +0 -0
  192. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/promptparser.py +0 -0
  193. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/provider.py +0 -0
  194. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/renderer.py +0 -0
  195. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/runtime.py +0 -0
  196. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/schema_cmd.py +0 -0
  197. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/settings.py +0 -0
  198. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/command_reader.py +0 -0
  199. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/config.py +0 -0
  200. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/connection_guard.py +0 -0
  201. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/Cypher.interp +0 -0
  202. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/Cypher.tokens +0 -0
  203. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherBaseListener.java +0 -0
  204. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherLexer.interp +0 -0
  205. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherLexer.java +0 -0
  206. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherLexer.tokens +0 -0
  207. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherListener.java +0 -0
  208. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherParser.java +0 -0
  209. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/Cypher.g4 +0 -0
  210. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/Cypher.interp +0 -0
  211. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/Cypher.tokens +0 -0
  212. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherLexer.interp +0 -0
  213. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherLexer.py +0 -0
  214. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherLexer.tokens +0 -0
  215. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherListener.py +0 -0
  216. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherParser.py +0 -0
  217. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/__init__.py +0 -0
  218. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherbuilder.py +0 -0
  219. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/__init__.py +0 -0
  220. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/batch.py +0 -0
  221. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/bulk_normalize.py +0 -0
  222. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/connection.py +0 -0
  223. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/criteria.py +0 -0
  224. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/expand.py +0 -0
  225. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/pagination.py +0 -0
  226. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/result.py +0 -0
  227. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/schema.py +0 -0
  228. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/search.py +0 -0
  229. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/sql.py +0 -0
  230. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherjson.py +0 -0
  231. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherquery/__init__.py +0 -0
  232. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherquery/builder.py +0 -0
  233. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherquery/params.py +0 -0
  234. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherquery/patterns.py +0 -0
  235. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/dbpool.py +0 -0
  236. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/display.py +0 -0
  237. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/formatprovider.py +0 -0
  238. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/graphops.py +0 -0
  239. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/main.py +0 -0
  240. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/modelinfo.py +0 -0
  241. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/modelprovider.py +0 -0
  242. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/modelrelations.py +0 -0
  243. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/models.py +0 -0
  244. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/options.py +0 -0
  245. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/py.typed +0 -0
  246. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/schema/__init__.py +0 -0
  247. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/schema/converter.py +0 -0
  248. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/schema/generator.py +0 -0
  249. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/statistics.py +0 -0
  250. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/__init__.py +0 -0
  251. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/base_exporter.py +0 -0
  252. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/base_importer.py +0 -0
  253. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/csv_exporter.py +0 -0
  254. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/csv_importer.py +0 -0
  255. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/csv_source.py +0 -0
  256. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/data_flattener.py +0 -0
  257. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/excel_exporter.py +0 -0
  258. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/excel_importer.py +0 -0
  259. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/excel_row_source.py +0 -0
  260. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/file_exporter.py +0 -0
  261. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/file_importer.py +0 -0
  262. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/__init__.py +0 -0
  263. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/csv.py +0 -0
  264. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/excel.py +0 -0
  265. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/json.py +0 -0
  266. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/yaml.py +0 -0
  267. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/hierarchical_exporter.py +0 -0
  268. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/hierarchical_importer.py +0 -0
  269. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/hierarchical_row_source.py +0 -0
  270. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/json_importer.py +0 -0
  271. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/json_yaml_data_source.py +0 -0
  272. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/row_collector.py +0 -0
  273. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/row_set.py +0 -0
  274. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/row_source.py +0 -0
  275. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/tabular_importer.py +0 -0
  276. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/yaml_importer.py +0 -0
  277. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/__init__.py +0 -0
  278. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/collection_utils.py +0 -0
  279. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/column_utils.py +0 -0
  280. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/conversion_utils.py +0 -0
  281. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/core_utils.py +0 -0
  282. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/schema_merge.py +0 -0
  283. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/schema_to_llm.py +0 -0
  284. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/schema_utils.py +0 -0
  285. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/settings_repr.py +0 -0
  286. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/string_utils.py +0 -0
  287. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/dependency_links.txt +0 -0
  288. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/entry_points.txt +0 -0
  289. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/top_level.txt +0 -0
  290. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/README.md +0 -0
  291. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/conftest.py +0 -0
  292. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/__init__.py +0 -0
  293. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_pagination.py +0 -0
  294. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/README.md +0 -0
  295. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/__init__.py +0 -0
  296. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/__init__.py +0 -0
  297. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/test_cmd_map.py +0 -0
  298. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/test_command_registry.py +0 -0
  299. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/test_promptgrammar.py +0 -0
  300. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/test_promptparser.py +0 -0
  301. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/mock_backend.py +0 -0
  302. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_agtype_parser.py +0 -0
  303. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_backend_capabilities.py +0 -0
  304. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_bulk_normalize.py +0 -0
  305. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_column_utils.py +0 -0
  306. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_command_reader.py +0 -0
  307. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_connection_guard.py +0 -0
  308. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherbuilder.py +0 -0
  309. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherquery.py +0 -0
  310. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherquery_facade.py +0 -0
  311. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherquery_patterns.py +0 -0
  312. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_dbpool.py +0 -0
  313. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_dict_access_mixin.py +0 -0
  314. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_expand.py +0 -0
  315. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_extend_relation_decorator.py +0 -0
  316. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_extend_relations.py +0 -0
  317. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_formatprovider.py +0 -0
  318. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_graph_id_zero.py +0 -0
  319. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_graphops.py +0 -0
  320. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_indexing.py +0 -0
  321. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_json_schema_loading.py +0 -0
  322. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_json_schema_vs_decorators.py +0 -0
  323. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_modelinfo.py +0 -0
  324. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_modelprovider_loading.py +0 -0
  325. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_modelprovider_schemas.py +0 -0
  326. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_models.py +0 -0
  327. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_pagination.py +0 -0
  328. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_prepared_statement_recovery.py +0 -0
  329. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_schema_converter.py +0 -0
  330. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/__init__.py +0 -0
  331. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_data_flattener.py +0 -0
  332. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_exporters.py +0 -0
  333. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_hierarchical_importer.py +0 -0
  334. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_json_yaml_data_source.py +0 -0
  335. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_resource_management.py +0 -0
  336. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_tabular_import.py +0 -0
  337. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_collection_utils.py +0 -0
  338. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_connection_utils.py +0 -0
  339. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_conversion_utils.py +0 -0
  340. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_core_utils.py +0 -0
  341. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_schema_merge.py +0 -0
  342. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_schema_utils.py +0 -0
  343. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_settings_repr.py +0 -0
  344. {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_string_utils.py +0 -0
@@ -0,0 +1,55 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ## [0.8.0] - 2026-11-08
11
+
12
+ ### Added
13
+ - Neo4j backend (`backend="neo4j"`): the graph name selects the database; named range indexes.
14
+ - Query timeouts per statement: `execute(..., timeout_s=)`, `execute_with_stats(..., timeout_s=)` and
15
+ `with db.query_timeout(...)` override the connection's default; a cancelled query raises
16
+ `QueryTimeoutError` (a `QueryExecutionError`) on every backend. Memgraph through pymgclient cannot
17
+ apply one per statement and logs a warning.
18
+ - Path length limits: the parser reports a query's longest path (`ParsedCypherQuery.max_path_length`,
19
+ None when unbounded); `execute`, `execute_with_stats` and `execute_cypher_page` take `max_path_length=`
20
+ and reject a longer query with `PathLengthExceededError` before it runs (no limit by default).
21
+ - Batched bulk deletes: `bulk_delete_nodes(..., batch_size=)` and `bulk_delete_orphans(..., batch_size=)`
22
+ delete in statements of at most that many nodes and their edges, each committed: on Memgraph and Neo4j
23
+ their recommendation for large deletes (memory stays flat), on AGE short transactions in SQL (brief row
24
+ locks, vacuum not held back, edges deleted through the start_id/end_id indexes). Each statement stays
25
+ far below a statement timeout. Without it, one statement as before.
26
+ - `bulk_delete_edges` and `bulk_update_nodes`, with a direct SQL delete path on AGE.
27
+
28
+ ### Changed
29
+ - Memgraph and the new Neo4j backend share a Bolt foundation (`backends/bolt`): each is a dialect on it.
30
+ Bolt goes through a transport chosen by the connection: for Memgraph pymgclient (default; faster on
31
+ large reads) or the Neo4j Python driver with `neo4j-rust-ext` (`?transport=neo4j`; per-transaction
32
+ timeouts, metadata, pooling, cluster routing); Neo4j always through the Neo4j driver. Each transport
33
+ turns its values into cypher-graphdb objects in one pass. pymgclient now runs in auto-commit mode when
34
+ the connection does (no BEGIN/COMMIT round trips per statement).
35
+ - The default query timeout (`query_timeout_s`) is 600 s instead of 30 s; with the Neo4j driver it is
36
+ sent per transaction instead of as Memgraph's server-wide setting.
37
+ - AGE: with autocommit, a failed statement is rolled back, so the connection is usable for the next.
38
+
39
+ ### Fixed
40
+ - AGE: graphids are looked up with one `ANY` condition per key property instead of a per-tuple `OR`
41
+ chain, which made composite-key edge writes take seconds per batch.
42
+ - AGE: the session setup is committed, so a rollback after a reconnect keeps `ag_catalog` on the
43
+ search path.
44
+ - An undecorated base class is no longer treated as a parent in a model's schema (it raised
45
+ `AttributeError`).
46
+ - A paged (`execute_cypher_page`) or streamed (`execute_cypher_stream`) query that the database refuses
47
+ raises `QueryExecutionError` (`QueryTimeoutError` when cancelled), the driver's error its cause -- as a
48
+ whole query always did. The native paths let the backend's own exception through (AGE's
49
+ `AGEExecutionError`, Memgraph's and Neo4j's driver errors), which a caller catching the library's types
50
+ did not catch.
51
+ - The parser no longer trips an assert on a pattern outside a clause, such as a pattern comprehension
52
+ in `RETURN`.
53
+
54
+ [Unreleased]: https://github.com/petrarca/cypher-graphdb-core/compare/v0.8.0...HEAD
55
+ [0.8.0]: https://github.com/petrarca/cypher-graphdb-core/compare/v0.7.3...v0.8.0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: cypher_graphdb
3
- Version: 0.7.2
3
+ Version: 0.8.0
4
4
  Summary: ORM like library and CLI for cypher query language supporting graph databases.
5
5
  Author-email: Wolfgang Miller <wolfgang.miller@petrarca-labs.com>
6
6
  License-Expression: Apache-2.0
@@ -19,7 +19,9 @@ Requires-Dist: pydantic-settings>=2.13.1
19
19
  Requires-Dist: loguru
20
20
  Requires-Dist: psycopg>=3.3.3
21
21
  Requires-Dist: psycopg-binary>=3.3.3
22
- Requires-Dist: pymgclient
22
+ Requires-Dist: pymgclient>=1.6
23
+ Requires-Dist: neo4j>=6.4.1
24
+ Requires-Dist: neo4j-rust-ext>=6.4.1
23
25
  Requires-Dist: typing-extensions
24
26
  Requires-Dist: tenacity
25
27
  Requires-Dist: json-schema-to-pydantic>=0.4.11
@@ -78,8 +80,9 @@ do not exist**.
78
80
  importing a module has no process-wide effect and two graphs can use the same
79
81
  label for different things.
80
82
 
81
- 4. **Built for bulk.** `bulk_create_nodes` / `bulk_create_edges` batch through
82
- `UNWIND` (or a direct SQL path), and property indexing is first-class —
83
+ 4. **Built for bulk.** `bulk_create_nodes` / `bulk_create_edges`,
84
+ `bulk_update_nodes` and `bulk_delete_edges` batch through `UNWIND` (or a
85
+ direct SQL path), and property indexing is first-class —
83
86
  because a graph load that ignores indexes is a graph load that never
84
87
  finishes.
85
88
 
@@ -26,8 +26,9 @@ do not exist**.
26
26
  importing a module has no process-wide effect and two graphs can use the same
27
27
  label for different things.
28
28
 
29
- 4. **Built for bulk.** `bulk_create_nodes` / `bulk_create_edges` batch through
30
- `UNWIND` (or a direct SQL path), and property indexing is first-class —
29
+ 4. **Built for bulk.** `bulk_create_nodes` / `bulk_create_edges`,
30
+ `bulk_update_nodes` and `bulk_delete_edges` batch through `UNWIND` (or a
31
+ direct SQL path), and property indexing is first-class —
31
32
  because a graph load that ignores indexes is a graph load that never
32
33
  finishes.
33
34
 
@@ -123,6 +123,23 @@ tasks:
123
123
  cmds:
124
124
  - .venv/bin/pytest -m integration_memgraph
125
125
 
126
+ test:integration:neo4j:
127
+ desc: "Run the integration tests for the Neo4j backend only"
128
+ cmds:
129
+ - .venv/bin/pytest -m integration_neo4j
130
+
131
+ test:integration:memgraph-neo4j:
132
+ desc: "Run the Memgraph integration tests through the Neo4j driver transport"
133
+ env:
134
+ CGDB_MEMGRAPH_TRANSPORT: neo4j
135
+ cmds:
136
+ - .venv/bin/pytest -m integration_memgraph
137
+
138
+ bench:
139
+ desc: "Benchmark a Bolt backend (usage: task bench -- bolt://localhost:7687 [memgraph|neo4j])"
140
+ cmds:
141
+ - .venv/bin/python scripts/bench_bolt.py {{.CLI_ARGS}}
142
+
126
143
  test:integration:age:
127
144
  desc: "Run the integration tests for Apache AGE backend only"
128
145
  cmds:
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  type: Guide
3
3
  title: Bulk writes, indexes and backend capabilities
4
- description: Loading data at volume with bulk_create_nodes/bulk_create_edges, creating property indexes, and checking what a backend actually supports.
4
+ description: Loading and maintaining data at volume with bulk_create_nodes/bulk_create_edges, bulk_update_nodes and bulk_delete_edges, creating property indexes, and checking what a backend actually supports.
5
5
  tags: [cypher-graphdb, bulk, indexes, capabilities, performance, age, memgraph]
6
6
  status: stable
7
7
  ---
@@ -79,6 +79,49 @@ target a single label table instead of scanning the whole graph, which is the
79
79
  difference between a fast load and an unusable one. `src_ref_prop` /
80
80
  `dst_ref_prop` default to `"id"`.
81
81
 
82
+ A ref prop can also be a sequence of properties forming a composite key, e.g.
83
+ `("symbol", "source_key")` when a symbol is only unique within one source of a
84
+ shared graph; each ref is then a tuple of values in the same order.
85
+
86
+ ## Bulk updating nodes
87
+
88
+ Setting properties on many existing nodes takes the nodes' references and,
89
+ parallel to them, the properties to set — every entry sets the same keys:
90
+
91
+ ```python
92
+ db.bulk_update_nodes(
93
+ "Class",
94
+ refs=[("cls:app.Foo", "svc-a"), ("cls:app.Bar", "svc-a")],
95
+ properties=[{"community": 3}, {"community": 5}],
96
+ ref_prop=("symbol", "source_key"),
97
+ )
98
+ ```
99
+
100
+ Nodes no ref matches are skipped; the return value counts the nodes updated.
101
+
102
+ ## Bulk deleting edges
103
+
104
+ Deleting many edges takes the same parallel references as creating them. Every
105
+ edge of the label from a matched source to its matched destination is deleted,
106
+ parallel edges included:
107
+
108
+ ```python
109
+ db.bulk_delete_edges(
110
+ "CALLS",
111
+ src_refs=[("mod.foo.bar", "svc-a")],
112
+ dst_refs=[("mod.target.a", "svc-a")],
113
+ src_label="Method",
114
+ dst_label="Method",
115
+ src_ref_prop=("qualified_name", "source_key"),
116
+ dst_ref_prop=("qualified_name", "source_key"),
117
+ )
118
+ ```
119
+
120
+ On AGE this resolves the endpoints with one SQL query per label and deletes by
121
+ `(start_id, end_id)`, without a Cypher `MATCH ... DELETE` — the form that gets
122
+ slow on AGE for large sets. Pairs that match no node, and labels that do not
123
+ exist yet, delete nothing.
124
+
82
125
  ## Property indexes
83
126
 
84
127
  ```python
@@ -159,6 +202,7 @@ a chunked implementation, so the loop above works either way. Pagination via
159
202
  Apache AGE cannot bind query parameters inside `UNWIND`. A portable
160
203
  `UNWIND $rows` write therefore has to be rewritten as inline Cypher literals for
161
204
  AGE, with all the escaping that implies. `bulk_create_nodes` and
162
- `bulk_create_edges` own that difference — and take the direct SQL path where the
163
- backend allows it — so consumer code stays the same across backends. See
205
+ `bulk_create_edges`, `bulk_update_nodes` and `bulk_delete_edges` own that
206
+ difference — and take the direct SQL path where the backend allows it — so
207
+ consumer code stays the same across backends. See
164
208
  [queries.md](queries.md) for the parameter caveat in its general form.
@@ -8,17 +8,25 @@ status: stable
8
8
 
9
9
  # Connecting and configuring
10
10
 
11
- ## The two backends
11
+ ## The three backends
12
12
 
13
13
  | Backend | Transport | Connection string | Graph means |
14
14
  |---|---|---|---|
15
15
  | `age` | PostgreSQL (`psycopg`) | `postgresql://user:pass@host:5432/db` | a PostgreSQL **schema**; labels are tables inside it |
16
- | `memgraph` | Bolt (`pymgclient`) | `bolt://[user:pass@]host:7687` | the single active database |
16
+ | `memgraph` | Bolt: pymgclient (default), or the Neo4j Python driver | `bolt://[user:pass@]host:7687[?transport=neo4j]` | the single active database |
17
+ | `neo4j` | Bolt: the Neo4j Python driver (with its Rust extension) | `bolt://` or `neo4j://[user:pass@]host:7687[/database]` | a Neo4j **database** (`neo4j` by default) |
17
18
 
18
- Both drivers are regular dependencies — there is no per-backend extra to install.
19
+ All drivers are regular dependencies. Memgraph speaks Bolt through pymgclient by default (faster
20
+ on large reads) or through the Neo4j driver (`?transport=neo4j`, or `connect_params={"transport":
21
+ ...}`: per-transaction timeouts, metadata, cluster routing); the URL's scheme goes to the
22
+ transport -- `bolt+s://` for TLS, `neo4j://` for cluster routing.
23
+
24
+ Memgraph and Neo4j share the Bolt foundation (statements, pages, streams, bulk writes); each is a
25
+ dialect on it -- index DDL, catalog queries, how a graph is selected.
19
26
 
20
27
  Because an AGE graph is a schema, AGE connections take a **graph name** and can
21
- create it on demand. Memgraph connections generally do not.
28
+ create it on demand. Memgraph connections generally do not; a Neo4j connection's graph name is
29
+ its database.
22
30
 
23
31
  ## Ways to connect
24
32
 
@@ -75,12 +83,34 @@ Configuration is read by a pydantic-settings `Settings` model.
75
83
 
76
84
  | Setting | Env var | CLI flag | Default | Meaning |
77
85
  |---|---|---|---|---|
78
- | `backend` | `CGDB_BACKEND` | `-b / --backend` | – | `age` or `memgraph` |
86
+ | `backend` | `CGDB_BACKEND` | `-b / --backend` | – | `age`, `memgraph` or `neo4j` |
79
87
  | `cinfo` | `CGDB_CINFO` | `-c / --cinfo` | – | Connection string / DSN |
80
88
  | `graph` | `CGDB_GRAPH` | `-g / --graph` | – | Graph name (backend-specific) |
81
89
  | `read_only` | `CGDB_READ_ONLY` | `-r / --read-only` | `False` | Reject write clauses |
82
90
  | `create_graph` | `CGDB_CREATE_GRAPH_IF_NOT_EXISTS` | – | `False` | Auto-create the graph (AGE) |
83
- | `query_timeout_s` | `CGDB_QUERY_TIMEOUT_S` | – | – | Per-query timeout in seconds |
91
+ | `query_timeout_s` | `CGDB_QUERY_TIMEOUT_S` | – | `600` | The connection's query timeout in seconds (`0`: none) |
92
+
93
+ ## Query timeouts
94
+
95
+ Every connection has a timeout for its queries: `query_timeout_s`, 600 s by default -- generous for
96
+ real work, and a runaway query ends instead of running for hours. A query running longer is
97
+ cancelled with `QueryTimeoutError` (a `QueryExecutionError`). A statement may set its own:
98
+
99
+ ```python
100
+ db.execute("MATCH (n) RETURN count(n)", timeout_s=30)
101
+
102
+ with db.query_timeout(5): # every statement inside: queries, pages, streams, bulk writes
103
+ db.execute(...)
104
+ ```
105
+
106
+ | Backend | Connection default | A statement's own |
107
+ |---|---|---|
108
+ | `age` | the session's `statement_timeout` | `SET LOCAL statement_timeout` in its transaction (queries; bulk writes keep the default) |
109
+ | `neo4j`, `memgraph` via the Neo4j driver | the Bolt transaction timeout of each transaction | the Bolt transaction timeout |
110
+ | `memgraph` via pymgclient | the server-wide setting `query.timeout` | not possible: a warning is logged, the default holds |
111
+
112
+ With autocommit, a statement cancelled for its timeout leaves no aborted transaction behind: the
113
+ connection is usable for the next one.
84
114
 
85
115
  **Precedence:** CLI arguments → environment variables → `.env` → constructor
86
116
  arguments → defaults.
@@ -13,7 +13,7 @@ From nothing to a working query, in four steps.
13
13
  ## 1. Install
14
14
 
15
15
  Requires **Python 3.14+**. Both backend drivers (`psycopg` for Apache AGE,
16
- `pymgclient` for Memgraph) ship as regular dependencies — there is nothing extra
16
+ pymgclient and the Neo4j Python driver for Memgraph and Neo4j) ship as regular dependencies — there is nothing extra
17
17
  to install per backend.
18
18
 
19
19
  ```bash
@@ -70,7 +70,7 @@ Some capabilities are orthogonal to the stack rather than a rung on it:
70
70
  | `graphops` | Client-side analysis over a materialized `Graph` — `root_nodes`, `incoming_nodes` / `outgoing_nodes`, `build_tree`, `has_cycles`, `density`. No database round-trip; you fetch a subgraph, then reason about it in memory. |
71
71
  | Schema introspection | `graphs()`, `labels()` — what exists, and how much of it. |
72
72
  | Full-text search | `search` over graph content, where the backend supports it. |
73
- | Indexing & bulk writes | `create_property_index()`, `bulk_create_nodes()` / `bulk_create_edges()` — see [bulk-and-indexes.md](bulk-and-indexes.md). |
73
+ | Indexing & bulk writes | `create_property_index()`, `bulk_create_nodes()` / `bulk_create_edges()`, `bulk_update_nodes()`, `bulk_delete_edges()` — see [bulk-and-indexes.md](bulk-and-indexes.md). |
74
74
  | Import / export | A format registry (CSV, JSON, YAML built in; Excel via `[excel]`), extensible with your own — see [import-export.md](import-export.md). |
75
75
 
76
76
  ## The 30-second example
@@ -181,6 +181,8 @@ size around 1000 objects is a reasonable starting point.
181
181
  | Exception | Raised when |
182
182
  |---|---|
183
183
  | `QueryExecutionError` | The backend rejected or failed the query |
184
+ | `QueryTimeoutError` | The query ran past its timeout (a `QueryExecutionError`) |
185
+ | `PathLengthExceededError` | The query's paths are longer than its `max_path_length` (it did not run) |
184
186
  | `ReadOnlyModeError` | A write was attempted on a read-only connection |
185
187
  | `LabelNotFoundError` | The referenced label does not exist |
186
188
  | `ConnectionGuardError` | An installed connection guard vetoed the connection |
@@ -203,3 +205,19 @@ otherwise.
203
205
  `parse_cypher_query()` returns a `ParsedCypherQuery` describing the operations
204
206
  and labels a statement touches. This is what read-only mode uses, and it is
205
207
  available for your own checks — per-label authorization, for instance.
208
+
209
+ ### Path length
210
+
211
+ `ParsedCypherQuery.max_path_length` is the most relationships one pattern can
212
+ match: a plain relationship counts 1, a variable-length one its upper bound
213
+ (`*1..5`: 5), summed along the pattern; 0 without relationships, `None` when a
214
+ pattern is unbounded (`*`, `*2..`). To refuse such queries before they run —
215
+ from users or an LLM, say — pass a limit; there is none by default:
216
+
217
+ ```python
218
+ db.execute("MATCH (a)-[:CALLS*]->(b) RETURN b", max_path_length=10)
219
+ # PathLengthExceededError: Query rejected: it has an unbounded variable-length
220
+ # relationship, the limit is 10; bound its variable-length relationships, e.g. [:REL*1..10]
221
+ ```
222
+
223
+ `execute`, `execute_with_stats` and `execute_cypher_page` take it.
@@ -26,7 +26,9 @@ dependencies = [
26
26
  "loguru",
27
27
  "psycopg >= 3.3.3",
28
28
  "psycopg-binary >= 3.3.3",
29
- "pymgclient",
29
+ "pymgclient>=1.6",
30
+ "neo4j>=6.4.1",
31
+ "neo4j-rust-ext>=6.4.1", # the Bolt protocol in Rust: the driver's hot path
30
32
  "typing-extensions",
31
33
  "tenacity",
32
34
  "json-schema-to-pydantic>=0.4.11",
@@ -123,6 +125,7 @@ markers = [
123
125
  "unit: marks tests as unit tests (default)",
124
126
  "integration: marks tests as integration tests (all backends)",
125
127
  "integration_memgraph: marks integration tests for Memgraph backend",
128
+ "integration_neo4j: marks integration tests for Neo4j backend",
126
129
  "integration_age: marks integration tests for Apache AGE backend",
127
130
  ]
128
131
  testpaths = ["tests"]
@@ -0,0 +1,60 @@
1
+ """Benchmark a Bolt backend: bulk writes, reads as models, streams, and queries of the sizes code uses.
2
+
3
+ task bench -- bolt://localhost:7687 # memgraph, the Neo4j driver
4
+ task bench -- "bolt://localhost:7687?transport=pymgclient" # memgraph, pymgclient
5
+ task bench -- bolt://localhost:7688 neo4j # the neo4j backend
6
+
7
+ Writes and deletes nodes labelled ``Bench`` (and edges ``BENCH_E``) on the server it is pointed at.
8
+ """
9
+
10
+ import statistics
11
+ import sys
12
+ import time
13
+
14
+ from loguru import logger
15
+
16
+ from cypher_graphdb import CypherGraphDB
17
+
18
+ N = 20000
19
+
20
+
21
+ def main() -> None:
22
+ url = sys.argv[1] if len(sys.argv) > 1 else "bolt://localhost:7687"
23
+ backend = sys.argv[2] if len(sys.argv) > 2 else "memgraph"
24
+ logger.remove()
25
+ db = CypherGraphDB(backend=backend, connect_url=url)
26
+ print(f"{backend} via {db._backend.transport}: {url}") # noqa: T201
27
+ db.execute("MATCH (n:Bench) DETACH DELETE n")
28
+ db.create_property_index("Bench", "id")
29
+
30
+ def timed(label: str, fn, runs: int = 3, per: int = 1) -> None:
31
+ times = []
32
+ for _ in range(runs):
33
+ start = time.perf_counter()
34
+ fn()
35
+ times.append((time.perf_counter() - start) / per)
36
+ print(f" {label:<36} {statistics.median(times) * 1000:9.2f} ms") # noqa: T201
37
+
38
+ def create() -> None:
39
+ db.execute("MATCH (n:Bench) DETACH DELETE n")
40
+ db.bulk_create_nodes([{"id": i, "name": f"node{i}", "score": i * 0.5} for i in range(N)], label="Bench", batch_size=1000)
41
+ db.bulk_create_edges([{"src": i, "dst": i + 1, "w": i} for i in range(N - 1)], "Bench", "Bench", label="BENCH_E", batch_size=1000)
42
+
43
+ timed(f"bulk create {N} nodes + edges", create)
44
+ timed(f"read {N} nodes as models", lambda: db.execute("MATCH (n:Bench) RETURN n"))
45
+ timed(f"read {N} edges as models", lambda: db.execute("MATCH ()-[e:BENCH_E]->() RETURN e"))
46
+ timed(f"stream {N} nodes, chunks of 1000", lambda: sum(len(c) for c in db.execute_cypher_stream("MATCH (n:Bench) RETURN n", chunk_size=1000)))
47
+ for size, reps in ((1, 500), (10, 500), (100, 300), (1000, 100)):
48
+ timed(
49
+ f"query of {size} nodes (per query)",
50
+ lambda size=size, reps=reps: [db.execute("MATCH (n:Bench) WHERE n.id < $n RETURN n", params={"n": size}) for _ in range(reps)],
51
+ runs=1,
52
+ per=reps,
53
+ )
54
+ db.execute("MATCH (n:Bench) DETACH DELETE n")
55
+ db.drop_index("Bench", "id")
56
+ db.disconnect()
57
+
58
+
59
+ if __name__ == "__main__":
60
+ main()
@@ -27,7 +27,7 @@ from .cyphergraphdb.pagination import Page
27
27
  from .cypherjson import GraphJSONEncoder
28
28
  from .cypherparser import ParsedCypherQuery, parse_cypher_query
29
29
  from .dbpool import CypherGraphDBPool
30
- from .exceptions import LabelNotFoundError, QueryExecutionError, ReadOnlyModeError
30
+ from .exceptions import LabelNotFoundError, PathLengthExceededError, QueryExecutionError, QueryTimeoutError, ReadOnlyModeError
31
31
  from .formatprovider import FormatProvider, FormatSpec, data_format, format_provider
32
32
  from .modelinfo import GraphEdgeInfo, GraphNodeInfo, GraphRelationInfo
33
33
  from .modelprovider import ModelProvider, validate_node_properties
@@ -70,6 +70,8 @@ __all__ = [
70
70
  "ReadOnlyModeError",
71
71
  "LabelNotFoundError",
72
72
  "QueryExecutionError",
73
+ "QueryTimeoutError",
74
+ "PathLengthExceededError",
73
75
  "ConnectionGuardError",
74
76
  "install_connection_guard",
75
77
  "clear_connection_guard",
@@ -6,7 +6,9 @@ CypherBackend: Abstract base class for implementing graph database backends.
6
6
  """
7
7
 
8
8
  import abc
9
+ import contextlib
9
10
  import re
11
+ from collections.abc import Iterator, Sequence
10
12
  from enum import Enum, auto
11
13
  from typing import Any
12
14
 
@@ -72,19 +74,41 @@ class CypherBackend(abc.ABC):
72
74
  # Maximum seconds a single query may run before the backend cancels it.
73
75
  # None means no timeout (backend default). Set via connect(query_timeout_s=N).
74
76
  self._query_timeout_s: int | None = kwargs.get("query_timeout_s")
77
+ # A statement's own timeout, while statement_timeout() is active: overrides the connection's default.
78
+ self._statement_timeout_s: float | None = None
75
79
 
76
80
  # An empty, backend-local provider unless one is injected. CypherGraphDB
77
81
  # overwrites this with its own provider right after construction.
78
82
  self._model_provider = kwargs.get("model_provider") or modelprovider.ModelProvider()
79
83
 
80
- # Concrete connection type varies per backend (psycopg for AGE, mgclient
81
- # for Memgraph); subclasses re-declare this with their own precise type.
84
+ # Concrete connection type varies per backend (psycopg for AGE, the Neo4j
85
+ # driver's Bolt connection for Memgraph); subclasses re-declare this with their own precise type.
82
86
  self._connection: Any = None
83
87
 
84
88
  @property
85
89
  def connection(self):
86
90
  return self._connection
87
91
 
92
+ @contextlib.contextmanager
93
+ def statement_timeout(self, timeout_s: float | None) -> Iterator[None]:
94
+ """The statements run inside get ``timeout_s`` instead of the connection's default (0: none).
95
+
96
+ A backend that cannot apply it to a statement logs a warning and keeps the connection's default.
97
+ """
98
+ previous, self._statement_timeout_s = self._statement_timeout_s, timeout_s
99
+ try:
100
+ yield
101
+ finally:
102
+ self._statement_timeout_s = previous
103
+ self._end_statement_timeout()
104
+
105
+ def _end_statement_timeout(self) -> None: # noqa: B027 -- a hook: most backends have nothing to clean up
106
+ """A backend's cleanup when a statement timeout ends (AGE: back to the session's default)."""
107
+
108
+ def is_timeout_error(self, error: Exception) -> bool:
109
+ """Whether ``error`` is the backend cancelling a statement for running out of time."""
110
+ return False
111
+
88
112
  @property
89
113
  def graph_name(self) -> str | None:
90
114
  return self._graph_name
@@ -453,23 +477,27 @@ class CypherBackend(abc.ABC):
453
477
  edges: list[dict],
454
478
  src_label: str,
455
479
  dst_label: str,
456
- src_ref_prop: str = "id",
457
- dst_ref_prop: str = "id",
480
+ src_ref_prop: str | Sequence[str] = "id",
481
+ dst_ref_prop: str | Sequence[str] = "id",
458
482
  batch_size: int = 500,
459
483
  ) -> int:
460
- """Create edges in batches by matching src/dst nodes on a reference property.
484
+ """Create edges in batches by matching src/dst nodes on a reference key.
461
485
 
462
486
  Each dict in edges must have "src" and "dst" keys whose values match
463
487
  the src_ref_prop/dst_ref_prop properties on source/destination nodes.
464
488
  Any additional keys are set as properties on the created edge.
465
489
 
490
+ A ref prop may name a single property or an ordered sequence of properties
491
+ (a composite key); for a composite key each "src"/"dst" is a parallel
492
+ sequence of values in the same order.
493
+
466
494
  Args:
467
495
  label: Edge label for all created edges.
468
496
  edges: List of dicts with "src", "dst", and optional edge properties.
469
497
  src_label: Label of source nodes. Required for optimal performance on AGE.
470
498
  dst_label: Label of destination nodes. Required for optimal performance on AGE.
471
- src_ref_prop: Property name on source nodes to match against "src".
472
- dst_ref_prop: Property name on destination nodes to match against "dst".
499
+ src_ref_prop: Property, or ordered sequence of properties, on source nodes to match against "src".
500
+ dst_ref_prop: As ``src_ref_prop``, for destination nodes.
473
501
  batch_size: Number of edges per UNWIND batch.
474
502
 
475
503
  Returns:
@@ -480,7 +508,64 @@ class CypherBackend(abc.ABC):
480
508
  """
481
509
  raise NotImplementedError(f"Backend {self.name} does not support bulk_create_edges")
482
510
 
483
- def bulk_delete_nodes(self, label: str, filters: dict[str, str]) -> int:
511
+ def bulk_delete_edges(
512
+ self,
513
+ label: str,
514
+ edges: list[dict],
515
+ src_label: str,
516
+ dst_label: str,
517
+ src_ref_prop: str | Sequence[str] = "id",
518
+ dst_ref_prop: str | Sequence[str] = "id",
519
+ batch_size: int = 500,
520
+ ) -> int:
521
+ """Delete edges in batches, matching their src/dst nodes on a reference key.
522
+
523
+ The counterpart of :meth:`bulk_create_edges`: each dict in edges has
524
+ "src" and "dst" keys matched against the src_ref_prop/dst_ref_prop
525
+ properties, and every ``label`` edge from a matched source to its matched
526
+ destination is deleted. Pairs whose endpoints match no node are skipped.
527
+ Composite keys work as for :meth:`bulk_create_edges`.
528
+
529
+ Args:
530
+ label: Label of the edges to delete.
531
+ edges: List of dicts with "src" and "dst" keys; other keys are ignored.
532
+ src_label: Label of source nodes.
533
+ dst_label: Label of destination nodes.
534
+ src_ref_prop: Property, or ordered sequence of properties, on source nodes to match against "src".
535
+ dst_ref_prop: As ``src_ref_prop``, for destination nodes.
536
+ batch_size: Number of pairs per batch.
537
+
538
+ Returns:
539
+ Total number of edges deleted.
540
+
541
+ Raises:
542
+ NotImplementedError: If the backend does not support bulk_delete_edges.
543
+ """
544
+ raise NotImplementedError(f"Backend {self.name} does not support bulk_delete_edges")
545
+
546
+ def bulk_update_nodes(self, label: str, rows: list[dict], ref_prop: str | Sequence[str] = "id", batch_size: int = 500) -> int:
547
+ """Set properties on existing nodes in batches, matching them on a reference key.
548
+
549
+ Each dict in rows has a "ref" key matched against the ``ref_prop``
550
+ property (or, for a composite key, a parallel sequence of values matched
551
+ element-wise) and the properties to set on the matched node. All rows of
552
+ one call set the same property keys. Rows that match no node are skipped.
553
+
554
+ Args:
555
+ label: Label of the nodes to update.
556
+ rows: List of dicts with "ref" and the properties to set.
557
+ ref_prop: Property, or ordered sequence of properties, to match "ref" against.
558
+ batch_size: Number of rows per batch.
559
+
560
+ Returns:
561
+ Total number of nodes updated.
562
+
563
+ Raises:
564
+ NotImplementedError: If the backend does not support bulk_update_nodes.
565
+ """
566
+ raise NotImplementedError(f"Backend {self.name} does not support bulk_update_nodes")
567
+
568
+ def bulk_delete_nodes(self, label: str, filters: dict[str, str], batch_size: int | None = None) -> int:
484
569
  """Delete all nodes of a label matching property filters, cascading to edges.
485
570
 
486
571
  Removes nodes where all specified property key=value pairs match, plus
@@ -494,6 +579,11 @@ class CypherBackend(abc.ABC):
494
579
  label: Node label to delete from (e.g. "Method", "Class").
495
580
  filters: Property filters to match. All must match (AND semantics).
496
581
  Example: {"source_key": "nais-platform", "lang": "ts"}
582
+ batch_size: None: one statement. A number: statements of at most that many nodes
583
+ (and their edges), each committed -- what Memgraph and Neo4j recommend for large
584
+ deletes: a single one holds every change in memory until it ends, and runs as
585
+ long as the whole delete. Work pending on the connection is committed with the
586
+ first batch. AGE overrides it with batches in SQL.
497
587
 
498
588
  Returns:
499
589
  Number of nodes deleted.
@@ -508,6 +598,8 @@ class CypherBackend(abc.ABC):
508
598
  if not _SAFE_FILTER_VAL_RE.match(v):
509
599
  raise ValueError(f"filter value must be alphanumeric/underscore/hyphen/dot/colon, got: {v!r}")
510
600
  where_parts = " AND ".join(f"n.{k} = '{v}'" for k, v in filters.items())
601
+ if batch_size:
602
+ return self._delete_in_batches(f"MATCH (n:{label}) WHERE {where_parts}", batch_size)
511
603
  count_cypher = f"MATCH (n:{label}) WHERE {where_parts} RETURN count(n)"
512
604
  parsed = self.parse_cypher(count_cypher)
513
605
  result, _ = self.execute_cypher(parsed)
@@ -518,8 +610,26 @@ class CypherBackend(abc.ABC):
518
610
  self.execute_cypher(parsed)
519
611
  return count
520
612
 
613
+ def _delete_in_batches(self, match: str, batch_size: int) -> int:
614
+ """DETACH DELETE the nodes ``n`` that ``match`` finds, ``batch_size`` per statement, committing each."""
615
+ parsed = self.parse_cypher(f"{match} WITH n LIMIT {int(batch_size)} DETACH DELETE n RETURN count(*)")
616
+ total = 0
617
+ while True:
618
+ result, _ = self.execute_cypher(parsed)
619
+ self.commit()
620
+ deleted = result[0][0] if result else 0
621
+ total += deleted
622
+ if deleted < batch_size:
623
+ return total
624
+
521
625
  def bulk_delete_orphans(
522
- self, label: str, edge_label: str, *, incoming: bool = True, filters: dict[str, str] | None = None
626
+ self,
627
+ label: str,
628
+ edge_label: str,
629
+ *,
630
+ incoming: bool = True,
631
+ filters: dict[str, str] | None = None,
632
+ batch_size: int | None = None,
523
633
  ) -> int:
524
634
  """Delete nodes of ``label`` that have no ``edge_label`` edge attached.
525
635
 
@@ -545,6 +655,8 @@ class CypherBackend(abc.ABC):
545
655
  restrict the orphan scan to a subset of nodes (e.g.
546
656
  ``{"source_key": "my-source"}``). When omitted, all nodes of
547
657
  the label are considered.
658
+ batch_size: As for ``bulk_delete_nodes``. In batches, a node whose last such edge
659
+ came from an orphan deleted by an earlier batch is an orphan, and deleted, too.
548
660
 
549
661
  Returns:
550
662
  Number of orphan nodes deleted.
@@ -564,6 +676,10 @@ class CypherBackend(abc.ABC):
564
676
  where_parts = "WHERE " + " AND ".join(f"n.{k} = '{v}'" for k, v in filters.items())
565
677
 
566
678
  arrow = f"<-[r:{edge_label}]-" if incoming else f"-[r:{edge_label}]->"
679
+ if batch_size:
680
+ return self._delete_in_batches(
681
+ f"MATCH (n:{label}) {where_parts} OPTIONAL MATCH (n){arrow}() WITH n, r WHERE r IS NULL", batch_size
682
+ )
567
683
  count_cypher = f"MATCH (n:{label}) {where_parts} OPTIONAL MATCH (n){arrow}() WITH n, r WHERE r IS NULL RETURN count(n)"
568
684
  parsed = self.parse_cypher(count_cypher)
569
685
  result, _ = self.execute_cypher(parsed)