floe 0.6.1 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b92b3c488e49ea77447b370e9152c49e11036e8295c6a781feda666662927f9e
-  data.tar.gz: c553deab6491c9876e28a816cb2422a1318ac6f91a9f9f75cbfc5a144a84d248
+  metadata.gz: 88cfa362fcb949aeaa6e9b0b799bff4bbb0e6b7158c95920545300ba063d6a0d
+  data.tar.gz: 14df3cddf7a1811e945f533b88fcacd6611566e212cacb88bebf2da0bae9fe67
 SHA512:
-  metadata.gz: 3f5c210d2a745aaed8e3419e228465203dcebb02ee678c1d2b47285083e1f154118c25864e51360d3d062ca0cfade9baa84f5a932804b586f26607a195acc710
-  data.tar.gz: 238fd469915e8682c449abd26e1950f68fd4b032a32fcace11130109d46dc6962b29e4ce381734d167f5328ef16ee2fdd4bb250f844644abebc571fc001ab2dd
+  metadata.gz: 90a3cdfdb241242d5b52ad403e7bbbf409476efec6d01d16f8f6f223b6f5fa3e227647da98ab2fb9466993982793be32684521ca5a268e73ab191ff7b6a025fb
+  data.tar.gz: c1194b741493a3db2f3abdf083ef2858b25af61442584c6a2001d222579c78e5057f0a7efd3c6c904e02d898c296f543c5af1889c2e4bb91c95f9197d327fa35

data/CHANGELOG.md

@@ -4,6 +4,18 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+## [0.7.1] - 2024-01-17
+### Fixed
+- Ensure that workflow credentials is not-nil ([#156](https://github.com/ManageIQ/floe/pull/156))
+
+## [0.7.0] - 2023-12-18
+### Changed
+- Remove the dependency on more_core_extensions in ReferencePath ([#144](https://github.com/ManageIQ/floe/pull/144))
+
+### Added
+- Implement `ReferencePath#get` ([#144](https://github.com/ManageIQ/floe/pull/144))
+- Allow a State to set a value in Credentials for subsequent states ([#145](https://github.com/ManageIQ/floe/pull/145))
+
 ## [0.6.1] - 2023-11-21
 ### Fixed
 - Return an error payload if run_async! fails ([#143](https://github.com/ManageIQ/floe/pull/143))
@@ -106,7 +118,9 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ### Added
 - Initial release
 
-[Unreleased]: https://github.com/ManageIQ/floe/compare/v0.6.1...HEAD
+[Unreleased]: https://github.com/ManageIQ/floe/compare/v0.7.1...HEAD
+[0.7.1]: https://github.com/ManageIQ/floe/compare/v0.7.0...v0.7.1
+[0.7.0]: https://github.com/ManageIQ/floe/compare/v0.6.1...v0.7.0
 [0.6.1]: https://github.com/ManageIQ/floe/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/ManageIQ/floe/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/ManageIQ/floe/compare/v0.4.1...v0.5.0

data/README.md

@@ -51,6 +51,38 @@ You can provide that at runtime via the `--credentials` parameter:
 bundle exec ruby exe/floe --workflow my-workflow.asl --credentials='{"roleArn": "arn:aws:iam::111122223333:role/LambdaRole"}'
 ```
 
+If you need to set a credential at runtime you can do that by using the `"ResultPath": "$.Credentials"` directive, for example to user a username/password to login and get a Bearer token:
+
+```
+bundle exec ruby exe/floe --workflow my-workflow.asl --credentials='{"username": "user", "password": "pass"}'
+```
+
+```json
+{
+  "StartAt": "Login",
+  "States": {
+    "Login": {
+      "Type": "Task",
+      "Resource": "docker://login:latest",
+      "Credentials": {
+        "username.$": "$.username",
+        "password.$": "$.password"
+      },
+      "ResultPath": "$.Credentials",
+      "Next": "DoSomething"
+    },
+    "DoSomething": {
+      "Type": "Task",
+      "Resource": "docker://do-something:latest",
+      "Credentials": {
+        "token.$": "$.bearer_token"
+      },
+      "End": true
+    }
+  }
+}
+```
+
 ### Ruby Library
 
 ```ruby

data/examples/set-credential.asl

@@ -0,0 +1,26 @@
+{
+  "Comment": "An example showing how to set a credential.",
+  "StartAt": "Login",
+  "States": {
+    "Login": {
+      "Type": "Task",
+      "Resource": "docker://docker.io/agrare/echo:latest",
+      "Parameters": {
+        "ECHO": "TOKEN"
+      },
+      "ResultPath": "$.Credentials",
+      "ResultSelector": {
+        "bearer_token.$": "$.echo"
+      },
+      "Next": "DoSomething"
+    },
+    "DoSomething": {
+      "Type": "Task",
+      "Resource": "docker://docker.io/agrare/hello-world:latest",
+      "Credentials": {
+        "bearer_token.$": "$.bearer_token"
+      },
+      "End": true
+    }
+  }
+}

data/floe.gemspec

@@ -32,6 +32,5 @@ Gem::Specification.new do |spec|
   spec.add_dependency "awesome_spawn", "~>1.0"
   spec.add_dependency "jsonpath", "~>1.1"
   spec.add_dependency "kubeclient", "~>4.7"
-  spec.add_dependency "more_core_extensions"
   spec.add_dependency "optimist", "~>3.0"
 end

data/lib/floe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Floe
-  VERSION = "0.6.1".freeze
+  VERSION = "0.7.1".freeze
 end

data/lib/floe/workflow/path.rb

@@ -9,6 +9,8 @@ module Floe
         end
       end
 
+      attr_reader :payload
+
       def initialize(payload)
         @payload = payload
 
@@ -28,10 +30,6 @@ module Floe
 
         results.count < 2 ? results.first : results
       end
-
-      private
-
-      attr_reader :payload
     end
   end
 end

data/lib/floe/workflow/reference_path.rb

@@ -4,37 +4,54 @@ module Floe
   class Workflow
     class ReferencePath < Path
       class << self
+        def get(payload, context)
+          new(payload).get(context)
+        end
+
         def set(payload, context, value)
           new(payload).set(context, value)
         end
       end
 
-      def initialize(*)
-        require "more_core_extensions/core_ext/hash/nested"
-        require "more_core_extensions/core_ext/array/nested"
+      attr_reader :path
 
+      def initialize(*)
         super
 
         raise Floe::InvalidWorkflowError, "Invalid Reference Path" if payload.match?(/@|,|:|\?/)
+        @path = JsonPath.new(payload)
+                        .path[1..]
+                        .map { |v| v.match(/\[(?<name>.+)\]/)["name"] }
+                        .map { |v| v[0] == "'" ? v.delete("'") : v.to_i }
+                        .compact
+      end
+
+      def get(context)
+        return context if path.empty?
+
+        context.dig(*path)
       end
 
       def set(context, value)
         result = context.dup
 
-        path = JsonPath.new(payload)
-                       .path[1..]
-                       .map { |v| v.match(/\[(?<name>.+)\]/)["name"] }
-                       .map { |v| v[0] == "'" ? v.delete("'") : v.to_i }
-                       .compact
-
         # If the payload is '$' then merge the value into the context
-        # otherwise use store path to set the value to a sub-key
+        # otherwise store the value under the path
         #
         # TODO: how to handle non-hash values, raise error if path=$ and value not a hash?
         if path.empty?
           result.merge!(value)
         else
-          result.store_path(path, value)
+          child    = result
+          keys     = path.dup
+          last_key = keys.pop
+
+          keys.each do |key|
+            child[key] = {} if child[key].nil?
+            child = child[key]
+          end
+
+          child[last_key] = value
         end
 
         result

data/lib/floe/workflow/states/input_output_mixin.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Floe
+  class Workflow
+    module States
+      module InputOutputMixin
+        def process_input(input)
+          input = input_path.value(context, input)
+          input = parameters.value(context, input) if parameters
+          input
+        end
+
+        def process_output(input, results)
+          return input if results.nil?
+          return if output_path.nil?
+
+          results = result_selector.value(context, results) if @result_selector
+          if result_path.payload.start_with?("$.Credentials")
+            credentials = result_path.set(workflow.credentials, results)["Credentials"]
+            workflow.credentials.merge!(credentials)
+            output = input
+          else
+            output = result_path.set(input, results)
+          end
+
+          output_path.value(context, output)
+        end
+      end
+    end
+  end
+end

data/lib/floe/workflow/states/pass.rb

@@ -4,6 +4,7 @@ module Floe
   class Workflow
     module States
       class Pass < Floe::Workflow::State
+        include InputOutputMixin
         include NonTerminalMixin
 
         attr_reader :end, :next, :result, :parameters, :input_path, :output_path, :result_path
@@ -25,12 +26,11 @@ module Floe
 
         def start(input)
           super
-          output = input_path.value(context, input)
-          output = result_path.set(output, result) if result && result_path
-          output = output_path.value(context, output)
 
+          input = process_input(input)
+
+          context.output     = process_output(input, result)
           context.next_state = end? ? nil : @next
-          context.output     = output
         end
 
         def running?

data/lib/floe/workflow/states/task.rb

@@ -4,6 +4,7 @@ module Floe
   class Workflow
     module States
       class Task < Floe::Workflow::State
+        include InputOutputMixin
         include NonTerminalMixin
 
         attr_reader :credentials, :end, :heartbeat_seconds, :next, :parameters,
@@ -49,7 +50,7 @@ module Floe
 
           if success?
             output = parse_output(output)
-            context.state["Output"] = process_output!(output)
+            context.state["Output"] = process_output(context.input.dup, output)
             context.next_state      = next_state
           else
             error = parse_error(output)
@@ -126,12 +127,6 @@ module Floe
           context.state["Error"] = context.output["Error"]
         end
 
-        def process_input(input)
-          input = input_path.value(context, input)
-          input = parameters.value(context, input) if parameters
-          input
-        end
-
         def parse_error(output)
           return if output.nil?
           return output if output.kind_of?(Hash)
@@ -150,16 +145,6 @@ module Floe
           nil
         end
 
-        def process_output!(results)
-          output = context.input.dup
-          return output if results.nil?
-          return if output_path.nil?
-
-          results = result_selector.value(context, results) if result_selector
-          output  = result_path.set(output, results)
-          output_path.value(context, output)
-        end
-
         def next_state
           end? ? nil : @next
         end

data/lib/floe/workflow.rb

@@ -44,7 +44,7 @@ module Floe
 
       @payload     = payload
       @context     = context
-      @credentials = credentials
+      @credentials = credentials || {}
       @start_at    = payload["StartAt"]
 
       @states         = payload["States"].to_a.map { |name, state| State.build!(self, name, state) }

data/lib/floe.rb

@@ -25,6 +25,7 @@ require_relative "floe/workflow/runner/podman"
 require_relative "floe/workflow/state"
 require_relative "floe/workflow/states/choice"
 require_relative "floe/workflow/states/fail"
+require_relative "floe/workflow/states/input_output_mixin"
 require_relative "floe/workflow/states/map"
 require_relative "floe/workflow/states/non_terminal_mixin"
 require_relative "floe/workflow/states/parallel"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: floe
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.1
 platform: ruby
 authors:
 - ManageIQ Developers
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-11-21 00:00:00.000000000 Z
+date: 2024-01-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_spawn
@@ -52,20 +52,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.7'
-- !ruby/object:Gem::Dependency
-  name: more_core_extensions
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: optimist
   requirement: !ruby/object:Gem::Requirement
@@ -96,6 +82,7 @@ files:
 - Gemfile
 - README.md
 - Rakefile
+- examples/set-credential.asl
 - examples/workflow.asl
 - exe/floe
 - floe.gemspec
@@ -123,6 +110,7 @@ files:
 - lib/floe/workflow/state.rb
 - lib/floe/workflow/states/choice.rb
 - lib/floe/workflow/states/fail.rb
+- lib/floe/workflow/states/input_output_mixin.rb
 - lib/floe/workflow/states/map.rb
 - lib/floe/workflow/states/non_terminal_mixin.rb
 - lib/floe/workflow/states/parallel.rb