Neomodel documentation

An Object Graph Mapper (OGM) for the Neo4j graph database, built on the awesome neo4j_driver

• Familiar Django model style definitions.
• Powerful query API.
• Enforce your schema through cardinality restrictions.
• Full transaction support.
• Thread safe.
• pre/post save/delete hooks.
• Django integration via django_neomodel

Requirements

For releases 5.x : - Python 3.7+ - neo4j 5.x, 4.4 (LTS)

For releases 4.x : - Python 3.7 -> 3.10 - Neo4j 4.x (including 4.4 LTS for neomodel version 4.0.10)

Installation

Install from pypi (recommended):

$ pip install neomodel

To install from github:

$ pip install git+git://github.com/neo4j-contrib/neomodel.git@HEAD#egg=neomodel-dev

Contents

• Getting started
  • Connecting
  • Defining Node Entities and Relationships
  • Applying constraints and indexes
  • Remove existing constraints and indexes
  • Create, Update, Delete operations
  • Retrieving nodes
  • Relationships
• Relationships
  • Cardinality
  • Properties
  • Relationship Uniqueness
  • Relationships and Inheritance
  • Explicit Traversal
• Property types
  • Naming Convention
  • Defaults
  • Mandatory / Optional Properties
  • Choices
  • Array Properties
  • Unique Identifiers
  • Dates and times
  • Other properties
  • Aliasing properties
  • Independent database property name
  • Notes
• Spatial Properties
  • The Point
  • Points in Neo4j
  • Points in neomodel
  • NeomodelPoint in detail
  • PointProperty in detail
  • Examples
• Advanced queries
  • Node sets and filtering
  • Complex lookups with Q objects
  • Has a relationship
  • Iteration, slicing and more
  • Filtering by relationship properties
  • Ordering by property
• Cypher queries
  • Stand alone
  • Logging
  • Utilities
• Transactions
  • Basic usage
  • Explicit Transactions
  • Bookmarks
• Hooks
  • Hooks on relationships
• Batch node operations
  • create()
  • create_or_update()
  • get_or_create()
• Configuration
  • Database
  • Enable automatic index and constraint creation
  • Require timezones on DateTimeProperty
• Extending neomodel
  • Inheritance
  • Mixins
  • Overriding the StructuredNode constructor
  • Automatic class resolution
  • neomodel under multiple processes and threads
• Modules documentation
  • Database
  • Core
  • Properties
  • Relationships
  • Match
  • Exceptions

Indices and tables

• Index
• Module Index