neo4j

# Node-Neo4j <a href="https://travis-ci.org/thingdom/node-neo4j" style="float: right; margin-left: 0.25em;"><img src="https://travis-ci.org/thingdom/node-neo4j.png?branch=master"/></a> <a href="http://badge.fury.io/js/neo4j" style="float: right;"><img src="https://badge.fury.io/js/neo4j.svg" alt="npm version" height="18"></a> This is a [Node.js][node.js] driver for [Neo4j][neo4j] via it's [REST API][neo4j-rest-api]. **This driver has undergone a complete rewrite for Neo4j v2.** It now *only* supports Neo4j 2.x — but it supports it really well. (If you're still on Neo4j 1.x, you can still use [node-neo4j v1](https://github.com/thingdom/node-neo4j/tree/v1).) ## What is Neo4j? Neo4j is a transactional, open-source graph database. A graph database manages data in a connected data structure, capable of representing any kind of data in a very accessible way. Information is stored in nodes and relationships connecting them, both of which can have arbitrary properties. To learn more visit [What is a Graph Database?][what-is-a-graph-database]   ## Installation ```sh npm install neo4j --save ``` ## Usage ```js var neo4j = require('neo4j'); var db = new neo4j.GraphDatabase('http://username:password@localhost:7474'); db.cypher({ query: 'MATCH (u:User {email: {email}}) RETURN u', params: { email: 'alice@example.com', }, }, function (err, results) { if (err) throw err; var result = results[0]; if (!result) { console.log('No user found.'); } else { var user = result['u']; console.log(JSON.stringify(user, null, 4)); } }); ``` Yields e.g.: ```json { "_id": 12345678, "labels": [ "User", "Admin" ], "properties": { "name": "Alice Smith", "email": "alice@example.com", "emailVerified": true, "passwordHash": "..." } } ``` ## Getting Help If you're having any issues you can first refer to the [API documentation][api-docs]. If you encounter any bugs or other issues, please file them in the [issue tracker][issue-tracker]. We also now have a [Google Group][google-group]! Post questions and participate in general discussions there. You can also [ask a question on StackOverflow][stackoverflow-ask] ## Neo4j version support | **Version** | **Ver 1.x** | **Ver 2.x** | |-------------|--------------|-------------| | 1.5-1.9 | Yes | No | | 2.0 | Yes | Yes | | 2.1 | Yes | Yes | | 2.2 | No | Yes | ## Neo4j feature support | **Feature** | **Ver 1.x** | **Ver 2.x** | |----------------------|-------------|-------------| | Auth | No | Yes | | Remote Cypher | Yes | Yes | | Transactions | No | No | | High Availability | No | No | | Embedded JVM support | No | No |  Node.js is asynchronous, which means this library is too: most functions take callbacks and return immediately, with the callbacks being invoked when the corresponding HTTP requests and responses finish. Because async flow in Node.js can be quite tricky to handle, we strongly recommend using a flow control tool or library to help. Our personal favorite is [Streamline.js][], but other popular choices are [async](https://github.com/caolan/async), [Step](https://github.com/creationix/step), [Seq](https://github.com/substack/node-seq), [TameJS](http://tamejs.org/) and [IcedCoffeeScript](http://maxtaco.github.com/coffee-script/). Once you've gotten the basics down, skim through the full **[API documentation][api-docs]** to see what this library can do, and take a look at [@aseemk][aseemk]'s [node-neo4j-template][] app for a complete usage example. (The `models/User.js` file in particular is the one that interacts with this library.) This library is officially stable at "v1", but "v2" will almost certainly have breaking changes to support only Neo4j 2.0 and generally improve the API ([roadmap][]). You can be sheltered from these changes if you simply specify your package.json dependency as e.g. `1.x` or `^1.0` instead of `*`. [Roadmap]: https://github.com/thingdom/node-neo4j/wiki/Roadmap ## Development git clone git@github.com:thingdom/node-neo4j.git cd node-neo4j npm install && npm run clean You'll need a local installation of Neo4j ([links](http://neo4j.org/download)), and it should be running on the default port of 7474 (`neo4j start`). To run the tests: npm test This library is written in [CoffeeScript][], using [Streamline.js][] syntax. The tests automatically compile the code on-the-fly, but you can also generate compiled `.js` files from the source `._coffee` files manually: npm run build This is in fact what's run each time this library is published to npm. But please don't check the generated `.js` files in; to remove: npm run clean When compiled `.js` files exist, changes to the source `._coffee` files will *not* be picked up automatically; you'll need to rebuild. If you `npm link` this module into another app (like [node-neo4j-template][]) and you want the code compiled on-the-fly during development, you can create an `index.js` file under `lib/` with the following: ```js require('coffee-script/register'); require('streamline/register'); module.exports = require('./index._coffee'); ``` But don't check this in! That would cause all clients to compile the code on-the-fly every time, which isn't desirable in production. ## Changes See the [Changelog][changelog] for the full history of changes and releases. ## License This library is licensed under the [Apache License, Version 2.0][license]. [neo4j]: http://neo4j.org/ [what-is-a-graph-database]: http://neo4j.com/developer/graph-database/ [node.js]: http://nodejs.org/ [neo4j-rest-api]: http://docs.neo4j.org/chunked/stable/rest-api.html [api-docs]: http://coffeedoc.info/github/thingdom/node-neo4j/master/ [aseemk]: https://github.com/aseemk [node-neo4j-template]: https://github.com/aseemk/node-neo4j-template [semver]: http://semver.org/ [coffeescript]: http://coffeescript.org/ [streamline.js]: https://github.com/Sage/streamlinejs [changelog]: CHANGELOG.md [issue-tracker]: https://github.com/thingdom/node-neo4j/issues [license]: http://www.apache.org/licenses/LICENSE-2.0.html [google-group]: https://groups.google.com/group/node-neo4j [stackoverflow-ask]: http://stackoverflow.com/questions/ask?tags=node.js,neo4j,thingdom