immutable-struct 2.1.2 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5c5b40b44baa7449ead521ed6adcc3d29f2d631c
-  data.tar.gz: afbd6ff4c6959e8cc1cde9432e53e606484ff4cb
+  metadata.gz: 8e33fc2fff0d454a888f54e3897851bd398b177a
+  data.tar.gz: ee9e7a6649f6165a9996b387b23aa16a6d76232a
 SHA512:
-  metadata.gz: 95da502d7c1f22a08bf24ec16a4c543350ef51d2124e88d865df9c7c61ec746fee65bd068dde00ba02a5822f2aa928b0c50e7d90f51229bd669323d5cba74518
-  data.tar.gz: 26aa7ba089b984a87362b6b1404763f6a453dc07f6ffcb61ce7cff40e689d62a6cfdb60691b77b525e052fa834b54799008a37b979634faeefc88f6f03b37c17
+  metadata.gz: 078b7691d7d08ae2bf66671243dba88f9db0f8c36ae97578cf7cd30a28857ccc937ddafbd2cc8754f418c30027291f7a2be34dd4e8481bf53a19f3d364c7d880
+  data.tar.gz: 2729cf68d9fcd5ab0597e5596b504cf23069bed3b98b4db2927a1b64b4b306570c78d1bce726a31e03bab2540338c442a80a73d3384afe5969af77cc813e45f5

data/.travis.yml

@@ -1,4 +1,6 @@
 language: ruby
+before_install:
+  - gem install bundler
 rvm:
   - 1.9.3
   - 2.0.0

data/CONTRIBUTING.md

@@ -1,5 +1,5 @@
 # Contributing
-Thanks for using and improving *ImmutableStruct*! If you'd like to help out, check out [the project's issues list][issues] for ideas on what could be improved.  If there's an idea you'd like to propose, or a design change, feel free to file a new issue or send a pull request:
+Thanks for using and improving *ImmutableStruct*! If you'd like to help out, check out [the project's issues list](https://github.com/stitchfix/immutable-struct/issues) for ideas on what could be improved.  If there's an idea you'd like to propose, or a design change, feel free to file a new issue or send a pull request:
 
 1. [Fork][fork] the repo.
 1. [Create a topic branch.][branch]

data/README.rdoc

@@ -52,8 +52,14 @@ If not using bundler, just use RubyGems:
 
     p == sp     # => false         # Different class leads to inequality
 
+    new_person = p.merge(name: "Other Dave", age: 41) # returns a new object with merged attributes
+    new_person.name    # => "Other Dave"
+    new_person.age     # => 41
+    new_person.active? # => true
+    
 You can also treat the interior as a normal class definition.  
 
+
 == Links
 
 * rdoc[http://stitchfix.github.io/immutable-struct]

data/lib/immutable-struct.rb

@@ -6,7 +6,7 @@
 # will be evaluated as if it were inside a class definition, allowing you
 # to add methods, include or extend modules, or do whatever else you want.
 class ImmutableStruct
-  VERSION='2.1.2' #:nodoc:
+  VERSION='2.2.0' #:nodoc:
   # Create a new class with the given read-only attributes.
   #
   # attributes:: list of symbols or strings that can be used to create attributes.
@@ -36,6 +36,11 @@ class ImmutableStruct
   #     p.minor    # => "yup"
   #     p.minor?   # => true
   #
+  #     new_person = p.merge(name: "Other Dave", age: 41) # returns a new object with merged attributes
+  #     new_person.name    # => "Other Dave"
+  #     new_person.age     # => 41
+  #     new_person.active? # => true
+  #
   def self.new(*attributes,&block)
     klass = Class.new do
       attributes.each do |attribute|
@@ -70,6 +75,11 @@ class ImmutableStruct
         attributes.all? { |attribute| self.send(attribute) == other.send(attribute) }
       end
 
+      define_method(:merge) do |new_attrs|
+        attrs = to_h
+        klass.new(attrs.merge(new_attrs))
+      end
+
       alias_method :eql?, :==
     end
     klass.class_exec(&block) unless block.nil?
@@ -77,7 +87,7 @@ class ImmutableStruct
     klass.class_exec(imethods) do |imethods|
       define_method(:to_h) do
         imethods.inject({}) do |hash, method|
-          next hash if [:==, :eql?].include?(method)
+          next hash if [:==, :eql?, :merge].include?(method)
           hash.merge(method.to_sym => self.send(method))
         end
       end

data/spec/immutable_struct_spec.rb

@@ -114,6 +114,24 @@ describe ImmutableStruct do
     end
   end
 
+  describe "merge" do
+    it "returns a new object as a result of merging attributes" do
+      klass = ImmutableStruct.new(:food, :snacks, :butter)
+      instance = klass.new(food: 'hot dogs', butter: true)
+      new_instance = instance.merge(snacks: 'candy hot dogs', butter: false)
+
+      instance.food.should == 'hot dogs'
+      instance.butter.should == true
+      instance.snacks.should == nil
+
+      new_instance.food.should == 'hot dogs'
+      new_instance.snacks.should == 'candy hot dogs'
+      new_instance.butter.should == false
+
+      new_instance.object_id.should_not == instance.object_id
+    end
+  end
+
   describe "equality" do
 
     before do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: immutable-struct
 version: !ruby/object:Gem::Version
-  version: 2.1.2
+  version: 2.2.0
 platform: ruby
 authors:
 - Stitch Fix Engineering
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-21 00:00:00.000000000 Z
+date: 2016-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler