ddd-associations 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.cache_rake_t

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+
+rvm:
+  - 1.9.3
+  - jruby-19mode

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Guardfile

@@ -0,0 +1,11 @@
+guard 'bundler' do
+  watch('Gemfile')
+end
+
+guard 'minitest' do
+  watch(%r|^test/unit/test_(.*)\.rb|)
+  watch(%r|^lib/*\.rb|){'test'}
+  watch(%r|^test/domain/undilatory/*\.rb|){'test'}
+  watch(%r{^test/domain/undilatory/([^/]+)\.rb$}){|m| "test/unit/test_#{m[1]}.rb"}
+  watch(%r|^test/helper\.rb|){'test'}
+end

data/README.md

@@ -0,0 +1,15 @@
+# DDD Associations
+
+A metaprogramming exercise that implements associations in pure Ruby, inspired by domain-driven design.
+
+Please see the [indilatory](http://github.com/nerab/indilatory) sample application for usage. It also serves as the initial unit test bed for this gem.
+
+[![Build Status](https://secure.travis-ci.org/nerab/ddd-associations.png?branch=master)](http://travis-ci.org/nerab/ddd-associations)
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+#!/usr/bin/env rake
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |test|
+  test.libs << 'lib' << 'test' << 'test/unit'
+  test.pattern = 'test/unit/test_*.rb'
+end
+
+task :default => :test

data/ddd-associations.gemspec

@@ -0,0 +1,18 @@
+require File.expand_path('../lib/ddd-associations/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Nicholas E. Rabenau"]
+  gem.email         = ["nerab@gmx.net"]
+  gem.summary       = %q{DDD Associations}
+  gem.description   = %q{Associations in pure Ruby, inspired by domain-driven design.}
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "ddd-associations"
+  gem.require_paths = ["lib"]
+  gem.version       = DDD::Associations::VERSION
+
+  gem.add_dependency 'activesupport', '~> 3.2'
+  gem.add_development_dependency 'rake'
+end

data/lib/ddd-associations.rb

@@ -0,0 +1,8 @@
+require 'set'
+require 'forwardable'
+require 'active_support/inflector'
+
+require 'ddd-associations/associations'
+require 'ddd-associations/many_collection'
+require 'ddd-associations/one_to_many_collection'
+require 'ddd-associations/many_to_many_collection'

data/lib/ddd-associations/associations.rb

@@ -0,0 +1,78 @@
+module DDD
+  module Associations
+    module ClassMethods
+      #
+      # One project has many tasks
+      #
+      def has_many(others)
+        @others = others
+        @collection = OneToManyCollection
+        self.send('attr_reader', others)
+      end
+
+      #
+      # A task belongs to a project
+      #
+      def belongs_to(other)
+        self.send('attr_reader', other)
+        self.send('define_method', "#{other}=") do |one|
+          return if self.instance_variable_get("@#{other}") == one
+
+          collection_name = self.class.name.demodulize.downcase.pluralize
+
+          if one.nil?
+            # de-register self at one it currently belongs to
+            self.instance_variable_get("@#{other}").send(collection_name).delete(self) if self.instance_variable_get("@#{other}")
+          else
+            # register self at the one
+            one.send(collection_name) << self
+          end
+
+          self.instance_variable_set("@#{other}", one)
+        end
+      end
+
+      #
+      # Regular attribute definition:
+      #
+      #   has_one :title
+      #
+      # is almost equivalent to
+      #
+      #   attr_accessor
+      #
+      # In addition, it registers the attribute(s) to they can be enumerated in the repository etc.
+      #
+      def has_one(*attr)
+        if attr.nil? or attr.empty?
+          @attributes
+        else
+          @attributes = attr
+          @attributes.each{|attr| self.send('attr_accessor', attr)}
+        end
+      end
+
+      attr_reader :attributes
+
+      #
+      # Many tasks belong to many tags and vice versa
+      #
+      def has_and_belongs_to_many(others)
+        @others = others
+        @collection = ManyToManyCollection
+        self.send('attr_reader', others)
+      end
+
+      def new(*args)
+        super(*args).tap do |instance|
+          instance.instance_variable_set("@#{@others}", @collection.new(instance))
+        end
+      end
+    end
+
+    # http://blog.jayfields.com/2006/12/ruby-instance-and-class-methods-from.html
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+  end
+end

data/lib/ddd-associations/many_collection.rb

@@ -0,0 +1,24 @@
+module DDD
+  module Associations
+    #
+    # Base class for has_many and has_and_belongs_to_many collections
+    #
+    class ManyCollection
+      extend Forwardable
+      include Enumerable
+      def_delegators :@many, :size, :each
+
+      #
+      # +one+ is what we are the collection for
+      #
+      def initialize(one)
+        @one = one
+        @many = Set.new
+      end
+
+      protected
+
+      attr_reader :many, :one
+    end
+  end
+end

data/lib/ddd-associations/many_to_many_collection.rb

@@ -0,0 +1,25 @@
+module DDD
+  module Associations
+    class ManyToManyCollection < ManyCollection
+      def <<(another_one)
+        unless many.include?(another_one)
+          many << another_one
+          another_one.send("#{collection_name}") << one
+        end
+      end
+
+      def delete(another_one)
+        if many.include?(another_one)
+          many.delete(another_one)
+          another_one.send("#{collection_name}").delete(one)
+        end
+      end
+
+      protected
+
+      def collection_name
+        one.class.name.demodulize.downcase.pluralize
+      end
+    end
+  end
+end

data/lib/ddd-associations/one_to_many_collection.rb

@@ -0,0 +1,25 @@
+module DDD
+  module Associations
+    class OneToManyCollection < ManyCollection
+      def <<(another_one)
+        unless many.include?(another_one)
+          many << another_one
+          another_one.send("#{collection_name}=", one)
+        end
+      end
+
+      def delete(another_one)
+        if many.include?(another_one)
+          many.delete(another_one)
+          another_one.send("#{collection_name}=", nil)
+        end
+      end
+
+      protected
+
+      def collection_name
+        one.class.name.demodulize.downcase.singularize
+      end
+    end
+  end
+end

data/lib/ddd-associations/version.rb

@@ -0,0 +1,5 @@
+module DDD
+  module Associations
+    VERSION = "0.0.1"
+  end
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: ddd-associations
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Nicholas E. Rabenau
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Associations in pure Ruby, inspired by domain-driven design.
+email:
+- nerab@gmx.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- Guardfile
+- README.md
+- Rakefile
+- ddd-associations.gemspec
+- lib/ddd-associations.rb
+- lib/ddd-associations/associations.rb
+- lib/ddd-associations/many_collection.rb
+- lib/ddd-associations/many_to_many_collection.rb
+- lib/ddd-associations/one_to_many_collection.rb
+- lib/ddd-associations/version.rb
+homepage: 
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: DDD Associations
+test_files: []