flow 0.10.1 → 0.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bb7054475f94b6d73503adf9168e31222098af20a36c048cdf72b68b3e0a7a5
-  data.tar.gz: 3a6feb462916f4d24dd180d88e63527ad1e18a4d99e8cbb5ecae664d919e744a
+  metadata.gz: fb00b50b5c0c19093beaf572f6e050e578b58fd83d5641f1b1dac553cb5096c5
+  data.tar.gz: 17ceb71b234ee7aebf897ff08ed11c2db68a1c63a9338322a9619f896c53e705
 SHA512:
-  metadata.gz: 467c98e3ab094d2af99c8c27b72cd493c4efb70bec3980c8dbe6c37d3f6101b829ded1fd80445adf4cbd83195d6143c97c4be3ddf1d1f9c87a19ab875aea07da
-  data.tar.gz: 2bcb846816f4f3ad8599dd14970e7ffe6e5d8d0bae9b171ca6b763a6940be1105331bab14e9391c2e2d2dd5b2468cb15d15a1797351259f06af57fc09e3fa133
+  metadata.gz: 57537f1e3d84c95cc6018dafa17db38c71bc2b0ef606f25e67c9e875a9ca6196f604240e693cf808a227862266d6c5fc3b19c0edcfe8b29c3ae793ddbd8b37a0
+  data.tar.gz: 93386f65a3b4fc066c2d9d82b68be1f103290aaa63a7c0b356f0d8d9f5a6290aa80aaa8706da42450c3aff1f9904d56c280b11e0d00dc6b7f1c73a18ab2519dd

data/README.md

@@ -124,7 +124,7 @@ Ex: `FooBarBazFlow` assumes there is a defined `FooBarBazState`.
 If you want to customize this behavior, define the state class explicitly:
 
 ```ruby
-class ExampleFlow < ApplicationState
+class ExampleFlow < ApplicationFlow
   def self.state_class
     MyCoolState
   end
@@ -1062,7 +1062,7 @@ The easiest and best way to test an Operation is with a unit test.
 
 Operation unit tests work best when you treat them like integration tests! (Read: **No Mocking!**)
 
-Operations are generated with the following RSPec template:
+Operations are generated with the following RSpec template:
 
 ```ruby
 # frozen_string_literal: true
@@ -1076,8 +1076,7 @@ RSpec.describe MakeTheThingDoTheStuff, type: :operation do
   let(:example_state_class) do
     Class.new(ApplicationState) do
       # argument :foo
-      # option :bar
-      # attribute :baz 
+
       # output :gaz 
     end
   end
@@ -1103,8 +1102,7 @@ In the boilerplate from the generator, there is the following snippet:
 let(:example_state_class) do
   Class.new(ApplicationState) do
     # argument :foo
-    # option :bar
-    # attribute :baz
+
     # output :gaz
   end
 end
@@ -1122,21 +1120,23 @@ You are heavily encouraged *not* to do that. If your Operation is used by severa
 
 Instead, use the spec as a way to communicate the contract of the Operation with the next developer. By boiling out a very clean example state that only includes what is necessary for the operation, you provide clear guidance on what the Operation's minimum requirements for a state are in a very transparent way.
 
+However, the emphasis is on _minimum_ requirements. `Option`s and `attribute`s are therefore discouraged in example states for operation specs, as well are contexts for when optional input is not provided. An operation designed for use with a State using optional inputs will _always_ require those methods to be available on its state class, so example states should always use arguments to define input.
+
 ```ruby
 let(:example_state_class) do
   Class.new(ApplicationState) do
     argument :foo
-    option :bar
-    attribute :baz
+    argument :bar
+
     output :gaz
   end
   
   let(:state_input) do
-    { foo: foo, bar: bar }
+    { foo: foo }
   end
   
   let(:foo) { ... }
-  let(:bar) { ... }
+  let(:bar) { nil }
 end
 ```
 
@@ -1183,7 +1183,11 @@ RSpec.describe FooState, type: :state do
   # it { is_expected.to define_argument :necessary_input, allow_nil: false }
   # it { is_expected.to define_option(:optional_input) }
   # it { is_expected.to define_option(:option_with_default, default: :default_static_value) }
+
+  # let(:default_block_value) { SecureRandom.uuid }
+  # before { allow(SecureRandom).to receive(:uuid).and_return(default_block_value) }
   # it { is_expected.to define_option(:option_with_default_from_block, default: default_block_value) }
+
   # it { is_expected.to validate_presence_of ... }
   # it { is_expected.to define_output :foo }
   # it { is_expected.to define_output :foo, default: :bar }

data/lib/flow/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Flow
-  VERSION = "0.10.1"
+  VERSION = "0.10.2"
 end

data/lib/generators/rspec/operation/templates/operation_spec.rb.erb

@@ -9,8 +9,7 @@ RSpec.describe <%= class_name %>, type: :operation do
   let(:example_state_class) do
     Class.new(ApplicationState) do
       # argument :foo
-      # option :bar
-      # attribute :baz
+
       # output :gaz
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flow
 version: !ruby/object:Gem::Version
-  version: 0.10.1
+  version: 0.10.2
 platform: ruby
 authors:
 - Eric Garside
@@ -12,48 +12,48 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-06-14 00:00:00.000000000 Z
+date: 2019-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.2.1
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.2.1
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.2.1
 - !ruby/object:Gem::Dependency
@@ -166,14 +166,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.6
+        version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.6
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rspice
   requirement: !ruby/object:Gem::Requirement
@@ -334,8 +334,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Write modular and reusable business logic that's understandable and maintainable.