metaractor 3.3.5 → 3.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba4a53b90f455fc6e2940aaabe62e2a88b64657feb57cba562b7456c68ed5cc8
-  data.tar.gz: c0f76bccfd5ad86a9ed9a2e0212b84512ceb56ab26426c0ea67251531a7e7498
+  metadata.gz: 54f810c7379560bdedc30b5b748fdfea64ee6ee6040b021f1c7315ebd82d6d25
+  data.tar.gz: 1b78f912f057e8c5bc8e9490e7c427f9203c240442561efc2acaecc72a16fa80
 SHA512:
-  metadata.gz: 0be2757b00ef748691d6d62b3021e6ce2fe481826d042da3ab27da93ba8ce1eaed4aabe73c069082683409cccdfd6510b3b8a137689ecc87ac1a3f641ed3892d
-  data.tar.gz: '090b6cba71a3b1a48c322ffb110dcb09b6eb77f87c6ac153b3a143c13e1525310fe3694aa50435a18dd5bc8b9ceb120087f9a8b65d6f74eee0a8c0c96b4820c7'
+  metadata.gz: cf8e038791c2611ed349dc6265cf349a68989f8aa227abc5e6c1458f50afc1f3b5c71dbfb9a12e8e56dbedbadfe8600fcb1f96e05533804393d0760c7dbd9821
+  data.tar.gz: 2909274be834f5621a739893803d1e5551e5aeebc9da404e216e07cb9b5947b725a78fbb5069b085c24f0c0ba4811026e370c92bb25a8099ef9d2ee4916a248f

data/.ruby-version

@@ -1 +1 @@
-3.4.4
+4.0.3

data/README.md

@@ -12,13 +12,14 @@ gem 'metaractor'
 
 And then execute:
 
-    $ bundle
+    bundle
 
 Or install it yourself as:
 
-    $ gem install metaractor
+    gem install metaractor
 
 ## Usage
+
 ```ruby
 class HighFiveUser
   include Metaractor
@@ -52,6 +53,7 @@ result.error_messages
 See Interactor's [README](https://github.com/collectiveidea/interactor/blob/master/README.md) for more information.
 
 ### Configuration
+
 Metaractor is meant to be extensible (hence the 'meta').  You can add additional modules in the following way:
 
 ```ruby
@@ -64,29 +66,37 @@ end
 ```
 
 ### Required Parameters
+
 Metaractor supports complex required parameter statements and you can chain these together in any manner using `and`, `or`, and `xor`.
+
 ```ruby
 required and: [:token, or: [:recipient_id, :recipient] ]
 ```
 
 You can also mark a parameter as required with the `required` option:
+
 ```ruby
 parameter :user, required: true
 ```
 
 ### Optional Parameters
+
 As optional parameters have no enforcement, they are merely advisory.
+
 ```ruby
 optional :enable_logging
 ```
 
 ### Parameter Options
+
 Metaractor supports arbitrary parameter options. The following are currently built in.
 Note that you can specify a block of `required` or `optional` parameters and then use
 `parameter` or `parameters` to add options to one or more of them.
 
 #### Skipping Blank Parameter Removal
+
 By default Metaractor removes blank values that are passed in. You may skip this behavior on a per-parameter basis:
+
 ```ruby
 parameter :name, allow_blank: true
 ```
@@ -94,28 +104,35 @@ parameter :name, allow_blank: true
 You may check to see if a parameter exists via `context.has_key?`.
 
 #### Default Values
+
 You can specify a default value for a parameter:
+
 ```ruby
 optional :role, default: :user
 ```
 
 This works with `allow_blank` and can also be anything that responds to `#call`.
+
 ```ruby
 parameter :role, allow_blank: true, default: -> { context.default_role }
 ```
 
 #### Typecasting/Coersion
+
 You can supply Metaractor with a callable that will typecast incoming parameters:
+
 ```ruby
 optional :needs_to_be_a_string, type: ->(value) { value.to_s }
 ```
 
 You can also configure Metaractor with named types and use them:
+
 ```ruby
 Metaractor.configure do |config|
   config.register_type(:boolean, ->(value) { ActiveModel::Type::Boolean.new.cast(value) })
 end
 ```
+
 ```ruby
 required :is_awesome, type: :boolean
 ```
@@ -123,7 +140,9 @@ required :is_awesome, type: :boolean
 **Note**: Typecasters will _not_ be called on `nil` values.
 
 ### Custom Validation
+
 Metaractor supports doing custom validation before any user supplied before_hooks run.
+
 ```ruby
 validate_parameters do
   if context.foo == :bar
@@ -137,6 +156,7 @@ end
 ```
 
 If you need to require a parameter from a `before_hook` for any reason, use the bang version of the method:
+
 ```ruby
 before do
   # Be careful with this approach as some user code may run before the parameter validation
@@ -145,7 +165,9 @@ end
 ```
 
 ### Structured Errors
+
 As of v2.0.0, metaractor supports structured errors.
+
 ```ruby
 class UpdateUser
   include Metaractor
@@ -202,7 +224,9 @@ result.errors.to_h
 ```
 
 ### I18n
+
 As of v3.0.0, metaractor supports i18n along with structured errors.
+
 ```ruby
 module Users
   class UpdateUser
@@ -225,6 +249,7 @@ end
 ```
 
 Locale:
+
 ```yaml
 en:
   errors:
@@ -246,10 +271,12 @@ You can see that above with the `users` key in the locale.
 
 The i18n integration will walk its way from the most specific message to the least specific one, stopping at the first one it can find.
 We currently expose the following variables for use in the message:
+
 - `error_key`: the error we added (ex: `blank` or `invalid_configuration`)
 - `parameter`: the name of the parameter
 
 You can also use this feature to work with machine readable keys:
+
 ```ruby
 result = Users::UpdateUser.call
 if result.failure? &&
@@ -260,7 +287,9 @@ end
 ```
 
 ### Spec Helpers
+
 Enable the helpers and/or matchers:
+
 ```ruby
 RSpec.configure do |config|
   config.include Metaractor::Spec::Helpers
@@ -269,7 +298,9 @@ end
 ```
 
 #### Helpers
+
 - `context_creator`
+
 ```ruby
 # context_creator(error_message: nil, error_messages: [], errors: [], valid: nil, invalid: nil, success: nil, failure: nil, **attributes)
 
@@ -300,7 +331,9 @@ context_creator(
 ```
 
 #### Matchers
+
 - `include_errors`
+
 ```ruby
 result = context_creator(
   errors: {
@@ -320,7 +353,9 @@ expect(result).to include_errors('user.title cannot be blank')
 ```
 
 ### Hash Formatting
+
 Metaractor customizes the output for `Metaractor::Errors#inspect` and `Interactor::Failure`:
+
 ```
 Interactor::Failure:
        Errors:
@@ -334,6 +369,7 @@ Interactor::Failure:
 ```
 
 You can further customize the hash formatting:
+
 ```ruby
 Metaractor.configure do |config|
   # Configure Metaractor to use awesome_print
@@ -342,22 +378,21 @@ end
 ```
 
 ### Further Reading
+
 For more examples of all of the above approaches, please see the specs.
 
 ## Development
 
-- `docker compose build --pull`
-- `docker compose run --rm metaractor` to run specs
-
-or with the Deskfile loaded:
+- `flox pull ryansch/ruby-4-0`
+- `flox activate`
+- `bundle`
 - `rspec spec`
 
 To release a new version:
+
 - Update the version number in `version.rb` and commit the result.
-- `docker compose build --pull`
-- `docker compose run --rm release`
+- Trigger the Release workflow.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/metaractor/metaractor.
-
+Bug reports and pull requests are welcome on GitHub at <https://github.com/metaractor/metaractor>.

data/lib/metaractor/chain_failures.rb

@@ -12,5 +12,15 @@ module Metaractor
       context.fail_from_context(context: e.context)
       raise
     end
+
+    def run(...)
+      run!(...)
+    rescue Interactor::Failure
+      # Intentionally rescue all Failures as we're
+      # handling child errors by failing the parents
+      # instead of allowing the child to raise
+      # all of the way up.
+      # Needed since Interactor v3.2.0.
+    end
   end
 end

data/lib/metaractor/delegation.rb

@@ -0,0 +1,16 @@
+module Metaractor
+  module Delegation
+    def respond_to_missing?(name, include_private = false)
+      return false if name == :marshal_dump || name == :_dump
+      context.has_key?(name) || super
+    end
+
+    def method_missing(name, ...)
+      if context.has_key?(name)
+        context.public_send(name, ...)
+      else
+        super
+      end
+    end
+  end
+end

data/lib/metaractor/version.rb

@@ -1,3 +1,3 @@
 module Metaractor
-  VERSION = "3.3.5"
+  VERSION = "3.4.1"
 end

data/lib/metaractor.rb

@@ -8,6 +8,7 @@ require "metaractor/parameters"
 require "metaractor/run_with_context"
 require "metaractor/chain_failures"
 require "metaractor/failure_output"
+require "metaractor/delegation"
 require "i18n"
 require "metaractor/namespace"
 require "metaractor/organizer"
@@ -45,7 +46,8 @@ module Metaractor
       {module: Metaractor::Parameters, method: :include},
       {module: Metaractor::RunWithContext, method: :include},
       {module: Metaractor::ChainFailures, method: :include},
-      {module: Metaractor::Namespace, method: :include}
+      {module: Metaractor::Namespace, method: :include},
+      {module: Metaractor::Delegation, method: :include}
     ]
   end
 

data/metaractor.gemspec

@@ -20,15 +20,15 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_runtime_dependency "interactor", "~> 3.1"
+  spec.add_runtime_dependency "interactor", "~> 3.2"
   spec.add_runtime_dependency "metaractor-sycamore", "~> 0.4", ">= 0.4.3"
   spec.add_runtime_dependency "i18n", "~> 1.14"
   spec.add_runtime_dependency "ostruct", "~> 0.6"
 
-  spec.add_development_dependency "bundler", "~> 2"
+  spec.add_development_dependency "bundler", "~> 4"
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.13"
-  spec.add_development_dependency "amazing_print", "~> 1.8"
+  spec.add_development_dependency "amazing_print", "~> 2.0"
   spec.add_development_dependency "debug", "~> 1.10"
   spec.add_development_dependency "activemodel", "~> 8"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: metaractor
 version: !ruby/object:Gem::Version
-  version: 3.3.5
+  version: 3.4.1
 platform: ruby
 authors:
 - Ryan Schlesinger
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: metaractor-sycamore
   requirement: !ruby/object:Gem::Requirement
@@ -77,14 +77,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '4'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -119,14 +119,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: debug
   requirement: !ruby/object:Gem::Requirement
@@ -174,6 +174,7 @@ files:
 - lib/metaractor/chain_failures.rb
 - lib/metaractor/context_errors.rb
 - lib/metaractor/context_methods.rb
+- lib/metaractor/delegation.rb
 - lib/metaractor/errors.rb
 - lib/metaractor/failure_output.rb
 - lib/metaractor/handle_errors.rb
@@ -203,7 +204,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Adds parameter validation and error control to interactor
 test_files: []