floe 0.11.2 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 302eabcce76893426ed95920bff11ed2bba9956a7d006249d86212e30c5cc67c
-  data.tar.gz: 4148b20da8ef81e6e45a4ec73489cdcf956115d1f99535019aef3b561ed45e00
+  metadata.gz: 2eb195983f47d7cac44f18e962bf314c3ff4fefbdf3ac5cae32e960bfc2c0fb0
+  data.tar.gz: 6a0f8d91337297786c03e99fc96cb118ed8cb76244e52cf8253702d1517a6f5d
 SHA512:
-  metadata.gz: 73a1a714b1d729af89dd9839655955f76c3ed69fa8814e230fc03746175d1ff243b8b58fd02dce272d683b39fe50cd88c1c3a7f05cd2e36e9aa070747f85ae6f
-  data.tar.gz: bf13a6c8f07a5918e78d99bb5a03c29b3a76e059c92cd6f3fec85dd64b1d701138a16a9c0e6df10ed820f4f97ef932152f1d0a61b38a60d3d344728da9ec33c7
+  metadata.gz: 99f5a3c8e67a9f5c97b43795739c201a49a8f1195d40a1da38f2aa0e16d200266783336e4be9ada5d41b566c545144a4533db258546ebbf04a23c454a489e6a1
+  data.tar.gz: a77bfe436b37adf9dbdc2a279b9b1f70f48980062aaaec191a8e1fd57238e8b8b50b02828025e561c7ccb8429cb67fefb3f7ed044ed309d82eaae8dd8d9d407b

data/.codeclimate.yml

@@ -0,0 +1,16 @@
+prepare:
+  fetch:
+  - url: https://raw.githubusercontent.com/ManageIQ/manageiq-style/master/.rubocop_base.yml
+    path: ".rubocop_base.yml"
+  - url: https://raw.githubusercontent.com/ManageIQ/manageiq-style/master/.rubocop_cc_base.yml
+    path: ".rubocop_cc_base.yml"
+  - url: https://raw.githubusercontent.com/ManageIQ/manageiq-style/master/styles/base.yml
+    path: styles/base.yml
+  - url: https://raw.githubusercontent.com/ManageIQ/manageiq-style/master/styles/cc_base.yml
+    path: styles/cc_base.yml
+plugins:
+  rubocop:
+    enabled: true
+    config: ".rubocop_cc.yml"
+    channel: rubocop-1-56-3
+version: '2'

data/.yamllint

@@ -1,8 +1,6 @@
----
 extends: relaxed
-
 rules:
   indentation:
     indent-sequences: false
   line-length:
-    max: 120
+    max: 1000

data/CHANGELOG.md

@@ -4,6 +4,54 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+## [0.12.0] - 2024-07-31
+### Added
+- Set Floe.logger.level if DEBUG env var set ([#234](https://github.com/ManageIQ/floe/pull/234))
+- Add InstrinsicFunction foundation + States.Array, States.UUID ([#194](https://github.com/ManageIQ/floe/pull/194))
+- Evaluate IntrinsicFunctions from PayloadTemplate ([#236](https://github.com/ManageIQ/floe/pull/236))
+- Add more intrinsic functions ([#242](https://github.com/ManageIQ/floe/pull/242))
+- Add State#cause_path, error_path ([#249](https://github.com/ManageIQ/floe/pull/249))
+- Validate Catcher Next ([#250](https://github.com/ManageIQ/floe/pull/250))
+- Add spec/supports ([#248](https://github.com/ManageIQ/floe/pull/248))
+
+### Fixed
+- Handle non-hash input/output values ([#214](https://github.com/ManageIQ/floe/pull/214))
+- Fix Input/Output handling for Pass, Choice, Succeed states ([#225](https://github.com/ManageIQ/floe/pull/225))
+- Wrap Parslet::ParseFailed errors as Floe::InvalidWorkflowError ([#235](https://github.com/ManageIQ/floe/pull/235))
+- Fix edge cases with States.Array ([#237](https://github.com/ManageIQ/floe/pull/237))
+- Fix sporadic test failure with Wait state ([#243](https://github.com/ManageIQ/floe/pull/243))
+- Fix invalid container names after normalizing ([#252](https://github.com/ManageIQ/floe/pull/252))
+
+### Changed
+- Extract ErrorMatcherMixin from Catch and Retry ([#186](https://github.com/ManageIQ/floe/pull/186))
+- Output should be JSON ([#230](https://github.com/ManageIQ/floe/pull/230))
+- Normalize functions to all take arguments ([#238](https://github.com/ManageIQ/floe/pull/238))
+- Pass full path name to State.new for better errors ([#229](https://github.com/ManageIQ/floe/pull/229))
+- Validate that state machine input is valid JSON ([#227](https://github.com/ManageIQ/floe/pull/227))
+- Move the Parslet parse into initialize so that invalid function definition will fail on workflow load ([#245](https://github.com/ManageIQ/floe/pull/245))
+
+## [0.11.3] - 2024-06-20
+### Fixed
+- ResultPath=$ replaces complete output ([#199](https://github.com/ManageIQ/floe/pull/199))
+- Fix retrier backoff values ([#200](https://github.com/ManageIQ/floe/pull/200))
+- Fix Retry issues ([#202](https://github.com/ManageIQ/floe/pull/202))
+- Add Apache-2.0 license ([#217](https://github.com/ManageIQ/floe/pull/217))
+
+### Changed
+- Update gemspec summary ([#205](https://github.com/ManageIQ/floe/pull/205))
+- Simpler State#long_name ([#204](https://github.com/ManageIQ/floe/pull/204))
+- State only modifies Context#state - prep for Map/Parallel ([#206](https://github.com/ManageIQ/floe/pull/206))
+- Set StateHistory in Workflow not State ([#211](https://github.com/ManageIQ/floe/pull/211))
+- Make Runner#wait optional ([#190](https://github.com/ManageIQ/floe/pull/190))
+- Pass credentials around with context ([#203](https://github.com/ManageIQ/floe/pull/203))
+- Pass context to State without workflow ([#216](https://github.com/ManageIQ/floe/pull/216))
+- Move the guts of the CLI into a class for easy testing ([#220](https://github.com/ManageIQ/floe/pull/220))
+
+### Added
+- Set State PreviousStateGuid in StateHistory ([#208](https://github.com/ManageIQ/floe/pull/208))
+- Add a codeclimate config file ([#224](https://github.com/ManageIQ/floe/pull/224))
+- Add an Execution unique ID to Context ([#226](https://github.com/ManageIQ/floe/pull/226))
+
 ## [0.11.2] - 2024-05-24
 ### Fixed
 - Output now based upon raw input not effective input ([#191](https://github.com/ManageIQ/floe/pull/191))
@@ -177,7 +225,9 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ### Added
 - Initial release
 
-[Unreleased]: https://github.com/ManageIQ/floe/compare/v0.11.2...HEAD
+[Unreleased]: https://github.com/ManageIQ/floe/compare/v0.12.0...HEAD
+[0.12.0]: https://github.com/ManageIQ/floe/compare/v0.11.3...v0.12.0
+[0.11.3]: https://github.com/ManageIQ/floe/compare/v0.11.2...v0.11.3
 [0.11.2]: https://github.com/ManageIQ/floe/compare/v0.11.1...v0.11.2
 [0.11.1]: https://github.com/ManageIQ/floe/compare/v0.11.0...v0.11.1
 [0.11.0]: https://github.com/ManageIQ/floe/compare/v0.10.0...v0.11.0

data/Gemfile

@@ -3,7 +3,7 @@
 source "https://rubygems.org"
 
 plugin "bundler-inject", "~> 2.0"
-require File.join(Bundler::Plugin.index.load_paths("bundler-inject")[0], "bundler-inject") rescue nil
+require File.join(Bundler::Plugin.index.load_paths("bundler-inject")[0], "bundler-inject") rescue nil # rubocop:disable Style/RescueModifier
 
 # Specify your gem's dependencies in floe.gemspec
 gemspec

data/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -148,7 +148,7 @@ until running_workflows.empty?
   ready_workflows = Floe::Workflow.wait(running_workflows)
   # Step through the ready workflows until they would block
   ready_workflows.each do |workflow|
-    loop while workflow.step_nonblock == 0
+    workflow.run_nonblock
   end
   # Remove any finished workflows from the list of running_workflows
   running_workflows.reject!(&:end?)
@@ -206,3 +206,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/ManageIQ/floe.
+
+## License
+
+The gem is available as open source under the terms of the [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0).

data/exe/floe

@@ -3,75 +3,6 @@
 
 $LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
 
-require "optimist"
-require "floe"
-require "floe/container_runner"
-
-opts = Optimist.options do
-  version("v#{Floe::VERSION}\n")
-  usage("[options] workflow input [workflow2 input2]")
-
-  opt :workflow, "Path to your workflow json file (alternative to passing a bare workflow)", :type => :string
-  opt :input, <<~EOMSG, :type => :string
-    JSON payload of the Input to the workflow
-      If --input is passed and --workflow is not passed, will be used for all bare workflows listed.
-      If --input is not passed and --workflow is passed, defaults to '{}'.
-  EOMSG
-  opt :context, "JSON payload of the Context",              :type => :string
-  opt :credentials, "JSON payload with Credentials",        :type => :string
-  opt :credentials_file, "Path to a file with Credentials", :type => :string
-
-  Floe::ContainerRunner.cli_options(self)
-
-  banner("")
-  banner("General options:")
-end
-
-# Create workflow/input pairs from the various combinations of paramaters
-args =
-  if opts[:workflow_given]
-    Optimist.die("cannot specify both --workflow and bare workflows") if ARGV.any?
-
-    [opts[:workflow], opts.fetch(:input, "{}")]
-  elsif opts[:input_given]
-    Optimist.die("workflow(s) must be specified") if ARGV.empty?
-
-    ARGV.flat_map { |w| [w, opts[:input].dup] }
-  else
-    Optimist.die("workflow/input pairs must be specified") if ARGV.empty? || (ARGV.size > 1 && ARGV.size.odd?)
-
-    ARGV
-  end
-
-Floe::ContainerRunner.resolve_cli_options!(opts)
-
-require "logger"
-Floe.logger = Logger.new($stdout)
-
-credentials =
-  if opts[:credentials_given]
-    opts[:credentials] == "-" ? $stdin.read : opts[:credentials]
-  elsif opts[:credentials_file_given]
-    File.read(opts[:credentials_file])
-  end
-
-workflows =
-  args.each_slice(2).map do |workflow, input|
-    context = Floe::Workflow::Context.new(opts[:context], :input => input)
-    Floe::Workflow.load(workflow, context, credentials)
-  end
-
-# run
-
-Floe::Workflow.wait(workflows, &:run_nonblock)
-
-# display status
-
-workflows.each do |workflow|
-  puts "", "#{workflow.name}#{" (#{workflow.status})" unless workflow.context.success?}", "===" if workflows.size > 1
-  puts workflow.output.inspect
-end
-
-# exit status
-
-exit workflows.all? { |workflow| workflow.context.success? } ? 0 : 1
+require "floe/cli"
+success = Floe::CLI.new.run(ARGV)
+exit(success ? 0 : 1)

data/floe.gemspec

@@ -7,9 +7,10 @@ Gem::Specification.new do |spec|
   spec.version = Floe::VERSION
   spec.authors = ["ManageIQ Developers"]
 
-  spec.summary = "Simple Workflow Runner."
-  spec.description = "Simple Workflow Runner."
+  spec.summary = "Floe is a runner for Amazon States Language workflows."
+  spec.description = spec.summary
   spec.homepage = "https://github.com/ManageIQ/floe"
+  spec.licenses = ["Apache-2.0"]
   spec.required_ruby_version = ">= 2.7.0"
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
@@ -35,11 +36,11 @@ Gem::Specification.new do |spec|
   spec.add_dependency "jsonpath", "~>1.1"
   spec.add_dependency "kubeclient", "~>4.7"
   spec.add_dependency "optimist", "~>3.0"
+  spec.add_dependency "parslet", "~>2.0"
 
-  spec.add_development_dependency "manageiq-style"
+  spec.add_development_dependency "manageiq-style", ">= 1.5.2"
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec"
-  spec.add_development_dependency "rubocop"
   spec.add_development_dependency "simplecov", ">= 0.21.2"
   spec.add_development_dependency "timecop"
 end

data/lib/floe/cli.rb

@@ -0,0 +1,86 @@
+module Floe
+  class CLI
+    def initialize
+      require "optimist"
+      require "floe"
+      require "floe/container_runner"
+      require "logger"
+
+      Floe.logger = Logger.new($stdout)
+      Floe.logger.level = 0 if ENV["DEBUG"]
+    end
+
+    def run(args = ARGV)
+      workflows_inputs, opts = parse_options!(args)
+
+      credentials =
+        if opts[:credentials_given]
+          opts[:credentials] == "-" ? $stdin.read : opts[:credentials]
+        elsif opts[:credentials_file_given]
+          File.read(opts[:credentials_file])
+        end
+
+      workflows =
+        workflows_inputs.each_slice(2).map do |workflow, input|
+          context = Floe::Workflow::Context.new(opts[:context], :input => input, :credentials => credentials)
+          Floe::Workflow.load(workflow, context)
+        end
+
+      Floe::Workflow.wait(workflows, &:run_nonblock)
+
+      # Display status
+      workflows.each do |workflow|
+        puts "", "#{workflow.name}#{" (#{workflow.status})" unless workflow.context.success?}", "===" if workflows.size > 1
+        puts workflow.output
+      end
+
+      workflows.all? { |workflow| workflow.context.success? }
+    rescue Floe::Error => err
+      abort(err.message)
+    end
+
+    private
+
+    def parse_options!(args)
+      opts = Optimist.options(args) do
+        version("v#{Floe::VERSION}\n")
+        usage("[options] workflow input [workflow2 input2]")
+
+        opt :workflow, "Path to your workflow json file (alternative to passing a bare workflow)", :type => :string
+        opt :input, <<~EOMSG, :type => :string
+          JSON payload of the Input to the workflow
+            If --input is passed and --workflow is not passed, will be used for all bare workflows listed.
+            If --input is not passed and --workflow is passed, defaults to '{}'.
+        EOMSG
+        opt :context, "JSON payload of the Context",              :type => :string
+        opt :credentials, "JSON payload with Credentials",        :type => :string
+        opt :credentials_file, "Path to a file with Credentials", :type => :string
+
+        Floe::ContainerRunner.cli_options(self)
+
+        banner("")
+        banner("General options:")
+      end
+
+      # Create workflow/input pairs from the various combinations of paramaters
+      workflows_inputs =
+        if opts[:workflow_given]
+          Optimist.die("cannot specify both --workflow and bare workflows") if args.any?
+
+          [opts[:workflow], opts.fetch(:input, "{}")]
+        elsif opts[:input_given]
+          Optimist.die("workflow(s) must be specified") if args.empty?
+
+          args.flat_map { |w| [w, opts[:input].dup] }
+        else
+          Optimist.die("workflow/input pairs must be specified") if args.empty? || (args.size > 1 && args.size.odd?)
+
+          args
+        end
+
+      Floe::ContainerRunner.resolve_cli_options!(opts)
+
+      return workflows_inputs, opts
+    end
+  end
+end

data/lib/floe/container_runner/docker_mixin.rb

@@ -24,6 +24,9 @@ module Floe
         # This does not follow the leading and trailing character restriction because we will embed it
         # below with a prefix and suffix that already conform to the RFC.
         normalized_name = name.downcase.gsub(/[^a-z0-9-]/, "-")[0, MAX_CONTAINER_NAME_SIZE]
+        # Ensure that the normalized_name doesn't end in any invalid characters after we
+        # limited the length to the MAX_CONTAINER_NAME_SIZE.
+        normalized_name.gsub!(/[^a-z0-9]+$/, "")
 
         "floe-#{normalized_name}-#{SecureRandom.hex(4)}"
       end

data/lib/floe/runner.rb

@@ -6,7 +6,7 @@ module Floe
 
     OUTPUT_MARKER = "__FLOE_OUTPUT__\n"
 
-    def initialize(_options = {})
+    def initialize(_options = {}) # rubocop:disable Style/RedundantInitialize
     end
 
     @runners = {}
@@ -75,8 +75,13 @@ module Floe
       raise NotImplementedError, "Must be implemented in a subclass"
     end
 
-    def wait(timeout: nil, events: %i[create update delete])
-      raise NotImplementedError, "Must be implemented in a subclass"
-    end
+    # Optional Watcher for events that is run in another thread.
+    #
+    # @yield [event, runner_context]
+    # @yieldparam [Symbol] event values: :create :update :delete :unknown
+    # @yieldparam [Hash] runner_context context provided by runner
+    # def wait(timeout: nil, events: %i[create update delete])
+    #   raise NotImplementedError, "Must be implemented in a subclass"
+    # end
   end
 end

data/lib/floe/validation_mixin.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Floe
+  module ValidationMixin
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    def parser_error!(comment)
+      self.class.parser_error!(name, comment)
+    end
+
+    def missing_field_error!(field_name)
+      self.class.missing_field_error!(name, field_name)
+    end
+
+    def invalid_field_error!(field_name, field_value = nil, comment = nil)
+      self.class.invalid_field_error!(name, field_name, field_value, comment)
+    end
+
+    def workflow_state?(field_value, workflow)
+      workflow.payload["States"] ? workflow.payload["States"].include?(field_value) : true
+    end
+
+    def wrap_parser_error(field_name, field_value)
+      yield
+    rescue ArgumentError, InvalidWorkflowError => error
+      invalid_field_error!(field_name, field_value, error.message)
+    end
+
+    module ClassMethods
+      def parser_error!(name, comment)
+        name = name.join(".") if name.kind_of?(Array)
+        raise Floe::InvalidWorkflowError, "#{name} #{comment}"
+      end
+
+      def missing_field_error!(name, field_name)
+        parser_error!(name, "does not have required field \"#{field_name}\"")
+      end
+
+      def invalid_field_error!(name, field_name, field_value, comment)
+        # instead of displaying a large hash or array, just displaying the word Hash or Array
+        field_value = field_value.class if field_value.kind_of?(Hash) || field_value.kind_of?(Array)
+
+        parser_error!(name, "field \"#{field_name}\"#{" value \"#{field_value}\"" unless field_value.nil?} #{comment}")
+      end
+    end
+  end
+end

data/lib/floe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Floe
-  VERSION = "0.11.2"
+  VERSION = "0.12.0"
 end

data/lib/floe/workflow/catcher.rb

@@ -3,14 +3,28 @@
 module Floe
   class Workflow
     class Catcher
-      attr_reader :error_equals, :next, :result_path
+      include ErrorMatcherMixin
+      include ValidationMixin
 
-      def initialize(payload)
-        @payload = payload
+      attr_reader :error_equals, :next, :result_path, :name
+
+      def initialize(workflow, name, payload)
+        @name         = name
+        @payload      = payload
 
         @error_equals = payload["ErrorEquals"]
         @next         = payload["Next"]
         @result_path  = ReferencePath.new(payload.fetch("ResultPath", "$"))
+
+        missing_field_error!("ErrorEquals") if !@error_equals.kind_of?(Array) || @error_equals.empty?
+        validate_state_next!(workflow)
+      end
+
+      private
+
+      def validate_state_next!(workflow)
+        missing_field_error!("Next") if @next.nil?
+        invalid_field_error!("Next", @next, "is not found in \"States\"") if @next && !workflow_state?(@next, workflow)
       end
     end
   end