neo4j 1.0.0.beta.21-java

data/CHANGELOG

@@ -0,0 +1,141 @@
+== 0.4.4 / 2010-08-01
+* Fixed bug on traversing when using the RelationshipMixin (#121)
+* BatchInserter and JRuby 1.6 - Fix iteration error with trying to modify in-place hash
+
+== 0.4.3 / 2010-04-10
+* Fixed .gitignore - make sure that we do not include unnecessarily files like neo4j databases. Release 0.4.2 contained test data.
+* Added synchronize around Index.new so that two thread can't modify the same index at the same time.
+
+== 0.4.2 / 2010-04-08
+*  No index on properties for the initialize method bug (#116)
+*  Tidy up Thread Synchronization in Lucene wrapper - lucene indexing performance improvement (#117)
+*  Permission bug loading neo4j jar file (#118)
+*  Spike: Make NodeMixin ActiveModel complient - experimental (#115)
+
+== 0.4.1 / 2010-03-11
+* Migrations (#108)
+* BatchInserter (#111)
+* Neo4j::Relationship.new should take a hash of properties (#110)
+* Upgrade to neo4j-1.0 (#114)
+* Bigfix: has_one should replace old relationship (#106)
+* Bugfix: custom accessors for NodeMixin#update (#113)
+* Bugfix: Indexed properties problem on extented ruby classes critical "properties indexer" (#112)
+
+== 0.4.0 / 2010-02-06
+* Performance improvements and Refactoring: Use and Extend Neo4j Java Classes (#97)
+* Support for Index and Declaration of Properties on Relationships (#91)
+* Upgrade to neo4j-1.0 rc (#100)
+* All internal properties should be prefix with a '_',0.4.0 (#105)
+* Generate relationship accessor methods for declared has_n and has_one relationships (#104)
+* New way of creating relationship - Neo4j::Relationship.new (#103)
+* Neo4j#init_node method should take one or more args (#98)
+* Namespaced relationships: has_one...from using the wrong has_n...to(#92)
+* Neo4j::NodeMixin and Neo4j::Node should allow a hash for initialization (#99)
+
+== 0.3.3 / 2009-11-25
+* Support for a counter property on has_lists (#75)
+* Support for Cascade delete. On has_n, had_one and has_list (#81)
+* NodeMixin#all should work with inheritance - Child classes should have a relationship of their own. (#64)
+* Support for other lucene analyzer then StandardAnalyzer (#87)
+* NodeMixin initialize should accept block like docs (#82)
+* Add incoming relationship should work as expected: n1.relationships.incoming(:foo) << n2 (#80)
+* Delete node from a has_list relationship should work as expected (#79)
+* Improve stacktraces (#94)
+* Removed sideeffect of rspecs (#90)
+* Add debug method on NodeMixin to print it self (#88)
+* Removed to_a method (#73)
+* Upgrade to neo4j-1.0b10 (#95)
+* Upgrade to lucene 2.9.0 (#83)
+* Refactoring: RSpecs (#74)
+* Refactoring: aggregate each, renamed to property aggregator (#72)
+* BugFix: neo4j gem cannot be built  from the source (#86)
+* BugFix: Neo4j::relationship should not raise Exception if there are no relationships (#78)
+
+== 0.3.2 / 2009-09-17
+* Added support for aggregating nodes (#65)
+* Wrapped Neo4j GraphAlgo AllSimplePath (#70)
+* Added traversal with traversal position (#71)
+* Removed DynamicAccessors mixin, replaced by [] operator (#67)
+* Impl Neo4j.all_nodes (#69)
+* Upgrated Neo4j jar file to 1.0-b9
+* The Neo4j#relationship method now allows a filter parameter (#66)
+* Neo4j.rb now can read database not created by Neo4j.rb - does not require classname property (#63)
+* REST - added an "all" value for the depth traversal query parameter (#62)
+* REST - Performance improvments using the Rest Mixin (#60)
+
+== 0.3.1 / 2009-07-25
+* Feature, extension -	find path between given pair of nodes (#58)
+* Fix a messy exception on GET /nodes/UnknownClassName (#57)
+* Bug  - exception on GET /nodes/classname/rel if rel is a has_one relationship (#56)
+* Bug: GET /nodes/classname missing out nodes with no properties (#55)
+* Bug: Lucene sorting caused exception if there were no documents (#54)
+* Bug:	reindexer fails to connect nodes to the IndexNode (#53)
+
+== 0.3.0 / 2009-06-25
+* Neo4j should track node changes
+* RESTful support for lucene queries, sorting and paging
+* RESTful support for Relationships
+* RESTful support for Node and properties
+* Experimental support for Master-Slave	Replication via REST
+* RESTful Node representation should contain hyperlinks to relationships
+* Added some handy method like first and empty? on relationships
+* Use new neo4j: neo-1.0-b8
+* Add an event handler for create/delete nodes start/stop neo, update property/relationship
+* The NodeMixin should behave like a hash, added [] and []= methods
+* Support list topology - has_list and belongs_to_list Neo4j::NodeMixin Classmethods
+* Should be possible to add relationships without declaring them (Neo4j#relationships.outgoing(:friends) << node)
+* Neo4j extensions file structure, should be easy to create your own extensions
+* Rename relation to relationship (Neo4j::Relations => Neo4j::Relationships, DynamicRelation => Relationship) [data incompatible change]
+* Auto Transaction is now optional
+* Setting Float properties fails under JRuby1.2.0
+* Bug: Indexing relationships does not work
+* Make the ReferenceNode include Neo4j::NodeMixin
+* Added handy Neo4j class that simply includes the Neo4j::NodeMixin
+* Neo4j::IndexNode now holds references to all nodes (Neo4j.ref_node -> Neo4j::IndexNode -> ...)
+
+
+== 0.2.1 / 2009-03-15
+* Refactoring of lucene indexing of the node space (28)
+* Fixed bug on Neo4j::Nodemixin#property? (#22)
+
+
+== 0.2.0 / 2009-01-20
+* Impl. Neo4j::Node#traverse - enables traversal and filtering using TraversalPosition info (#17,#19)
+* Impl. traversal to any depth (#15)
+* Impl. traversal several relationships type at the same time (#16)
+* Fixed a Lucene timezone bug (#20)
+* Lots of refactoring of the neo4j.rb traversal code and RSpecs
+
+== 0.1.0 / 2008-12-18
+* Property can now be of any type (and not only String, Fixnum, Float)
+* Indexing and Query with Date and DateTime
+* YARD documentation
+* Properties can be removed
+* A property can be set to nil (it will then be removed).
+
+== 0.0.7 / 2008-12-10
+* Added method to_param and methods on the value object needed for Ruby on Rails
+* Impl. update from a value object/hash for a node
+* Impl. generation of value object classes/instances from a node.
+* Refactoring the Transaction handling (reuse PlaceboTransaction instances if possible)
+* Removed the need to start and stop neo. It will be done automatically when needed.
+
+
+== 0.0.6 / 2008-12-03
+* Removed the configuration from the Neo4j.start method. Now exist in Neo4j::Config and Lucene::Config.
+* Implemented sort_by method.
+* Lazy loading of search result. Execute the query and load the nodes only if needed.
+* Added support to use lucene query language, example: Person.find("name:foo AND age:42")
+* All test now uses RAM based lucene indexes.
+
+== 0.0.5 / 2008-11-17
+* Supports keeping lucene index in memory instead of on disk
+* Added support for lucene full text search
+* Fixed so neo4j runs on JRuby 1.1.5
+* Implemented support for reindex all instances of a node class. This is needed if the lucene index is kept in memory or if the index is changed.
+* Added ReferenceNode. All nodes now have a relationship from this reference node.
+* Lots of refactoring
+* Added the IMDB example. It shows how to create a neo database, lucene queries and node traversals.
+
+== 0.0.4 / 2008-10-23
+* First release to rubyforge

data/CONTRIBUTORS

@@ -0,0 +1,17 @@
+Maintainer:
+  Andreas Ronge <andreas dot ronge at gmail dot com>
+
+Contributors:
+* Ben Jackson
+* Dwight van Tuyl
+* Martin Kleppmann
+* Peter Neubauer
+* Jan-Felix Wittmann
+* Marius Mårnes Mathiesen
+* Bert Fitié
+* Jan Berkel
+* David Beckwith
+* Johny Ho
+* Carlo Cabanilla
+* Anders Janmyr
+* Nick Sieger

data/Gemfile

@@ -0,0 +1,16 @@
+source :gemcutter
+
+gemspec
+
+group 'test' do
+  gem "rake", ">= 0.8.7"
+  gem "rdoc", ">= 2.5.10"
+  gem "horo", ">= 1.0.2"
+  gem "rspec", ">= 2.0.0"
+  gem "rspec-rails-matchers", ">= 0.2.1"
+  gem "test-unit"
+end
+
+#gem 'ruby-debug-base19' if RUBY_VERSION.include? "1.9"
+#gem 'ruby-debug-base' if RUBY_VERSION.include? "1.8"
+#gem "ruby-debug-ide"

data/README.rdoc

@@ -0,0 +1,135 @@
+== Welcome to Neo4j.rb
+
+Neo4j.rb is a graph database for JRuby.
+
+You can think of \Neo4j as a high-performance graph engine with all the features of a mature and robust database.
+The programmer works with an object-oriented, flexible network structure rather than with strict and static tables — yet enjoys all the benefits of a fully transactional, enterprise-strength database.
+
+It uses two powerful and mature Java libraries:
+* {Neo4J}[http://www.neo4j.org] - for persistence and traversal of the graph
+* {Lucene}[http://lucene.apache.org/java/docs/index.html] for querying and indexing.
+
+=== Why Neo4j.rb or a Graph Database ?
+
+Here are some of the major benefits of Neo4j.rb
+
+* Domain Modeling - use the language of a graph (nodes/relationship/properties) to express your domain !
+  * Schema Less and Efficient storage of Semi Structured Information
+  * No {O/R mismatch}[http://en.wikipedia.org/wiki/Object-relational_impedance_mismatch] - very natural to map a graph to an \Object Oriented language like Ruby.
+* {Performance}[http://www.oscon.com/oscon2009/public/schedule/detail/8364]
+* Embedded Database - no database tier, easier to install, test, deploy and configure. It is run in the same process as your application.
+* Express Queries as Traversals
+  * Fast deep traversal instead of slow SQL queries that span many table joins.
+  * Very natural to express graph related problem with traversals (recommendation engine, find shortest parth etc..)
+* Seamless integration with Ruby on \Rails.
+* ACID Transaction with rollbacks support.
+
+=== Documentation
+
+* {API Documentation}[http://neo4j.rubyforge.org]
+* {Documentation and Getting Started with Neo4j}[http://neo4j.rubyforge.org/guides/index.html]
+
+=== Some Examples
+
+==== Neo4j::Node
+
+Example of creating a Neo4j::Node
+
+  require "rubygems"
+  require 'neo4j'
+
+  Neo4j::Transaction.run do
+    node = Neo4j::Node.new (:name => 'andreas')
+    node.outgoing(:friends) << Neo4j::Node.new (:name => 'peter')
+    node.outgoing(:friends).each {|node| puts "name #{node[:name]}"}
+  end
+
+==== Neo4j::Mapping::NodeMixin
+
+Example of mapping a ruby class to a node and delaring properties and relationships and lucene index.
+
+  class Person
+    include Neo4j::NodeMixin
+    property :name
+    property :city
+
+    has_n :friends
+    has_one :address
+    index :name
+  end
+
+  # assume we have an transaction already running
+  andreas = Person.new (:name => 'andreas')
+  andreas.friends << Person.new (:name => 'peter')
+  andreas.friends.each {|person| puts "name #{person.name}" }
+  Person.find("name: andreas").first.name # => 'andreas'
+
+==== Neo4j::Rails::Model
+
+Example of using Neo4j with Rails 3 (ActiveModel)
+
+  class User < Neo4j::Model
+    attr_accessor :password
+    attr_accessible :email, :password, :password_confirmation, :pending_account
+
+    after_save   :encrypt_password
+
+    email_regex = /\A[\w+\-.]+@[a-z\d\-.]+\.[a-z]+\z/i
+
+    property :email
+    index :email
+
+    has_one(:avatar).to(Avator)
+
+    validates :email, :presence => true,:format   => { :with => email_regex }
+    validates :email, :uniqueness => true, :unless => :pending_account?
+    accepts_nested_attributes_for :avatar, :allow_destroy => true
+
+    ...
+  end
+
+==== Generate a Rails Application
+
+Example of creating an Neo4j Application from scratch:
+
+ gem install rails
+ rails new myapp -m http://andreasronge.github.com/rails3.rb
+ cd myapp
+ bundle
+ rails generate scaffold User name:string email:string
+ rails s
+ open a webbrowser: http://localhost:3000/users
+
+You may get an error message "ERROR IOError: Connection reset by peer"
+using WEBrick (it still works). This error message is not shown when running
+the application with {Tomcat/Trinidad}[https://github.com/calavera/trinidad]
+
+To run it with Tomcat
+  
+  gem install trinidad
+  trinidad
+
+
+=== Presentation Materials and other URLs
+* {Intoduction to Neo4j.rb}[http://www.slideshare.net/andreasronge/neo4jrb]
+* {Nordic Ruby 2010 May 21-23}[http://nordicruby.org/speakers#user_29]
+* {Neo4j wiki, check the guidelines and domain modeling gallery pages}[http://wiki.neo4j.org/content/Main_Page]
+
+=== Project information
+* {GitHub}[http://github.com/andreasronge/neo4j/tree/master]
+* {Lighthouse Issue Tracking}[http://neo4j.lighthouseapp.com]
+* {Twitter}[http://twitter.com/ronge]
+* IRC -  #neo4j @ irc.freenode.net
+* {Mailing list, neo4jrb@googlegroups.com}[http://groups.google.com/group/neo4jrb]
+
+=== Contributing
+
+Have you found a bug, need help or have a patch ?
+Just clone neo4j.rb and send me a pull request or email me.
+Do you need help - send me an email (andreas.ronge at gmail dot com).
+Please also check/add issues at lighthouse, http://neo4j.lighthouseapp.com
+
+=== License
+* Neo4j.rb - MIT, see the LICENSE file http://github.com/andreasronge/neo4j/tree/master/LICENSE.
+* Lucene -  Apache, see http://lucene.apache.org/java/docs/features.html
+* \Neo4j - Dual free software/commercial license, see http://neo4j.org/

data/lib/generators/neo4j.rb

@@ -0,0 +1,65 @@
+require 'rails/generators/named_base'
+require 'rails/generators/active_model'
+
+module Neo4j
+	module Generators
+	end
+end
+
+class Neo4j::Generators::Base < Rails::Generators::NamedBase #:nodoc:
+	def self.source_root
+		@_neo4j_source_root ||= File.expand_path(File.join(File.dirname(__FILE__),
+			'neo4j', generator_name, 'templates'))
+	end
+end
+
+class Neo4j::Generators::ActiveModel < Rails::Generators::ActiveModel #:nodoc:
+	def self.all(klass)
+		"#{klass}.all"
+	end
+
+	def self.find(klass, params=nil)
+		"#{klass}.find(#{params})"
+	end
+
+	def self.build(klass, params=nil)
+		if params
+			"#{klass}.new(#{params})"
+		else
+			"#{klass}.new"
+		end
+	end
+
+	def save
+		"#{name}.save"
+	end
+
+	def update_attributes(params=nil)
+		"#{name}.update_attributes(#{params})"
+	end
+
+	def errors
+		"#{name}.errors"
+	end
+
+	def destroy
+		"#{name}.destroy"
+	end
+end
+
+module Rails
+  module Generators
+    class GeneratedAttribute #:nodoc:
+      def type_class
+      	case type.to_s.downcase
+					when 'datetime' 										then 'DateTime'
+					when 'date' 												then 'Date'
+					when 'text' 												then 'String'
+					when 'integer', 'number', 'fixnum' 	then 'Fixnum'
+					when 'float' 												then 'Float'
+					else 'String'
+      	end
+      end
+    end
+  end
+end

data/lib/generators/neo4j/model/model_generator.rb

@@ -0,0 +1,39 @@
+require File.join(File.dirname(__FILE__), '..', '..', 'neo4j.rb')
+
+class Neo4j::Generators::ModelGenerator < Neo4j::Generators::Base
+	argument :attributes, :type => :array, :default => [], :banner => "field:type field:type"
+	
+	check_class_collision
+	
+	class_option :timestamps, :type => :boolean
+	class_option :parent,     :type => :string, :desc => "The parent class for the generated model"
+	
+	def create_model_file
+		template "model.erb", File.join('app/models', "#{singular_name}.rb")
+	end
+	
+	protected
+	def migration?
+		false
+	end
+	
+	def timestamps?
+		options[:timestamps]
+	end
+	
+	def parent?
+		options[:parent]
+	end
+	
+	def timestamp_statements
+		%q{
+  property :created_at, DateTime
+  # property :created_on, Date
+
+  property :updated_at, DateTime
+  # property :updated_on, Date
+}            
+	end
+	
+	hook_for :test_framework
+end

data/lib/generators/neo4j/model/templates/model.erb

@@ -0,0 +1,7 @@
+class <%= class_name %> < <%= parent? ? options[:parent].classify : "Neo4j::Rails::Model" %>
+<% attributes.each do |attribute| -%>
+  property :<%= attribute.name %><%= ", :type => #{attribute.type_class}" %>
+<% end -%>
+
+<%= timestamp_statements if timestamps? -%>
+end

data/lib/neo4j.rb

@@ -0,0 +1,77 @@
+include Java
+
+require 'enumerator'
+require 'forwardable'
+require 'time'
+require 'date'
+
+require 'neo4j/jars/neo4j-index-1.2-1.2.M03.jar'
+require 'neo4j/jars/neo4j-kernel-1.2-1.2.M03.jar'
+require 'neo4j/jars/neo4j-lucene-index-0.2-1.2.M03.jar'
+require 'neo4j/jars/geronimo-jta_1.1_spec-1.1.1.jar'
+require 'neo4j/jars/lucene-core-3.0.2.jar'
+require 'neo4j/to_java'
+require 'neo4j/version'
+require 'neo4j/equal'
+
+require 'neo4j/event_handler'
+require 'neo4j/database'
+require 'neo4j/neo4j'
+
+require 'neo4j/index/index'
+require 'neo4j/index/class_methods'
+require 'neo4j/index/indexer_registry'
+require 'neo4j/index/indexer'
+require 'neo4j/index/lucene_query'
+require 'neo4j/relationship_traverser'
+require 'neo4j/node_traverser'
+require 'neo4j/property'
+require 'neo4j/transaction'
+require 'neo4j/node_relationship'
+require 'neo4j/load'
+require 'neo4j/relationship'
+require 'neo4j/node'
+require 'neo4j/config'
+require 'neo4j/type_converters'
+require 'neo4j/mapping/class_methods/init_node'
+require 'neo4j/mapping/class_methods/init_rel'
+require 'neo4j/mapping/class_methods/property'
+require 'neo4j/mapping/class_methods/relationship'
+require 'neo4j/mapping/class_methods/list'
+require 'neo4j/mapping/decl_relationship_dsl'
+require 'neo4j/mapping/has_n'
+require 'neo4j/mapping/has_list'
+require 'neo4j/mapping/node_mixin'
+require 'neo4j/mapping/relationship_mixin'
+require 'neo4j/node_mixin'
+require 'neo4j/relationship_mixin'
+require 'neo4j/mapping/class_methods/rule'
+
+# rails
+require 'rails/railtie'
+require 'active_model'
+require 'neo4j/rails/tx_methods'
+require 'neo4j/rails/transaction'
+require 'neo4j/rails/railtie'
+require 'neo4j/rails/validations/uniqueness'
+require 'neo4j/rails/validations/non_nil'
+require 'neo4j/rails/finders'
+require 'neo4j/rails/mapping/property'
+require 'neo4j/rails/validations'
+require 'neo4j/rails/callbacks'
+require 'neo4j/rails/timestamps'
+require 'neo4j/rails/serialization'
+require 'neo4j/rails/attributes'
+require 'neo4j/rails/persistence'
+require 'neo4j/rails/relationships/mapper'
+require 'neo4j/rails/relationships/relationship'
+require 'neo4j/rails/relationships/relationships'
+require 'neo4j/rails/model'
+require 'neo4j/rails/lucene_connection_closer'
+
+require 'neo4j/model'
+require 'orm_adapter/adapters/neo4j'
+
+# hmm, looks like Enumerator have been moved in some ruby versions
+Enumerator = Enumerable::Enumerator unless defined? Enumerator
+