nxt_state_machine 0.1.10 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c131c9fdbce2f5a605ecdfa39a63e0ea7ef21dda4a2f9600e790e56e0c4444a0
-  data.tar.gz: 49689f892d2262705c0248c05d7b0d6612b31255fb3da130494cbe200f105d83
+  metadata.gz: 413f20677e821a50eaa46266005d902f1e9e32590e1456e49847e92a257857c0
+  data.tar.gz: c4e1069379acacf327ab01922de03fdd3e16090d73a29e6c31486a78d4d22e26
 SHA512:
-  metadata.gz: e176a5b1205cbfb3d901f5c7c768971b64eea974f613d4a298430f81473c13dc3852f6e4eb021d4fd1eb98cba2fd8b9d69a4671a64b0c9a5e1f2e46cc20c7580
-  data.tar.gz: 9dff03854918e23c0c0dc9ae00c55116a4244a314f0799ce2e3c81841d257e9406cff25eb68833c6c32a99e8d4c562ff1609d22fb307c63f44a12165f47a2997
+  metadata.gz: 06da24e5f64c4a5575ffdf1a5ffc5761554758750b5e2d6c6a2012df7df7950376a6c66e46b82476848529f6bd893b26c4e108a0e1fe0585f0f813ab3f128843
+  data.tar.gz: 02c7131e6230181cdfcbb2ada9f8e995674ba4472ebe19482ed0f09a8185094446e7b3ac43ebf3840a35156077038404a632bd84846dcdf82729b73033d9b950

data/.circleci/config.yml

@@ -1,15 +1,12 @@
-# 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
+
 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.3.4-node'
 
     working_directory: ~/repo
 
@@ -17,46 +14,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/.gitignore

@@ -1,7 +1,6 @@
 /.bundle/
 /.yardoc
 /_yardoc/
-/coverage/
 /doc/
 /pkg/
 /spec/reports/

data/.ruby-version

@@ -1 +1 @@
-2.7.3
+3.3.4

data/CHANGELOG.md

@@ -1,3 +1,18 @@
+# v0.1.12 2024-07-31
+
+### Changed
+- Remove Coveralls remainings
+- Upgrade dependencies
+
+[Compare v0.1.11...v0.1.12](https://github.com/nxt-insurance/nxt_state_machine/compare/v0.1.11...v0.1.12)
+
+# 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,71 @@
 PATH
   remote: .
   specs:
-    nxt_state_machine (0.1.10)
+    nxt_state_machine (0.1.12)
       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.1.3.4)
+      activesupport (= 7.1.3.4)
+    activerecord (7.1.3.4)
+      activemodel (= 7.1.3.4)
+      activesupport (= 7.1.3.4)
+      timeout (>= 0.4.0)
+    activesupport (7.1.3.4)
+      base64
+      bigdecimal
       concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
+      mutex_m
       tzinfo (~> 2.0)
-      zeitwerk (~> 2.3)
+    base64 (0.2.0)
+    bigdecimal (3.1.8)
     coderay (1.1.3)
-    concurrent-ruby (1.1.9)
-    diff-lcs (1.4.4)
-    i18n (1.8.10)
+    concurrent-ruby (1.3.3)
+    connection_pool (2.4.1)
+    diff-lcs (1.5.1)
+    drb (2.2.1)
+    i18n (1.14.5)
       concurrent-ruby (~> 1.0)
-    method_source (1.0.0)
-    minitest (5.14.4)
+    method_source (1.1.0)
+    minitest (5.24.1)
+    mutex_m (0.2.0)
     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)
+    rake (13.2.1)
+    rexml (3.3.2)
+      strscan
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-mocks (3.10.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.1)
       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.13.0)
+    rspec-support (3.13.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.4.4)
+    strscan (3.1.0)
+    timeout (0.4.1)
+    tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby
@@ -63,11 +75,11 @@ DEPENDENCIES
   bundler (~> 2.0)
   nxt_state_machine!
   pry
-  rake (~> 12.0)
+  rake (~> 13.2)
   rspec (~> 3.0)
   rspec_junit_formatter
   ruby-graphviz
-  sqlite3
+  sqlite3 (~> 1.4.4)
 
 BUNDLED WITH
-   2.1.4
+   2.5.15

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.12'
 end

data/nxt_state_machine.gemspec

@@ -38,10 +38,10 @@ Gem::Specification.new do |spec|
   spec.add_dependency "nxt_registry", "~> 0.3.0"
 
   spec.add_development_dependency "bundler", "~> 2.0"
-  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rake", "~> 13.2"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "pry"
   spec.add_development_dependency "activerecord"
-  spec.add_development_dependency "sqlite3"
+  spec.add_development_dependency "sqlite3", "~> 1.4.4"
   spec.add_development_dependency "ruby-graphviz"
 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.12
 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: 2024-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -61,14 +61,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.2'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -115,16 +115,16 @@ dependencies:
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.4.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.4.4
 - !ruby/object:Gem::Dependency
   name: ruby-graphviz
   requirement: !ruby/object:Gem::Requirement
@@ -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.5.11
 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