dm-is-self_referential 1.0.0.rc1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,8 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+.bundle
+*.gem
+

data/Gemfile

@@ -0,0 +1,145 @@
+# If you're working on more than one datamapper gem at a time, then it's
+# recommended to create a local Gemfile and use this instead of the git
+# sources. This will make sure that you are  developing against your
+# other local datamapper sources that you currently work on. Gemfile.local
+# will behave identically to the standard Gemfile apart from the fact that
+# it fetches the datamapper gems from local paths. This means that you can use
+# the same environment variables, like ADAPTER(S) or PLUGIN(S) when running
+# bundle commands. Gemfile.local is added to .gitignore, so you don't need to
+# worry about accidentally checking local development paths into git.
+# In order to create a local Gemfile, all you need to do is run:
+#
+#   bundle exec rake local_gemfile
+#
+# This will give you a Gemfile.local file that points to your local clones of
+# the various datamapper gems. It's assumed that all datamapper repo clones
+# reside in the same directory. You can use the Gemfile.local like so for
+# running any bundle command:
+#
+#   BUNDLE_GEMFILE=Gemfile.local bundle foo
+#
+# You can also specify which adapter(s) should be part of the bundle by setting
+# an environment variable. This of course also works when using the Gemfile.local
+#
+#   bundle foo                        # dm-sqlite-adapter
+#   ADAPTER=mysql bundle foo          # dm-mysql-adapter
+#   ADAPTERS=sqlite,mysql bundle foo  # dm-sqlite-adapter and dm-mysql-adapter
+#
+# Of course you can also use the ADAPTER(S) variable when using the Gemfile.local
+# and running specs against selected adapters.
+#
+# For easily working with adapters supported on your machine, it's recommended
+# that you first install all adapters that you are planning to use or work on
+# by doing something like
+#
+#   ADAPTERS=sqlite,mysql,postgres bundle install
+#
+# This will clone the various repositories and make them available to bundler.
+# Once you have them installed you can easily switch between adapters for the
+# various development tasks. Running something like
+#
+#   ADAPTER=mysql bundle exec rake spec
+#
+# will make sure that the dm-mysql-adapter is part of the bundle, and will be used
+# when running the specs.
+#
+# You can also specify which plugin(s) should be part of the bundle by setting
+# an environment variable. This also works when using the Gemfile.local
+#
+#   bundle foo                                 # dm-migrations
+#   PLUGINS=dm-validations bundle foo          # dm-migrations and dm-validations
+#   PLUGINS=dm-validations,dm-types bundle foo # dm-migrations, dm-validations and dm-types
+#
+# Of course you can combine the PLUGIN(S) and ADAPTER(S) env vars to run specs
+# for certain adapter/plugin combinations.
+#
+# Finally, to speed up running specs and other tasks, it's recommended to run
+#
+#   bundle lock
+#
+# after running 'bundle install' for the first time. This will make 'bundle exec' run
+# a lot faster compared to the unlocked version. With an unlocked bundle you would
+# typically just run 'bundle install' from time to time to fetch the latest sources from
+# upstream. When you locked your bundle, you need to run
+#
+#   bundle install --relock
+#
+# to make sure to fetch the latest updates and then lock the bundle again. Gemfile.lock
+# is added to the .gitignore file, so you don't need to worry about accidentally checking
+# it into version control.
+
+source 'http://rubygems.org'
+
+DATAMAPPER = 'git://github.com/datamapper'
+DM_VERSION = '~> 1.0.0.rc1'
+
+
+group :runtime do # Runtime dependencies (as in the gemspec)
+
+  if ENV['EXTLIB']
+    gem 'extlib',        '~> 0.9.15',      :git => "#{DATAMAPPER}/extlib.git"
+  else
+    gem 'activesupport', '~> 3.0.0.beta3', :git => 'git://github.com/rails/rails.git', :require => nil
+  end
+
+  gem 'dm-core',         DM_VERSION, :git => "#{DATAMAPPER}/dm-core.git"
+
+end
+
+group(:development) do # Development dependencies (as in the gemspec)
+
+  gem 'dm-validations', DM_VERSION, :git => "#{DATAMAPPER}/dm-validations.git"
+
+  gem 'rake',           '~> 0.8.7'
+  gem 'rspec',          '~> 1.3'
+  gem 'jeweler',        '~> 1.4'
+
+end
+
+group :quality do # These gems contain rake tasks that check the quality of the source code
+
+  gem 'metric_fu',      '~> 1.3'
+  gem 'rcov',           '~> 0.9.7'
+  gem 'reek',           '~> 1.2.7'
+  gem 'roodi',          '~> 2.1'
+  gem 'yard',           '~> 0.5'
+  gem 'yardstick',      '~> 0.1'
+
+
+end
+
+group :datamapper do # We need this because we want to pin these dependencies to their git master sources
+
+  adapters = ENV['ADAPTER'] || ENV['ADAPTERS']
+  adapters = adapters.to_s.gsub(',',' ').split(' ') - ['in_memory']
+
+  unless adapters.empty?
+
+    DO_VERSION     = '~> 0.10.2'
+    DM_DO_ADAPTERS = %w[sqlite postgres mysql oracle sqlserver]
+
+    gem 'data_objects',  DO_VERSION, :git => "#{DATAMAPPER}/do.git"
+
+    adapters.each do |adapter|
+      if DM_DO_ADAPTERS.any? { |dm_do_adapter| dm_do_adapter =~ /#{adapter}/  }
+        adapter = 'sqlite3' if adapter == 'sqlite'
+        gem "do_#{adapter}", DO_VERSION, :git => "#{DATAMAPPER}/do.git"
+      end
+    end
+
+    gem 'dm-do-adapter', DM_VERSION, :git => "#{DATAMAPPER}/dm-do-adapter.git"
+
+    adapters.each do |adapter|
+      gem "dm-#{adapter}-adapter", DM_VERSION, :git => "#{DATAMAPPER}/dm-#{adapter}-adapter.git"
+    end
+
+  end
+
+  plugins = ENV['PLUGINS'] || ENV['PLUGIN']
+  plugins = (plugins.to_s.gsub(',',' ').split(' ') + ['dm-migrations']).uniq
+
+  plugins.each do |plugin|
+    gem plugin, DM_VERSION, :git => "#{DATAMAPPER}/#{plugin}.git"
+  end
+
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 snusnu
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,108 @@
+= dm-is-self_referential
+
+A datamapper[http://github.com/datamapper/dm-core] plugin that allows declarative specification of self referential m:m relationships.
+
+== Examples
+
+  class User
+
+    include DataMapper::Resource
+
+    property :id, Serial
+    property :name, String, :nullable => false, :unique => true, :unique_index => true
+
+    # with default options
+    #
+    # will define and thus be able to automigrate the UserToUser model
+    # with the following relationships established between the participating models
+    #
+    #   has n, :user_children, 'UserToUser', :child_key => [ :source_id ]
+    #   has n, :user_parents,  'UserToUser', :child_key => [ :target_id ]
+    #
+    # once dm-core has full support for the following m:m relationships built in,
+    # these will also get established.
+    #
+    #   has n, :children, self, :through => :user_children, :via => :target
+    #   has n, :parents , self, :through => :user_parents,  :via => :source
+    #
+    # In the meantime, the following helper methods get defined
+    #
+    #   def children
+    #     children_ids = self.user_children.map { |r| r.target_id }
+    #     self.class.all(:id => children_ids)
+    #   end
+    #
+    #   def parents
+    #     parent_ids = self.user_parents.map { |r| r.source_id }
+    #     self.class.all(:id => parent_ids)
+    #   end
+    #
+    is :self_referential
+
+
+    # With explicit intermediate model name and default options
+    #
+    # Will define and thus be able to automigrate the Friendship model
+    # with the following relationships established between the participating models
+    #
+    #   has n, :user_children, 'Friendship', :child_key => [ :source_id ]
+    #   has n, :user_parents,  'Friendship', :child_key => [ :target_id ]
+    #
+    # Once dm-core has full support for the following m:m relationships built in,
+    # these will also get established.
+    #
+    #   has n, :children, self, :through => :user_children, :via => :target
+    #   has n, :parents , self, :through => :user_parents,  :via => :source
+    #
+    # In the meantime, the following helper methods get defined
+    #
+    #   def children
+    #     children_ids = self.user_children.map { |r| r.target_id }
+    #     self.class.all(:id => children_ids)
+    #   end
+    #
+    #   def parents
+    #     parent_ids = self.user_parents.map { |r| r.source_id }
+    #     self.class.all(:id => parent_ids)
+    #   end
+    #
+    is :self_referential, :through => 'Friendship'
+
+
+    # With explicit intermediate model name and customized options
+    #
+    # Will define and thus be able to automigrate the UserRelationship model
+    # with the following relationships established between the participating models
+    #
+    #   has n, :user_children, 'UserRelationship', :child_key => [ :parent_user_id ]
+    #   has n, :user_parents,  'UserRelationship', :child_key => [ :child_user_id  ]
+    #
+    # Once dm-core has full support for the following m:m relationships built in,
+    # these will also get established.
+    #
+    #   has n, :child_users,  User, :through => :user_children, :via => :child_user
+    #   has n, :parent_users, User, :through => :user_parents,  :via => :parent_user
+    #
+    # In the meantime, the following helper methods get defined
+    #
+    #   def child_users
+    #     children_ids = self.user_children.map { |r| r.target_id }
+    #     self.class.all(:id => children_ids)
+    #   end
+    #
+    #   def parent_users
+    #     parent_ids = self.user_parents.map { |r| r.source_id }
+    #     self.class.all(:id => parent_ids)
+    #   end
+    #
+    is :self_referential, :through => 'UserRelationship',
+      :children => :child_users,
+      :parents  => :parent_users,
+      :source   => :parent_user,
+      :target   => :child_user
+
+  end
+
+== Copyright
+
+Copyright (c) 2009 Martin Gamsjaeger (snusnu). See LICENSE for details.

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rake'
+
+begin
+
+  require 'jeweler'
+
+  Jeweler::Tasks.new do |gem|
+    gem.name        = 'dm-is-self_referential'
+    gem.summary     = 'Declaratively specify self referential m:m relationships in datamapper models'
+    gem.description = gem.summary
+    gem.email       = 'gamsnjaga@gmail.com'
+    gem.homepage    = 'http://github.com/snusnu/dm-is-self_referential'
+    gem.authors     = [ "Martin Gamsjaeger (snusnu)" ]
+
+    gem.add_dependency             'dm-core', '~> 1.0.0.rc1'
+
+    gem.add_development_dependency 'rspec',   '~> 1.3'
+    gem.add_development_dependency 'yard',    '~> 0.5'
+  end
+
+  Jeweler::GemcutterTasks.new
+
+  FileList['tasks/**/*.rake'].each { |task| import task }
+rescue LoadError
+  puts 'Jeweler (or a dependency) not available. Install it with: gem install jeweler'
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0.rc1

data/dm-is-self_referential.gemspec

@@ -0,0 +1,69 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{dm-is-self_referential}
+  s.version = "1.0.0.rc1"
+
+  s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Martin Gamsjaeger (snusnu)"]
+  s.date = %q{2010-05-19}
+  s.description = %q{Declaratively specify self referential m:m relationships in datamapper models}
+  s.email = %q{gamsnjaga@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "Gemfile",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "dm-is-self_referential.gemspec",
+     "lib/dm-is-self_referential.rb",
+     "spec/dm-is-self_referential_spec.rb",
+     "spec/rcov.opts",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "tasks/ci.rake",
+     "tasks/local_gemfile.rake",
+     "tasks/metrics.rake",
+     "tasks/spec.rake",
+     "tasks/yard.rake",
+     "tasks/yardstick.rake"
+  ]
+  s.homepage = %q{http://github.com/snusnu/dm-is-self_referential}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Declaratively specify self referential m:m relationships in datamapper models}
+  s.test_files = [
+    "spec/dm-is-self_referential_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<dm-core>, ["~> 1.0.0.rc1"])
+      s.add_development_dependency(%q<rspec>, ["~> 1.3"])
+      s.add_development_dependency(%q<yard>, ["~> 0.5"])
+    else
+      s.add_dependency(%q<dm-core>, ["~> 1.0.0.rc1"])
+      s.add_dependency(%q<rspec>, ["~> 1.3"])
+      s.add_dependency(%q<yard>, ["~> 0.5"])
+    end
+  else
+    s.add_dependency(%q<dm-core>, ["~> 1.0.0.rc1"])
+    s.add_dependency(%q<rspec>, ["~> 1.3"])
+    s.add_dependency(%q<yard>, ["~> 0.5"])
+  end
+end
+

data/lib/dm-is-self_referential.rb

@@ -0,0 +1,57 @@
+require 'dm-core'
+
+module DataMapper
+  module Is
+
+    module SelfReferential
+
+      def is_self_referential(options = {})
+        # Given 'Nested::Module::ClassName'
+        # deepest_context = Nested::Module::
+        # self_model_name = ClassName
+        # ---
+        # Given 'ClassName'
+        # deepest_context = "::"
+        # self_model_name = ClassName
+        deepest_context, self_model_name = (self.name =~ /^(.*::)(.*)$/) ? [$1, $2] : ["::", self.name]
+        sane_self_model_name = ActiveSupport::Inflector.underscore(self.name.gsub(/::/, ""))
+
+        options = {
+          :through     => "#{deepest_context}#{self_model_name}To#{self_model_name}",
+          :children    => :children,
+          :parents     => :parents,
+          :source      => :source,
+          :target      => :target
+        }.merge!(options)
+
+        Object.full_const_set(options[:through], Class.new)
+
+        source_model       = self
+        intermediate_model = Object.full_const_get(options[:through])
+        target_model       = self
+
+        source_fk = ActiveSupport::Inflector.foreign_key(options[:source]).to_sym
+        target_fk = ActiveSupport::Inflector.foreign_key(options[:target]).to_sym
+
+        intermediate_model.class_eval do
+          include DataMapper::Resource
+          belongs_to options[:source], source_model, :key => true
+          belongs_to options[:target], target_model, :key => true
+        end
+
+        intermediate_children = "#{sane_self_model_name}_#{options[:children]}".to_sym
+        intermediate_parents  = "#{sane_self_model_name}_#{options[:parents ]}".to_sym
+
+        has n, intermediate_children, intermediate_model, :child_key => [ source_fk ]
+        has n, intermediate_parents,  intermediate_model, :child_key => [ target_fk ]
+
+        has n, options[:children], self, :through => intermediate_children, :via => :target
+        has n, options[:parents ], self, :through => intermediate_parents,  :via => :source
+
+      end
+
+    end
+
+  end
+  Model.append_extensions(Is::SelfReferential)
+end

data/spec/dm-is-self_referential_spec.rb

@@ -0,0 +1,258 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+class Object
+
+  def full_const_defined?(name)
+    !!full_const_get(name) rescue false
+  end
+
+end
+
+module RemixableHelper
+
+  def clear_remixed_models(*models)
+    models.each do |model|
+      deepest_context, removable_const = (model =~ /^(.*::)(.*)$/) ? [$1, $2] : ["Object", model]
+
+      if Object.full_const_defined?(model)
+        if Object.full_const_defined?(deepest_context)
+          deepest_context = Object.full_const_get(deepest_context)
+          deepest_context.send(:remove_const, removable_const)
+        end
+      end
+    end
+  end
+
+  alias :clear_remixed_model :clear_remixed_models
+
+end
+
+class User
+
+  include DataMapper::Resource
+
+  property :id, Serial
+  property :name, String, :required => true, :unique => true, :unique_index => true
+
+end
+
+module Main
+  class Group
+    include DataMapper::Resource
+
+    property :id, Serial
+    property :name, String, :required => true
+  end
+
+  class GroupHeritage
+    include DataMapper::Resource
+
+    property :parent_group_id, Integer, :key => true
+    property :child_group_id, Integer, :key => true
+  end
+end
+
+describe 'every self referential m:m relationship', :shared => true do
+
+  it "should establish a 1:m relationship to the intermediate model" do
+    relationship = @model.relationships(:default)[@intermediate_name]
+    relationship.is_a?(DataMapper::Associations::OneToMany::Relationship).should be_true
+  end
+
+  it "should establish a m:m relationship to the target model" do
+    relationship = @model.relationships(:default)[@target_name]
+    relationship.is_a?(DataMapper::Associations::ManyToMany::Relationship).should be_true
+  end
+
+
+  it "should establish a method to retrieve children for an individual parent" do
+    @source_instance.respond_to?(@children_accessor).should be_true
+  end
+
+  it "should establish a method to retrieve parents for an individual child" do
+    @source_instance.respond_to?(@parents_accessor).should be_true
+  end
+
+
+  it "should return a DataMapper::Collection when calling the children accessor" do
+    @source_instance.send(@children_accessor).is_a?(DataMapper::Collection).should be_true
+  end
+
+  it "should return a DataMapper::Collection when calling the parents accessor" do
+    @source_instance.send(@parents_accessor).is_a?(DataMapper::Collection).should be_true
+  end
+
+  it "should be able to return all children" do
+    pending_if 'M:M operations are not supported in_memory and on yaml', !SUPPORTS_M2M do
+      @child_1 = @model.create(:name => 'Bars')
+      @child_2 = @model.create(:name => 'Lisichka')
+      @intermediate_model.create(@intermediate_source => @source_instance, @intermediate_target => @child_1)
+      @intermediate_model.create(@intermediate_source => @source_instance, @intermediate_target => @child_2)
+      @source_instance.send(@children_accessor).size.should == 2
+    end
+  end
+
+  it "should be able to return all parents" do
+    pending_if 'M:M operations are not supported in_memory and on yaml', !SUPPORTS_M2M do
+      @parent_1 = @model.create(:name => 'Belka')
+      @parent_2 = @model.create(:name => 'Strelka')
+      @intermediate_model.create(@intermediate_target => @source_instance, @intermediate_source => @parent_1)
+      @intermediate_model.create(@intermediate_target => @source_instance, @intermediate_source => @parent_2)
+      @source_instance.send(@parents_accessor).size.should == 2
+    end
+  end
+
+end
+
+describe DataMapper::Is::SelfReferential do
+
+  include RemixableHelper
+
+  describe "with default options" do
+
+    before(:each) do
+
+      clear_remixed_models 'UserToUser'
+
+      User.is :self_referential
+      DataMapper.auto_migrate!
+
+      @model               = User
+      @intermediate_model  = UserToUser # implicitly test intermediate model generation
+      @intermediate_source = :source
+      @intermediate_target = :target
+      @children_accessor   = :children
+      @parents_accessor    = :parents
+
+      @intermediate_name   = "user_#{@children_accessor}".to_sym
+      @target_name         = @children_accessor
+
+      @source_instance     = User.create(:name => 'Laika')
+
+    end
+
+    it_should_behave_like 'every self referential m:m relationship'
+
+  end
+
+  describe "with explict intermediate model name and default options" do
+
+    before(:each) do
+
+      clear_remixed_models 'Friendship'
+
+      User.is :self_referential, :through => 'Friendship'
+      DataMapper.auto_migrate!
+
+      @model               = User
+      @intermediate_model  = Friendship # implicitly test intermediate model generation
+      @intermediate_source = :source
+      @intermediate_target = :target
+      @children_accessor   = :children
+      @parents_accessor    = :parents
+
+      @intermediate_name   = "user_#{@children_accessor}".to_sym
+      @target_name         = @children_accessor
+
+      @source_instance     = User.create(:name => 'Laika')
+
+    end
+
+    it_should_behave_like 'every self referential m:m relationship'
+
+  end
+
+  describe "with explict intermediate model name and customized options" do
+
+    before(:each) do
+
+      clear_remixed_models 'UserRelationship'
+
+      User.is :self_referential, :through => 'UserRelationship',
+        :children => :child_users,
+        :parents  => :parent_users,
+        :source   => :parent_user,
+        :target   => :child_user
+
+      DataMapper.auto_migrate!
+
+      @model               = User
+      @intermediate_model  = UserRelationship # implicitly test intermediate model generation
+      @intermediate_source = :parent_user
+      @intermediate_target = :child_user
+      @children_accessor   = :child_users
+      @parents_accessor    = :parent_users
+
+      @intermediate_name   = "user_#{@children_accessor}".to_sym
+      @target_name         = @children_accessor
+
+      @source_instance     = User.create(:name => 'Laika')
+
+    end
+
+    it_should_behave_like 'every self referential m:m relationship'
+
+  end
+
+  describe "with default options for nested model" do
+
+    before(:each) do
+
+      clear_remixed_models 'Main::GroupToGroup'
+
+      Main::Group.is :self_referential
+      DataMapper.auto_migrate!
+
+      @model               = Main::Group
+      @intermediate_model  = Main::GroupToGroup # implicitly test intermediate model generation
+      @intermediate_source = :source
+      @intermediate_target = :target
+      @children_accessor   = :children
+      @parents_accessor    = :parents
+
+      @intermediate_name   = "main_group_#{@children_accessor}".to_sym
+      @target_name         = @children_accessor
+
+      @source_instance     = Main::Group.create(:name => 'Laika')
+
+    end
+
+    it_should_behave_like 'every self referential m:m relationship'
+
+  end
+
+
+  describe "with explict intermediate nested model name and customized options" do
+
+   before(:each) do
+
+      clear_remixed_models 'Main::GroupHeritage'
+
+      Main::Group.is :self_referential, :through => 'Main::GroupHeritage',
+        :children => :child_groups,
+        :parents  => :parent_groups,
+        :source   => :parent_group,
+        :target   => :child_group
+
+      DataMapper.auto_migrate!
+
+      @model               = Main::Group
+      @intermediate_model  = Main::GroupHeritage # implicitly test intermediate model generation
+      @intermediate_source = :parent_group
+      @intermediate_target = :child_group
+      @children_accessor   = :child_groups
+      @parents_accessor    = :parent_groups
+
+      @intermediate_name   = "main_group_#{@children_accessor}".to_sym
+      @target_name         = @children_accessor
+
+      @source_instance     = Main::Group.create(:name => 'Laika')
+
+    end
+
+    it_should_behave_like 'every self referential m:m relationship'
+
+  end
+
+
+end

data/spec/rcov.opts

@@ -0,0 +1,6 @@
+--exclude "spec"
+--sort coverage
+--callsites
+--xrefs
+--profile
+--text-summary

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--format specdoc
+--colour

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+require 'dm-core/spec/setup'
+require 'dm-core/spec/lib/adapter_helpers'
+require 'dm-core/spec/lib/pending_helpers'
+
+require 'dm-is-self_referential'
+require 'dm-migrations'
+require 'dm-validations'
+
+DataMapper::Spec.setup
+
+SUPPORTS_M2M = %w[sqlite postgres mysql oracle sqlserver].include?(DataMapper::Spec.adapter_name)
+
+Spec::Runner.configure do |config|
+  config.extend(DataMapper::Spec::Adapters::Helpers)
+  config.include(DataMapper::Spec::PendingHelpers)
+end

data/tasks/ci.rake

@@ -0,0 +1 @@
+task :ci => [ :verify_measurements, 'metrics:all' ]

data/tasks/local_gemfile.rake

@@ -0,0 +1,18 @@
+desc "Support bundling from local source code (allows BUNDLE_GEMFILE=Gemfile.local bundle foo)"
+task :local_gemfile do |t|
+
+  root              = Pathname(__FILE__).dirname.parent
+  datamapper        = root.parent
+
+  source_regex     = /DATAMAPPER = 'git:\/\/github.com\/datamapper'/
+  gem_source_regex = /:git => \"#\{DATAMAPPER\}\/(.+?)(?:\.git)?\"/
+
+  root.join('Gemfile.local').open('w') do |f|
+    root.join('Gemfile').open.each do |line|
+      line.sub!(source_regex,     "DATAMAPPER = '#{datamapper}'")
+      line.sub!(gem_source_regex, ':path => "#{DATAMAPPER}/\1"')
+      f.puts line
+    end
+  end
+
+end

data/tasks/metrics.rake

@@ -0,0 +1,36 @@
+begin
+  require 'metric_fu'
+rescue LoadError
+  namespace :metrics do
+    task :all do
+      abort 'metric_fu is not available. In order to run metrics:all, you must: gem install metric_fu'
+    end
+  end
+end
+
+begin
+  require 'reek/adapters/rake_task'
+
+  Reek::RakeTask.new do |t|
+    t.fail_on_error = true
+    t.verbose       = false
+    t.source_files  = 'lib/**/*.rb'
+  end
+rescue LoadError
+  task :reek do
+    abort 'Reek is not available. In order to run reek, you must: gem install reek'
+  end
+end
+
+begin
+  require 'roodi'
+  require 'roodi_task'
+
+  RoodiTask.new do |t|
+    t.verbose = false
+  end
+rescue LoadError
+  task :roodi do
+    abort 'Roodi is not available. In order to run roodi, you must: gem install roodi'
+  end
+end

data/tasks/spec.rake

@@ -0,0 +1,38 @@
+spec_defaults = lambda do |spec|
+  spec.pattern    = 'spec/**/*_spec.rb'
+  spec.libs      << 'lib' << 'spec'
+  spec.spec_opts << '--options' << 'spec/spec.opts'
+end
+
+begin
+  require 'spec/rake/spectask'
+
+  Spec::Rake::SpecTask.new(:spec, &spec_defaults)
+rescue LoadError
+  task :spec do
+    abort 'rspec is not available. In order to run spec, you must: gem install rspec'
+  end
+end
+
+begin
+  require 'rcov'
+  require 'spec/rake/verify_rcov'
+
+  Spec::Rake::SpecTask.new(:rcov) do |rcov|
+    spec_defaults.call(rcov)
+    rcov.rcov      = true
+    rcov.rcov_opts = File.read('spec/rcov.opts').split(/\s+/)
+  end
+
+  RCov::VerifyTask.new(:verify_rcov => :rcov) do |rcov|
+    rcov.threshold = 100
+  end
+rescue LoadError
+  %w[ rcov verify_rcov ].each do |name|
+    task name do
+      abort "rcov is not available. In order to run #{name}, you must: gem install rcov"
+    end
+  end
+end
+
+task :default => :spec

data/tasks/yard.rake

@@ -0,0 +1,9 @@
+begin
+  require 'yard'
+
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yard do
+    abort 'YARD is not available. In order to run yard, you must: gem install yard'
+  end
+end

data/tasks/yardstick.rake

@@ -0,0 +1,19 @@
+begin
+  require 'pathname'
+  require 'yardstick/rake/measurement'
+  require 'yardstick/rake/verify'
+
+  # yardstick_measure task
+  Yardstick::Rake::Measurement.new
+
+  # verify_measurements task
+  Yardstick::Rake::Verify.new do |verify|
+    verify.threshold = 100
+  end
+rescue LoadError
+  %w[ yardstick_measure verify_measurements ].each do |name|
+    task name.to_s do
+      abort "Yardstick is not available. In order to run #{name}, you must: gem install yardstick"
+    end
+  end
+end

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification 
+name: dm-is-self_referential
+version: !ruby/object:Gem::Version 
+  hash: 977940574
+  prerelease: true
+  segments: 
+  - 1
+  - 0
+  - 0
+  - rc1
+  version: 1.0.0.rc1
+platform: ruby
+authors: 
+- Martin Gamsjaeger (snusnu)
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-19 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: dm-core
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 977940574
+        segments: 
+        - 1
+        - 0
+        - 0
+        - rc1
+        version: 1.0.0.rc1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 1
+        - 3
+        version: "1.3"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 0
+        - 5
+        version: "0.5"
+  type: :development
+  version_requirements: *id003
+description: Declaratively specify self referential m:m relationships in datamapper models
+email: gamsnjaga@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- Gemfile
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- dm-is-self_referential.gemspec
+- lib/dm-is-self_referential.rb
+- spec/dm-is-self_referential_spec.rb
+- spec/rcov.opts
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/ci.rake
+- tasks/local_gemfile.rake
+- tasks/metrics.rake
+- tasks/spec.rake
+- tasks/yard.rake
+- tasks/yardstick.rake
+has_rdoc: true
+homepage: http://github.com/snusnu/dm-is-self_referential
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      hash: 25
+      segments: 
+      - 1
+      - 3
+      - 1
+      version: 1.3.1
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Declaratively specify self referential m:m relationships in datamapper models
+test_files: 
+- spec/dm-is-self_referential_spec.rb
+- spec/spec_helper.rb