foobara 0.0.112 → 0.0.114

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a36c133c68acf0ea569d20a21409921f0c5dfe0e147c830f2572b84bda6d77b2
-  data.tar.gz: e0e44b5fb75ab902e32b8200ef8a19420f1aaee94f8786c6af63731463e78318
+  metadata.gz: 0a65302dbd9dc22dd5ba53bb011e0f4fab25899634940519e1dbe954ecd7cace
+  data.tar.gz: bb03693721af1e40ec818209d1f32566e72a9152394055d07b93264ce121cf0f
 SHA512:
-  metadata.gz: f2d7343f12f57901d9d60c9ef419e35938bf77e2a9552ea0ef095d33cd07fd0f648d9d8f78698842c94ffb0fcc447fbe1a64ea62d5d5ae5569ea0c127fba8d60
-  data.tar.gz: 97edd6f9217b2fd7651f72643671ad7ce191772d6472f4a1715eb66ca93506181c43614ddef6c3405de3f579d9765e5a135ce0383e5547a19b1b7e21faead8a8
+  metadata.gz: 3436e3ef29601c86662f913a6ea2d6fd2d6b018e778423703fa0e382b5d19d057425b0e39ddccc0b3273c57a609fff0bd70d02ea776f39ba84563cc171802a97
+  data.tar.gz: bd83c8e7df911f6e5960e956581c6c2de0a9a4c562b76b2ae2e0ef1e70d278764856361ccfd38340b7e428974ac5b532c52a71f0bbcf898b040b553fe298416b

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+# [0.0.114] - 2025-05-01
+
+- Support choosing among multiple processors
+- Make Authenticator a Processor
+- Give a way for Processor::Selection to give nil when nothing matches
+
+# [0.0.113] - 2025-04-25
+
+- If an inputs transformer fails give relevant error/outcome not an unknown error
+
 # [0.0.112] - 2025-04-25
 
 - Fix bugs preventing generating manifest for connector with mutator instances instead of classes

data/projects/command/src/transformed_command.rb

@@ -217,9 +217,6 @@ module Foobara
       end
 
       def types_depended_on
-        # Seems to be not necessary?
-        # types = command_class.types_depended_on
-
         types = Set.new
 
         # TODO: memoize this
@@ -299,18 +296,14 @@ module Foobara
         response_mutators = mutators_to_manifest_symbols(self.response_mutators, to_include:)
         request_mutators = mutators_to_manifest_symbols(self.request_mutators, to_include:)
 
-        authenticator_manifest = if authenticator
-                                   if authenticator.respond_to?(:foobara_manifest)
-                                     # TODO: test this path
-                                     # :nocov:
-                                     authenticator.foobara_manifest
-                                     # :nocov:
-                                   else
-                                     true
-                                   end
-                                 end
-
-        inputs_types_depended_on =  TypeDeclarations.with_manifest_context(remove_sensitive: false) do
+        authenticator_details = if authenticator
+                                  {
+                                    symbol: authenticator.symbol,
+                                    explanation: authenticator.explanation
+                                  }
+                                end
+
+        inputs_types_depended_on = TypeDeclarations.with_manifest_context(remove_sensitive: false) do
           self.inputs_types_depended_on.map(&:foobara_manifest_reference).sort
         end
 
@@ -338,7 +331,7 @@ module Foobara
             response_mutators:,
             request_mutators:,
             requires_authentication:,
-            authenticator: authenticator_manifest
+            authenticator: authenticator_details
           )
         )
       end
@@ -486,7 +479,8 @@ module Foobara
       end
     end
 
-    attr_accessor :command, :untransformed_inputs, :transformed_inputs, :outcome, :authenticated_user
+    attr_accessor :command, :untransformed_inputs, :transformed_inputs, :outcome, :authenticated_user,
+                  :authenticated_credential
 
     def initialize(untransformed_inputs = {})
       self.untransformed_inputs = untransformed_inputs || {}
@@ -526,7 +520,14 @@ module Foobara
 
     def transform_inputs
       self.transformed_inputs = if self.class.inputs_transformer
-                                  self.class.inputs_transformer.process_value!(untransformed_inputs)
+                                  outcome = self.class.inputs_transformer.process_value(untransformed_inputs)
+
+                                  if outcome.success?
+                                    outcome.result
+                                  else
+                                    self.outcome = outcome
+                                    untransformed_inputs
+                                  end
                                 else
                                   untransformed_inputs
                                 end

data/projects/command_connectors/src/authenticator.rb

@@ -1,14 +1,32 @@
 module Foobara
   class CommandConnector
-    class Authenticator
-      attr_reader :block, :explanation, :symbol
+    # TODO: should switch to a processor and give errors if the authenticator header is malformed
+    class Authenticator < Value::Transformer
+      attr_reader :block
 
       def initialize(symbol: nil, explanation: nil, &block)
         symbol ||= Util.non_full_name_underscore(self.class).to_sym
+        explanation ||= symbol
+
+        super(symbol:, explanation:)
 
-        @symbol = symbol
         @block = block
-        @explanation = explanation || symbol
+      end
+
+      def symbol
+        declaration_data[:symbol]
+      end
+
+      def explanation
+        declaration_data[:explanation]
+      end
+
+      def transform(request)
+        request.instance_exec(&to_proc)
+      end
+
+      def authenticate(request)
+        transform(request)
       end
 
       def to_proc

data/projects/command_connectors/src/authenticator_selector.rb

@@ -0,0 +1,29 @@
+require_relative "authenticator"
+
+module Foobara
+  class CommandConnector
+    # TODO: should switch to a processor and give errors if the authenticator header is malformed
+    class AuthenticatorSelector < Authenticator
+      attr_accessor :authenticators
+
+      def initialize(authenticators:, symbol: nil, explanation: nil, &block)
+        self.authenticators = authenticators
+
+        symbol ||= authenticators.map(&:symbol).map(&:to_s).join("_or_").to_sym
+        explanation ||= authenticators.map(&:explanation).join(", or ")
+
+        super(symbol:, explanation:)
+
+        @block = block
+      end
+
+      def selector
+        @selector ||= Value::Processor::Selection.new(processors: authenticators, error_if_none_applicable: false)
+      end
+
+      def authenticate(request)
+        selector.process_value!(request)
+      end
+    end
+  end
+end

data/projects/command_connectors/src/command_connector.rb

@@ -85,6 +85,19 @@ module Foobara
           end
 
           authenticator
+        when ::Array
+          case object.size
+          when 0
+            # TODO: test this
+            # :nocov:
+            nil
+            # :nocov:
+          when 1
+            to_authenticator(object.first)
+          else
+            authenticators = object.map { |authenticatorish| to_authenticator(authenticatorish) }
+            AuthenticatorSelector.new(authenticators:, symbol:)
+          end
         else
           if object.respond_to?(:call)
             Authenticator.new(symbol:, &object)
@@ -388,7 +401,11 @@ module Foobara
     end
 
     def run_command(request)
-      request.command.run
+      command = request.command
+
+      unless command.outcome
+        command.run
+      end
     rescue => e
       if capture_unknown_error
         request.error = CommandConnector::UnknownError.for(e)
@@ -399,12 +416,14 @@ module Foobara
 
     def authenticate(request)
       request_command = request.command
-      auth_block = request_command.authenticator || authenticator
+      authenticator = request_command.authenticator || self.authenticator
 
       request_command.after_load_records do |command:, **|
-        authenticated_user = request.instance_exec(&auth_block)
+        authenticated_user, authenticated_credential = authenticator.authenticate(request)
 
+        # TODO: why are these on the command instead of the request??
         request_command.authenticated_user = authenticated_user
+        request_command.authenticated_credential = authenticated_credential
 
         unless authenticated_user
           request_command.outcome = Outcome.error(CommandConnector::UnauthenticatedError.new)

data/projects/value/src/processor/selection.rb

@@ -16,10 +16,12 @@ module Foobara
           end
         end
 
-        attr_accessor :enforce_unique
+        attr_accessor :enforce_unique, :error_if_none_applicable
 
-        def initialize(*, enforce_unique: true, **)
+        def initialize(*, enforce_unique: true, error_if_none_applicable: true, **)
           self.enforce_unique = enforce_unique
+          self.error_if_none_applicable = error_if_none_applicable
+
           super(*, **)
         end
 
@@ -29,12 +31,19 @@ module Foobara
 
           if outcome.success?
             processor = outcome.result
-            outcome = processor.process_value(value)
+
+            unless processor.nil?
+              outcome = processor.process_value(value)
+            end
           end
 
           outcome
         end
 
+        def process_value!(value)
+          process_value(value).result!
+        end
+
         def processor_for(value)
           processor = if enforce_unique
                         applicable_processors = processors.select { |p| p.applicable?(value) }
@@ -59,8 +68,10 @@ module Foobara
 
           if processor
             Outcome.success(processor)
-          else
+          elsif error_if_none_applicable
             Outcome.error(build_error(value, error_class: NoApplicableProcessorError))
+          else
+            Outcome.success(nil)
           end
         end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: foobara
 version: !ruby/object:Gem::Version
-  version: 0.0.112
+  version: 0.0.114
 platform: ruby
 authors:
 - Miles Georgi
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-05-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -182,6 +182,7 @@ files:
 - projects/command/src/transformed_command.rb
 - projects/command_connectors/lib/foobara/command_connectors.rb
 - projects/command_connectors/src/authenticator.rb
+- projects/command_connectors/src/authenticator_selector.rb
 - projects/command_connectors/src/command_connector.rb
 - projects/command_connectors/src/command_connector/command_connector_error.rb
 - projects/command_connectors/src/command_connector/commands/describe.rb
@@ -508,7 +509,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.2
 specification_version: 4
 summary: A command-centric and discoverable software framework with a focus on domain
   concepts and abstracting away integration code