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.
- cypher_graphdb-0.8.0/CHANGELOG.md +55 -0
- {cypher_graphdb-0.7.2/src/cypher_graphdb.egg-info → cypher_graphdb-0.8.0}/PKG-INFO +7 -4
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/README.md +3 -2
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/Taskfile.yml +17 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/bulk-and-indexes.md +47 -3
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/connecting.md +36 -6
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/getting-started.md +1 -1
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/index.md +1 -1
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/queries.md +18 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/pyproject.toml +4 -1
- cypher_graphdb-0.8.0/scripts/bench_bolt.py +60 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/__init__.py +3 -1
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backend.py +125 -9
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agebulkwriter.py +198 -40
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agegraphdb.py +123 -23
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/ageserializer.py +8 -4
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agesqlbuilder.py +64 -36
- cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/__init__.py +13 -0
- cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/backend.py +387 -0
- cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/neo4j_transport.py +178 -0
- cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/pymgclient_transport.py +166 -0
- cypher_graphdb-0.8.0/src/cypher_graphdb/backends/bolt/transport.py +80 -0
- cypher_graphdb-0.8.0/src/cypher_graphdb/backends/memgraph/memgraphdb.py +70 -0
- cypher_graphdb-0.8.0/src/cypher_graphdb/backends/neo4j/__init__.py +9 -0
- cypher_graphdb-0.8.0/src/cypher_graphdb/backends/neo4j/neo4jdb.py +74 -0
- cypher_graphdb-0.8.0/src/cypher_graphdb/bulk_refs.py +85 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/_host.py +3 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/cyphergraphdb.py +56 -13
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/indexing.py +157 -9
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/pagination_mixin.py +14 -8
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/stream_mixin.py +3 -2
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherparser.py +52 -4
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/exceptions.py +35 -1
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/schema/core.py +5 -3
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/settings.py +7 -6
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/connection_utils.py +5 -1
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0/src/cypher_graphdb.egg-info}/PKG-INFO +7 -4
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/SOURCES.txt +12 -1
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/requires.txt +3 -1
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/scm_file_list.json +12 -1
- cypher_graphdb-0.8.0/src/cypher_graphdb.egg-info/scm_version.json +8 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/conftest.py +57 -2
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_basic_operations.py +31 -21
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_create_or_merge.py +1 -1
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_cypher_query_builder.py +11 -11
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_cypher_query_writes.py +6 -6
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_example.py +3 -3
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_expand.py +6 -6
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_indexes_and_bulk.py +557 -43
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_mass_delete.py +11 -11
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_parameters.py +12 -12
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_query_execution_error.py +4 -4
- cypher_graphdb-0.8.0/tests/integration/test_query_timeouts.py +64 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_read_only_mode.py +1 -1
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_streaming.py +13 -6
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_age_serializer.py +10 -3
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_age_sqlbuilder.py +54 -0
- cypher_graphdb-0.8.0/tests/unit/test_bulk_refs.py +85 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherparser.py +10 -0
- cypher_graphdb-0.8.0/tests/unit/test_max_path_length.py +64 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_model_inheritance.py +17 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_query_execution_error.py +34 -2
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_query_timeout.py +34 -23
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_settings.py +2 -2
- cypher_graphdb-0.8.0/uv.lock +1602 -0
- cypher_graphdb-0.7.2/CHANGELOG.md +0 -19
- cypher_graphdb-0.7.2/src/cypher_graphdb/backends/memgraph/memgraphdb.py +0 -850
- cypher_graphdb-0.7.2/src/cypher_graphdb/backends/memgraph/memgraphrowfactories.py +0 -235
- cypher_graphdb-0.7.2/src/cypher_graphdb.egg-info/scm_version.json +0 -8
- cypher_graphdb-0.7.2/uv.lock +0 -1356
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.env.age.example +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.env.example +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.env.memgraph.example +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.github/workflows/audit.yml +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.github/workflows/ci.yml +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.github/workflows/publish.yml +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.github/workflows/release.yml +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.gitignore +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/.pre-commit-config.yaml +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/AGENTS.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/CONTRIBUTING.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/ENGINEERING-STANDARDS.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/LICENSE.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/NOTICE +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/README.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/adr/0001-explicit-model-providers.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/adr/index.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/cli-prompt-parsing.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/duckdb-migration.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/falkordb-integration.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/fluent-cypher-query-builder.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/format-registry.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/hierarchical-export-format.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/index.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/model-provider-isolation.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/model-provider-label-collision.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/multiple-statement-execution.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/packaging-and-extras.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/parameterized-queries-for-typed-models.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/query-result-immutable-design.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/read-only-mode.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/design/stateless-multi-graph-support.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/cli.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/import-export.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/docs/usage/typed-models.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/scripts/release.config.sh +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/scripts/release.sh +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/scripts/verify.sh +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/setup.cfg +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/__main__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/_extras.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/args.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backendprovider.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agerowfactories.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agesearch.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agtype.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/age/agtype_parser.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/backends/memgraph/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cardinality.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/app.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/banner.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/command_manager.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/command_map.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/command_registry.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commandposition.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/add_graph_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/apply_config_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/base_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/clear_graph_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/commit_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/connect_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/create_edge_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/create_graph_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/create_linked_node_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/create_node_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/delete_graphobj_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/disconnect_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/drop_graph_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_backends_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_graphs_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_indexes_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_labels_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_models_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_parsed_query_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_schema_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/dump_statistics_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/execute_cypher_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/execute_file_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/exit_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/export_graph_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/fetch_all_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/fetch_edges_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/fetch_nodes_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/format_output_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/get_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/gid_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/graph_exists_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/graph_op_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/graph_to_tree_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/help_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/import_graph_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/last_result_op_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/load_models_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/resolve_edges_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/rollback_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/search_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/set_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/sql_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/update_graphobj_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/commands/use_graph_command.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/completer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/config.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/exporter.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/file_executor.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/graphdata.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/graphdb.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/_overview.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/_template.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/add_graph.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/exit.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/export_graph.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/import_graph.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help/last_result.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/help.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/prompt.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/promptgrammar.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/promptparser.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/provider.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/renderer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/runtime.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/schema_cmd.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cli/settings.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/command_reader.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/config.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/connection_guard.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/Cypher.interp +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/Cypher.tokens +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherBaseListener.java +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherLexer.interp +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherLexer.java +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherLexer.tokens +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherListener.java +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/.antlr/CypherParser.java +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/Cypher.g4 +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/Cypher.interp +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/Cypher.tokens +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherLexer.interp +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherLexer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherLexer.tokens +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherListener.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/CypherParser.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypher/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherbuilder.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/batch.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/bulk_normalize.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/connection.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/criteria.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/expand.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/pagination.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/result.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/schema.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/search.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cyphergraphdb/sql.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherjson.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherquery/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherquery/builder.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherquery/params.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/cypherquery/patterns.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/dbpool.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/display.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/formatprovider.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/graphops.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/main.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/modelinfo.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/modelprovider.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/modelrelations.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/models.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/options.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/py.typed +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/schema/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/schema/converter.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/schema/generator.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/statistics.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/base_exporter.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/base_importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/csv_exporter.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/csv_importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/csv_source.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/data_flattener.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/excel_exporter.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/excel_importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/excel_row_source.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/file_exporter.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/file_importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/csv.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/excel.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/json.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/formats/yaml.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/hierarchical_exporter.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/hierarchical_importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/hierarchical_row_source.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/json_importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/json_yaml_data_source.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/row_collector.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/row_set.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/row_source.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/tabular_importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/tools/yaml_importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/collection_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/column_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/conversion_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/core_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/schema_merge.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/schema_to_llm.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/schema_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/settings_repr.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb/utils/string_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/dependency_links.txt +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/entry_points.txt +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/src/cypher_graphdb.egg-info/top_level.txt +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/README.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/conftest.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/integration/test_pagination.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/README.md +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/test_cmd_map.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/test_command_registry.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/test_promptgrammar.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/cli/test_promptparser.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/mock_backend.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_agtype_parser.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_backend_capabilities.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_bulk_normalize.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_column_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_command_reader.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_connection_guard.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherbuilder.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherquery.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherquery_facade.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_cypherquery_patterns.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_dbpool.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_dict_access_mixin.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_expand.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_extend_relation_decorator.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_extend_relations.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_formatprovider.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_graph_id_zero.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_graphops.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_indexing.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_json_schema_loading.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_json_schema_vs_decorators.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_modelinfo.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_modelprovider_loading.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_modelprovider_schemas.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_models.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_pagination.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_prepared_statement_recovery.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/test_schema_converter.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/__init__.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_data_flattener.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_exporters.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_hierarchical_importer.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_json_yaml_data_source.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_resource_management.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/tools/test_tabular_import.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_collection_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_connection_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_conversion_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_core_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_schema_merge.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_schema_utils.py +0 -0
- {cypher_graphdb-0.7.2 → cypher_graphdb-0.8.0}/tests/unit/utils/test_settings_repr.py +0 -0
- {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.
|
|
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
|
|
82
|
-
`
|
|
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
|
|
30
|
-
`
|
|
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`
|
|
163
|
-
|
|
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
|
|
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 (
|
|
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
|
-
|
|
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 `
|
|
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` | – |
|
|
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
|
-
|
|
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,
|
|
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
|
|
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
|
|
472
|
-
dst_ref_prop:
|
|
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
|
|
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,
|
|
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)
|