statefully 0.1.7 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ab676bd0fdc9e9d6b17d8c606aa381e9aeab8cac
-  data.tar.gz: 11c77ad8e395dac8b413606ce8e7698b4482c27b
+SHA256:
+  metadata.gz: 133314844a98c7934bd388ac9a25bf4c5b6f8532e56936c3881bf964c10a96b1
+  data.tar.gz: c2b9d739224fe5bc7af794c08d5afce6d6b95e6bea30c7284549fb2a66eb0432
 SHA512:
-  metadata.gz: a6dcbb610b68d77357d1f4a015cadb5c33430b763ea244bacc6bf2d9748356bb7576ec5154b6c3c4840248bac1df85b1f45134ad11c1e99c011510fd8cd2e024
-  data.tar.gz: '0543961fa3864e71e1c647c8f1d1176ee1ad6bdfd420dd8a2336358f8f2e65b3c5a4c6458815a85c64c10f82aa4c14919a5a5b5de4d4d456bfa0d847eec9cc92'
+  metadata.gz: 74e86d22ffffc5a45407c957067810e7c496b5a1b57d524eefb2f51c15bd6dab2c7b0d6524b90e52df5f476a9f4a5c0e872f39b5b6148306848ffe677415db07
+  data.tar.gz: d7a7dc1ae4899eba2caa6328ca78acabafda24d7f149134089905ea68204c65537d8692dc0de2319d524cdd8f95b57841206ed8dc177cc363972c6c35cbb00a6

data/lib/statefully/state.rb

@@ -61,7 +61,7 @@ module Statefully
     #
     # @param values [Hash<Symbol, Object>] keyword arguments
     #
-    # @return [type] [description]
+    # @return [State::Success] new successful State
     # @api public
     # @example
     #   Statefully::State.create(key: 'val')
@@ -71,6 +71,17 @@ module Statefully
       Success.send(:new, base.merge(values), previous: None.instance).freeze
     end
 
+    # Return all States that came before
+    #
+    # @return [Array<State>]
+    # @api public
+    # @example
+    #   state = Statefully::State.create
+    #   => [#<Statefully::State::None>]
+    def ancestry
+      [previous] + previous.ancestry
+    end
+
     # Return a {Diff} between current and previous {State}
     #
     # @return [Diff]
@@ -290,6 +301,17 @@ module Statefully
     class None < State
       include Singleton
 
+      # Base case - {None} state does not have any ancestry
+      #
+      # @return [Array<State>]
+      # @api public
+      # @example
+      #   Statefully::State::None.instance.ancestry
+      #   => []
+      def ancestry
+        []
+      end
+
       # Return all historical changes to this {State}
       #
       # @return [Array<Diff>]

data/lib/statefully/version.rb

@@ -1,3 +1,3 @@
 module Statefully
-  VERSION = '0.1.7'.freeze
+  VERSION = '0.1.8'.freeze
 end

data/spec/state_spec.rb

@@ -62,7 +62,15 @@ module Statefully
       it { expect(state).not_to be_finished }
     end
 
-    describe 'history' do
+    describe '#ancestry' do
+      let(:ancestry) { state.succeed.ancestry }
+
+      it { expect(ancestry.count).to eq 2 }
+      it { expect(ancestry.first).to eq state }
+      it { expect(ancestry.last).to be_none }
+    end
+
+    describe '#history' do
       let(:history) { state.history }
 
       it { expect(history.length).to eq 1 }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statefully
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - Marcin Wyszynski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-22 00:00:00.000000000 Z
+date: 2018-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -264,7 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 2.7.4
 signing_key: 
 specification_version: 4
 summary: Immutable state with helpers to build awesome things