anima 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 537a7e2e192c0d4b7519c1299b12bec430145e1f
-  data.tar.gz: 2ca3528ae56ef4f7ab304f9a394121ba74f20f28
+  metadata.gz: 4d3d1052ef69a252eba9f680d8918977ebe21957
+  data.tar.gz: 95726462b39f8b85f7706c5415369eb0e141e48d
 SHA512:
-  metadata.gz: d989083d89deabafa011dbd874f1f90eab12f5efe36a8e1a472c70dfdbf061109e3786146b11cd59a3d3b4158e6f8187342c494fbc71fbc0f7f2b6de6fe237cb
-  data.tar.gz: 3874ed4c1a4454eee07b86d45dd3ddd718db57afded1332bee13b17a89e87d68ddb74ae8af227071272a1ee701933c724a350c32b17422fddf98c9e83ff9dd55
+  metadata.gz: 320e39521765b3c969063d635b90c3fc51927b2ac9f1fb46e4c13b02f56a539fb3bf1d57fd8f05742a7fe2b83143c0b3d91c3b3e037a4b142cb3341c7907f9cb
+  data.tar.gz: 73e0f2c5c9dc9901dc0c0ce04b899a3c23c5587ff144794b303e53eff9da2bc13d09ca99ea43ff9600805cc8f3ff58c991ebfe66b1eeb9cf8e9c9a796630e29f

data/.rubocop.yml

@@ -1,6 +1,6 @@
 AllCops:
-  Includes:
+  Include:
     - 'Gemfile'
-  Excludes:
+  Exclude:
     - 'Gemfile.devtools'
-    - 'vendor/**'
+    - 'vendor/**/*'

data/.travis.yml

@@ -3,26 +3,9 @@ cache: bundler
 bundler_args: --without yard guard benchmarks
 script: "bundle exec rake ci:metrics"
 rvm:
-  - 1.9.3
-  - 2.0.0
-  - 2.1.0-rc1
-  - ruby-head
-  - rbx
+  - '2.1'
+  - '2.2'
 matrix:
-  include:
-    - rvm: jruby-19mode
-      env: JRUBY_OPTS="$JRUBY_OPTS --debug"  # for simplecov
-    - rvm: jruby-20mode
-      env: JRUBY_OPTS="$JRUBY_OPTS --debug"  # for simplecov
-    - rvm: jruby-head
-      env: JRUBY_OPTS="$JRUBY_OPTS --debug"  # for simplecov
-  allow_failures:
-    - rvm: 2.1.0-rc1
-    - rvm: ruby-head
-  fast_finish: true
-notifications:
-  irc:
-    channels:
-      - irc.freenode.org#rom-rb
-    on_success: never
-    on_failure: change
+  allowed_failures:
+  - jruby # Travis jruby does not run in >= 2.1 ruby yet
+  - rbx # segfault

data/Changelog.md

@@ -1,3 +1,17 @@
+# v0.3.0 2015-xx-xx
+
+Changes:
+
+* Drop support for ruby < 2.1
+* Drop support for Anima::Update
+* Add #with as a replacement that is active by default [#13]
+
+# v0.2.1 2014-04-10
+
+Changes:
+
+* Require ruby version >= 1.9.3 in gemspec.
+
 # v0.2.0 2014-01-13
 
 Breaking changes:

data/Gemfile

@@ -1,11 +1,9 @@
-# encoding: utf-8
-
 source 'https://rubygems.org'
 
 gemspec
 
-group :development, :test do
-  gem 'devtools', git: 'https://github.com/rom-rb/devtools.git'
-end
-
-eval_gemfile 'Gemfile.devtools'
+gem 'devtools', git: 'https://github.com/rom-rb/devtools.git'
+gem 'mutant',   git: 'https://github.com/mbj/mutant.git',
+                branch: 'fix/anima-update'
+gem 'morpher',  git: 'https://github.com/mbj/morpher.git',
+                branch: 'fix/upgrade-anima'

data/README.md

@@ -4,6 +4,7 @@ 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/github/mbj/anima.png)](https://codeclimate.com/github/mbj/anima)
+[![Gem Version](https://img.shields.io/gem/v/anima.svg)](https://rubygems.org/gems/anima)
 
 Simple library to declare read only attributes on value-objects that are initialized via attributes hash.
 
@@ -15,7 +16,9 @@ Install the gem `anima` via your preferred method.
 Examples
 --------
 
-```
+```ruby
+require 'anima'
+
 # Definition
 class Person
   include Anima.new(:salutation, :firstname, :lastname)
@@ -23,28 +26,30 @@ end
 
 # Every day operation
 a = Person.new(
-  :salutation => 'Mr',
-  :firstname  => 'Markus',
-  :lastname   => 'Schirp'
+  salutation: 'Mr',
+  firstname:  'Markus',
+  lastname:   'Schirp'
 )
 
+# Returns expected values
 a.salutation # => "Mr"
 a.firstname  # => "Markus"
 a.lastname   # => "Schirp"
-a.frozen?    # => true
+a.frozen?    # => false
 
 b = Person.new(
-  :salutation => 'Mr',
-  :firstname  => 'John',
-  :lastname   => 'Doe'
+  salutation: 'Mr',
+  firstname:  'John',
+  lastname:   'Doe'
 )
 
-a = Person.new(
-  :salutation => 'Mr',
-  :firstname  => 'Markus',
-  :lastname   => 'Schirp'
+c = Person.new(
+  salutation: 'Mr',
+  firstname:  'Markus',
+  lastname:   'Schirp'
 )
 
+# Equality based on attributes
 a == b      # => false
 a.eql?(b)   # => false
 a.equal?(b) # => false
@@ -53,21 +58,25 @@ a == c      # => true
 a.eql?(c)   # => true
 a.equal?(c) # => false
 
-# Functional updates
-class Person
-  include Anima::Update
-end
-
-d = b.update(
-  :salutation => 'Mrs',
-  :firstname  => 'Sue',
+# Functional-style updates
+d = b.with(
+  salutation: 'Mrs',
+  firstname:  'Sue',
 )
 
 # It returns copies, no inplace modification
 d.equal?(b) # => false
 
 # Hash representation
-d.to_h # => { :salutation => 'Mrs', :firstname => 'Sue' }
+d.to_h # => { salutation: 'Mrs', firstname: 'Sue', lastname: 'Doe' }
+
+# Disallows initialization with incompatible attributes
+
+Person.new(
+  # :saluatation key missing
+  "firstname" => "Markus", # does NOT coerce this by intention
+  :lastname   => "Schirp"
+) # raises Anima::Error with message "Person attributes missing: [:salutation, :firstname], unknown: ["firstname"]
 ```
 
 Credits

data/Rakefile

@@ -6,6 +6,14 @@ task('metrics:mutant').clear
 
 namespace :metrics do
   task :mutant => :coverage do
-    $stderr.puts 'Anima is a dependency of mutant and zombification is currently defunkt :('
+    system(*%w[
+      bundle exec mutant
+        --include lib
+        --require anima
+        --use rspec
+        --zombie
+        --
+        Anima*
+    ]) or fail "Mutant task failed"
   end
 end

data/anima.gemspec

@@ -1,8 +1,8 @@
 # encoding: utf-8
 
 Gem::Specification.new do |s|
-  s.name = 'anima'
-  s.version  = '0.2.0'
+  s.name     = 'anima'
+  s.version  = '0.3.0'
 
   s.authors  = ['Markus Schirp']
   s.email    = 'mbj@schirp-dso.com'
@@ -15,7 +15,9 @@ Gem::Specification.new do |s|
   s.require_paths    = %w(lib)
   s.extra_rdoc_files = %w(README.md)
 
-  s.add_dependency('adamantium',    '~> 0.1')
-  s.add_dependency('equalizer',     '~> 0.0.8')
+  s.required_ruby_version = '>= 2.1.0'
+
+  s.add_dependency('adamantium',    '~> 0.2')
+  s.add_dependency('equalizer',     '~> 0.0.11')
   s.add_dependency('abstract_type', '~> 0.0.7')
 end

data/circle.yml

@@ -1,6 +1,7 @@
 ---
-ruby:
-  version: 2.0.0-p353
+machine:
+  ruby:
+    version: '2.2'
 test:
   override:
     - bundle exec rake ci

data/config/flay.yml

@@ -1,3 +1,3 @@
 ---
 threshold: 6
-total_score: 44
+total_score: 29

data/config/flog.yml

@@ -1,2 +1,2 @@
 ---
-threshold: 9.2
+threshold: 11.9

data/config/mutant.yml

@@ -1,3 +1,4 @@
 ---
 name: anima
 namespace: Anima
+zombify: true

data/config/reek.yml

@@ -22,7 +22,8 @@ UncommunicativeMethodName:
   - !ruby/regexp /[A-Z]/
 LongParameterList:
   max_params: 2  # TODO: decrease max_params to 2
-  exclude: []
+  exclude:
+  - Anima::Error#initialize # 3 params
   enabled: true
   overrides: {}
 FeatureEnvy:
@@ -35,9 +36,10 @@ ClassVariable:
 BooleanParameter:
   exclude: []
   enabled: true
+# Buggy like hell
 IrresponsibleModule:
   exclude: []
-  enabled: true
+  enabled: false
 UncommunicativeModuleName:
   accept: []
   exclude: []
@@ -49,8 +51,7 @@ NestedIterators:
   ignore_iterators: []
   exclude:
   - Anima::Attribute#define_reader # 2 levels
-  - Anima::Builder#define_anima_method # 2 levels
-  - Anima::Builder#define_attribute_readers # 2 levels
+  - Anima#included # 2 levels
   enabled: true
   max_allowed_nesting: 1
 TooManyStatements:
@@ -64,7 +65,8 @@ DuplicateMethodCall:
   max_calls: 1
 UtilityFunction:
   max_helper_calls: 1
-  exclude: []
+  exclude:
+  - Anima::Error#initialize # false positive, calls super
   enabled: true
 Attribute:
   exclude: []
@@ -93,3 +95,6 @@ LongYieldList:
   max_params: 1
   exclude: []
   enabled: true
+# Thats the whole point of this lib, oOo.
+ModuleInitialize:
+  enabled: false

data/config/rubocop.yml

@@ -16,6 +16,9 @@ CollectionMethods:
     inject:   'reduce'
     find:     'detect'
     find_all: 'select'
+  Exclude:
+    # The Pathname#find method is mistakenly identified as Enumberable#find
+    - lib/tasks/assets_precompile_nodigest.rake
 
 # Do not force public/protected/private keyword to be indented at the same
 # level as the def keyword. My personal preference is to outdent these keywords
@@ -26,38 +29,20 @@ CollectionMethods:
 AccessModifierIndentation:
   Enabled: false
 
-MethodLength:
-  CountComments: false
-  Max: 17 # TODO: Bring down to 10
-
-RegexpLiteral: # I do not agree %r(\A) is more readable than /\A/
-  Enabled: false
-
-Eval:
-  Enabled: false # Mutant must use Kernel#eval to inject mutated source
-
 # Limit line length
 LineLength:
-  Max: 124  # TODO: lower to 79
+  Max: 79
 
 # Disable documentation checking until a class needs to be documented once
 Documentation:
   Enabled: false
 
-# Do not favor modifier if/unless usage when you have a single-line body
-IfUnlessModifier:
-  Enabled: false
-
-# Mutant needs to define methods like def bar; end in specs
-Semicolon:
-  Enabled: false
-
-# Mutant needs to define multiple methods on same line in specs
-EmptyLineBetweenDefs:
+# Do not always use &&/|| instead of and/or.
+AndOr:
   Enabled: false
 
-# Mutant needs to define singleton methods like Foo.bar in specs
-ClassMethods:
+# Do not favor modifier if/unless usage when you have a single-line body
+IfUnlessModifier:
   Enabled: false
 
 # Allow case equality operator (in limited use within the specs)
@@ -72,10 +57,81 @@ ConstantName:
 TrivialAccessors:
   Enabled: false
 
-# And also have a differend opinion here
-AndOr:
+# Allow empty lines around class body
+EmptyLinesAroundClassBody:
+  Enabled: false
+
+# Allow empty lines around module body
+EmptyLinesAroundModuleBody:
+  Enabled: false
+
+# Allow empty lines around block body
+EmptyLinesAroundBlockBody:
+  Enabled: false
+
+# Allow multiple line operations to not require indentation
+MultilineOperationIndentation:
+  Enabled: false
+
+# Prefer String#% over Kernel#sprintf
+FormatString:
+  Enabled: false
+
+# Use square brackets for literal Array objects
+PercentLiteralDelimiters:
+  PreferredDelimiters:
+    '%':  '{}'
+    '%i': '[]'
+    '%q': ()
+    '%Q': ()
+    '%r': '{}'
+    '%s': ()
+    '%w': '[]'
+    '%W': '[]'
+    '%x': ()
+
+# Use %i[...] for arrays of symbols
+SymbolArray:
+  Enabled: true
+
+# Align if/else blocks with the variable assignment
+EndAlignment:
+  AlignWith: variable
+
+# Do not always align parameters when it is easier to read
+AlignParameters:
+  Exclude:
+    - spec/**/*_spec.rb
+
+# Prefer #kind_of? over #is_a?
+ClassCheck:
+  EnforcedStyle: kind_of?
+
+# Do not prefer double quotes to be used when %q or %Q is more appropriate
+UnneededPercentQ:
+  Enabled: false
+
+# Allow a maximum ABC score
+Metrics/AbcSize:
+  Max: 21.02
+
+# Do not prefer lambda.call(...) over lambda.(...)
+LambdaCall:
+  Enabled: false
+
+# Buggy cop, returns false positive for our code base
+NonLocalExitFromIterator:
+  Enabled: false
+
+# To allow alignment of similar expressions we want to allow more than one
+# space around operators:
+#
+# let(:a) { bar    + something }
+# let(:b) { foobar + something }
+#
+SpaceAroundOperators:
   Enabled: false
 
-# Allow empty lines around body
-EmptyLinesAroundBody:
+# We use parallel assignments with great success
+ParallelAssignment:
   Enabled: false

data/lib/anima.rb

@@ -31,8 +31,8 @@ class Anima < Module
   # @return [Anima]
   #
   # @example
-  #   anima = Anima.new(:foo, :bar)
-  #   anima.add(:foo) # equals Anima.new(:foo, :bar)
+  #   anima = Anima.new(:foo)
+  #   anima.add(:bar) # equals Anima.new(:foo, :bar)
   #
   # @api private
   #
@@ -45,7 +45,7 @@ class Anima < Module
   # @return [Anima]
   #
   # @example
-  #   anima = Anima.new(:foo)
+  #   anima = Anima.new(:foo, :bar)
   #   anima.remove(:bar) # equals Anima.new(:foo)
   #
   # @api public
@@ -90,16 +90,62 @@ class Anima < Module
   # @api private
   #
   def initialize_instance(object, attribute_hash)
-    assert_known_attributes(object, attribute_hash)
+    assert_known_attributes(object.class, attribute_hash)
     attributes.each do |attribute|
       attribute.load(object, attribute_hash)
     end
     self
   end
 
+  # Static instance methods for anima infected classes
+  module InstanceMethods
+    # Initialize an anima infected object
+    #
+    # @param [#to_h] attributes
+    #   a hash that matches anima defined attributes
+    #
+    # @return [undefined]
+    #
+    # @api public
+    def initialize(attributes)
+      self.class.anima.initialize_instance(self, attributes)
+    end
+
+    # Return a hash representation of an anima infected object
+    #
+    # @return [Hash]
+    #
+    # @api public
+    def to_h
+      self.class.anima.attributes_hash(self)
+    end
+
+    # Return updated instance
+    #
+    # @example
+    #   klass = Class.new do
+    #     include Anima.new(:foo, :bar)
+    #   end
+    #
+    #   foo = klass.new(:foo => 1, :bar => 2)
+    #   updated = foo.with(:foo => 3)
+    #   updated.foo # => 3
+    #   updated.bar # => 2
+    #
+    # @param [Hash] attributes
+    #
+    # @return [Anima]
+    #
+    # @api private
+    #
+    def with(attributes)
+      self.class.new(to_h.update(attributes))
+    end
+  end # InstanceMethods
+
   private
 
-  # Hook called when module is included
+  # Infect the instance with anima
   #
   # @param [Class, Module] scope
   #
@@ -108,28 +154,41 @@ class Anima < Module
   # @api private
   #
   def included(descendant)
-    Builder.call(self, descendant)
+    descendant.instance_exec(self, attribute_names) do |anima, names|
+      # Define anima method
+      define_singleton_method(:anima) { anima }
+
+      # Define instance methods
+      include InstanceMethods
+
+      # Define attribute readers
+      attr_reader(*names)
+
+      # Define equalizer
+      include Equalizer.new(*names)
+    end
   end
 
   # Fail unless keys in +attribute_hash+ matches #attribute_names
   #
-  # @param [Object] object
-  #   the object being initialized
+  # @param [Class] klass
+  #   the class being initialized
   #
   # @param [Hash] attribute_hash
   #   the attributes to initialize +object+ with
   #
   # @return [undefined]
   #
-  # @raise [Error::Unknown]
+  # @raise [Error]
   #
   # @api private
-  def assert_known_attributes(object, attribute_hash)
-    overflow = attribute_hash.keys - attribute_names
+  def assert_known_attributes(klass, attribute_hash)
+    keys = attribute_hash.keys
 
-    if overflow.any?
-      fail Error::Unknown.new(object, overflow)
-    end
+    unknown = keys - attribute_names
+    missing = attribute_names - keys
+
+    fail Error.new(klass, missing, unknown) if unknown.any? || missing.any?
   end
 
   # Return new instance
@@ -143,10 +202,7 @@ class Anima < Module
   def new(attributes)
     self.class.new(*attributes)
   end
-
 end # Anima
 
-require 'anima/builder'
 require 'anima/error'
 require 'anima/attribute'
-require 'anima/update'

data/lib/anima/attribute.rb

@@ -1,7 +1,6 @@
 # encoding: utf-8
 
 class Anima
-
   # An attribute
   class Attribute
     include Adamantium::Flat, Equalizer.new(:name)
@@ -24,6 +23,14 @@ class Anima
     #
     attr_reader :name
 
+    # Return instance variable name
+    #
+    # @return [Symbol]
+    #
+    # @api private
+    #
+    attr_reader :instance_variable_name
+
     # Load attribute
     #
     # @param [Object] object
@@ -34,11 +41,7 @@ class Anima
     # @api private
     #
     def load(object, attributes)
-      value = attributes.fetch(name) do |attribute_name|
-        fail Error::Missing.new(object, attribute_name)
-      end
-
-      set(object, value)
+      set(object, attributes.fetch(name))
     end
 
     # Get attribute value from object
@@ -63,10 +66,9 @@ class Anima
     # @api private
     #
     def set(object, value)
-      object.instance_variable_set(@instance_variable_name, value)
+      object.instance_variable_set(instance_variable_name, value)
 
       self
     end
-
   end # Attribute
 end # Anima

data/lib/anima/error.rb

@@ -1,39 +1,24 @@
 # encoding: utf-8
 
 class Anima
-
   # Abstract base class for anima errors
   class Error < RuntimeError
-
-    # Error for unknown attributes
-    class Unknown < self
-    end
-
-    # Error for missing attributes
-    class Missing < self
-    end
-
-    include AbstractType
-
-    DOUBLE_COLON = '::'.freeze
+    FORMAT = '%s attributes missing: %s, unknown: %s'.freeze
+    private_constant(*constants(false))
 
     # Initialize object
     #
-    # @param [Object] object
-    # @param [Enumerable<Symbol>] names
+    # @param [Class] klass
+    #   the class being initialized
+    # @param [Enumerable<Symbol>] missing
+    # @param [Enumerable<Symbol>] unknown
     #
     # @return [undefined]
     #
     # @api private
     #
-    def initialize(object, names)
-      super("#{name} attribute(s) #{names.inspect} for #{object.class}")
-    end
-
-    private
-
-    def name
-      self.class.name.split(DOUBLE_COLON).last
+    def initialize(klass, missing, unknown)
+      super(FORMAT % [klass, missing, unknown])
     end
   end # Error
 end # Anima

data/spec/integration/simple_spec.rb

@@ -32,20 +32,19 @@ describe Anima, 'simple integration' do
 
     it 'should raise error' do
       expect { subject }.to raise_error(
-        Anima::Error::Unknown,
-        'Unknown attribute(s) [:extra] for TestClass'
+        Anima::Error,
+        'TestClass attributes missing: [], unknown: [:extra]'
       )
     end
   end
 
   context 'when instantiated with missing attributes' do
-
     let(:attributes) { {} }
 
     it 'should raise error' do
       expect { subject }.to raise_error(
-        Anima::Error::Missing,
-        'Missing attribute(s) :firstname for TestClass'
+        Anima::Error,
+        'TestClass attributes missing: [:firstname, :lastname], unknown: []'
       )
     end
   end

data/spec/spec_helper.rb

@@ -3,6 +3,3 @@
 require 'anima'
 require 'devtools'
 Devtools.init_spec_helper
-
-RSpec.configure do |config|
-end

data/spec/unit/anima/attribute_spec.rb

@@ -29,29 +29,24 @@ describe Anima::Attribute do
   describe '#load' do
     subject { object.load(target, attribute_hash) }
 
-    let(:target) { Object.new }
-
-    let(:value) { double('Value') }
-
-    context 'when attribute hash contains key' do
-      let(:attribute_hash) { { foo: value } }
+    let(:target)         { Object.new      }
+    let(:value)          { double('Value') }
+    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 set value as instance variable' do
+      subject
+      expect(target.instance_variable_get(:@foo)).to be(value)
+    end
 
-      it_should_behave_like 'a command method'
+    it_should_behave_like 'a command method'
+  end
 
-    end
+  describe '#instance_variable_name' do
+    subject { object.instance_variable_name }
 
-    context 'when attribute hash does not contain key' do
-      let(:attribute_hash) { {} }
+    it { should be(:@foo) }
 
-      it 'should raise error' do
-        expect { subject }.to raise_error(Anima::Error::Missing, Anima::Error::Missing.new(target, :foo).message)
-      end
-    end
+    it_should_behave_like 'an idempotent method'
   end
 
   describe '#set' do
@@ -65,7 +60,7 @@ describe Anima::Attribute do
 
     it 'should set value as instance variable' do
       subject
-      target.instance_variable_get(:@foo).should be(value)
+      expect(target.instance_variable_get(:@foo)).to be(value)
     end
   end
 end

data/spec/unit/anima/error_spec.rb

@@ -2,25 +2,19 @@
 
 require 'spec_helper'
 
-describe Anima::Error, '#message' do
-  let(:object) { error.new(instance, name) }
+describe Anima::Error do
+  describe '#message' do
+    let(:object) { described_class.new(Anima, missing, unknown) }
 
-  let(:error) do
-    Class.new(described_class) do
-      def self.name
-        'Test::Error'
-      end
-    end
-  end
+    let(:missing) { %i[missing] }
+    let(:unknown) { %i[unknown] }
 
-  subject { object.message }
+    subject { object.message }
 
-  let(:instance) { Object.new }
-  let(:name)     { 'foo' }
+    it 'should return the message string' do
+      should eql('Anima attributes missing: [:missing], unknown: [:unknown]')
+    end
 
-  it 'should return the message string' do
-    should eql('Error attribute(s) "foo" for Object')
+    it_should_behave_like 'an idempotent method'
   end
-
-  it_should_behave_like 'an idempotent method'
 end

data/spec/unit/anima_spec.rb

@@ -89,7 +89,7 @@ describe Anima do
       subject { target }
 
       it 'should define attribute hash reader' do
-        instance.to_h.should eql(foo: value)
+        expect(instance.to_h).to eql(foo: value)
       end
 
       its(:anima) { should be(object) }
@@ -109,9 +109,15 @@ describe Anima do
 
       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)
+
+        expect(
+          target
+            .instance_variables
+            .map(&:to_sym)
+            .to_set
+        ).to eql(%i[@foo @bar].to_set)
+        expect(target.instance_variable_get(:@foo)).to be(foo)
+        expect(target.instance_variable_get(:@bar)).to be(bar)
       end
 
       it_should_behave_like 'a command method'
@@ -121,7 +127,10 @@ describe Anima do
       let(:attribute_hash) { { foo: foo, bar: bar, baz: double('Baz') } }
 
       it 'should raise error' do
-        expect { subject }.to raise_error(Anima::Error::Unknown, Anima::Error::Unknown.new(target, [:baz]).message)
+        expect { subject }.to raise_error(
+          Anima::Error,
+          Anima::Error.new(target.class, [], [:baz]).message
+        )
       end
     end
 
@@ -129,7 +138,9 @@ describe Anima do
       let(:attribute_hash) { { bar: bar } }
 
       it 'should raise error' do
-        expect { subject }.to raise_error(Anima::Error::Missing, Anima::Error::Missing.new(target, :foo).message)
+        expect { subject }.to raise_error(
+          Anima::Error.new(target.class, [:foo], []).message
+        )
       end
     end
   end
@@ -162,4 +173,28 @@ describe Anima do
 
     it { should eql(params) }
   end
+
+  describe '#with' do
+    subject { object.with(attributes) }
+
+    let(:klass) do
+      Class.new do
+        include Anima.new(:foo, :bar)
+      end
+    end
+
+    let(:object) { klass.new(foo: 1, bar: 2) }
+
+    context 'with empty attributes' do
+      let(:attributes) { {} }
+
+      it { should eql(object) }
+    end
+
+    context 'with updated attribute' do
+      let(:attributes) { { foo: 3 } }
+
+      it { should eql(klass.new(foo: 3, bar: 2)) }
+    end
+  end
 end

metadata

@@ -1,55 +1,55 @@
 --- !ruby/object:Gem::Specification
 name: anima
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Markus Schirp
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-13 00:00:00.000000000 Z
+date: 2015-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: adamantium
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: equalizer
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.8
+        version: 0.0.11
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.8
+        version: 0.0.11
 - !ruby/object:Gem::Dependency
   name: abstract_type
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.0.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.0.7
 description: 
@@ -59,13 +59,12 @@ extensions: []
 extra_rdoc_files:
 - README.md
 files:
-- .gitignore
-- .rspec
-- .rubocop.yml
-- .travis.yml
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
 - Changelog.md
 - Gemfile
-- Gemfile.devtools
 - Guardfile
 - README.md
 - Rakefile
@@ -81,14 +80,11 @@ files:
 - config/yardstick.yml
 - lib/anima.rb
 - lib/anima/attribute.rb
-- lib/anima/builder.rb
 - lib/anima/error.rb
-- lib/anima/update.rb
 - spec/integration/simple_spec.rb
 - spec/spec_helper.rb
 - spec/unit/anima/attribute_spec.rb
 - spec/unit/anima/error_spec.rb
-- spec/unit/anima/update_spec.rb
 - spec/unit/anima_spec.rb
 homepage: http://github.com/mbj/anima
 licenses:
@@ -100,17 +96,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.14
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
 summary: Initialize object attributes via attributes hash
@@ -119,6 +115,5 @@ test_files:
 - spec/spec_helper.rb
 - spec/unit/anima/attribute_spec.rb
 - spec/unit/anima/error_spec.rb
-- spec/unit/anima/update_spec.rb
 - spec/unit/anima_spec.rb
 has_rdoc: 

data/Gemfile.devtools

@@ -1,69 +0,0 @@
-# encoding: utf-8
-
-group :development do
-  gem 'rake',  '~> 10.1.0'
-  gem 'rspec', '~> 2.14.1'
-  gem 'yard',  '~> 0.8.7'
-
-  platform :rbx do
-    gem 'rubysl-singleton', '~> 2.0.0'
-  end
-end
-
-group :yard do
-  gem 'kramdown', '~> 1.3.0'
-end
-
-group :guard do
-  gem 'guard',         '~> 2.2.4'
-  gem 'guard-bundler', '~> 2.0.0'
-  gem 'guard-rspec',   '~> 4.2.0'
-  gem 'guard-rubocop', '~> 1.0.0'
-
-  # file system change event handling
-  gem 'listen',     '~> 2.4.0'
-  gem 'rb-fchange', '~> 0.0.6', require: false
-  gem 'rb-fsevent', '~> 0.9.3', require: false
-  gem 'rb-inotify', '~> 0.9.0', require: false
-
-  # notification handling
-  gem 'libnotify',               '~> 0.8.0', require: false
-  gem 'rb-notifu',               '~> 0.0.4', require: false
-  gem 'terminal-notifier-guard', '~> 1.5.3', require: false
-end
-
-group :metrics do
-  gem 'coveralls', '~> 0.7.0'
-  gem 'flay',      '~> 2.4.0'
-  gem 'flog',      '~> 4.2.0'
-  gem 'reek',      '~> 1.3.2'
-  gem 'rubocop',   '~> 0.16.0'
-  gem 'simplecov', '~> 0.8.2'
-  gem 'yardstick', '~> 0.9.7', git: 'https://github.com/dkubb/yardstick.git'
-
-  platforms :mri do
-    gem 'mutant', '~> 0.3.4'
-  end
-
-  platforms :ruby_19, :ruby_20 do
-    gem 'yard-spellcheck', '~> 0.1.5'
-  end
-
-  platform :rbx do
-    gem 'json',               '~> 1.8.1'
-    gem 'racc',               '~> 1.4.10'
-    gem 'rubysl-logger',      '~> 2.0.0'
-    gem 'rubysl-open-uri',    '~> 2.0.0'
-    gem 'rubysl-prettyprint', '~> 2.0.2'
-  end
-end
-
-group :benchmarks do
-  gem 'rbench', '~> 0.2.3'
-end
-
-platform :jruby do
-  group :jruby do
-    gem 'jruby-openssl', '~> 0.8.5'
-  end
-end

data/lib/anima/builder.rb

@@ -1,130 +0,0 @@
-# encoding: utf-8
-
-class Anima
-
-  # Builds an anima infected class
-  class Builder
-
-    # Static instance methods for anima infected classes
-    module Methods
-      # Initialize an anima infected object
-      #
-      # @param [#to_h] attributes
-      #   a hash that matches anima defined attributes
-      #
-      # @return [undefined]
-      #
-      # @api public
-      def initialize(attributes)
-        self.class.anima.initialize_instance(self, attributes)
-      end
-
-      # Return a hash representation of an anima infected object
-      #
-      # @return [Hash]
-      #
-      # @api public
-      def to_h
-        self.class.anima.attributes_hash(self)
-      end
-    end # Methods
-
-    include Adamantium::Flat
-
-    # Infect +descendant+ with anima
-    #
-    # @param [Anima] anima
-    #   the anima instance used for infection
-    #
-    # @param [Class, Module] descendant
-    #   the object to infect
-    #
-    # @return [undefined]
-    #
-    # @api private
-    def self.call(anima, descendant)
-      new(anima, descendant).call
-    end
-
-    # Initialize a new instance
-    #
-    # @param [Anima] anima
-    #   the anima instance used for infection
-    #
-    # @param [Class, Module] descendant
-    #   the object to infect
-    #
-    # @return [undefined]
-    #
-    # @api private
-    def initialize(anima, descendant)
-      @anima      = anima
-      @names      = anima.attribute_names
-      @descendant = descendant
-    end
-
-    # Infect the instance with anima
-    #
-    # @return [undefined]
-    #
-    # @api private
-    def call
-      define_equalizer
-      define_anima_method
-      define_attribute_readers
-      descendant_exec do
-        include Methods
-      end
-    end
-
-    private
-
-    # Define equalizer
-    #
-    # @return [undefined]
-    #
-    # @api private
-    def define_equalizer
-      descendant_exec(@names) do |names|
-        include Equalizer.new(*names)
-      end
-    end
-
-    # Define anima method
-    #
-    # @return [undefined]
-    #
-    # @api private
-    def define_anima_method
-      descendant_exec(@anima) do |anima|
-        define_singleton_method(:anima) { anima }
-      end
-    end
-
-    # Define attribute readers
-    #
-    # @return [undefined]
-    #
-    # @api private
-    def define_attribute_readers
-      descendant_exec(@names) do |names|
-        attr_reader(*names)
-      end
-    end
-
-    # Deduplicate instance_exec inside descendant's scope
-    #
-    # @param [*] *args
-    #   arguments to pass to instance_exec
-    #
-    # @param [Proc] &block
-    #   the block to eval
-    #
-    # @return [undefined]
-    #
-    # @api private
-    def descendant_exec(*args, &block)
-      @descendant.instance_exec(*args, &block)
-    end
-  end # Builder
-end # Anima

data/lib/anima/update.rb

@@ -1,30 +0,0 @@
-# encoding: utf-8
-
-class Anima
-  # Module for mixin in update functionallity to anima infected clases
-  module Update
-
-    # Return updated instance
-    #
-    # @example
-    #   klass = Class.new do
-    #     include Anima.new(:foo, :bar), Anima::Update
-    #   end
-    #
-    #   foo = klass.new(:foo => 1, :bar => 2)
-    #   updated = foo.update(:foo => 3)
-    #   updated.foo # => 3
-    #   updated.bar # => 2
-    #
-    # @param [Hash] attributes
-    #
-    # @return [Anima]
-    #
-    # @api private
-    #
-    def update(attributes)
-      self.class.new(to_h.update(attributes))
-    end
-
-  end # Update
-end # Anima

data/spec/unit/anima/update_spec.rb

@@ -1,27 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe Anima::Update, '#update' do
-  subject { object.update(attributes) }
-
-  let(:object) { class_under_test.new(foo: 1, bar: 2) }
-
-  let(:class_under_test) do
-    Class.new do
-      include Anima.new(:foo, :bar), Anima::Update
-    end
-  end
-
-  context 'with empty attributes' do
-    let(:attributes) { {} }
-
-    it { should eql(object) }
-  end
-
-  context 'with updated attribute' do
-    let(:attributes) { { foo: 3 } }
-
-    it { should eql(class_under_test.new(foo: 3, bar: 2)) }
-  end
-end