entasis 0.4.0 → 0.5.0.rc1

data/Gemfile

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

data/README.md

@@ -30,10 +30,21 @@ anon.errors           # => {:name=>["can't be blank"]}>
 Default behavior is to raise if any key in the hash given to `.new` or `#attributes=` is not defined,
 this can be circumvented by passing `ignore_undefined: true` as options when defining your attributes.
 
+
+Transposing keys
+----------------
+
+If you include the module `Entasis::TransposeKeys` after you have included `Entasis::Model`,
+keys in the given hash will be downcased and underscored before calling the setter methods.
+
+This can be very useful when you got hash with camelcased keys, for example from an external service serving XML soup.
+
+
 Contributors
 ------------
 
-Ingemar Edsborn (ingemar)
-Joshua Davey (jgdavey)
-Johnny Winn (nurugger07)
-Jack Christensen (jackc)
+  - Ingemar Edsborn (ingemar)
+  - Joshua Davey (jgdavey)
+  - Johnny Winn (nurugger07)
+  - Jack Christensen (jackc)
+

data/entasis.gemspec

@@ -16,6 +16,6 @@ Gem::Specification.new do |s|
   s.files        = Dir.glob("lib/**/*") + %w(Gemfile entasis.gemspec HISTORY README.md LICENSE)
   s.test_files   = Dir.glob('spec/*')
 
-  s.add_runtime_dependency('activemodel', '~> 3.0')
+  s.add_runtime_dependency 'activemodel', '~> 3.0'
   s.add_development_dependency 'rspec', '~> 2.0'
 end

data/lib/entasis/model.rb

@@ -3,8 +3,9 @@ module Entasis
     extend ActiveSupport::Concern
 
     included do
+      include Entasis::Relations
       include ActiveModel::Validations
-      class_attribute :attribute_names, :attributes_config, instance_writer: false
+      class_attribute :attribute_names, :attributes_config, :belongings, instance_writer: false
 
       self.attribute_names ||= []
       self.class_eval 'class UnknownAttributeError < StandardError; end'
@@ -13,7 +14,9 @@ module Entasis
     module ClassMethods
       ##
       #
-      # Takes a list of attribute names. Last argument can be an options hash.
+      # Takes a list of attribute names.
+      #
+      # Last argument can be an options hash:
       #
       #   ignore_undefined: true - Silently ignore any undefined attributes
       #

data/lib/entasis/relations.rb

@@ -0,0 +1,72 @@
+module Entasis
+  module Relations
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      ##
+      #
+      # Takes a list of relations. Speciefy each relation as a
+      # pluralization of corresponding class.
+      #
+      # Last argument can be an options hash:
+      #
+      #   class: provide a custom class name
+      #
+      # This macro will give each instance corresponding
+      # setter and getter methods. Passing a collection of
+      # corresponding instances of the given class will populate
+      # the collection. Passing hashes will try to instanciate
+      # new objects of the relation's class.
+      #
+      # To set the inverse association and tie the objects together
+      # specify the +belongs_to+ relation in the other class.
+      #
+      def has_many(*relations)
+        options = relations.last.is_a?(Hash) ? relations.pop : {}
+
+        relations.each do |relation|
+          relation_model = (options[:class] || relation).to_s.singularize.camelize.constantize
+
+          self.class_eval <<-RUBY
+            def #{relation}=(resources)
+              @#{relation} = []
+
+              resources.each do |resource|
+                unless resource.is_a? #{relation_model}
+                  resource = #{relation_model}.new resource
+                end
+
+                if resource.belongs_to? self.class
+                  resource.send "\#{self.class.name.underscore}=", self
+                end
+
+                @#{relation} << resource
+              end
+            end
+
+            def #{relation}
+              @#{relation} || []
+            end
+          RUBY
+        end
+      end
+
+      #
+      # To complete the inverse relationship and tie two models togeter
+      # specify the +belongs_to+ relationship.
+      #
+      def belongs_to(*relations)
+        options = relations.last.is_a?(Hash) ? relations.pop : {}
+
+        self.belongings ||= []
+        self.belongings += relations.map(&:to_s).sort
+
+        attr_accessor *relations
+      end
+    end
+
+    def belongs_to?(model)
+      self.belongings.include? model.to_s.underscore
+    end
+  end
+end

data/lib/entasis/version.rb

@@ -1,3 +1,3 @@
 module Entasis
-  VERSION = "0.4.0"
+  VERSION = "0.5.0.rc1"
 end

data/lib/entasis.rb

@@ -5,6 +5,7 @@ module Entasis
   extend ActiveSupport::Autoload
 
   autoload :Model
+  autoload :Relations
   autoload :TransposeKeys
   autoload :Base
 end

data/spec/relations_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+describe Entasis::Relations do
+  let(:attributes) do
+    {
+      name: 'Volvo',
+      people: [{ name: 'Aslog' }],
+      passengers: [{ name: 'Gunnar' }]
+    }
+  end
+  let(:car) { Car.new }
+  let(:person) { car.people.first }
+  let(:passenger) { car.passengers.first }
+
+  describe '#attributes=' do
+    before { car.attributes = attributes }
+
+    context 'when given a hash' do
+      it 'creates a new instance of the relation' do
+        expect(car.name).to eq('Volvo')
+        expect(person).to be_a(Person)
+        expect(person.name).to eq('Aslog')
+        expect(person.car).to eq(car)
+      end
+    end
+
+    context 'when relation definied with a custom class' do
+      it 'creates a new instance of the relation' do
+        expect(passenger).to be_a(Person)
+        expect(passenger.name).to eq('Gunnar')
+        expect(passenger.car).to eq(car)
+      end
+    end
+  end
+end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: entasis
 version: !ruby/object:Gem::Version
-  version: 0.4.0
-  prerelease: 
+  version: 0.5.0.rc1
+  prerelease: 6
 platform: ruby
 authors:
 - Ingemar Edsborn
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-29 00:00:00.000000000 Z
+date: 2013-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -53,6 +53,7 @@ extra_rdoc_files: []
 files:
 - lib/entasis/base.rb
 - lib/entasis/model.rb
+- lib/entasis/relations.rb
 - lib/entasis/transpose_keys.rb
 - lib/entasis/version.rb
 - lib/entasis.rb
@@ -62,6 +63,7 @@ files:
 - README.md
 - LICENSE
 - spec/entasis_spec.rb
+- spec/relations_spec.rb
 - spec/spec_helper.rb
 - spec/transpose_keys_spec.rb
 homepage: http://github.com/ingemar/entasis
@@ -79,9 +81,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>='
+  - - ! '>'
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -90,5 +92,6 @@ specification_version: 3
 summary: A few neat methods for a basic class
 test_files:
 - spec/entasis_spec.rb
+- spec/relations_spec.rb
 - spec/spec_helper.rb
 - spec/transpose_keys_spec.rb