Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Py2neo

PyPI version PyPI Downloads License Coverage Status

Py2neo is a client library and toolkit for working with Neo4j from within Python applications. The library supports both Bolt and HTTP and provides a high level API, an OGM, admin tools, a Cypher lexer for Pygments, and many other bells and whistles.

Command line tooling has been removed from the library in py2neo 2021.2. This functionality now exists in the separate ipy2neo project.

As of version 2021.1, py2neo contains full support for routing, as exposed by a Neo4j cluster. This can be enabled using a neo4j://... URI or by passing routing=True to a Graph constructor.

Installation & Compatibility

To install the latest release of py2neo, simply use:

$ pip install py2neo

The following versions of Python and Neo4j (all editions) are supported:

Neo4j

Python 3.5+

Python 2.7

4.4

GitHub workflow status for tests against Neo4j 4.4 using py35+

GitHub workflow status for tests against Neo4j 4.4 using py27

4.3

GitHub workflow status for tests against Neo4j 4.3 using py35+

GitHub workflow status for tests against Neo4j 4.3 using py27

4.2

GitHub workflow status for tests against Neo4j 4.2 using py35+

GitHub workflow status for tests against Neo4j 4.2 using py27

4.1

GitHub workflow status for tests against Neo4j 4.1 using py35+

GitHub workflow status for tests against Neo4j 4.1 using py27

4.0

GitHub workflow status for tests against Neo4j 4.0 using py35+

GitHub workflow status for tests against Neo4j 4.0 using py27

3.5

GitHub workflow status for tests against Neo4j 3.5 using py35+

GitHub workflow status for tests against Neo4j 3.5 using py27

3.4

GitHub workflow status for tests against Neo4j 3.4 using py35+

GitHub workflow status for tests against Neo4j 3.4 using py27

Note that py2neo is developed and tested under Linux using standard CPython distributions. While other operating systems and Python distributions may work, support for these is not available.

Quick Example

To run a query against a local database is straightforward:

>>> from py2neo import Graph
>>> graph = Graph("bolt://localhost:7687", auth=("neo4j", "password"))
>>> graph.run("UNWIND range(1, 3) AS n RETURN n, n * n as n_sq")
   n | n_sq
-----|------
   1 |    1
   2 |    4
   3 |    9

Releases & Versioning

As of 2020, py2neo has switched to Calendar Versioning, using a scheme of YYYY.N.M. Here, N is an incrementing zero-based number for each year, and M is a revision within that version (also zero-based).

No compatibility guarantees are given between versions, but as a general rule, a change in M should require little-to-no work within client applications, whereas a change in N may require some work. A change to the year is likely to require a more significant amount of work to upgrade.

Note that py2neo is developed on a rolling basis, so patches are not made to old versions. Users will instead need to install the latest release to adopt bug fixes.

More

For more information, read the handbook.

Metadata

Release files for py2neoglo4035 2021.2.dev0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for py2neoglo4035 2021.2.dev0
File Size Uploaded
py2neoglo4035-2021.2.dev0.tar.gz 156.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for py2neoglo4035 2021.2.dev0
File Interpreter ABI Platform
py2neoglo4035-2021.2.dev0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 333.4 kB

Release files / py2neoglo4035-2021.2.dev0.tar.gz

Download URL py2neoglo4035-2021.2.dev0.tar.gz
Size 156.3 kB
Tags Source
SHA-256 checksum
How to use checksums
a0ee3f39581dfa0fc4be964a1c953243e5694f3c51cb9667f5c23a1919fffecd
BLAKE2b-256 checksum
How to use checksums
7977b1f1bff38c1b46068b6ac01dd48023e16ed4a9b250678924750bb68dc86c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.16

Release files / py2neoglo4035-2021.2.dev0-py2.py3-none-any.whl

Download URL py2neoglo4035-2021.2.dev0-py2.py3-none-any.whl
Size 177.1 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
5ae3c0105cb146d6c1a491eed9f0fa45571d767bbd67fdd4120df21fbed2836c
BLAKE2b-256 checksum
How to use checksums
c67c245818f011ad61538cc2df77e8bd9adb9161f2d36210684391dfd0acfac5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.16

Release history Release notifications | RSS feed

This release

2021.2.dev0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page