Update from pre 1.0.0

If you have been using Data2Neo prior to version 1.0.0, you will need to update your code. The following changes have been made:

RELATION to RELATIONSHIP

The keyword RELATION has been renamed to RELATIONSHIP. This is to be consistent with the naming scheme in neo4j. Simply replace all instances of RELATION with RELATIONSHIP in your schema.

Py2neo to native neo4j driver

With the release of Data2Neo 1.0.0, the underlying driver for neo4j has been changed from py2neo to the native neo4j driver. Py2neo has been deprecated and is no longer supported. This means that you will need to update your code to use the new driver. The following changes have been made:

1. The Converter now takes a uri and credentials instead of a graph object.

# Old
from py2neo import Graph
from data2neo import Converter

graph = Graph("bolt://localhost:7687", auth=("neo4j", "password"))
converter = Converter(schema, iterator, graph)

# New
from data2neo import Converter
import neo4j

uri = "bolt://localhost:7687"
auth = neo4j.basic_auth("neo4j", "password")

converter = Converter(schema, iterator, uri, auth)

2. If you use wrappers that operate on the py2neo graph object, you will need to update them to use the native neo4j driver. The Global Shared State provides the neo4j driver with GlobalSharedState.graph_driver. Further the neo4j module provides the Node, Relationship and Subgraph classes, similar to py2neo. To push a subgraph to the neo4j database, use the create and merge methods.

# Old
from py2neo import Graph
from data2neo import register_subgraph_postprocessor
from py2neo import Node

@register_subgraph_postprocessor
def add_node(subgraph):
    # create a new node
    node = Node("Label", name="name")
    subgraph |= node
    return subgraph

@register_subgraph_postprocessor
def change_graph(graph, subgraph):
    # add a new node to the graph
    GlobalSharedState.graph.create(Node("Label", name="name"))
    return subgraph

# New
from data2neo import register_subgraph_postprocessor, GlobalSharedState
from data2neo.neo4j import create, Node, Subgraph, Relationship

@register_subgraph_postprocessor
def add_node(subgraph):
    # create a new node
    node = Node("Label", name="name")
    subgraph |= node
    return subgraph

@register_subgraph_postprocessor
def change_graph(graph, subgraph):
    # add a new node to the graph
    with GlobalSharedState.graph_driver.session() as session:
        create(Node("Label", name="name"), session) # or merge
    return subgraph