u-case 5.1.0 → 5.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1270d6bb85374361d86582de966908d7e876a108ebb91bad69bd27f451c6885
-  data.tar.gz: b947c931285820d04082e97a41936d65a8f3c4a50da49d54afc304b23dae67ba
+  metadata.gz: 2c0d84e916ac431f822d767a3485ce0a6ec9db47bba8b9b6cbc914ec72ec18da
+  data.tar.gz: b272186504907f0f2e88fe3fd19c241a7135bfa191a621a55ae912c95f680b57
 SHA512:
-  metadata.gz: bc81c0fb34d2f300768b010aeb0357e8007ced4aac12a4443878179c4f68d333cb8d0c0ccbcac04e9f1101d318569c913880f5f11fb2e3ff48f9b9362d73aebf
-  data.tar.gz: 9fa4f08d80d2f89f0622ef76553d148a6ea5a2aebdf29019db4e92932ad986d17a6098533c30e5089cd8b3dc6b703118a9a08e507a15b8a24e67cc06c699e524
+  metadata.gz: ee96e3cc845c753481a94e394b496b8a923c0a15d220713c610dbb77046d4f79f434291f31cc5b8e88fa16d55dba12db11953d1553b0a8aa284277aa4558512a
+  data.tar.gz: 4edb2ce9cb98319bab947ebfb9166518eaeca467d68198e5b3ac4a258ac907b16e1eb8c44ffd991140dddf863e4a821a146c29ef007139ad8c2e666732630fce

data/Gemfile

@@ -9,6 +9,8 @@ gem "rake", "~> 13.0"
 
 group :test do
   gem "simplecov", "~> 0.22.0", require: false
+  gem "minitest", (RUBY_VERSION >= "4.0") ? "~> 6.0" : "~> 5.27" if RUBY_VERSION >= "3.1"
+  gem "ostruct", "~> 0.6.3" if RUBY_VERSION >= "3.5"
 end
 
 group :development, :test do

data/README.md

@@ -27,7 +27,7 @@ The main project goals are:
 Version   | Documentation
 --------- | -------------
 unreleased| https://github.com/serradura/u-case/blob/main/README.md
-5.1.0     | https://github.com/serradura/u-case/blob/v5.x/README.md
+5.2.0     | https://github.com/serradura/u-case/blob/v5.x/README.md
 4.5.1     | https://github.com/serradura/u-case/blob/v4.x/README.md
 
 > **Note:** Você entende português? 🇧🇷 🇵🇹 Verifique o [README traduzido em pt-BR](https://github.com/serradura/u-case/blob/main/README.pt-BR.md).
@@ -60,6 +60,7 @@ unreleased| https://github.com/serradura/u-case/blob/main/README.md
   - [`Micro::Case::Safe` - Is there some feature to auto handle exceptions inside of a use case or flow?](#microcasesafe---is-there-some-feature-to-auto-handle-exceptions-inside-of-a-use-case-or-flow)
     - [`Micro::Cases::Safe::Flow`](#microcasessafeflow)
     - [`Micro::Case::Result#on_exception`](#microcaseresulton_exception)
+  - [Validating attributes with `accept:` / `reject:`](#validating-attributes-with-accept--reject)
   - [`u-case/with_activemodel_validation` - How to validate the use case attributes?](#u-casewith_activemodel_validation---how-to-validate-the-use-case-attributes)
     - [If I enabled the auto validation, is it possible to disable it only in specific use cases?](#if-i-enabled-the-auto-validation-is-it-possible-to-disable-it-only-in-specific-use-cases)
     - [`Kind::Validator`](#kindvalidator)
@@ -87,7 +88,8 @@ unreleased| https://github.com/serradura/u-case/blob/main/README.md
 
 | u-case           | branch | ruby     | activemodel    | u-attributes   |
 | ---------------- | ------ | -------- | -------------- | -------------- |
-| unreleased       | main   | >= 2.7   | >= 6.0         | >= 2.7, < 4.0  |
+| unreleased       | main   | >= 2.7   | >= 6.0         | >= 2.8, < 4.0  |
+| 5.2.0            | v5.x   | >= 2.7   | >= 6.0         | >= 2.8, < 4.0  |
 | 5.1.0            | v5.x   | >= 2.7   | >= 6.0         | >= 2.7, < 4.0  |
 | 4.5.1            | v4.x   | >= 2.2.0 | >= 3.2, <= 8.1 | >= 2.7, < 3.0  |
 
@@ -1068,6 +1070,43 @@ As you can see, this hook has the same behavior of `result.on_failure(:exception
 
 [⬆️ Back to Top](#table-of-contents-)
 
+### Validating attributes with `accept:` / `reject:`
+
+Since `u-case 5.2.0`, every use case includes the [`accept` extension](https://github.com/serradura/u-attributes#accept-extension) from [`u-attributes`](https://github.com/serradura/u-attributes) (requires `u-attributes >= 2.8`). You can declare type expectations (or any other check) directly on the attribute, and the use case will fail automatically with the `:invalid_attributes` type when any attribute is rejected — no need to validate inside `call!`.
+
+```ruby
+class CreateUser < Micro::Case
+  attribute :name,  accept: String
+  attribute :email, accept: ->(value) { value.is_a?(String) && value.include?('@') }
+  attribute :age,   accept: Integer, allow_nil: true
+
+  def call!
+    Success result: { user: User.create!(attributes) }
+  end
+end
+
+CreateUser.call(name: 'Bob', email: 'bob@example.com')
+# => #<Success type=:ok ...>
+
+CreateUser.call(name: 42, email: 'not-an-email')
+# => #<Failure type=:invalid_attributes data={
+#       errors: {
+#         "name"  => "expected to be a kind of String",
+#         "email" => "is invalid"
+#       }
+#     }>
+```
+
+The failure type follows the same setting used by the ActiveModel validation integration — see [`Micro::Case.config`](#microcaseconfig) and `set_activemodel_validation_errors_failure`.
+
+When combined with [`u-case/with_activemodel_validation`](#u-casewith_activemodel_validation---how-to-validate-the-use-case-attributes), the execution order is:
+
+1. `u-attributes` resolves the default value of each attribute.
+2. `u-attributes` runs the `accept:` / `reject:` checks.
+3. `u-case` runs the `ActiveModel` validations **only if** every attribute was accepted.
+
+[⬆️ Back to Top](#table-of-contents-)
+
 ### `u-case/with_activemodel_validation` - How to validate the use case attributes?
 
 **Requirement:**

data/README.pt-BR.md

@@ -27,7 +27,7 @@ Principais objetivos deste projeto:
 Versão    | Documentação
 --------- | -------------
 unreleased| https://github.com/serradura/u-case/blob/main/README.md
-5.1.0     | https://github.com/serradura/u-case/blob/v5.x/README.md
+5.2.0     | https://github.com/serradura/u-case/blob/v5.x/README.md
 4.5.1     | https://github.com/serradura/u-case/blob/v4.x/README.md
 
 ## Índice <!-- omit in toc -->
@@ -58,6 +58,7 @@ unreleased| https://github.com/serradura/u-case/blob/main/README.md
   - [`Micro::Case::Safe` - Existe algum recurso para lidar automaticamente com exceções dentro de um caso de uso ou fluxo?](#microcasesafe---existe-algum-recurso-para-lidar-automaticamente-com-exceções-dentro-de-um-caso-de-uso-ou-fluxo)
     - [`Micro::Cases::Safe::Flow`](#microcasessafeflow)
     - [`Micro::Case::Result#on_exception`](#microcaseresulton_exception)
+  - [Validando atributos com `accept:` / `reject:`](#validando-atributos-com-accept--reject)
   - [`u-case/with_activemodel_validation` - Como validar os atributos do caso de uso?](#u-casewith_activemodel_validation---como-validar-os-atributos-do-caso-de-uso)
     - [Se eu habilitei a validação automática, é possível desabilitá-la apenas em casos de uso específicos?](#se-eu-habilitei-a-validação-automática-é-possível-desabilitá-la-apenas-em-casos-de-uso-específicos)
     - [`Kind::Validator`](#kindvalidator)
@@ -85,7 +86,8 @@ unreleased| https://github.com/serradura/u-case/blob/main/README.md
 
 | u-case           | branch | ruby     | activemodel    | u-attributes   |
 | ---------------- | ------ | -------- | -------------- | -------------- |
-| unreleased       | main   | >= 2.7   | >= 6.0         | >= 2.7, < 4.0  |
+| unreleased       | main   | >= 2.7   | >= 6.0         | >= 2.8, < 4.0  |
+| 5.2.0            | v5.x   | >= 2.7   | >= 6.0         | >= 2.8, < 4.0  |
 | 5.1.0            | v5.x   | >= 2.7   | >= 6.0         | >= 2.7, < 4.0  |
 | 4.5.1            | v4.x   | >= 2.2.0 | >= 3.2, <= 8.1 | >= 2.7, < 3.0  |
 
@@ -1069,6 +1071,43 @@ Como você pode ver, este hook tem o mesmo comportamento de `result.on_failure(:
 
 [⬆️ Voltar para o índice](#índice-)
 
+### Validando atributos com `accept:` / `reject:`
+
+Desde a versão `5.2.0` do `u-case`, todo caso de uso já inclui a [extensão `accept`](https://github.com/serradura/u-attributes#accept-extension) do [`u-attributes`](https://github.com/serradura/u-attributes) (requer `u-attributes >= 2.8`). Você pode declarar a expectativa de tipo (ou qualquer outra verificação) diretamente no atributo, e o caso de uso falhará automaticamente com o tipo `:invalid_attributes` quando algum atributo for rejeitado — sem precisar validar dentro do `call!`.
+
+```ruby
+class CreateUser < Micro::Case
+  attribute :name,  accept: String
+  attribute :email, accept: ->(value) { value.is_a?(String) && value.include?('@') }
+  attribute :age,   accept: Integer, allow_nil: true
+
+  def call!
+    Success result: { user: User.create!(attributes) }
+  end
+end
+
+CreateUser.call(name: 'Bob', email: 'bob@example.com')
+# => #<Success type=:ok ...>
+
+CreateUser.call(name: 42, email: 'not-an-email')
+# => #<Failure type=:invalid_attributes data={
+#       errors: {
+#         "name"  => "expected to be a kind of String",
+#         "email" => "is invalid"
+#       }
+#     }>
+```
+
+O tipo da falha segue a mesma configuração usada pela integração com `ActiveModel` — veja [`Micro::Case.config`](#microcaseconfig) e `set_activemodel_validation_errors_failure`.
+
+Quando combinado com [`u-case/with_activemodel_validation`](#u-casewith_activemodel_validation---como-validar-os-atributos-do-caso-de-uso), a ordem de execução é:
+
+1. O `u-attributes` resolve o valor padrão de cada atributo.
+2. O `u-attributes` executa as verificações de `accept:` / `reject:`.
+3. O `u-case` executa as validações do `ActiveModel` **apenas se** todos os atributos forem aceitos.
+
+[⬆️ Voltar para o índice](#índice-)
+
 ### `u-case/with_activemodel_validation` - Como validar os atributos do caso de uso?
 
 **Requisitos:**

data/lib/micro/case/version.rb

@@ -2,6 +2,6 @@
 
 module Micro
   class Case
-    VERSION = '5.1.0'.freeze
+    VERSION = '5.2.0'.freeze
   end
 end

data/lib/micro/case/with_activemodel_validation.rb

@@ -19,7 +19,10 @@ module Micro
     private
 
       def __call_use_case
-        return failure_by_validation_error(self) if !self.class.auto_validation_disabled? && errors.present?
+        unless self.class.auto_validation_disabled?
+          return failure_by_validation_error(self) if errors.present?
+          return __failure_from_attributes_errors if __attributes_errors_present?
+        end
 
         result = call!
 

data/lib/micro/case.rb

@@ -18,6 +18,7 @@ module Micro
     require 'micro/cases'
 
     include Micro::Attributes
+    include Micro::Attributes::Features::Accept
 
     def self.call(input = Kind::Empty::HASH)
       result = __new__(Result.new, input).__call__
@@ -206,6 +207,8 @@ module Micro
       end
 
       def __call_use_case
+        return __failure_from_attributes_errors if __attributes_errors_present?
+
         result = call!
 
         return result if result.is_a?(Result)
@@ -213,6 +216,17 @@ module Micro
         raise Error::UnexpectedResult.new("#{self.class.name}#call!")
       end
 
+      def __attributes_errors_present?
+        attributes_errors?
+      end
+
+      def __failure_from_attributes_errors
+        Failure(
+          Config.instance.activemodel_validation_errors_failure,
+          result: { errors: attributes_errors }
+        )
+      end
+
       def __call_the_use_case_flow?
         self.class.__flow_get__
       end

data/u-case.gemspec

@@ -26,7 +26,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.7.0'
 
   spec.add_runtime_dependency 'kind', '>= 5.6', '< 7.0'
-  spec.add_runtime_dependency 'u-attributes', '>= 2.7', '< 4.0'
+  spec.add_runtime_dependency 'u-attributes', '>= 2.8', '< 4.0'
 
   spec.add_development_dependency 'appraisal', '~> 2.5'
   spec.add_development_dependency 'bundler'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: u-case
 version: !ruby/object:Gem::Version
-  version: 5.1.0
+  version: 5.2.0
 platform: ruby
 authors:
 - Rodrigo Serradura
@@ -35,7 +35,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.8'
     - - "<"
       - !ruby/object:Gem::Version
         version: '4.0'
@@ -45,7 +45,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.8'
     - - "<"
       - !ruby/object:Gem::Version
         version: '4.0'