To install, run:
pip install cy2py
Or clone this repository and run:
python setup.py install
You can use cy2py in two ways:
-
as a line magic, it returns a Python dataframe that you can than manipulate as you wish
-
as cell magic that will print a graph or dataframe if the result is tabular
You can check the list of accepted arguments by running the following command:
%cypher?
%cypher [-a ALIAS] [-u URI] [-us USERNAME] [-pw PASSWORD] [-db DATABASE]
[-q QUERY] [-p PARAMS] [-c CLOSE] [-co COLORS] [-ca CAPTIONS]
[-la LAYOUT] [-l]
optional arguments:
-a ALIAS, --alias ALIAS
The Neo4j connection configuration alias. You after
you defined it the first time in combination with the
other arguments you can use only it to connect to the
Neo4j instance without repassing the arguments each
time. If you don't specify it the first time you'll
pass the config it'll became the default for each
connection
-u URI, --uri URI The Neo4j URI. You can use this kind of URI in order
to define a specific database to query:
neo4j:https://localhost:7687/my-db
-us USERNAME, --username USERNAME
The Neo4j User
-pw PASSWORD, --password PASSWORD
The Neo4j Password
-db DATABASE, --database DATABASE
The Neo4j Database, if not provided we use the default
-q QUERY, --query QUERY
Pass the Cypher query as argument. Valid only when you
use line magic.
-p PARAMS, --params PARAMS
A map of Cypher query parameters
-c CLOSE, --close CLOSE
Close a Driver connection by alias or URI
-co COLORS, --colors COLORS
A map label/color
-ca CAPTIONS, --captions CAPTIONS
A map label/caption
-la LAYOUT, --layout LAYOUT
A map for layout configuration
-l, --list List active configurations
Under the examples directory you'll find a Google Colab notebook that shows how to use cy2py in order to dive into a Neo4j crime dataset showing also how is easy to seamlessly leverage other visualization libraries such as Ploty.