cmdx 1.16.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d864a54c25ea1fd3a30f5c84b760bfa1f50207f7b26e47143876c76e2258b37a
-  data.tar.gz: f1381fc4c62e761b0553800ccdd28a1aa0315e8dab4c2504692d936635b07063
+  metadata.gz: 6f8ab8732cd1ac0a15ac46872e78dc5d9549905c52bfda74d24948cae216b0d5
+  data.tar.gz: 7735fc7d16163a8265adc59ad35f17990887c853aded67a92d5039c44c2df888
 SHA512:
-  metadata.gz: 3431a3d16f0ac92ebb52daa8c412d8f9e33975deab27482d6756e00935015100b3edeb008a419d28daf3daa5e3ba59456110b8ef9554a648ebda348d68152609
-  data.tar.gz: b7837730a25c052356e45d56c69f2f41baa932362031f4f3f2fb9f5302020fff4ed8d690973afd0b482ba22a38d13091fe47f11b54635f1c321372bcbbf0cf60
+  metadata.gz: 294c1f8cf3eab880c4e2f5d12c8655b246534cb61c357531171e90102f73146c37efc185cc6e877e4680c5a2809f0d3cba4fb64bf59fe1b6fea410da65454c9e
+  data.tar.gz: d5e8e31425d658cfe151eeab44c938352d92d4f9e96326691d0c63b2688f0eeb64db26f7297d38264cbc6485c7355ae1ea3ad9a486a4ea0ccea8c02e4cd07a13

data/CHANGELOG.md

@@ -4,7 +4,22 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [TODO]
+
+## [1.17.0] - 2025-02-23
+
+### Added
+- Add `returns` macro for context output validation after task execution
+- Add `remove_return`/`remove_returns` macro to remove declared returns (supports inheritance)
+- Add array coercion for JSON `"null"` string as empty array
+- Add hash coercion for JSON `"null"` string as empty hash
+- Add attribute sourcing to support both string and symbol keys when sourcing/deriving from Hash
+
+## Changed
+- Do not fail coercion if nil on optional attributes
+- Include the source method in the required attribute error message
+
+## [1.16.0] - 2025-02-06
 
 ### Added
 - Add `CMDx::Exception` alias for `CMDx::Error`

data/README.md

@@ -59,8 +59,11 @@ class AnalyzeMetrics < CMDx::Task
   on_success :track_analysis_completion!
 
   required :dataset_id, type: :integer, numeric: { min: 1 }
+
   optional :analysis_type, default: "standard"
 
+  returns :result, :analyzed_at
+
   def work
     if dataset.nil?
       fail!("Dataset not found", code: 404)

data/lib/cmdx/attribute.rb

@@ -184,6 +184,18 @@ module CMDx
 
     end
 
+    # Checks if the attribute is optional.
+    #
+    # @return [Boolean] true if the attribute is optional, false otherwise
+    #
+    # @example
+    #   attribute.optional? # => true
+    #
+    # @rbs () -> bool
+    def optional?
+      !required? || !!options[:optional]
+    end
+
     # Checks if the attribute is required.
     #
     # @return [Boolean] true if the attribute is required, false otherwise

data/lib/cmdx/attribute_value.rb

@@ -18,7 +18,7 @@ module CMDx
     # @rbs @attribute: Attribute
     attr_reader :attribute
 
-    def_delegators :attribute, :task, :parent, :name, :options, :types, :source, :method_name, :required?
+    def_delegators :attribute, :task, :parent, :name, :options, :types, :source, :method_name, :required?, :optional?
     def_delegators :task, :attributes, :errors
 
     # Creates a new attribute value manager for the given attribute.
@@ -113,10 +113,11 @@ module CMDx
 
       if required? && (parent.nil? || parent&.required?) && Utils::Condition.evaluate(task, options)
         case sourced_value
-        when Context, Hash then sourced_value.key?(name)
+        when Context then sourced_value.key?(name)
+        when Hash then sourced_value.key?(name.to_s) || sourced_value.key?(name.to_sym)
         when Proc then true # HACK: Cannot be determined so assume it will respond
         else sourced_value.respond_to?(name, true)
-        end || errors.add(method_name, Locale.t("cmdx.attributes.required"))
+        end || errors.add(method_name, Locale.t("cmdx.attributes.required", method: source))
       end
 
       sourced_value
@@ -164,7 +165,8 @@ module CMDx
     def derive_value(source_value)
       derived_value =
         case source_value
-        when Context, Hash then source_value[name]
+        when Context then source_value[name]
+        when Hash then source_value[name.to_s] || source_value[name.to_sym]
         when Symbol then source_value.send(name)
         when Proc then task.instance_exec(name, &source_value)
         else source_value.call(task, name) if source_value.respond_to?(:call)
@@ -222,16 +224,17 @@ module CMDx
       rescue CoercionError => e
         next if i != last_idx
 
-        message =
-          if last_idx.zero?
-            e.message
-          else
-            tl = types.map { |t| Locale.t("cmdx.types.#{t}") }.join(", ")
-            Locale.t("cmdx.coercions.into_any", types: tl)
-          end
+        unless optional? && transformed_value.nil?
+          message =
+            if last_idx.zero?
+              e.message
+            else
+              tl = types.map { |t| Locale.t("cmdx.types.#{t}") }.join(", ")
+              Locale.t("cmdx.coercions.into_any", types: tl)
+            end
 
-        errors.add(method_name, message)
-        nil
+          errors.add(method_name, message)
+        end
       end
     end
 

data/lib/cmdx/coercions/array.rb

@@ -5,7 +5,7 @@ module CMDx
     # Converts various input types to Array format
     #
     # Handles conversion from strings that look like JSON arrays and other
-    # values that can be converted to arrays using Ruby's Array() method.
+    # values that can be wrapped in an array using Ruby's Array() method.
     module Array
 
       extend self
@@ -29,8 +29,11 @@ module CMDx
       #
       # @rbs (untyped value, ?Hash[Symbol, untyped] options) -> Array[untyped]
       def call(value, options = {})
-        if value.is_a?(::String) && value.start_with?("[")
-          JSON.parse(value)
+        if value.is_a?(::String) && (
+          value.start_with?("[") ||
+          value.strip == "null"
+        )
+          JSON.parse(value) || []
         else
           Array(value)
         end

data/lib/cmdx/coercions/hash.rb

@@ -9,6 +9,7 @@ module CMDx
     # - Hash objects (returned as-is)
     # - Array objects (converted using Hash[*array])
     # - JSON strings starting with "{" (parsed into Hash)
+    # - JSON strings that are "null" (parsed into empty Hash)
     # - Other types raise CoercionError
     module Hash
 
@@ -39,8 +40,11 @@ module CMDx
           value
         elsif value.is_a?(::Array)
           ::Hash[*value]
-        elsif value.is_a?(::String) && value.start_with?("{")
-          JSON.parse(value)
+        elsif value.is_a?(::String) && (
+          value.start_with?("{") ||
+          value.strip == "null"
+        )
+          JSON.parse(value) || {}
         elsif value.respond_to?(:to_h)
           value.to_h
         else

data/lib/cmdx/executor.rb

@@ -66,6 +66,7 @@ module CMDx
       task.class.settings[:middlewares].call!(task) do
         pre_execution! unless @pre_execution
         execution!
+        verify_returns!
       rescue UndefinedMethodError => e
         raise(e) # No need to clear the Chain since exception is not being re-raised
       rescue Fault => e
@@ -97,6 +98,7 @@ module CMDx
       task.class.settings[:middlewares].call!(task) do
         pre_execution! unless @pre_execution
         execution!
+        verify_returns!
       rescue UndefinedMethodError => e
         raise_exception(e)
       rescue Fault => e
@@ -231,6 +233,27 @@ module CMDx
       task.work
     end
 
+    # Verifies that all declared returns are present in the context after execution.
+    #
+    # @rbs () -> void
+    def verify_returns!
+      return unless result.success?
+
+      returns = Array(task.class.settings[:returns])
+      missing = returns.reject { |name| task.context.key?(name) }
+      return if missing.empty?
+
+      missing.each { |name| task.errors.add(name, Locale.t("cmdx.returns.missing")) }
+
+      result.fail!(
+        Locale.t("cmdx.faults.invalid"),
+        errors: {
+          full_message: task.errors.to_s,
+          messages: task.errors.to_h
+        }
+      )
+    end
+
     # Performs post-execution tasks including callback invocation.
     #
     # @rbs () -> void

data/lib/cmdx/task.rb

@@ -130,6 +130,7 @@ module CMDx
             end
 
           hash[:attributes] ||= AttributeRegistry.new
+          hash[:returns] ||= []
           hash[:tags] ||= []
 
           hash.merge!(options)
@@ -217,6 +218,33 @@ module CMDx
       end
       alias remove_attribute remove_attributes
 
+      # Declares expected context returns that must be set after task execution.
+      # If any declared return is missing from the context after {#work} completes
+      # successfully, the task will fail with a validation error.
+      #
+      # @param names [Array<Symbol, String>] Names of expected return keys in the context
+      #
+      # @example
+      #   returns :user, :token
+      #
+      # @rbs (*untyped names) -> void
+      def returns(*names)
+        settings[:returns] |= names.map(&:to_sym)
+      end
+
+      # Removes declared returns from the task.
+      #
+      # @param names [Array<Symbol>] Names of returns to remove
+      #
+      # @example
+      #   remove_returns :old_return
+      #
+      # @rbs (*Symbol names) -> void
+      def remove_returns(*names)
+        settings[:returns] -= names.map(&:to_sym)
+      end
+      alias remove_return remove_returns
+
       # @return [Hash] Hash of attribute names to their configurations
       #
       # @example

data/lib/cmdx/version.rb

@@ -5,6 +5,6 @@ module CMDx
   # @return [String] the version of the CMDx gem
   #
   # @rbs return: String
-  VERSION = "1.16.0"
+  VERSION = "1.17.0"
 
 end

data/lib/locales/af.yml

@@ -1,13 +1,15 @@
 af:
   cmdx:
     attributes:
-      required: "moet toeganklik wees via die bron"
+      required: "moet toeganklik wees via die %{method} bronmetode"
       undefined: "delegeer na ongedefinieerde metode %{method}"
     coercions:
       into_a: "kon nie na %{type} omskep word nie"
       into_an: "kon nie na %{type} omskep word nie"
       into_any: "kon nie na een van: %{types} omskep word nie"
       unknown: "onbekende %{type} omskep tipe"
+    returns:
+      missing: "moet in die konteks gestel word"
     faults:
       invalid: "Ongeldig"
       unspecified: "Ongespesifiseer"

data/lib/locales/ar.yml

@@ -1,13 +1,15 @@
 ar:
   cmdx:
     attributes:
-      required: "يجب أن يكون قابلاً للوصول عبر المصدر"
+      required: "يجب أن يكون قابلاً للوصول عبر طريقة المصدر %{method}"
       undefined: "يفوض إلى طريقة غير معرفة %{method}"
     coercions:
       into_a: "لا يمكن تحويله إلى %{type}"
       into_an: "لا يمكن تحويله إلى %{type}"
       into_any: "لا يمكن تحويله إلى واحد من: %{types}"
       unknown: "نوع تحويل %{type} غير معروف"
+    returns:
+      missing: "يجب تعيينه في السياق"
     faults:
       invalid: "غير صالح"
       unspecified: "غير محدد"

data/lib/locales/az.yml

@@ -1,13 +1,15 @@
 az:
   cmdx:
     attributes:
-      required: "mənbə vasitəsilə əlçatan olmalıdır"
+      required: "%{method} mənbə metodu vasitəsilə əlçatan olmalıdır"
       undefined: "müəyyən edilməmiş metoda %{method} təyin edir"
     coercions:
       into_a: "%{type} tipinə çevrilə bilmədi"
       into_an: "%{type} tipinə çevrilə bilmədi"
       into_any: "aşağıdakılardan birinə çevrilə bilmədi: %{types}"
       unknown: "naməlum %{type} çevrilmə tipi"
+    returns:
+      missing: "kontekstdə təyin edilməlidir"
     faults:
       invalid: "Etibarsız"
       unspecified: "Göstərilməyib"

data/lib/locales/be.yml

@@ -1,13 +1,15 @@
 be:
   cmdx:
     attributes:
-      required: "павінна быць даступна праз крыніцу"
+      required: "павінен быць даступны праз зыходны метад %{method}"
       undefined: "дэлегуе невызначанаму метаду %{method}"
     coercions:
       into_a: "не ўдалося пераўтварыць у %{type}"
       into_an: "не ўдалося пераўтварыць у %{type}"
       into_any: "не ўдалося пераўтварыць у адзін з: %{types}"
       unknown: "невядомы тып пераўтварэння %{type}"
+    returns:
+      missing: "павінна быць усталявана ў кантэксце"
     faults:
       invalid: "Няправільныя"
       unspecified: "Не паказана"

data/lib/locales/bg.yml

@@ -1,13 +1,15 @@
 bg:
   cmdx:
     attributes:
-      required: "трябва да бъде достъпен чрез източника"
+      required: "трябва да е достъпен чрез изходния метод %{method}"
       undefined: "делегира към недефиниран метод %{method}"
     coercions:
       into_a: "не може да бъде преобразуван в %{type}"
       into_an: "не може да бъде преобразуван в %{type}"
       into_any: "не може да бъде преобразуван в един от: %{types}"
       unknown: "неизвестен тип преобразуване %{type}"
+    returns:
+      missing: "трябва да бъде зададено в контекста"
     faults:
       invalid: "Невалидни"
       unspecified: "Не е посочена"

data/lib/locales/bn.yml

@@ -1,13 +1,15 @@
 bn:
   cmdx:
     attributes:
-      required: "উৎসের মাধ্যমে অ্যাক্সেসযোগ্য হতে হবে"
+      required: "%{method} সোর্স মেথডের মাধ্যমে অ্যাক্সেসযোগ্য হতে হবে"
       undefined: "অসংজ্ঞায়িত পদ্ধতিতে %{method} অর্পণ করে"
     coercions:
       into_a: "%{type} এ রূপান্তর করা যায়নি"
       into_an: "%{type} এ রূপান্তর করা যায়নি"
       into_any: "নিম্নলিখিতগুলির মধ্যে একটিতে রূপান্তর করা যায়নি: %{types}"
       unknown: "অজানা %{type} রূপান্তর প্রকার"
+    returns:
+      missing: "প্রসঙ্গে সেট করতে হবে"
     faults:
       invalid: "অবৈধ"
       unspecified: "অনির্দিষ্ট"

data/lib/locales/bs.yml

@@ -1,13 +1,15 @@
 bs:
   cmdx:
     attributes:
-      required: "mora biti dostupan kroz izvor"
+      required: "mora biti dostupan preko izvorne metode %{method}"
       undefined: "delegira nedefiniranoj metodi %{method}"
     coercions:
       into_a: "nije mogao biti pretvoren u %{type}"
       into_an: "nije mogao biti pretvoren u %{type}"
       into_any: "nije mogao biti pretvoren u jedan od: %{types}"
       unknown: "nepoznati tip pretvorbe %{type}"
+    returns:
+      missing: "mora biti postavljeno u kontekstu"
     faults:
       invalid: "Neispravni"
       unspecified: "Nije naveden"

data/lib/locales/ca.yml

@@ -1,13 +1,15 @@
 ca:
   cmdx:
     attributes:
-      required: "ha de ser accessible a través de la font"
+      required: "ha de ser accessible mitjançant el mètode font %{method}"
       undefined: "delega al mètode no definit %{method}"
     coercions:
       into_a: "no es va poder convertir a %{type}"
       into_an: "no es va poder convertir a %{type}"
       into_any: "no es va poder convertir a un de: %{types}"
       unknown: "tipus de conversió %{type} desconegut"
+    returns:
+      missing: "ha de ser establert en el context"
     faults:
       invalid: "No vàlides"
       unspecified: "No especificat"

data/lib/locales/cnr.yml

@@ -1,13 +1,15 @@
 cnr:
   cmdx:
     attributes:
-      required: "mora biti dostupan preko izvora"
+      required: "mora biti dostupan preko izvorne metode %{method}"
       undefined: "delegira na nedefinisani metod %{method}"
     coercions:
       into_a: "nije mogao konvertovati u %{type}"
       into_an: "nije mogao konvertovati u %{type}"
       into_any: "nije mogao konvertovati u jedan od: %{types}"
       unknown: "nepoznati %{type} tip konverzije"
+    returns:
+      missing: "mora biti postavljeno u kontekstu"
     faults:
       invalid: "Neispravni"
       unspecified: "Nije dat"

data/lib/locales/cs.yml

@@ -1,13 +1,15 @@
 cs:
   cmdx:
     attributes:
-      required: "musí být přístupné přes zdroj"
+      required: "musí být přístupné přes zdrojovou metodu %{method}"
       undefined: "deleguje na nedefinovanou metodu %{method}"
     coercions:
       into_a: "nelze převést na %{type}"
       into_an: "nelze převést na %{type}"
       into_any: "nelze převést na jeden z: %{types}"
       unknown: "neznámý typ převodu %{type}"
+    returns:
+      missing: "musí být nastaveno v kontextu"
     faults:
       invalid: "Neplatné"
       unspecified: "Neurčeno"

data/lib/locales/cy.yml

@@ -1,13 +1,15 @@
 cy:
   cmdx:
     attributes:
-      required: "rhaid iddo fod yn hygyrch drwy'r ffynhonnell"
+      required: "rhaid bod yn hygyrch trwy'r dull ffynhonnell %{method}"
       undefined: "delegio i'r dull amhendant %{method}"
     coercions:
       into_a: "ni allwyd ei drawsnewid i %{type}"
       into_an: "ni allwyd ei drawsnewid i %{type}"
       into_any: "ni allwyd ei drawsnewid i un o: %{types}"
       unknown: "math anhysbys o drawsnewid %{type}"
+    returns:
+      missing: "rhaid ei osod yn y cyd-destun"
     faults:
       invalid: "Annilys"
       unspecified: "Anhebgor"

data/lib/locales/da.yml

@@ -1,13 +1,15 @@
 da:
   cmdx:
     attributes:
-      required: "skal være tilgængelig via kilden"
+      required: "skal være tilgængelig via %{method} kildemetoden"
       undefined: "delegerer til udefineret metode %{method}"
     coercions:
       into_a: "kunne ikke konverteres til %{type}"
       into_an: "kunne ikke konverteres til %{type}"
       into_any: "kunne ikke konverteres til en af: %{types}"
       unknown: "ukendt %{type} konverteringstype"
+    returns:
+      missing: "skal være sat i konteksten"
     faults:
       invalid: "Ugyldige"
       unspecified: "Uspecificeret"

data/lib/locales/de.yml

@@ -1,13 +1,15 @@
 de:
   cmdx:
     attributes:
-      required: "muss über die Quelle zugänglich sein"
+      required: "muss über die Quellmethode %{method} zugänglich sein"
       undefined: "delegiert an undefinierte Methode %{method}"
     coercions:
       into_a: "konnte nicht in %{type} umgewandelt werden"
       into_an: "konnte nicht in %{type} umgewandelt werden"
       into_any: "konnte nicht in einen von: %{types} umgewandelt werden"
       unknown: "unbekannter %{type} Umwandlungstyp"
+    returns:
+      missing: "muss im Kontext gesetzt sein"
     faults:
       invalid: "Ungültig"
       unspecified: "Nicht angegeben"

data/lib/locales/dz.yml

@@ -1,13 +1,15 @@
 dz:
   cmdx:
     attributes:
-      required: "ཁུངས་ཆུང་བརྒྱུད་ནས་འཇུག་ཆོག་པ་ཆེད་དགོས་པ་ཡིན།"
+      required: "%{method} གི་འབྱུང་ཁུངས་ཐབས་ལམ་བརྒྱུད་དེ་འཛུལ་སྤྱོད་འབད་ཚུགསཔ་དགོ།"
       undefined: "ཚད་མ་ཆག་པའི་ཐབས་ལམ་ %{method} ལ་ཆ་རྐྱེན་བྱེད།"
     coercions:
       into_a: "%{type} ལ་བསྒྱུར་མ་ཐུབ།"
       into_an: "%{type} ལ་བསྒྱུར་མ་ཐུབ།"
       into_any: "འདི་ཚོའི་ནང་ནས་གཅིག་ལ་བསྒྱུར་མ་ཐུབ། %{types}"
       unknown: "མ་ཤེས་པའི་ %{type} བསྒྱུར་པའི་རིགས།"
+    returns:
+      missing: "སྐབས་དོན་ནང་བཀོད་དགོས"
     faults:
       invalid: "ཆ་རྐྱེན་མི་ཆོག"
       unspecified: "མ་བཟུང་།"

data/lib/locales/el.yml

@@ -1,13 +1,15 @@
 el:
   cmdx:
     attributes:
-      required: "πρέπει να είναι προσβάσιμο μέσω της πηγής"
+      required: "πρέπει να είναι προσβάσιμο μέσω της μεθόδου πηγής %{method}"
       undefined: "αντιπροσωπεύει απροσδιόριστη μέθοδο %{method}"
     coercions:
       into_a: "δεν μπόρεσε να μετατραπεί σε %{type}"
       into_an: "δεν μπόρεσε να μετατραπεί σε %{type}"
       into_any: "δεν μπόρεσε να μετατραπεί σε ένα από: %{types}"
       unknown: "άγνωστος τύπος μετατροπής %{type}"
+    returns:
+      missing: "πρέπει να οριστεί στο πλαίσιο"
     faults:
       invalid: "Μη έγκυρες"
       unspecified: "Απροσδιόριστο"

data/lib/locales/en.yml

@@ -1,7 +1,7 @@
 en:
   cmdx:
     attributes:
-      required: "must be accessible via the source"
+      required: "must be accessible via the %{method} source method"
       undefined: "delegates to undefined method %{method}"
     coercions:
       into_a: "could not coerce into a %{type}"
@@ -11,6 +11,8 @@ en:
     faults:
       invalid: "Invalid"
       unspecified: "Unspecified"
+    returns:
+      missing: "must be set in the context"
     types:
       array: "array"
       big_decimal: "big decimal"

data/lib/locales/eo.yml

@@ -1,13 +1,15 @@
 eo:
   cmdx:
     attributes:
-      required: "devas esti alirebla tra la fonto"
+      required: "devas esti alirebla per la fontmetodo %{method}"
       undefined: "delegas al nedifinita metodo %{method}"
     coercions:
       into_a: "ne povis esti konvertita al %{type}"
       into_an: "ne povis esti konvertita al %{type}"
       into_any: "ne povis esti konvertita al unu el: %{types}"
       unknown: "nekonata %{type} konverta tipo"
+    returns:
+      missing: "devas esti agordita en la kunteksto"
     faults:
       invalid: "Nevalidaj"
       unspecified: "Nespecifita"

data/lib/locales/es.yml

@@ -1,13 +1,15 @@
 es:
   cmdx:
     attributes:
-      required: "debe ser accesible a través de la fuente"
+      required: "debe ser accesible a través del método de origen %{method}"
       undefined: "delega a método indefinido %{method}"
     coercions:
       into_a: "no se pudo convertir en un %{type}"
       into_an: "no se pudo convertir en un %{type}"
       into_any: "no se pudo convertir en uno de: %{types}"
       unknown: "tipo de conversión %{type} desconocido"
+    returns:
+      missing: "debe estar establecido en el contexto"
     faults:
       invalid: "Inválidas"
       unspecified: "No especificada"

data/lib/locales/et.yml

@@ -1,13 +1,15 @@
 et:
   cmdx:
     attributes:
-      required: "peab olema kättesaadav läbi allika"
+      required: "peab olema juurdepääsetav lähtemeetodi %{method} kaudu"
       undefined: "delegeerib määramata meetodile %{method}"
     coercions:
       into_a: "ei õnnestunud teisendada %{type} tüübiks"
       into_an: "ei õnnestunud teisendada %{type} tüübiks"
       into_any: "ei õnnestunud teisendada üheks järgmistest: %{types}"
       unknown: "tundmatu %{type} teisendustüüp"
+    returns:
+      missing: "peab olema kontekstis määratud"
     faults:
       invalid: "Kehtetud"
       unspecified: "Määramata"

data/lib/locales/eu.yml

@@ -1,13 +1,15 @@
 eu:
   cmdx:
     attributes:
-      required: "iturriaren bidez eskuragarri izan behar du"
+      required: "eskuragarri egon behar du %{method} iturburu-metodoaren bidez"
       undefined: "metodo zehaztugabea %{method} delegatzen du"
     coercions:
       into_a: "ezin izan da %{type} ra bihurtu"
       into_an: "ezin izan da %{type} ra bihurtu"
       into_any: "ezin izan da honetako batera bihurtu: %{types}"
       unknown: "%{type} bihurtze mota ezezaguna"
+    returns:
+      missing: "testuinguruan ezarrita egon behar du"
     faults:
       invalid: "Baliogabeak"
       unspecified: "Zehaztu gabe"

data/lib/locales/fa.yml

@@ -1,13 +1,15 @@
 fa:
   cmdx:
     attributes:
-      required: "باید از طریق منبع قابل دسترسی باشد"
+      required: "باید از طریق متد منبع %{method} قابل دسترسی باشد"
       undefined: "به متد تعریف نشده %{method} واگذار می‌کند"
     coercions:
       into_a: "نمی‌تواند به %{type} تبدیل شود"
       into_an: "نمی‌تواند به %{type} تبدیل شود"
       into_any: "نمی‌تواند به یکی از اینها تبدیل شود: %{types}"
       unknown: "نوع تبدیل %{type} ناشناخته"
+    returns:
+      missing: "باید در زمینه تنظیم شود"
     faults:
       invalid: "نامعتبر"
       unspecified: "نامشخص"