This repository contains 2 implementation of a neo4j driver for ruby:
- based on official java implementation. It provides a thin wrapper over the java driver (only on jruby).
- pure ruby implmementation. Available on all ruby versions >= 3.1.
Add this line to your application's Gemfile:
And then execute:
Or install it yourself as:
$ gem install neo4j-ruby-driver
The compatibility with Neo4j Server versions is documented in the Neo4j Knowledge Base.
The API is to highest possible degree consistent with the official java driver. At this moment The Neo4j Drivers Manual v4.4 along with the ruby version of the code fragments and the ruby specs provide the only documentation.
Neo4j Java Driver 4.3 API can be helpful as well..
This gem includes 2 different implementations: java driver wrapper and pure ruby driver
To run the tests the following tools need to be installed:
$ brew install python $ pip3 install --user git+https://email@example.com#egg=boltkit $ neoctrl-install -e 4.4.5 servers $ neoctrl-configure servers/neo4j-enterprise-4.4.5 dbms.directories.import= dbms.default_listen_address=:: $ neoctrl-set-initial-password pass servers/neo4j-enterprise-4.4.5 $ neoctrl-start servers/neo4j-enterprise-4.4.5
To run the tests:
$ bin/setup $ rspec spec
- In case of heap space memory error (
org.neo4j.driver.exceptions.DatabaseException: Java heap space), you should limit the dbms memory, for example:
$ neoctrl-configure servers/neo4j-enterprise-4.4.5 dbms.memory.pagecache.size=600m dbms.memory.heap.max_size=600m dbms.memory.heap.initial_size=600m dbms.directories.import= dbms.connectors.default_listen_address=::
- When using command
pip3 install --user git+https://firstname.lastname@example.org#egg=boltkit, if you have m1 mac chip, you may get error when pip3 tries to install
cryptography. Steps to take in that case (reference https://stackoverflow.com/a/70074869/2559490)
$ pip uninstall cffi $ python -m pip install --upgrade pip $ pip install cffi $ pip install cryptography
Suggestions, improvements, bug reports and pull requests are welcome on GitHub at https://github.com/neo4jrb/neo4j-ruby-driver.
The gem is available as open source under the terms of the MIT License.