u-case 5.0.0 → 5.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d654bd6a59c3920ef02a3fa0c2b82fb32ff5f695cfe1f4d4565a84c53bf1d86c
-  data.tar.gz: e42a81c72ad2f49d01f2464e220e72bd201ca0adce6be06f14defa4ee84f67fe
+  metadata.gz: a1270d6bb85374361d86582de966908d7e876a108ebb91bad69bd27f451c6885
+  data.tar.gz: b947c931285820d04082e97a41936d65a8f3c4a50da49d54afc304b23dae67ba
 SHA512:
-  metadata.gz: '090c4536a5205ed89e0cf2e76b163ca127455f90df793980bd33cdc28efecabd35736e543dc2f003954b8131367672dea79319382412dd7ce6ae25121847eab6'
-  data.tar.gz: 0a9f2345b82957003238137fcd5a4ca081205f3b83c1f8f092d92f153ef3b57dd7d726abef600cdd1b76b7e6983b222931d8903edf984573cf8dd4696851a7cd
+  metadata.gz: bc81c0fb34d2f300768b010aeb0357e8007ced4aac12a4443878179c4f68d333cb8d0c0ccbcac04e9f1101d318569c913880f5f11fb2e3ff48f9b9362d73aebf
+  data.tar.gz: 9fa4f08d80d2f89f0622ef76553d148a6ea5a2aebdf29019db4e92932ad986d17a6098533c30e5089cd8b3dc6b703118a9a08e507a15b8a24e67cc06c699e524

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.0.0     | https://github.com/serradura/u-case/blob/v5.x/README.md
+5.1.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).
@@ -88,7 +88,7 @@ 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  |
-| 5.0.0            | v5.x   | >= 2.7   | >= 6.0         | >= 2.7, < 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  |
 
 This library is tested (CI matrix) against:
@@ -189,6 +189,8 @@ A `Micro::Case::Result` stores the use cases output data. These are their main m
 - `#type` a Symbol which gives meaning for the result, this is useful to declare different types of failures or success.
 - `#data` the result data itself.
 - `#[]` and `#values_at` are shortcuts to access the `#data` values.
+- `#fetch` and `#fetch_values` are another way of accessing values of the result data, but raises a `KeyError` if the one of the keys are not present in the result.
+- `#keys` returns an array of keys present in the result data.
 - `#key?` returns `true` if the key is present in `#data`.
 - `#value?` returns `true` if the given value is present in `#data`.
 - `#slice` returns a new hash that includes only the given keys. If the given keys don't exist, an empty hash is returned.

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.0.0     | https://github.com/serradura/u-case/blob/v5.x/README.md
+5.1.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 -->
@@ -86,7 +86,7 @@ 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  |
-| 5.0.0            | v5.x   | >= 2.7   | >= 6.0         | >= 2.7, < 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  |
 
 Esta biblioteca é testada (matriz de CI) contra:
@@ -187,8 +187,10 @@ Um `Micro::Case::Result` armazena os dados de output de um caso de uso. Esses s
 - `#type` retorna um Symbol que dá significado ao resultado, isso é útil para declarar diferentes tipos de falha e sucesso.
 - `#data` os dados do resultado (um `Hash`).
 - `#[]` e `#values_at` são atalhos para acessar as propriedades do `#data`.
-- `#key?` retorna `true` se a chave estiver present no `#data`.
-- `#value?` retorna `true` se o valor estiver present no `#data`.
+- `#fetch` e `#fetch_values` são outras maneiras de acessar os valores contidos em `#data`, porém se alguma chave não existir, é levantado um `KeyError`.
+- `#keys` retorna uma array com as chaves presentes no resultado.
+- `#key?` retorna `true` se a chave estiver presente no `#data`.
+- `#value?` retorna `true` se o valor estiver presente no `#data`.
 - `#slice` retorna um novo `Hash` que inclui apenas as chaves fornecidas. Se as chaves fornecidas não existirem, um `Hash` vazio será retornado.
 - `#on_success` or `#on_failure` são métodos de hooks que te auxiliam a definir o fluxo da aplicação.
 - `#then` este método permite aplicar novos casos de uso ao resultado atual se ele for sucesso. A ideia dessa feature é a criação de fluxos dinâmicos.

data/lib/micro/case/result.rb

@@ -62,6 +62,18 @@ module Micro
         data.key?(key)
       end
 
+      def keys
+        data.keys
+      end
+
+      def fetch(*args, &block)
+        data.fetch(*args, &block)
+      end
+
+      def fetch_values(*keys, &block)
+        Utils::Hashes.fetch_values(data, keys, &block)
+      end
+
       def value?(value)
         data.value?(value)
       end

data/lib/micro/case/utils.rb

@@ -27,6 +27,14 @@ module Micro::Case::Utils
 
       hash.select { |key, _value| keys.include?(key) }
     end
+
+    def self.fetch_values(hash, keys, &block)
+      return hash.fetch_values(*keys, &block) if hash_respond_to?(hash, :fetch_values)
+
+      keys.each_with_object([]) do |key, values|
+        values << hash.fetch(key, &block)
+      end
+    end
   end
 
 end

data/lib/micro/case/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: u-case
 version: !ruby/object:Gem::Version
-  version: 5.0.0
+  version: 5.1.0
 platform: ruby
 authors:
 - Rodrigo Serradura