NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1042 most downloaded on PyPI
Neo4j Bolt driver for Python
Latest stable
6.4.1
Last release 1 months ago
15 Oct 2026
Release timing varies
gaps range from 8 days to 6 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
8 years old
117 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#641
🔧️ Fixes
Fix pool acquisition stuck actively spinning ( #1362 ). Regression introduced in 6.4.0 ( #1346 ).
Fix double-encoding of bearer tokens via HTTP/Query API ( #1363 ).
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#640
neo4://example.com/some/path) or fragment (e.g. neo4://example.com#some-fragment).Your coding agent can read these notes before it upgrades. Set up the MCP server →
⭐️ New Features
🔮 New Preview Features
🔧️ Fixes
👏️ Improvements
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#631
🔧️ Fixes
🧹️ Clean-up
Clean up dead and broken code ( #1335 ).
Fix (currently unused) getpeercert method pass-through in low-level driver code ( #1334 ).
🧑️💻️ Development
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#630
⭐️ New Features
Add Bolt 6.1 support with support for uuid.UUID values ( #1308 ).
Make driver-created SSL context respect SSLKEYLOGFILE environment variable ( #1312 ). Similar to Python's own ssl.create_default_context , if SSLKEYLOGFILE is set, any SSL context created by the driver will have key logging enabled.
Add support for pyarrow version 25.x.x ( #1328 ).
🔧️ Fixes
Fix potential ImportError caused by the driver not properly loading the submodule pyarrow.compute ( #1316 ).
Fix async driver waiting for OS on closing half-open socket ( #1311 ).
Fix type annotation for undocumented (i.e., unsupported) method ( #1314 ).
🧹️ Clean-up
🧑️💻️ Development
Add unit tests with and without optional dependencies to the test matrix ( #1306 ).
Avoid lazy iterators for pytest parametrization (now deprecated) ( #1317 ).
Fix async tests timing out on Windows ( #1317 , #1320 ).
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#620
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#620
⭐️ New Features
Pandas 3 support ( #1291 ).
Instant one-shot retries on certain errors in session.run ( #1300 ). New driver and session config option disable_auto_commit_retries to opt-out.
Pyarrow 23 and 24 support ( #1304 ).
🔧️ Fixes
Fix overflow in DateTime + negative Duration ( #1279 ).
Fix connection_write_timeout config being ignored ( #1294 ).
Fix socket timeouts during connection establishment ( #1301 ).
Prevent async driver from causing ValueError by using ssl_handshake_timeout=0 .
Align async driver with sync driver:
(lazily) raise a ValueError when configured with a negative connection_timeout .
Treat connection_timeout=0 as "no timeout".
Fix sync driver setting the socket timeout to 0 (non-blocking) on expired connection_acquisition_timeout .
👏️ Improvements
Speed up iteration over Result ( #1295 ).
Allow negative components in Duration.from_iso_format ( #1284 ).
Improve error message on invalid Vector init overload invocation ( #1285 ).
Migrate internal usage from deprecated package to spec ( #1293 ).
📚️ Docs
List vector types next to other types ( #1287 ).
clarify auto-commit caveats ( #1286 ).
🧹️ Clean-up
🧑️💻️ Development
Bump linters ( #1283 ).
Fix Python 3.10 dev env ( #1292 ).
Remove .snyk file ( #1296 ).
Fix new mypy version being unhappy with type annotations ( #1298 ).
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#610
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#610
⭐️ New Features
🔧️ Fixes
Fix AttributeError when pool is None in Bolt3 error handling ( #1267 ). Thanks to @kirill-stepanishin for this contribution.
connection_acquisition_timeout now covers TLS handshake ( #1274 ).
👏️ Improvements
📚️ Docs
🧑️💻️ Development
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#603
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#603
🔧️ Fixes
Fix Vector type native adapters ( #1263 ). Converting native Python types to Vector s and vice versa used to have alternative implementations using NumPy or the Rust extensions when available to speed up the process. These implementations didn't have behavioral equality (especially for f32 ) which was hard to establish. Further optimization of the pure Python implementation narrowed the performance gap to the point where maintaining the Numpy and Rust implementations alongside was deemed too little gain for too much effort. Therefore, only the new, fast pure Python implementation remains.
Fix driver factory type hints suggesting supported options being unsupported ( #1255 ).
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#602
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#602
🔧️ Fixes
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#601
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#601
🔧️ Fixes
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#600
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#600
neo4j-driver. Use pip install neo4j instead.setup.py. Please use a recent enough packaging/build tool that supports pyproject.tomlneo4j.confneo4j.dataneo4j.metaneo4j.packstreamneo4j.routingneo4j.time.arithmeticneo4j.time.clock_implementationneo4j.time.hydrationneo4j.time.metaclassesneo4j.workneo4j.work.queryneo4j.work.summaryneo4j:
log, Config, PoolConfig, SessionConfig, WorkspaceConfig (internal - no replacement)SummaryNotificationPosition (use SummaryInputPosition instead)api.Version has been removed as it's unused now.ServerInfo.protocol_version now is a tuple[int, int] insteadof a api.Version.
This should be drop-in replacement is most cases:
Version was a sup-type of tuple[int, int]ServerInfo.protocol_version was already documented and typed as tuple[int, int]Version's additional methods were undocumented and shouldn't have been usedConfigurationError if the passed auth parameters is not valid (instead of AuthError)
DriverError for client-side errors and Neo4jError for server-side
errors.access_mode configuration option
ValueError on invalid value (instead of ClientError)neo4j.exceptions.UnsupportedServerProduct if no common bolt protocol version could be negotiated with the server
(instead of internal neo4j._exceptions.BoltHandshakeError).UnsupportedServerProduct is now a subclass of ConfigurationError (instead of Exception directly).connection_acquisition_timeout configuration option
ValueError on invalid values (instead of ClientError).ConnectionAcquisitionTimeoutError (subclass of DriverError) instead of ClientError
(subclass of Neo4jError) the timeout is exceeded.
DriverError for client-side errors and Neo4jError for server-side
errors.TypeError instead of ValueError when passing a Query object to Transaction.run.TransactionError (subclass of DriverError) instead of ClientError (subclass of Neo4jError) when calling
session.run() while an explicit transaction is active on that session.
DriverError for client-side errors and Neo4jError for server-side
errors.Neo4jError and ClientError:
message and code are always a str (instead of str | None).message and code properties.Neo4jError.hydrate, Neo4jError.invalidates_all_connections,
and Neo4jError.is_fatal_during_discovery.Neo4jError.is_retriable.Neo4jError.is_retryable instead.Neo4jError to include GQL error information.Record.__getslice__. This magic method has been removed in Python 3.0.Record.__getitem__(slice(...)) or simply record[...] instead.neo4j.Bookmark in favor of neo4j.Bookmarks.session.last_bookmark() in favor of last_bookmarks().initial_bookmarks to GraphDatabase.bookmark_manager().neo4j.Bookmarks object instead.Driver.session() no longer accepts raw string bookmarks as bookmarks argument.neo4j.Bookmarks object instead.ServerInfo.connection_id.trust.trusted_certificates instead.
neo4j.TRUST_ALL_CERTIFICATES and neo4j.TRUST_SYSTEM_CA_SIGNED_CERTIFICATES.session.read_transaction and session.write_transaction.session.execute_read and session.execute_write respectively.ResolvedAddress, ResolvedIPv4Address, and ResolvedIPv6Address private.PreviewWarning.
ExperimentalWarning and turn the few left instances of it into PreviewWarning.PreviewWarning from neo4j.neo4j.warnings instead.neo4j.api
DRIVER_BOLTDRIVER_NEO4JSECURITY_TYPE_NOT_SECURESECURITY_TYPE_SECURESECURITY_TYPE_SELF_SIGNED_CERTIFICATEcheck_access_modeparse_neo4j_uriparse_routing_contextneo4j.exceptions
CLASSIFICATION_CLIENTCLASSIFICATION_DATABASECLASSIFICATION_TRANSIENTERROR_REWRITE_MAPclient_errorstransient_errorstyping as neo4j.exceptions.t)neo4j.time
DATE_ISO_PATTERNTIME_ISO_PATTERNDURATION_ISO_PATTERNNANO_SECONDSAVERAGE_SECONDS_IN_MONTHAVERAGE_SECONDS_IN_DAYFORMAT_F_REPLACEIS_LEAP_YEARDAYS_IN_YEARDAYS_IN_MONTHround_half_to_evensymmetric_divmodDateTimeTypeDateTypeTimeTypere as neo4j.time.re)neo4j.spatial
hydrate_pointdehydrate_pointpoint_typeneo4j.GraphDatabase
.bolt_driver.neo4j_driverneo4j.BoltDriver and neo4j.Neo4jDriver
.open.parse_target.default_host.default_port.default_targetneo4j.graph, neo4j.addressing, neo4j.api
collections.abc.Mapping as neo4j.graph.Mapping).BoltDriver and Neo4jDriver
.open.parse_target.default_host.default_port.default_targetneo4j.debug
ColourFormatterTaskIdFilterasyncio as neo4j.debug.asyncio)ClockTime and its accessors
neo4j.time.Date, neo4j.time.DateTime, neo4j.time.Time
from_clock_time and to_clock_time methodsneo4j.time.ClockTime itselfConfigurationError instead of ignoring the routing context (URI query parameters) when creating a direct
driver ("bolt[+s[sc]]://" scheme).DriverError on using the closed driver.driver.close() again is now a no-op.__del__() (finalizer/destructor)..close() on them explicitly or use them in a with statement.Summary.summary_notifications a tuple instead of a list and type it with Sequence to signify that it
should be treated as immutable.neo4j.graph.EntitySetView) can no longer by indexed by legacy id (int, e.g., graph.nodes[0]).element_id instead (str, e.g., graph.nodes["..."]).NotImplemented instead of False (or raising TypeError in some
instances) if the other operand is not of a supported type.
This means that when comparing a driver type with another type is doesn't support, the other type get the chance to
handle the comparison.neo4j.Recordneo4j.graph.Node, neo4j.graph.Relationship, neo4j.graph.Pathneo4j.time.Date, neo4j.time.Time, neo4j.time.DateTimeneo4j.spatial.Point (and subclasses)ServiceUnavailable error
instead of a ValueError.neo4j.pool to a new sub-logger neo4j.session.ResultSummary.notificationsResultSummary.summary_notificationsneo4j.SummaryNotificationneo4j.NotificationCategoryneo4j.NotificationDisabledCategorynotifications_disabled_categories driver and session configuration option
in favor of notifications_disabled_classificationsResultSummary.gql_status_objectsneo4j.GqlStatusObjectneo4j.exceptions.GqlError, neo4j.exceptions.GqlErrorClassification)liveness_check_timeout configuration option), the driver will no longer remove the
remote from the cached routing tables, but only close the connection under test.connection_write_timeout with a default value of 30 seconds is introduced.SummaryCounters: repr and str to conform with Python's recommendations.Point and its subclasses: repr to conform with Python's recommendations.Duration and ClockTime: repr to be more consistent with other temporal driver types.GqlStatusObject: repr to conform with Python's recommendations.SummaryInputPosition: repr to be more informative.🔧️ Fixes
Complete Bolt 6.0 implementation: add support for UnsupportedType ( #1241 ).
Fix socket timeouts ( #1227 ).
Apply connection timeout hint only to reads (as it was intended).
Introduce new config option connection_write_timeout (default: 30 seconds ) to cover write operations.
ℹ️ The option is broken in this version and has no effect.
👏️ Improvements
Optimize error path in vector types ( #1226 ).
Improve repr string representation of spatial types ( #1231 ).
Improve repr and str string representations of SummaryCounters ( #1233 ).
Improve repr string representation of Duration and ClockTime ( #1235 ).
Improve repr string representation of internal classes (might change log output) ( #1236 ).
Improve repr string representation of GqlStatusObject and SummaryInputPosition ( #1234 ).
Unify str string representation of Vector with other drivers ( #1238 ).
Minor formatting fixes ( #1246 ).
📚️ Docs
Fix type hint resolution in docs ( #1247 ).
Drop documented support for Bolt 4.4 ( #1221 ).
Document continuation of support for Bolt 4.4 ( #1242 ).
Fix deprecations around notification APIs as part of migrating notifications to GQL status ( #1240 ).
Better explain security config options interplay ( #1239 ).
Minor API docs improvements ( #1247 , #1248 , #1251 ).
🧑️💻️ Development
Improve internal packstream Structure class for a better debugging and development experience ( #1232 ).
Bump development dependencies ( #1250 ).
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#600a1
https://github.com/neo4j/neo4j-python-driver/wiki/6.x-changelog#600a1
This release contains all fixes up until version 5.28.1 plus:
⭐️ New Features
Introduce Bolt 6.0 support with vector types ( #1214 ).
Chain failure causes on routing table fetching failure ( #1219 ). When a routing driver ( neo4j[+s[sc]] URL scheme), fails to fetch a routing table, instead of swallowing all errors from the connection and RT fetching attempts that lead up to the failure, the errors are not attached as cause of the raised error.
Introduce helper method GqlError.find_by_gql_status ( #1216 ).
🔧️ Fixes
Fix driver stuck on RecursionError on COMMIT SUCCESS ( #1192 ).
Fix re-authentication interfering with connectivity checks ( #1144 ).
⚠️ make unsupported comparisons return NotImplemented instead of False or raising ( #1199 ). This means that when comparing a driver type with another type is doesn't support, the other type gets the chance to handle the comparison. Affected types:
neo4j.Record
neo4j.graph.Node , neo4j.graph.Relationship , neo4j.graph.Path
neo4j.time.Date , neo4j.time.Time , neo4j.time.DateTime
neo4j.spatial.Point (and subclasses)
👏️ Improvements
⚠️ Align connection_acquisition_timeout configuration option with other drivers ( #1215 ). The timeout now spans anything required to acquire a working connection from the pool. This includes potential fetching of routing tables which in itself requires acquiring a connection. Previously, the timeout would be restarted for auxiliary connection acquisitions like those for fetching a routing table.
⚠️ Make DNS error retryable ( #1211 ). Configuring the driver with a URL that cannot be DNS resolved will raise a (retryable) ServiceUnavailable error instead of a ValueError .
Introduce new sub-logger neo4j.session ( #1206 ). This separates log entries that are session-related (including transaction retries) form sub-logger neo4j.pool .
⚠️ No longer implicitly closing drivers and sessions in del() (finalizer/destructor) ( #1183 ). Make sure to call .close() on them explicitly or use them in a with statement.
⚠️ Disallow using a closed driver ( #1182 ).
Raise DriverError on using the closed driver.
Calling driver.close() again is now a no-op.
⚠️ Slightly change Neo4jError and ClientError ( #1179 ).
Properties message and code are always a str (instead of str | None ).
Remove possibility to override/set message and code properties.
Remove undocumented, internal methods Neo4jError.hydrate , Neo4jError.invalidates_all_connections , and Neo4jError.is_fatal_during_discovery .
Remove deprecated method Neo4jError.is_retriable . Use Neo4jError.is_retryable instead.
Change string representation of Neo4jError to include GQL error information.
⚠️ Raise ConfigurationError instead of ignoring the routing context (URI query parameters) when creating a direct driver ( "bolt[+s[sc]]://" scheme) ( #1178 ).
⚠️ Raise new ConnectionAcquisitionTimeoutError (subclass of DriverError ) instead of ClientError (subclass of Neo4jError ) the connection_acquisition_timeout is exceeded ( #1169 ).
This improves the differentiation between DriverError for client-side errors and Neo4jError for server-side errors.
⚠️ Raise TypeError instead of ValueError when passing a Query object to Transaction.run ( #1171 ).
⚠️ Raise TransactionError (subclass of DriverError ) instead of ClientError (subclass of Neo4jError ) when calling session.run() while an explicit transaction is active on that session ( #1170 ).
This improves the differentiation between DriverError for client-side errors and Neo4jError for server-side errors.
It is now the same error raised as when trying to start an explicit transaction while another explicit transaction is already active.
⚠️ Improve validation of connection_acquisition_timeout configuration option ( #1168 ).
Raise ValueError on invalid values (instead of ClientError ).
Consistently restrict the value to be strictly positive.
⚠️ Raise neo4j.exceptions.UnsupportedServerProduct if no common bolt protocol version could be negotiated with the server (instead of internal neo4j._exceptions.BoltHandshakeError ) ( #1164 , #1224 ). UnsupportedServerProduct is now a subclass of ConfigurationError (instead of Exception directly).
⚠️ Improve validation of access_mode configuration option ( #1166 ).
ValueError on invalid value (instead of ClientError ).
Consistently check the value (also for non-routing drivers).
⚠️ Raise ConfigurationError if the passed auth parameters is not valid (instead of AuthError ) ( #1162 ).
This improves the differentiation between DriverError for client-side errors and Neo4jError for server-side errors.
📚️ Docs
Document that is_retryable is not applicable to auto-commit transactions ( #1217 ).
Fix formatting, wording, and minor updates for 6.0 ( #1200 ).
Minor fixes: add more links and versions changed/added remarks ( #1146 ).
🌳️ Maturing
Stabilize GQL status objects (use these instead of notifications) ( #1209 ). Affected APIs:
ResultSummary.gql_status_objects
neo4j.GqlStatusObject
( neo4j.exceptions.GqlError , neo4j.exceptions.GqlErrorClassification )
Stabilize driver debug mode ( #1205 ).
warn_notification_severity config option
concurrency checker
🧹️ Clean-up
⚠️ Bump minimum supported Python version to 3.10 ( #1153 ).
Drop support for Python 3.7 (end of life 2023-06-27)
Drop support for Python 3.8 (end of life 2024-10-07)
Drop support for Python 3.9 (end of life scheduled for 2025-10).
⚠️ Remove deprecated Bookmark in favor or Bookmarks ( #1175 , #1196 ).
Remove deprecated class neo4j.Bookmark in favor of neo4j.Bookmarks .
Remove deprecated method session.last_bookmark() in favor of last_bookmarks() .
Deprecate passing raw sting bookmarks as initial_bookmarks to GraphDatabase.bookmark_manager() . Use a neo4j.Bookmarks object instead.
Driver.session() no longer accepts raw string bookmarks as bookmarks argument. Use a neo4j.Bookmarks object instead.
⚠️ Remove deprecated ServerInfo.connection_id ( #1193 ). There is no replacement as this is considered internal information.
⚠️ Make undocumented internal constants, helper functions, and other items private.
neo4j.api ( #1176 , #1186 ).
DRIVER_BOLT
DRIVER_NEO4J
SECURITY_TYPE_NOT_SECURE
SECURITY_TYPE_SECURE
SECURITY_TYPE_SELF_SIGNED_CERTIFICATE
check_access_mode
parse_neo4j_uri
parse_routing_context
neo4j.exceptions ( #1176 , #1195 ).
CLASSIFICATION_CLIENT
CLASSIFICATION_DATABASE
CLASSIFICATION_TRANSIENT
ERROR_REWRITE_MAP
client_errors
transient_errors
all other indirectly exposed items from imports (e.g. typing as neo4j.exceptions.t )
neo4j.time ( #1191 ).
DATE_ISO_PATTERN
TIME_ISO_PATTERN
DURATION_ISO_PATTERN
NANO_SECONDS
AVERAGE_SECONDS_IN_MONTH
AVERAGE_SECONDS_IN_DAY
FORMAT_F_REPLACE
IS_LEAP_YEAR
DAYS_IN_YEAR
DAYS_IN_MONTH
round_half_to_even
symmetric_divmod
DateTimeType
DateType
TimeType
all other indirectly exposed items from imports (e.g. re as neo4j.time.re )
neo4j.spatial ( #1188 ).
hydrate_point
dehydrate_point
point_type
neo4j.GraphDatabase ( #1181 ).
.bolt_driver
.neo4j_driver
neo4j.BoltDriver and neo4j.Neo4jDriver ( #1181 ).
.open
.parse_target
.default_host
.default_port
.default_target
neo4j.graph , neo4j.addressing , neo4j.api ( #1195 ).
indirectly exposed items from imports (e.g. collections.abc.Mapping as neo4j.graph.Mapping ).
BoltDriver and Neo4jDriver ( ).
.open
.parse_target
.default_host
.default_port
.default_target
neo4j.debug ( #1194 ).
ColourFormatter
TaskIdFilter
all other indirectly exposed items from imports (e.g. asyncio as neo4j.debug.asyncio )
⚠️ Remove deprecated option to index EntitySetView by int id ( #1187 ). Graph type sets ( neo4j.graph.EntitySetView ) can no longer by indexed by legacy id ( int , e.g., graph.nodes[0] ). Use the element_id instead ( str , e.g., graph.nodes["..."] ).
⚠️ Make Summary.summary_notifications a tuple instead of a list and type it with Sequence to signify that it should be treated as immutable ( #1185 ).
⚠️ Remove deprecated session.read_transaction and session.write_transaction ( #1184 ). Instead, use session.execute_read and session.execute_write respectively.
⚠️ Deprecate notifications (use GQL status objects instead) ( #1209 ). Deprecated APIs:
ResultSummary.notifications
ResultSummary.summary_notifications
neo4j.SummaryNotification
neo4j.NotificationCategory
neo4j.NotificationDisabledCategory
⚠️ Remove deprecated driver configuration option trust ( #1177 ). Use trusted_certificates instead.
Remove the associated constants neo4j.TRUST_ALL_CERTIFICATES and neo4j.TRUST_SYSTEM_CA_SIGNED_CERTIFICATES .
⚠️ Rework PreviewWarning ( #1173 ).
Remove ExperimentalWarning and turn the few left instances of it into PreviewWarning .
Deprecate importing PreviewWarning from neo4j . Import it from neo4j.warnings instead.
⚠️ Make undocumented classes ResolvedAddress , ResolvedIPv4Address , and ResolvedIPv6Address private ( #1174 ).
⚠️ Remove deprecated Record.getslice . This magic method has been removed in Python 3.0 ( #1172 ). If you were calling it directly, please use Record.getitem(slice(...)) or simply record[...] instead.
⚠️ ServerInfo.protocol_version now is a tuple[int, int] insteadof a api.Version ( #1164 ).
This should be drop-in replacement is most cases:
Version was a sup-type of tuple[int, int] .
ServerInfo.protocol_version was already documented and typed as tuple[int, int] .
Version 's additional methods were undocumented and shouldn't have been used.
api.Version has been removed as it's unused now.
⚠️ Remove deprecated exports from neo4j ( #1160 ).
log , Config , PoolConfig , SessionConfig , WorkspaceConfig (internal - no replacement).
SummaryNotificationPosition (use SummaryInputPosition instead).
⚠️ Remove deprecated modules ( #1159 ):
neo4j.conf
neo4j.data
neo4j.meta
neo4j.packstream
neo4j.routing
neo4j.time.arithmetic
neo4j.time.clock_implementation
neo4j.time.hydration
neo4j.time.metaclasses
neo4j.work
neo4j.work.query
neo4j.work.summary
⚠️ Deprecate ClockTime and its accessors ( #1191 ).
For each neo4j.time.Date , neo4j.time.DateTime , neo4j.time.Time
from_clock_time and to_clock_time methods
neo4j.time.ClockTime itself.
Lift server agent string restrictions ( #1208 ).
📦️ Packaging
⚠️ Remove deprecated package alias neo4j-driver ( #1161 ). Use pip install neo4j instead.
⚠️ Remove setup.py . Please use a recent enough packaging/build tool that supports pyproject.toml ( #1161 ).
PEP 639 style licensing metadata ( #1207 ).
🧑️💻️ Development
Bump pre-commit hooks and fix new lints ( #1204 ).
Use dependency-groups in pyproject.toml for dev dependencies ( #1201 ).
Fix ParamSpec type annotation of internal method ( #1157 ).
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5288-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5287-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5286-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5285-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5284-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5284-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5283-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5283-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5282-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5282-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5281-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5281-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5280-lts
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5280-lts
Relationships are tied to the Graph object they belong to, fixing pickle support for graph types means that Relationships with the same name will have a different type after deepcopying or pickling and unpickling them or their graph.
For more details, see https://github.com/neo4j/neo4j-python-driver/pull/1133https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5270
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5270
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5260
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5260
Neo4jError like message and code.Neo4jError.hydrate.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5250
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5250
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5240
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5240
neo4j.auth_management.RotatingClientCertificateProvider and
...AsyncRotatingClientCertificateProvider (in preview)
abstract classes, meaning they can no longer be instantiated directly.neo4j.auth_management.RotatingClientCertificateProvider.rotating and
....AsyncRotatingClientCertificateProvider.rotating() respectively.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5231
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5231
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5230
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5230
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5220
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5220
SummaryNotificationPosition has been deprecated in favor of SummaryInputPosition.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5210
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5210
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5200
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5200
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5190
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5190
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5180
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5180
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5170
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5170
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5160
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5160
neo4j.io: For socket and bolt protocol related logging.neo4j.pool: For logs pertaining to connection pooling and routing.neo4j.auth_management: For logging inside the provided AuthManager
implementations.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5150
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5150
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5141
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5141
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5140
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5140
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5130
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5130
neo4j.Driver and neo4j.AsyncDriver after calling .close() on them,
except for calling .close() again, which has no effects.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5120
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5120
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5110
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5110
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5100
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#5100
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#590
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#590
neo4j.auth_management.ExpiringAuth's expires_in (in preview) was replaced
by expires_at, which is a unix timestamp.ExpiringAuth(some_auth).expires_in(123) instead.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#581
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#581
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#580
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#580
neo4j.RoutingControl.READERS to READ and WRITERS to
WRITE.driver.query_bookmark_manager to
execute_query_bookmark_manager.driver.execute_query not is typed
LiteralString instead of str to help mitigate accidental Cypher
injections. There are rare use-cases where a computed string is necessary.
Please use # type: ignore, or typing.cast to suppress the type checking in
those cases.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#570
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#570
neo4j.work and its submodules.
Everything should be imported directly from neo4j instead.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#560
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#560
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#550
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#550
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#540
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#540
Neo4jError.is_fatal_during_discovery and
Neo4jError.invalidates_all_connections have been deprecated and will be
removed without replacement in version 6.0.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#530
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#530
neo4j.data.map_typeLiteralString instead of str to help mitigate
accidental Cypher injections. There are rare use-cases where a computed
string is necessary. Please use # type: ignore, or typing.cast to
suppress the type checking in those cases.neo4j.BookmarkManger and neo4j.AsyncBookmarkManger abstract base
classes:
update_bookmarks has no longer a database argument.get_bookmarks has no longer a database argument.get_all_bookmarks method was removed.forget method was removed.neo4j.GraphDatabase.bookmark_manager and
neo4j.AsyncGraphDatabase.bookmark_manager factory methods:
initial_bookmarks is no longer a mapping from database name
to bookmarks but plain bookmarks.bookmarks_supplier no longer receives the database name as
an argument.bookmarks_consumer no longer receives the database name as
an argument.https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#521
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#521
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#520
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#520
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#510
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#510
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#501
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#501
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#500
https://github.com/neo4j/neo4j-python-driver/wiki/5.x-changelog#500
Result, Session, and Transaction can no longer be imported from
neo4j.work. They should've been imported from neo4j all along.noe4j if
available, not its submodules or subpackages.ResultSummary.server.version_info has been removed.ResultSummary.server.agent, ResultSummary.server.protocol_version,
or call the dbms.components procedure instead.trust has been deprecated and will be removed in a future release.trusted_certificates instead.
See the API documentation for more details.neo4j.time module:
Duration
subseconds anymore.milliseconds, microseconds, or nanoseconds instead.subseconds has been removed.nanoseconds instead.hours_minutes_seconds has been removed.hours_minutes_seconds_nanoseconds instead.months, days, nanoseconds).
This affects (i.e., changes) the working of //, %, /, and *.
seconds, milliseconds, microseconds, and nanoseconds are
implicitly converted to nanoseconds or seconds as fit.Time
floats for second anymore.nanosecond instead.int).
ticks_ns has been renamed to ticks.ticks is no longer supported.from_ticks_ns has been renamed to from_ticks.from_ticks is no longer supported.second returns an int instead of a float.nanosecond to get the sub-second information.hour_minute_second has been removed.hour_minute_second_nanosecond instead.DateTime
hour_minute_second has been removed.hour_minute_second_nanosecond instead.second returns an int instead of a float.nanosecond to get the sub-second information.bolt[+s[sc]]:// scheme and a routing context has
been deprecated and will raise an error in the Future. The routing context was
and will be silently ignored until then.Session.last_bookmark was deprecated. Its behaviour is partially incorrect
and cannot be fixed without breaking its signature.Session.last_bookmarks instead.neo4j.Bookmark was deprecated.neo4j.Bookmarks instead.ResourceWarning is emitted instead.peek, single, iter, ...)
after their owning transaction has been closed, committed, or rolled back.
Previously, this would yield undefined behavior.
It now raises a ResultConsumedError.peek, single, iter, ...)
after the Result has been consumed (Result.consume()).
Previously, this would always yield no records.
It now raises a ResultConsumedError.Result.closed() can be used to check for this condition if
necessary.driver.verify_connectivity() has been
removed. If you need information about the remote server, use
driver.get_server_info() instead.ManagedTransaction
object. It behaves exactly like a regular Transaction object, except it
does not offer the commit, rollback, close, and closed methods.id property (int) in favor of
element_id (str).Graph objects as indexing graph.nodes[...] and
graph.relationships[...] with integers has been deprecated in favor of
indexing them with strings.ServerInfo.connection_id has been deprecated and will be removed in a
future release. There is no replacement as this is considered internal
information.neo4j.debug.watch changes
neo4j.exceptions.Neo4jError.is_retriable().neo4j.exceptions.Neo4jError.is_retryable() instead.neo4j.time (neo4j.time.xyz) has been deprecated.
Everything needed should be imported from neo4j.time directly.neo4j.spatial.hydrate_point and neo4j.spatial.dehydrate_point have been
deprecated without replacement. They are internal functions.neo4j.packstream has been deprecated. It's internal and should not
be used by client code.neo4j.routing has been deprecated. It's internal and should not
be used by client code.neo4j.config has been deprecated. It's internal and should not
be used by client code.neoj4.Config, neoj4.PoolConfig, neoj4.SessionConfig, and
neoj4.WorkspaceConfig have been deprecated without replacement. They are
internal classes.neo4j.meta has been deprecated. It's internal and should not
be used by client code. ExperimantalWarning should be imported directly from
neo4j. neo4j.meta.version is exposed through neo4j.__vesrion__neo4j.data has been deprecated. It's internal and should not
be used by client code. Record should be imported directly from neo4j
instead. neo4j.data.DataHydrator and neo4j.data.DataDeydrator have been
removed without replacement.protocol_version and init_size.neo4j.exceptions.SessionError that is raised when trying to
execute work on a closed or otherwise terminated session.update_routing_table_timeout and
session_connection_timeout.connection_acquisition_timeout are sufficient to avoid the
driver getting stuck.Session.read_transaction and Session.write_transaction in favor
of Session.execute_read and Session.execute_write respectively.https://github.com/neo4j/neo4j-python-driver/wiki/5.0-changelog#500a2
https://github.com/neo4j/neo4j-python-driver/wiki/5.0-changelog#500a2
IMPORTANT: this pre-release does not contain any 5.0 features and future pre-releases might have to be API-breaking. This release' sole purpose it to
IMPORTANT: this pre-release does not contain any 5.0 features and future pre-releases might have to be API-breaking. This release' sole purpose it to give early access to the async driver.
For more details see the changelog: https://github.com/neo4j/neo4j-python-driver/wiki/5.0-changelog#500a1
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#4413
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#4413
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#4412
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#4412
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#4411
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#4411
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#4410
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#4410
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#449
https://github.com/neo4j/neo4j-python-driver/wiki/4.4-changelog#449
One column per quarter.