nxt_state_machine 0.1.10 → 0.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c131c9fdbce2f5a605ecdfa39a63e0ea7ef21dda4a2f9600e790e56e0c4444a0
-  data.tar.gz: 49689f892d2262705c0248c05d7b0d6612b31255fb3da130494cbe200f105d83
+  metadata.gz: bc37e9d88ae62233544b548a5085fe81f67be0957f498ebf0490a191ac37af8d
+  data.tar.gz: b999a6f14950de8f1bcca65082ff6c7ff9d7e61d29aeb0323e65d126502a5cdc
 SHA512:
-  metadata.gz: e176a5b1205cbfb3d901f5c7c768971b64eea974f613d4a298430f81473c13dc3852f6e4eb021d4fd1eb98cba2fd8b9d69a4671a64b0c9a5e1f2e46cc20c7580
-  data.tar.gz: 9dff03854918e23c0c0dc9ae00c55116a4244a314f0799ce2e3c81841d257e9406cff25eb68833c6c32a99e8d4c562ff1609d22fb307c63f44a12165f47a2997
+  metadata.gz: bd80fa569f48c50ab81bc1380e1683d4d646a128ed5bae016d46a4c8263411f0de0bdf39934a480fdf55d0849fc516201444f2e2eecdf75ee903f45df5373661
+  data.tar.gz: af346178ff3e9321a4592862babffe717aceeabde96aa625768bd163070c99bad477514a9b2d4aa3b16553ebf3886039beed0748fee67a60c7cc4f96ed66b1dd

data/.circleci/config.yml

@@ -1,15 +1,13 @@
-# Ruby CircleCI 2.0 configuration file
-#
-# Check https://circleci.com/docs/2.0/language-ruby/ for more details
-#
-version: 2
+version: 2.1
+
+orbs:
+  ruby: circleci/ruby@2.0.1
+  coveralls: coveralls/coveralls@1.0.6
+
 jobs:
   build:
     docker:
-      # specify the version you desire here
-      - image: circleci/ruby:2.6.5-node
-    environment:
-      BUNDLER_VERSION: 2.0.2
+      - image: 'cimg/ruby:3.2.2-node'
 
     working_directory: ~/repo
 
@@ -17,46 +15,12 @@ jobs:
       - checkout
 
       - run:
-          name: Install apt dependencies
+          name: Install apt dependencies (graphviz)
           command: |
             sudo apt update -q \
             && sudo apt upgrade -q \
             && sudo apt install -qq graphviz
-      # Download and cache dependencies
-      - restore_cache:
-          keys:
-            - v1-dependencies-{{ checksum "Gemfile.lock" }}
-
-      - run: gem install bundler --version $BUNDLER_VERSION
-
-      - run:
-          name: install dependencies
-          command: |
-            bundle install --jobs=4 --retry=3 --path vendor/bundle
-
-      - save_cache:
-          paths:
-            - ./vendor/bundle
-          key: v1-dependencies-{{ checksum "Gemfile.lock" }}
-
-      # run tests!
-      - run:
-          name: run tests
-          command: |
-            mkdir /tmp/test-results
-            TEST_FILES="$(circleci tests glob "spec/**/*_spec.rb" | \
-              circleci tests split --split-by=timings)"
-
-            bundle exec rspec \
-              --format progress \
-              --format RspecJunitFormatter \
-              --out /tmp/test-results/rspec.xml \
-              --format progress \
-              $TEST_FILES
-
-      # collect reports
-      - store_test_results:
-          path: /tmp/test-results
-      - store_artifacts:
-          path: /tmp/test-results
-          destination: test-results
+      - ruby/install-deps:
+          key: gems-v2
+          include-branch-in-cache-key: false
+      - ruby/rspec-test

data/.ruby-version

@@ -1 +1 @@
-2.7.3
+3.2.2

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+# v0.1.11 2023-06-29
+
+### Added
+- Added `state_machine.event_methods`
+
+[Compare v0.1.10...v0.1.11](https://github.com/nxt-insurance/nxt_state_machine/compare/v0.1.10...v0.1.11)
+
 # v0.1.10 2021-07-19
 
 ### Added

data/Gemfile.lock

@@ -1,59 +1,59 @@
 PATH
   remote: .
   specs:
-    nxt_state_machine (0.1.10)
+    nxt_state_machine (0.1.11)
       activesupport
       nxt_registry (~> 0.3.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (6.1.3.2)
-      activesupport (= 6.1.3.2)
-    activerecord (6.1.3.2)
-      activemodel (= 6.1.3.2)
-      activesupport (= 6.1.3.2)
-    activesupport (6.1.3.2)
+    activemodel (7.0.5.1)
+      activesupport (= 7.0.5.1)
+    activerecord (7.0.5.1)
+      activemodel (= 7.0.5.1)
+      activesupport (= 7.0.5.1)
+    activesupport (7.0.5.1)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
       tzinfo (~> 2.0)
-      zeitwerk (~> 2.3)
     coderay (1.1.3)
-    concurrent-ruby (1.1.9)
-    diff-lcs (1.4.4)
-    i18n (1.8.10)
+    concurrent-ruby (1.2.2)
+    diff-lcs (1.5.0)
+    i18n (1.14.1)
       concurrent-ruby (~> 1.0)
     method_source (1.0.0)
-    minitest (5.14.4)
+    mini_portile2 (2.8.2)
+    minitest (5.18.1)
     nxt_registry (0.3.10)
       activesupport
-    pry (0.14.1)
+    pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
     rake (12.3.3)
     rexml (3.2.5)
-    rspec (3.10.0)
-      rspec-core (~> 3.10.0)
-      rspec-expectations (~> 3.10.0)
-      rspec-mocks (~> 3.10.0)
-    rspec-core (3.10.0)
-      rspec-support (~> 3.10.0)
-    rspec-expectations (3.10.0)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-mocks (3.10.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.5)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-support (3.10.0)
-    rspec_junit_formatter (0.4.1)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.1)
+    rspec_junit_formatter (0.6.0)
       rspec-core (>= 2, < 4, != 2.12.0)
     ruby-graphviz (1.2.5)
       rexml
-    sqlite3 (1.4.2)
-    tzinfo (2.0.4)
+    sqlite3 (1.6.3)
+      mini_portile2 (~> 2.8.0)
+    tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby

data/README.md

@@ -181,7 +181,14 @@ class Article < ApplicationRecord
 end
 ```
 
-You can also navigate between states 
+You can retrieve a list of states using the `states` method:
+
+```rb
+states = Article.state_machine.states # returns a NxtStateMachine::StateRegistry instance
+states.keys # ["draft", "written", "submitted", "approved", "published", "rejected", "deleted"]
+```
+
+You can also navigate between states:
 
 ```ruby
 state.next # will give you the next state in the order they have been registered
@@ -192,6 +199,7 @@ state.index # gives you the index of the state in the registry
 # You can also set indexes manually by passing in indexes when defining states. Make sure they are in order! 
 ```
 
+
 ### Events
 
 Once you have defined your states you can define events and their transitions. Events trigger state transitions based
@@ -241,15 +249,27 @@ article.approve(approved_at: Time.current)
 article.approve!(approved_at: Time.current)
 ```
 
-**NOTE:** Transitions run in transactions that acquire a lock to prevent concurrency issues per default. 
-Transactions will be rolled back in case of an exception or if your target cannot be saved due to validation errors. 
+> **Note**:
+> 
+> By default, transitions run in transactions that acquire a lock to prevent concurrency issues. 
+Transactions will be rolled back if an exception occurs or if your target cannot be saved due to validation errors. 
 The state is set back to the state before the transition! If you try to transition on records with unpersisted changes
 you will get a `RuntimeError: Locking a record with unpersisted changes is not supported.` error saying something
 like `Use :save to persist the changes, or :reload to discard them explicitly.` since it's not possible to acquire a 
-lock on modified records. You can also switch of locking and transactions for events by passing in the `lock_transitions: false` 
+lock on modified records. 
+> 
+> You can switch off locking and transactions for events by passing in the `lock_transitions: false` 
 option when defining an event or globally on the state machine with the `lock_transitions: false` option. Currently 
 there is no option to toggle locking at runtime.   
 
+
+You can retrieve a list of event methods with `event_methods`:
+
+```rb
+Article.state_machine.event_methods 
+# => [:write, :submit, :approve, :publish, :reject, :delete, :write!, :submit!, :approve!, :publish!, :reject!, :delete!]
+```
+
 ### Transitions
 
 When your transition takes arguments other than keyword arguments, it will always be passed the transition object itself

data/lib/nxt_state_machine/state_machine.rb

@@ -75,6 +75,13 @@ module NxtStateMachine
       states.values.map(&:enum)
     end
 
+    def event_methods
+      event_names = events.keys
+      event_names_with_bang = event_names.map { |e| e + '!' }
+
+      (event_names + event_names_with_bang).map(&:to_sym)
+    end
+
     alias_method :all_states, :any_state
 
     def all_states_except(*excluded)

data/lib/nxt_state_machine/version.rb

@@ -1,3 +1,3 @@
 module NxtStateMachine
-  VERSION = '0.1.10'
+  VERSION = '0.1.11'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nxt_state_machine
 version: !ruby/object:Gem::Version
-  version: 0.1.10
+  version: 0.1.11
 platform: ruby
 authors:
 - Andreas Robecke
@@ -11,7 +11,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-07-19 00:00:00.000000000 Z
+date: 2023-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -152,7 +152,6 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".ruby-version"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
@@ -220,7 +219,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: A rich but straight forward state machine library

data/.travis.yml

@@ -1,7 +0,0 @@
----
-sudo: false
-language: ruby
-cache: bundler
-rvm:
-  - 2.6.1
-before_install: gem install bundler -v 2.0.2