compo 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 914e22d4c5fb780ddfb95a6b71ecabf0046200b1
-  data.tar.gz: 91fa7096c61860f8aa06b7d773a3c8a490ac1cb6
+  metadata.gz: 27f469c00cf86d294398a92e891752c829380282
+  data.tar.gz: f3e4f7776ea089dcd80d77a0827f4c77cca6c728
 SHA512:
-  metadata.gz: b6477ff141c788b2889b06c7674bb0ffcb157880f739e7ab0532a866e917fe4df56c19dffb8794b69caaffb1f011ff463326435460334a95c58813cdea3d2c4c
-  data.tar.gz: 42527748f975f4e21bfbf8ca7b3b8cc46cda5304eaf586bd5ea37961c0ff9d998cec64641c8f3e82611248626796fdb1b7a352afb95e2037b459b04e7599e263
+  metadata.gz: c0f0d6d791a42006eeb243311980e21c04338b68ccb4157c54303db2f77b6d08d962a6bdc709385188b52be2fed5b20125c003515294d5e9f1d06fd06f6bca67
+  data.tar.gz: 35962706d2103ccad4c75fa5c4ed6131daa0bc2a9eef3361a056b7edaa692620e6975bb03999744d539fbff272c72ac5a87307ab0e24f9509e4fc7bb4296d5e5

data/CHANGELOG

@@ -1,3 +1,6 @@
+0.1.2 (2013-12-27)
+  - Implement and specify #get_child.
+
 0.1.1 (2013-12-27)
   - Avoid a function name clash between #remove_parent on a child and
     #remove_parent on a parent.  The latter is now #remove_parent_of.

data/lib/compo/composite.rb

@@ -69,6 +69,23 @@ module Compo
       remove_id!(id).tap(&method(:remove_parent_of))
     end
 
+    # Gets the child in this Composite with the given ID
+    #
+    # @api  public
+    # @example  Gets the child with ID :in, if children is {in: 3}.
+    #   composite.get_child(:in)
+    #   #=> 3
+    # @example  Fails to get the child with ID :out, if children is {in: 3}.
+    #   composite.get_child(:out)
+    #   #=> nil
+    #
+    # @param id  [Object]  The ID of the child to get from this Composite.
+    #
+    # @return [Object]  The child if successful; nil otherwise.
+    def get_child(id)
+      children[id]
+    end
+
     def_delegator :children, :each
 
     protected

data/lib/compo/version.rb

@@ -1,4 +1,4 @@
 # The current gem version.  See CHANGELOG for information.
 module Compo
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

data/spec/composite_spec.rb

@@ -246,4 +246,24 @@ describe MockComposite do
       subject.each
     end
   end
+
+  describe '#get_child' do
+    before(:each) { allow(subject).to receive(:children).and_return(children) }
+    let(:children) { { in_children: child } }
+
+    it 'calls #children' do
+      expect(subject).to receive(:children).once
+      subject.get_child(:in_children)
+    end
+
+    context 'when the argument is in #children' do
+      it 'returns the child' do
+        expect(subject.get_child(:in_children)).to eq(child)
+      end
+    end
+
+    context 'when the argument is in #children' do
+      specify { expect(subject.get_child(:not_in_children)).to be_nil }
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: compo
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Matt Windsor