anima 0.0.2

data/.gitignore

@@ -0,0 +1,2 @@
+/.rspec
+/Gemfile.lock

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+bundler_args: --without guard 
+script: "bundle exec rake ci" 
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - jruby-18mode 
+  - jruby-19mode 
+  - rbx-18mode
+  - rbx-19mode
+notifications:
+  email:
+    - mbj@seonic.net

data/Changelog.md

@@ -0,0 +1,3 @@
+# v0.0.2 2012-12-13
+
+First public release!

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'devtools', :git => 'https://github.com/datamapper/devtools.git'
+eval File.read('Gemfile.devtools')

data/Gemfile.devtools

@@ -0,0 +1,44 @@
+group :development do
+  gem 'rake',    '~> 0.9.2'
+  gem 'rspec',   '~> 2.12.0'
+  gem 'yard',    '~> 0.8.3'
+end
+
+group :guard do
+  gem 'guard',         '~> 1.5.4'
+  gem 'guard-bundler', '~> 1.0.0'
+  gem 'guard-rspec',   '~> 2.1.1'
+  gem 'rb-inotify', :git => 'https://github.com/mbj/rb-inotify'
+end
+
+group :benchmarks do
+  gem 'rbench', '~> 0.2.3'
+end
+
+platform :jruby do
+  group :jruby do
+    gem 'jruby-openssl', '~> 0.7.4'
+  end
+end
+
+group :metrics do
+  gem 'flay',      '~> 1.4.2'
+  gem 'flog',      '~> 2.5.1'
+  gem 'reek',      '~> 1.2.8', :git => 'https://github.com/dkubb/reek.git'
+  gem 'roodi',     '~> 2.1.0'
+  gem 'yardstick', '~> 0.8.0'
+  gem 'mutant',    '~> 0.2.5'
+
+  platforms :ruby_18, :ruby_19 do
+    # this indirectly depends on ffi which does not build on ruby-head
+    gem 'yard-spellcheck', '~> 0.1.5'
+  end
+
+  platforms :mri_19 do
+    gem 'simplecov',   '~> 0.7'
+  end
+
+  platforms :rbx do
+    gem 'pelusa', '~> 0.2.1'
+  end
+end

data/Guardfile

@@ -0,0 +1,18 @@
+# encoding: utf-8
+
+guard :bundler do
+  watch('Gemfile')
+end
+
+guard :rspec, :version => 2 do
+  # run all specs if the spec_helper or supporting files files are modified
+  watch('spec/spec_helper.rb')                      { 'spec' }
+  watch(%r{\Aspec/(?:lib|support|shared)/.+\.rb\z}) { 'spec' }
+
+  # run unit specs if associated lib code is modified
+  watch(%r{\Alib/(.+)\.rb\z})                                         { |m| Dir["spec/unit/#{m[1]}"] }
+  watch("lib/#{File.basename(File.expand_path('../', __FILE__))}.rb") { 'spec'                       }
+
+  # run a spec if it is modified
+  watch(%r{\Aspec/(?:unit|integration)/.+_spec\.rb\z})
+end

data/README.md

@@ -0,0 +1,56 @@
+anima
+=====
+
+[![Build Status](https://secure.travis-ci.org/mbj/anima.png?branch=master)](http://travis-ci.org/mbj/anima)
+[![Dependency Status](https://gemnasium.com/mbj/anima.png)](https://gemnasium.com/mbj/anima)
+[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/mbj/anima)
+
+Simple library to declare read only attributes on objects that are initializable via attributes hash.
+
+Installation
+------------
+
+There is no gem release and the code is under development and unusable.
+
+Examples
+--------
+
+See specs.
+
+Credits
+-------
+
+Contributing
+-------------
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with Rakefile or version
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+License
+-------
+
+Copyright (c) 2012 Markus Schirp
+
+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/Rakefile

@@ -0,0 +1,3 @@
+require 'devtools'
+
+Devtools.init

data/TODO

@@ -0,0 +1,3 @@
+* Use module subclass trick to improve expressiveness of Attribute / AttributeSet / ClassMethod
+* Add ability to freeze attribute_set via dsl
+* Add full unit spec coverage

data/anima.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = 'anima'
+  s.version  = '0.0.2'
+
+  s.authors  = ['Markus Schirp']
+  s.email    = 'mbj@seonic.net'
+  s.summary  = 'Attributes for Plain Old Ruby Objects Experiment'
+  s.homepage = 'http://github.com/mbj/anima'
+
+  s.files            = `git ls-files`.split("\n")
+  s.test_files       = `git ls-files -- {spec,features}/*`.split("\n")
+  s.require_paths    = %w(lib)
+  s.extra_rdoc_files = %w(README.md)
+
+  s.add_dependency('backports',     '~> 2.6.4')
+  s.add_dependency('adamantium',    '~> 0.0.3')
+  s.add_dependency('equalizer',     '~> 0.0.1')
+  s.add_dependency('abstract_type', '~> 0.0.2')
+end

data/config/flay.yml

@@ -0,0 +1,3 @@
+---
+threshold: 10
+total_score: 61

data/config/flog.yml

@@ -0,0 +1,2 @@
+---
+threshold: 15.1

data/config/mutant.yml

@@ -0,0 +1,3 @@
+---
+name: anima
+namespace: Anima

data/config/roodi.yml

@@ -0,0 +1,18 @@
+---
+AbcMetricMethodCheck:            { score: 11.0 }
+AssignmentInConditionalCheck:    { }
+CaseMissingElseCheck:            { }
+ClassLineCountCheck:             { line_count: 293 }
+ClassNameCheck:                  { pattern: !ruby/regexp '/\A(?:[A-Z]+|[A-Z][a-z](?:[A-Z]?[a-z])+)\z/' }
+ClassVariableCheck:              { }
+CyclomaticComplexityBlockCheck:  { complexity: 2 }
+CyclomaticComplexityMethodCheck: { complexity: 4 }
+EmptyRescueBodyCheck:            { }
+ForLoopCheck:                    { }
+# TODO: decrease line_count to 5 to 10
+MethodLineCountCheck:            { line_count: 14 }
+MethodNameCheck:                 { pattern: !ruby/regexp '/\A(?:[a-z\d](?:_?[a-z\d])+[?!=]?|\[\]=?|==|<=>|[+*&|-])\z/' }
+ModuleLineCountCheck:            { line_count: 295 }
+ModuleNameCheck:                 { pattern: !ruby/regexp '/\A(?:[A-Z]+|[A-Z][a-z](?:[A-Z]?[a-z])+)\z/' }
+# TODO: decrease parameter_count to 2 or less
+ParameterNumberCheck:            { parameter_count: 3 }

data/config/site.reek

@@ -0,0 +1,93 @@
+---
+UncommunicativeParameterName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+LargeClass:
+  max_methods: 10
+  exclude: []
+  enabled: true
+  max_instance_variables: 2
+UncommunicativeMethodName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^[a-z]$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+LongParameterList:
+  max_params: 2  # TODO: decrease max_params to 2
+  exclude: []
+  enabled: true
+  overrides: {}
+FeatureEnvy:
+  exclude: 
+  - Anima#attributes_hash
+  enabled: true
+ClassVariable:
+  exclude: []
+  enabled: true
+BooleanParameter:
+  exclude: []
+  enabled: true
+IrresponsibleModule:
+  exclude: []
+  enabled: true
+UncommunicativeModuleName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+NestedIterators:
+  ignore_iterators: []
+  exclude: 
+  - Anima::Attribute#define_reader # 2 levels
+  enabled: true
+  max_allowed_nesting: 1
+LongMethod:
+  max_statements: 7  # TODO: decrease max_statements to 5 or less
+  exclude: []
+  enabled: true
+Duplication:
+  allow_calls: []
+  exclude: []
+  enabled: true
+  max_calls: 1
+UtilityFunction:
+  max_helper_calls: 1
+  exclude: []
+  enabled: true
+Attribute:
+  exclude: []
+  enabled: false
+UncommunicativeVariableName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+SimulatedPolymorphism:
+  exclude: []
+  enabled: true
+  max_ifs: 1
+DataClump:
+  exclude: []
+  enabled: true
+  max_copies: 1
+  min_clump_size: 3
+ControlCouple:
+  exclude: []
+  enabled: true
+LongYieldList:
+  max_params: 1
+  exclude: []
+  enabled: true

data/config/yardstick.yml

@@ -0,0 +1,2 @@
+---
+threshold: 100

data/lib/anima.rb

@@ -0,0 +1,167 @@
+require 'backports'
+require 'adamantium'
+require 'equalizer'
+require 'abstract_type'
+
+# Main library namespace and mixin
+class Anima < Module
+  include Adamantium::Flat
+
+  # Return names
+  #
+  # @return [AttriuteSet]
+  #
+  # @api private
+  #
+  attr_reader :attributes
+
+  # Initialize object
+  #
+  # @return [undefined]
+  #
+  # @api private
+  #
+  def initialize(*names)
+    @attributes = names.map { |name| Attribute.new(name) }.freeze
+  end
+
+  # Return attributes hash for instance
+  #
+  # @param [Object] object
+  #
+  # @return [Hash]
+  #
+  # @api private
+  #
+  def attributes_hash(object)
+    attributes.each_with_object({}) do |attribute, attributes_hash|
+      attributes_hash[attribute.name] = attribute.get(object)
+    end
+  end
+
+  # Return attribute names
+  #
+  # @return [Enumerable<Symbol>]
+  #
+  # @api private
+  #
+  def attribute_names
+    attributes.map(&:name)
+  end
+  memoize :attribute_names
+
+  # Initialize instance
+  #
+  # @param [Object] object
+  #
+  # @param [Hash] attribute_hash
+  #
+  # @return [self]
+  #
+  # @api private
+  #
+  def initialize_instance(object, attribute_hash)
+    attributes.each do |attribute|
+      attribute.load(object, attribute_hash)
+    end
+
+    overflow = attribute_hash.keys - attribute_names
+
+    unless overflow.empty?
+      raise Error::Unknown.new(object.class, overflow)
+    end
+
+    self
+  end
+
+private
+
+  # Hook called when module is included
+  #
+  # @param [Class, Module] scope
+  #
+  # @return [undefined]
+  #
+  # @api private
+  #
+  def included(scope)
+    define_anima_method(scope)
+    define_initializer(scope)
+    define_attribute_readers(scope)
+    define_attribute_hash_reader(scope)
+    define_equalizer(scope)
+  end
+
+  # Define anima method on scope
+  #
+  # @param [Class, Module] scope
+  #
+  # @return [undefined]
+  #
+  # @api private
+  #
+  def define_anima_method(scope)
+    anima = self
+
+    scope.define_singleton_method(:anima) do
+      anima
+    end
+  end
+
+  # Define equalizer on scope
+  #
+  # @param [Class, Module] scope
+  #
+  # @return [undefined]
+  #
+  # @api private
+  #
+  def define_equalizer(scope)
+    scope.send(:include, Equalizer.new(*attribute_names))
+  end
+
+  # Define attribute readers
+  #
+  # @param [Class, Module] scope
+  #
+  # @return [undefined]
+  #
+  # @api private
+  #
+  def define_attribute_readers(scope)
+    attributes.each do |attribute|
+      attribute.define_reader(scope)
+    end
+  end
+
+  # Define initializer
+  #
+  # @param [Class, Module] scope
+  #
+  # @return [undefined]
+  #
+  # @api private
+  #
+  def define_initializer(scope)
+    scope.send(:define_method, :initialize) do |attributes|
+      self.class.anima.initialize_instance(self, attributes)
+    end
+  end
+
+  # Define attribute hash reader
+  #
+  # @param [Class, Module] scope
+  #
+  # @return [undefined]
+  #
+  # @api private
+  #
+  def define_attribute_hash_reader(scope)
+    scope.define_singleton_method(:attribute_hash) do |object|
+      anima.attributes_hash(object)
+    end
+  end
+end
+
+require 'anima/error'
+require 'anima/attribute'

data/lib/anima/attribute.rb

@@ -0,0 +1,99 @@
+class Anima
+
+  # An attribute
+  class Attribute
+    include Adamantium::Flat
+
+    # Return attribute name
+    #
+    # @return [Symbol]
+    #
+    # @api private
+    #
+    attr_reader :name
+    
+    # Load attribute
+    #
+    # @param [Object] object
+    # @param [Hash] attributes
+    #
+    # @return [self]
+    #
+    # @api private
+    #
+    def load(object, attributes)
+      attribute_name = name
+
+      value = attributes.fetch(attribute_name) do 
+        raise Error::Missing.new(object.class, attribute_name)
+      end
+
+      set(object, value)
+    end
+
+    # Get attribute value from object
+    #
+    # @param [Object] object
+    #
+    # @return [Object] 
+    #
+    # @api private
+    #
+    def get(object)
+      object.public_send(name)
+    end
+
+    # Set attribute value in object
+    #
+    # @param [Object] object
+    # @param [Object] value
+    #
+    # @return [self]
+    #
+    # @api private
+    #
+    def set(object, value)
+      object.instance_variable_set(instance_variable_name, value)
+
+      self
+    end
+
+    # Return instance variable name
+    #
+    # @return [Symbol]
+    #   returns @ prefixed name
+    #
+    # @api private
+    #
+    def instance_variable_name
+      :"@#{name}"
+    end
+    memoize :instance_variable_name
+
+    # Define reader
+    #
+    # @param [Class, Module] scope
+    #
+    # @return [self]
+    #
+    # @api private
+    #
+    def define_reader(scope)
+      scope.send(:attr_reader, name)
+      self
+    end
+
+  private
+
+
+    # Initialize attribute
+    #
+    # @param [Symbol] name
+    #
+    # @api private
+    #
+    def initialize(name)
+      @name = name
+    end
+  end
+end

data/lib/anima/error.rb

@@ -0,0 +1,29 @@
+class Anima
+
+  # Abstract base class for anima errors
+  class Error < RuntimeError
+    include AbstractType
+
+    # Initialize object
+    #
+    # @param [Class] model
+    # @param [Enumerable<Symbol>] names
+    #
+    # @return [undefined]
+    #
+    # @api private
+    #
+    def initialize(model, names)
+      super("#{self.class.name.split('::').last} attribute(s) #{names.inspect} for #{model.name}")
+    end
+
+    # Error for unknown attributes
+    class Unknown < self
+    end
+
+    # Error for missing attributes
+    class Missing < self
+    end
+
+  end
+end

data/spec/integration/simple_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+
+describe Anima, 'simple integration' do
+  subject { class_under_test.new(attributes) }
+
+  let(:class_under_test) do
+    Class.new do
+      include Anima.new(:firstname, :lastname)
+
+      def self.name
+        'TestClass'
+      end
+    end
+  end
+
+  context 'when instanciated with all attributes' do
+    let(:attributes) do
+      {
+        :firstname => 'Markus',
+        :lastname => 'Schirp'
+      }
+    end
+
+    its(:firstname) { should eql('Markus') }
+    its(:lastname) { should eql('Schirp') }
+  end
+
+  context 'with instanciated with extra attributes' do
+    let(:attributes) do 
+      {
+        :firstname => 'Markus',
+        :lastname => 'Schirp',
+        :extra => 'Foo'
+      }
+    end
+
+    it 'should raise error' do
+      expect { subject }.to raise_error(
+        Anima::Error::Unknown, 
+        'Unknown attribute(s) [:extra] for TestClass'
+      )
+    end
+  end
+
+  context 'when instanciated with missing attribute' do
+
+    let(:attributes) { {} }
+
+    it 'should raise error' do
+      expect { subject }.to raise_error(
+        Anima::Error::Missing,
+        'Missing attribute(s) :firstname for TestClass'
+      )
+    end
+  end
+end

data/spec/shared/command_method_behavior.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+
+shared_examples_for 'a command method' do
+  it 'returns self' do
+    should equal(object)
+  end
+end

data/spec/shared/each_method_behaviour.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+
+shared_examples_for 'an #each method' do
+  it_should_behave_like 'a command method'
+
+  context 'with no block' do
+    subject { object.each }
+
+    it { should be_instance_of(to_enum.class) }
+
+    it 'yields the expected values' do
+      subject.to_a.should eql(object.to_a)
+    end
+  end
+end

data/spec/shared/hash_method_behavior.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+shared_examples_for 'a hash method' do
+  it_should_behave_like 'an idempotent method'
+
+  specification = proc do
+    should be_instance_of(Fixnum)
+  end
+
+  it 'is a fixnum' do
+    instance_eval(&specification)
+  end
+
+  it 'memoizes the hash code' do
+    subject.should eql(object.memoized(:hash))
+  end
+end

data/spec/shared/idempotent_method_behavior.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+
+shared_examples_for 'an idempotent method' do
+  it 'is idempotent' do
+    should equal(instance_eval(&self.class.subject))
+  end
+end

data/spec/shared/invertible_method_behaviour.rb

@@ -0,0 +1,9 @@
+# encoding: utf-8
+
+shared_examples_for 'an invertible method' do
+  it_should_behave_like 'an idempotent method'
+
+  it 'is invertible' do
+    subject.inverse.should equal(object)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+require 'anima'
+require 'rspec'
+
+# require spec support files and shared behavior
+Dir[File.expand_path('../{support,shared}/**/*.rb', __FILE__)].each { |f| require(f) }
+
+
+RSpec.configure do |config|
+end

data/spec/unit/anima/attribute/define_reader_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Anima::Attribute, '#define_reader' do
+  let(:object) { described_class.new(:foo) }
+
+  subject { object.define_reader(target_class) }
+
+  let(:target_class) do
+    Class.new do
+      def initialize(foo)
+        @foo = foo
+      end
+    end
+  end
+
+  let(:value) { mock('Value') }
+
+  it 'should create a reader' do
+    instance = target_class.new(value)
+    lambda { subject }.should change { instance.respond_to?(:foo) }.from(false).to(true)
+  end
+
+  it_should_behave_like 'a command method'
+end

data/spec/unit/anima/attribute/get_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Anima::Attribute, '#get' do
+  let(:object) { described_class.new(:foo) }
+
+  subject { object.get(target) }
+
+  let(:target_class) do
+    Class.new do
+      attr_reader :foo
+
+      def initialize(foo)
+        @foo = foo
+      end
+    end
+  end
+
+  let(:target) { target_class.new(value) }
+
+  let(:value) { mock('Value') }
+
+  it 'should return value' do
+    should be(value)
+  end
+end

data/spec/unit/anima/attribute/instance_variable_name_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe Anima::Attribute, '#instance_variable_name' do
+  subject { Anima::Attribute.new(:foo).instance_variable_name }
+
+  it { should be(:@foo) }
+
+  it_should_behave_like 'an idempotent method'
+end

data/spec/unit/anima/attribute/load_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Anima::Attribute, '#load' do
+  let(:object) { described_class.new(:foo) }
+
+  subject { object.load(target, attribute_hash) }
+
+  let(:target) { Object.new }
+
+  let(:value) { mock('Value') }
+
+  context 'when attribute hash contains key' do
+    let(:attribute_hash) { { :foo => value } }
+
+    it 'should set value as instance variable' do
+      subject
+      target.instance_variable_get(:@foo).should be(value)
+    end
+
+    it_should_behave_like 'a command method'
+
+  end
+
+  context 'when attribute hash does not contain key' do
+    let(:attribute_hash) { {} }
+
+    it 'should raise error' do
+      expect { subject }.to raise_error(Anima::Error::Missing, Anima::Error::Missing.new(target.class, :foo).message)
+    end
+  end
+end

data/spec/unit/anima/attribute/set_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe Anima::Attribute, '#set' do
+  let(:object) { described_class.new(:foo) }
+
+  subject { object.set(target, value) }
+
+  let(:target) { Object.new }
+
+  let(:value) { mock('Value') }
+
+  it_should_behave_like 'a command method'
+
+  it 'should set value as instance variable' do
+    subject
+    target.instance_variable_get(:@foo).should be(value)
+  end
+end

data/spec/unit/anima/attributes_hash_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Anima, '#attributes_hash' do
+  let(:object) { described_class.new(:foo) }
+
+  let(:value) { mock('Value') }
+
+  let(:instance) { mock(:foo => value) }
+
+  subject { object.attributes_hash(instance) }
+
+  it { should eql(:foo => value) }
+end

data/spec/unit/anima/error/message_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe Anima::Error, '#message' do
+  let(:object) { described_class.new(klass, name) }
+  
+  subject { object.message }
+
+  let(:klass) { mock(:name => 'THE-CLASS-NAME') }
+  let(:name)  { 'THE-ATTRIBUTE-NAME' }
+
+  it 'should return the message string' do
+    should eql('Error attribute(s) "THE-ATTRIBUTE-NAME" for THE-CLASS-NAME')
+  end
+
+  it_should_behave_like 'an idempotent method'
+end

data/spec/unit/anima/included_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe Anima, '#included' do
+  let(:object) { described_class.new(:foo) }
+
+  let(:target) do
+    object = self.object
+    Class.new do
+      include object
+    end
+  end
+
+  let(:value) { mock('Value') }
+
+  let(:instance)   { target.new(:foo => value) }
+  let(:instance_b) { target.new(:foo => value) }
+  let(:instance_c) { target.new(:foo => mock('Bar')) }
+
+  context 'on instance' do
+    subject { instance }
+
+    its(:foo) { should be(value) }
+
+    it { should eql(instance_b) }
+  end
+
+  context 'on singleton' do
+    subject { target }
+
+    it 'should define attribute hash reader' do
+      target.attribute_hash(instance).should eql(:foo => value)
+    end
+
+    its(:anima) { should be(object) }
+  end
+end

data/spec/unit/anima/initialize_instance_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe Anima, '#initialize_instance' do
+  let(:object) { Anima.new(:foo, :bar) }
+
+  let(:target) { Object.new }
+
+  let(:foo) { mock('Foo') }
+  let(:bar) { mock('Bar') }
+
+  subject { object.initialize_instance(target, attribute_hash) }
+
+  context 'when all keys are present in attribute hash' do
+    let(:attribute_hash) { { :foo => foo, :bar => bar } }
+
+    it 'should initialize target instance variables' do
+      subject
+      target.instance_variables.map(&:to_sym).to_set.should eql([:@foo, :@bar].to_set)
+      target.instance_variable_get(:@foo).should be(foo)
+      target.instance_variable_get(:@bar).should be(bar)
+    end
+
+    it_should_behave_like 'a command method'
+  end
+
+  context 'when extra key is missing in attribute hash' do
+    let(:attribute_hash) { { :foo => foo, :bar => bar, :baz => mock('Baz') } }
+
+    it 'should raise error' do
+      expect { subject }.to raise_error(Anima::Error::Unknown, Anima::Error::Unknown.new(target.class, [:baz]).message)
+    end
+  end
+
+  context 'when a key is missing in attribute hash' do
+    let(:attribute_hash) { { :bar => bar } }
+
+    it 'should raise error' do
+      expect { subject }.to raise_error(Anima::Error::Missing, Anima::Error::Missing.new(target.class, :foo).message)
+    end
+  end
+end

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification
+name: anima
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Markus Schirp
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: backports
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.4
+- !ruby/object:Gem::Dependency
+  name: adamantium
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+- !ruby/object:Gem::Dependency
+  name: equalizer
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+- !ruby/object:Gem::Dependency
+  name: abstract_type
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+description: 
+email: mbj@seonic.net
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Changelog.md
+- Gemfile
+- Gemfile.devtools
+- Guardfile
+- README.md
+- Rakefile
+- TODO
+- anima.gemspec
+- config/flay.yml
+- config/flog.yml
+- config/mutant.yml
+- config/roodi.yml
+- config/site.reek
+- config/yardstick.yml
+- lib/anima.rb
+- lib/anima/attribute.rb
+- lib/anima/error.rb
+- spec/integration/simple_spec.rb
+- spec/shared/command_method_behavior.rb
+- spec/shared/each_method_behaviour.rb
+- spec/shared/hash_method_behavior.rb
+- spec/shared/idempotent_method_behavior.rb
+- spec/shared/invertible_method_behaviour.rb
+- spec/spec_helper.rb
+- spec/unit/anima/attribute/define_reader_spec.rb
+- spec/unit/anima/attribute/get_spec.rb
+- spec/unit/anima/attribute/instance_variable_name_spec.rb
+- spec/unit/anima/attribute/load_spec.rb
+- spec/unit/anima/attribute/set_spec.rb
+- spec/unit/anima/attributes_hash_spec.rb
+- spec/unit/anima/error/message_spec.rb
+- spec/unit/anima/included_spec.rb
+- spec/unit/anima/initialize_instance_spec.rb
+homepage: http://github.com/mbj/anima
+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: Attributes for Plain Old Ruby Objects Experiment
+test_files:
+- spec/integration/simple_spec.rb
+- spec/shared/command_method_behavior.rb
+- spec/shared/each_method_behaviour.rb
+- spec/shared/hash_method_behavior.rb
+- spec/shared/idempotent_method_behavior.rb
+- spec/shared/invertible_method_behaviour.rb
+- spec/spec_helper.rb
+- spec/unit/anima/attribute/define_reader_spec.rb
+- spec/unit/anima/attribute/get_spec.rb
+- spec/unit/anima/attribute/instance_variable_name_spec.rb
+- spec/unit/anima/attribute/load_spec.rb
+- spec/unit/anima/attribute/set_spec.rb
+- spec/unit/anima/attributes_hash_spec.rb
+- spec/unit/anima/error/message_spec.rb
+- spec/unit/anima/included_spec.rb
+- spec/unit/anima/initialize_instance_spec.rb
+has_rdoc: