cmdx 0.5.0 → 1.0.1

data/lib/generators/cmdx/task_generator.rb

@@ -1,13 +1,54 @@
 # frozen_string_literal: true
 
 module Cmdx
+  ##
+  # Rails generator for creating CMDx task classes.
+  #
+  # This generator creates individual task files that encapsulate specific
+  # business logic operations. Tasks inherit from CMDx::Task and provide
+  # parameter validation, callbacks, result tracking, and error handling
+  # capabilities for focused business operations.
+  #
+  # The generator handles name normalization, ensuring "Task" suffix
+  # and proper file naming conventions. Generated tasks inherit from
+  # ApplicationTask when available, falling back to CMDx::Task.
+  #
+  # @example Generate a task
+  #   rails generate cmdx:task SendEmail
+  #   rails generate cmdx:task ProcessPayment
+  #   rails generate cmdx:task ProcessPaymentTask  # "Task" suffix preserved
+  #
+  # @example Generated file location
+  #   app/cmds/send_email_task.rb
+  #   app/cmds/process_payment_task.rb
+  #
+  # @since 1.0.0
   class TaskGenerator < Rails::Generators::NamedBase
 
     source_root File.expand_path("templates", __dir__)
     check_class_collision suffix: "Task"
 
-    desc "Generates a task with the given NAME (if one does not exist)."
+    desc "Creates a task with the given NAME"
 
+    ##
+    # Copies the task template to the application commands directory.
+    #
+    # Creates a new task file in `app/cmds/` with the normalized name.
+    # The generator automatically handles:
+    # - Removing "Task" suffix from file naming
+    # - Converting to snake_case for file naming
+    # - Adding "_task" suffix to the filename
+    # - Setting up proper class inheritance
+    #
+    # @return [void]
+    # @raise [Thor::Error] if the destination file cannot be created
+    #
+    # @example Generated task structure
+    #   class SendEmailTask < ApplicationTask
+    #     def call
+    #       # Task business logic
+    #     end
+    #   end
     def copy_files
       name = file_name.sub(/_?task$/i, "")
       path = File.join("app/cmds", class_path, "#{name}_task.rb")
@@ -16,10 +57,37 @@ module Cmdx
 
     private
 
+    ##
+    # Normalizes the class name by ensuring "Task" suffix.
+    #
+    # Ensures consistent class naming by adding "Task" suffix if not
+    # already present, allowing users to specify either "SendEmail"
+    # or "SendEmailTask".
+    #
+    # @return [String] the normalized class name with "Task" suffix
+    #
+    # @example Class name normalization
+    #   # Input: "SendEmail"
+    #   # Output: "SendEmailTask"
+    #
+    #   # Input: "SendEmailTask"
+    #   # Output: "SendEmailTask"
     def class_name
       @class_name ||= super.end_with?("Task") ? super : "#{super}Task"
     end
 
+    ##
+    # Determines the parent class for the generated task.
+    #
+    # Attempts to use ApplicationTask as the parent class if available,
+    # falling back to CMDx::Task if ApplicationTask is not defined.
+    # This allows applications to define custom base task behavior.
+    #
+    # @return [String] the parent class name to inherit from
+    #
+    # @example Parent class resolution
+    #   # If ApplicationTask exists: "ApplicationTask"
+    #   # If ApplicationTask missing: "CMDx::Task"
     def parent_class_name
       ApplicationTask
     rescue StandardError

data/lib/generators/cmdx/templates/install.rb

@@ -1,23 +1,51 @@
 # frozen_string_literal: true
 
 CMDx.configure do |config|
-  # Define which statuses a bang `call!` will halt and raise a fault.
-  # This option can accept an array of statuses.
-  config.task_halt = CMDx::Result::FAILED
+  # Task halt configuration - controls when call! raises faults
+  # See https://github.com/drexed/cmdx/blob/main/docs/outcomes/statuses.md for more details
+  #
+  # Available statuses: "success", "skipped", "failed"
+  # If set to an empty array, task will never halt
+  config.task_halt = %w[failed]
 
-  # Enable task timeouts to prevent call execution beyond a defined threshold.
-  config.task_timeout = nil
+  # Workflow halt configuration - controls when workflows stop execution
+  # When a task returns these statuses, subsequent workflow tasks won't execute
+  # See https://github.com/drexed/cmdx/blob/main/docs/workflow.md for more details
+  #
+  # Available statuses: "success", "skipped", "failed"
+  # If set to an empty array, workflow will never halt
+  config.workflow_halt = %w[failed]
 
-  # Define which statuses a batch task will halt execution from proceeding to the next step.
-  # By default skipped tasks are treated as a NOOP so processing is continued.
-  # This option can accept an array of statuses.
-  config.batch_halt = CMDx::Result::FAILED
+  # Logger configuration - choose from multiple formatters
+  # See https://github.com/drexed/cmdx/blob/main/docs/logging.md for more details
+  #
+  # Available formatters:
+  # - CMDx::LogFormatters::Line
+  # - CMDx::LogFormatters::PrettyLine
+  # - CMDx::LogFormatters::Json
+  # - CMDx::LogFormatters::PrettyJson
+  # - CMDx::LogFormatters::KeyValue
+  # - CMDx::LogFormatters::PrettyKeyValue
+  # - CMDx::LogFormatters::Logstash
+  # - CMDx::LogFormatters::Raw
+  config.logger = Logger.new($stdout, formatter: CMDx::LogFormatters::Line.new)
 
-  # Enable batch timeouts to prevent call execution beyond a defined threshold.
-  # TIP: remember to account for all defined tasks when setting this value
-  config.batch_timeout = nil
+  # Global middlewares - automatically applied to all tasks
+  # See https://github.com/drexed/cmdx/blob/main/docs/middlewares.md for more details
+  #
+  # config.middlewares.use CMDx::Middlewares::Timeout, seconds: 30
+  # config.middlewares.use CMDx::Middlewares::Correlate
+  # config.middlewares.use CustomAuthMiddleware, role: "admin"
+  # config.middlewares.use PerformanceMiddleware.new(threshold: 5.0)
 
-  # A list of available log formatter can be found at:
-  # https://github.com/drexed/cmdx/tree/main/lib/cmdx/log_formatters
-  config.logger = Logger.new($stdout, formatter: CMDx::LogFormatters::Line.new)
+  # Global callbacks - automatically applied to all tasks
+  # See https://github.com/drexed/cmdx/blob/main/docs/callbacks.md for more details
+  #
+  # config.callbacks.register :before_execution, :log_task_start
+  # config.callbacks.register :after_execution, :log_task_end
+  # config.callbacks.register :on_success, NotificationCallback.new([:email])
+  # config.callbacks.register :on_failure, :alert_support, if: :critical?
+  # config.callbacks.register :on_complete, proc { |task, callback_type|
+  #   Metrics.increment("task.#{task.class.name.underscore}.completed")
+  # }
 end

data/lib/generators/cmdx/workflow_generator.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module Cmdx
+  ##
+  # Rails generator for creating CMDx workflow task classes.
+  #
+  # This generator creates workflow task files that coordinate multiple
+  # individual tasks in a structured workflow. Workflow tasks inherit
+  # from CMDx::Workflow and provide orchestration capabilities for
+  # complex business processes.
+  #
+  # The generator handles name normalization, ensuring proper file naming
+  # conventions and class names. Generated workflow tasks inherit from
+  # ApplicationWorkflow when available, falling back to CMDx::Workflow.
+  #
+  # @example Generate a workflow task
+  #   rails generate cmdx:workflow OrderProcessing
+  #   rails generate cmdx:workflow PaymentWorkflow  # "Workflow" suffix preserved
+  #
+  # @example Generated file location
+  #   app/cmds/order_processing_workflow.rb
+  #   app/cmds/payment_workflow.rb
+  #
+  # @example Generated class structure
+  #   class OrderProcessingWorkflow < ApplicationWorkflow
+  #     def call
+  #       # Workflow orchestration logic
+  #     end
+  #   end
+  #
+  # @see CMDx::Workflow Base workflow class
+  # @see Rails::Generators::NamedBase Rails generator base class
+  # @since 1.0.0
+  class WorkflowGenerator < Rails::Generators::NamedBase
+
+    source_root File.expand_path("templates", __dir__)
+    check_class_collision suffix: "Workflow"
+
+    desc "Creates a workflow with the given NAME"
+
+    ##
+    # Copies the workflow task template to the application commands directory.
+    #
+    # Creates a new workflow task file in `app/cmds/` with the normalized
+    # name. The generator automatically handles:
+    # - Removing "workflow" suffix from the provided name for filename
+    # - Converting to snake_case for file naming
+    # - Adding "_workflow" suffix to the filename
+    # - Setting up proper class inheritance
+    # - Ensuring class names end with "Workflow"
+    #
+    # @return [void]
+    # @raise [Thor::Error] if the destination file cannot be created
+    #
+    # @example File generation
+    #   # Input: rails generate cmdx:workflow OrderProcessing
+    #   # Creates: app/cmds/order_processing_workflow.rb
+    #   # Class: OrderProcessingWorkflow
+    #
+    #   # Input: rails generate cmdx:workflow PaymentWorkflow
+    #   # Creates: app/cmds/payment_workflow.rb
+    #   # Class: PaymentWorkflow
+    def copy_files
+      name = file_name.sub(/_?workflow$/i, "")
+      path = File.join("app/cmds", class_path, "#{name}_workflow.rb")
+      template("workflow.rb.tt", path)
+    end
+
+    private
+
+    ##
+    # Normalizes the class name by ensuring it ends with "Workflow".
+    #
+    # Ensures consistent class naming by appending "Workflow" suffix
+    # to the provided generator name if it doesn't already end with it,
+    # allowing users to specify either "OrderProcessing" or "OrderProcessingWorkflow".
+    #
+    # @return [String] the normalized class name with "Workflow" suffix
+    #
+    # @example Class name normalization
+    #   # Input: "OrderProcessing"
+    #   # Output: "OrderProcessingWorkflow"
+    #
+    #   # Input: "PaymentWorkflow"
+    #   # Output: "PaymentWorkflow"
+    def class_name
+      @class_name ||= super.end_with?("Workflow") ? super : "#{super}Workflow"
+    end
+
+    ##
+    # Determines the parent class for the generated workflow task.
+    #
+    # Attempts to use ApplicationWorkflow as the parent class if available,
+    # falling back to CMDx::Workflow if ApplicationWorkflow is not defined.
+    # This allows applications to define custom base workflow behavior.
+    #
+    # @return [String] the parent class name to inherit from
+    #
+    # @example Parent class resolution
+    #   # If ApplicationWorkflow exists: "ApplicationWorkflow"
+    #   # If ApplicationWorkflow missing: "CMDx::Workflow"
+    def parent_class_name
+      ApplicationWorkflow
+    rescue StandardError
+      CMDx::Workflow
+    end
+
+  end
+end

data/lib/locales/ar.yml

@@ -0,0 +1,36 @@
+ar:
+  cmdx:
+    coercions:
+      into_a: "لا يمكن تحويل إلى %{type}"
+      into_an: "لا يمكن تحويل إلى %{type}"
+      into_any: "لا يمكن تحويل إلى أي من: %{values}"
+      unknown: "نوع التحويل %{type} غير معروف"
+    faults:
+      unspecified: "لم يتم تحديد سبب"
+    parameters:
+      required: "معامل مطلوب"
+      undefined: "يفوض لطريقة غير معرفة %{source}"
+    validators:
+      custom: "غير صالح"
+      exclusion:
+        of: "يجب ألا يكون أحد: %{values}"
+        within: "يجب ألا يكون بين %{min} و %{max}"
+      format: "له تنسيق غير صالح"
+      inclusion:
+        of: "يجب أن يكون أحد: %{values}"
+        within: "يجب أن يكون بين %{min} و %{max}"
+      length:
+        is: "يجب أن يكون الطول %{is}"
+        is_not: "يجب ألا يكون الطول %{is_not}"
+        min: "يجب أن يكون الطول على الأقل %{min}"
+        max: "يجب أن يكون الطول على الأكثر %{max}"
+        not_within: "يجب ألا يكون الطول بين %{min} و %{max}"
+        within: "يجب أن يكون الطول بين %{min} و %{max}"
+      numeric:
+        is: "يجب أن يكون %{is}"
+        is_not: "يجب ألا يكون %{is_not}"
+        min: "يجب أن يكون على الأقل %{min}"
+        max: "يجب أن يكون على الأكثر %{max}"
+        not_within: "يجب ألا يكون بين %{min} و %{max}"
+        within: "يجب أن يكون بين %{min} و %{max}"
+      presence: "لا يمكن أن يكون فارغاً"

data/lib/locales/cs.yml

@@ -0,0 +1,36 @@
+cs:
+  cmdx:
+    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: %{values}"
+      unknown: "neznámý typ převodu %{type}"
+    faults:
+      unspecified: "nebyl uveden důvod"
+    parameters:
+      required: "je povinný parametr"
+      undefined: "deleguje na nedefinovanou metodu %{source}"
+    validators:
+      custom: "není platný"
+      exclusion:
+        of: "nesmí být jeden z: %{values}"
+        within: "nesmí být mezi %{min} a %{max}"
+      format: "má neplatný formát"
+      inclusion:
+        of: "musí být jeden z: %{values}"
+        within: "musí být mezi %{min} a %{max}"
+      length:
+        is: "délka musí být %{is}"
+        is_not: "délka nesmí být %{is_not}"
+        min: "délka musí být alespoň %{min}"
+        max: "délka může být nejvýše %{max}"
+        not_within: "délka nesmí být mezi %{min} a %{max}"
+        within: "délka musí být mezi %{min} a %{max}"
+      numeric:
+        is: "musí být %{is}"
+        is_not: "nesmí být %{is_not}"
+        min: "musí být alespoň %{min}"
+        max: "může být nejvýše %{max}"
+        not_within: "nesmí být mezi %{min} a %{max}"
+        within: "musí být mezi %{min} a %{max}"
+      presence: "nemůže být prázdný"

data/lib/locales/da.yml

@@ -0,0 +1,36 @@
+da:
+  cmdx:
+    coercions:
+      into_a: "kunne ikke konvertere til en %{type}"
+      into_an: "kunne ikke konvertere til en %{type}"
+      into_any: "kunne ikke konvertere til en af: %{values}"
+      unknown: "ukendt %{type} konverteringstype"
+    faults:
+      unspecified: "ingen grund angivet"
+    parameters:
+      required: "er en påkrævet parameter"
+      undefined: "delegerer til udefineret metode %{source}"
+    validators:
+      custom: "er ikke gyldig"
+      exclusion:
+        of: "må ikke være en af: %{values}"
+        within: "må ikke være mellem %{min} og %{max}"
+      format: "har et ugyldigt format"
+      inclusion:
+        of: "skal være en af: %{values}"
+        within: "skal være mellem %{min} og %{max}"
+      length:
+        is: "længde skal være %{is}"
+        is_not: "længde må ikke være %{is_not}"
+        min: "længde skal være mindst %{min}"
+        max: "længde må være højst %{max}"
+        not_within: "længde må ikke være mellem %{min} og %{max}"
+        within: "længde skal være mellem %{min} og %{max}"
+      numeric:
+        is: "skal være %{is}"
+        is_not: "må ikke være %{is_not}"
+        min: "skal være mindst %{min}"
+        max: "må være højst %{max}"
+        not_within: "må ikke være mellem %{min} og %{max}"
+        within: "skal være mellem %{min} og %{max}"
+      presence: "kan ikke være tom"

data/lib/locales/de.yml

@@ -0,0 +1,36 @@
+de:
+  cmdx:
+    coercions:
+      into_a: "konnte nicht in einen %{type} konvertiert werden"
+      into_an: "konnte nicht in einen %{type} konvertiert werden"
+      into_any: "konnte nicht in einen von: %{values} konvertiert werden"
+      unknown: "unbekannter %{type} Konvertierungstyp"
+    faults:
+      unspecified: "kein Grund angegeben"
+    parameters:
+      required: "ist ein erforderlicher Parameter"
+      undefined: "delegiert an undefinierte Methode %{source}"
+    validators:
+      custom: "ist nicht gültig"
+      exclusion:
+        of: "darf nicht einer von: %{values} sein"
+        within: "darf nicht zwischen %{min} und %{max} liegen"
+      format: "hat ein ungültiges Format"
+      inclusion:
+        of: "muss einer von: %{values} sein"
+        within: "muss zwischen %{min} und %{max} liegen"
+      length:
+        is: "Länge muss %{is} sein"
+        is_not: "Länge darf nicht %{is_not} sein"
+        min: "Länge muss mindestens %{min} sein"
+        max: "Länge darf höchstens %{max} sein"
+        not_within: "Länge darf nicht zwischen %{min} und %{max} liegen"
+        within: "Länge muss zwischen %{min} und %{max} liegen"
+      numeric:
+        is: "muss %{is} sein"
+        is_not: "darf nicht %{is_not} sein"
+        min: "muss mindestens %{min} sein"
+        max: "darf höchstens %{max} sein"
+        not_within: "darf nicht zwischen %{min} und %{max} liegen"
+        within: "muss zwischen %{min} und %{max} liegen"
+      presence: "kann nicht leer sein"

data/lib/locales/el.yml

@@ -0,0 +1,36 @@
+el:
+  cmdx:
+    coercions:
+      into_a: "δεν ήταν δυνατή η μετατροπή σε %{type}"
+      into_an: "δεν ήταν δυνατή η μετατροπή σε %{type}"
+      into_any: "δεν ήταν δυνατή η μετατροπή σε κανένα από: %{values}"
+      unknown: "άγνωστος τύπος μετατροπής %{type}"
+    faults:
+      unspecified: "δεν δόθηκε λόγος"
+    parameters:
+      required: "είναι υποχρεωτική παράμετρος"
+      undefined: "αναθέτει σε μη ορισμένη μέθοδο %{source}"
+    validators:
+      custom: "δεν είναι έγκυρο"
+      exclusion:
+        of: "δεν πρέπει να είναι ένα από: %{values}"
+        within: "δεν πρέπει να είναι μεταξύ %{min} και %{max}"
+      format: "έχει μη έγκυρη μορφή"
+      inclusion:
+        of: "πρέπει να είναι ένα από: %{values}"
+        within: "πρέπει να είναι μεταξύ %{min} και %{max}"
+      length:
+        is: "το μήκος πρέπει να είναι %{is}"
+        is_not: "το μήκος δεν πρέπει να είναι %{is_not}"
+        min: "το μήκος πρέπει να είναι τουλάχιστον %{min}"
+        max: "το μήκος πρέπει να είναι το πολύ %{max}"
+        not_within: "το μήκος δεν πρέπει να είναι μεταξύ %{min} και %{max}"
+        within: "το μήκος πρέπει να είναι μεταξύ %{min} και %{max}"
+      numeric:
+        is: "πρέπει να είναι %{is}"
+        is_not: "δεν πρέπει να είναι %{is_not}"
+        min: "πρέπει να είναι τουλάχιστον %{min}"
+        max: "πρέπει να είναι το πολύ %{max}"
+        not_within: "δεν πρέπει να είναι μεταξύ %{min} και %{max}"
+        within: "πρέπει να είναι μεταξύ %{min} και %{max}"
+      presence: "δεν μπορεί να είναι κενό"

data/lib/locales/en.yml

@@ -6,31 +6,31 @@ en:
       into_any: "could not coerce into one of: %{values}"
       unknown: "unknown %{type} coercion type"
     faults:
-      unspecified: no reason given
+      unspecified: "no reason given"
     parameters:
-      required: is a required parameter
-      undefined: delegates to undefined method %{source}
+      required: "is a required parameter"
+      undefined: "delegates to undefined method %{source}"
     validators:
-      custom: is not valid
+      custom: "is not valid"
       exclusion:
         of: "must not be one of: %{values}"
-        within: must not be within %{min} and %{max}
-      format: is an invalid format
+        within: "must not be within %{min} and %{max}"
+      format: "is an invalid format"
       inclusion:
         of: "must be one of: %{values}"
-        within: must be within %{min} and %{max}
+        within: "must be within %{min} and %{max}"
       length:
-        is: length must be %{is}
-        is_not: length must not be %{is_not}
-        min: length must be at least %{min}
-        max: length must be at most %{max}
-        not_within: length must not be within %{min} and %{max}
-        within: length must be within %{min} and %{max}
+        is: "length must be %{is}"
+        is_not: "length must not be %{is_not}"
+        min: "length must be at least %{min}"
+        max: "length must be at most %{max}"
+        not_within: "length must not be within %{min} and %{max}"
+        within: "length must be within %{min} and %{max}"
       numeric:
-        is: must be %{is}
-        is_not: must not be %{is_not}
-        min: must be at least %{min}
-        max: must be at most %{max}
-        not_within: must not be within %{min} and %{max}
-        within: must be within %{min} and %{max}
-      presence: cannot be empty
+        is: "must be %{is}"
+        is_not: "must not be %{is_not}"
+        min: "must be at least %{min}"
+        max: "must be at most %{max}"
+        not_within: "must not be within %{min} and %{max}"
+        within: "must be within %{min} and %{max}"
+      presence: "cannot be empty"

data/lib/locales/es.yml

@@ -6,31 +6,31 @@ es:
       into_any: "no podía coacciona el valor a un: %{values}"
       unknown: "%{type} tipo de coacciona desconocido"
     faults:
-      unspecified: ninguna razón dada
+      unspecified: "ninguna razón dada"
     parameters:
-      required: es un parámetro requerido
-      undefined: delegado al método indefinido %{source}
+      required: "es un parámetro requerido"
+      undefined: "delegado al método indefinido %{source}"
     validators:
-      custom: no es válida
+      custom: "no es válida"
       exclusion:
         of: "no debe ser uno de: %{values}"
-        within: no debe estar dentro %{min} y %{max}
-      format: es un formato inválido
+        within: "no debe estar dentro %{min} y %{max}"
+      format: "es un formato inválido"
       inclusion:
         of: "debe ser uno de: %{values}"
-        within: debe estar dentro %{min} y %{max}
+        within: "debe estar dentro %{min} y %{max}"
       length:
-        is: tiene una longitud que debe ser %{is}
-        is_not: tiene una longitud no debe ser %{is}
-        min: tiene una longitud que debe ser menos de %{min}
-        max: tiene una longitud que debe ser mas de %{max}
-        not_within: tiene una longitud que no debe estar dentro %{min} y %{max}
-        within: tiene una longitud que debe estar dentro %{min} y %{max}
+        is: "tiene una longitud que debe ser %{is}"
+        is_not: "tiene una longitud no debe ser %{is}"
+        min: "tiene una longitud que debe ser menos de %{min}"
+        max: "tiene una longitud que debe ser mas de %{max}"
+        not_within: "tiene una longitud que no debe estar dentro %{min} y %{max}"
+        within: "tiene una longitud que debe estar dentro %{min} y %{max}"
       numeric:
-        is: debe ser %{is}
-        is_not: no debe ser %{is}
-        min: debe ser %{min} como minimo
-        max: debe ser %{max} como máximo
-        not_within: no debe estar dentro %{min} y %{max}
-        within: debe estar dentro %{min} y %{max}
-      presence: no puede estar vacío
+        is: "debe ser %{is}"
+        is_not: "no debe ser %{is}"
+        min: "debe ser %{min} como minimo"
+        max: "debe ser %{max} como máximo"
+        not_within: "no debe estar dentro %{min} y %{max}"
+        within: "debe estar dentro %{min} y %{max}"
+      presence: "no puede estar vacío"

data/lib/locales/fi.yml

@@ -0,0 +1,36 @@
+fi:
+  cmdx:
+    coercions:
+      into_a: "ei voitu muuntaa tyypiksi %{type}"
+      into_an: "ei voitu muuntaa tyypiksi %{type}"
+      into_any: "ei voitu muuntaa yhteenkään seuraavista: %{values}"
+      unknown: "tuntematon %{type} muunnostyyppi"
+    faults:
+      unspecified: "syytä ei annettu"
+    parameters:
+      required: "on pakollinen parametri"
+      undefined: "delegoi määrittelemättömään metodiin %{source}"
+    validators:
+      custom: "ei ole kelvollinen"
+      exclusion:
+        of: "ei saa olla mikään seuraavista: %{values}"
+        within: "ei saa olla välillä %{min} ja %{max}"
+      format: "on virheellisessä muodossa"
+      inclusion:
+        of: "on oltava jokin seuraavista: %{values}"
+        within: "on oltava välillä %{min} ja %{max}"
+      length:
+        is: "pituuden on oltava %{is}"
+        is_not: "pituus ei saa olla %{is_not}"
+        min: "pituuden on oltava vähintään %{min}"
+        max: "pituus saa olla enintään %{max}"
+        not_within: "pituus ei saa olla välillä %{min} ja %{max}"
+        within: "pituuden on oltava välillä %{min} ja %{max}"
+      numeric:
+        is: "on oltava %{is}"
+        is_not: "ei saa olla %{is_not}"
+        min: "on oltava vähintään %{min}"
+        max: "saa olla enintään %{max}"
+        not_within: "ei saa olla välillä %{min} ja %{max}"
+        within: "on oltava välillä %{min} ja %{max}"
+      presence: "ei voi olla tyhjä"

data/lib/locales/fr.yml

@@ -0,0 +1,36 @@
+fr:
+  cmdx:
+    coercions:
+      into_a: "impossible de convertir en un %{type}"
+      into_an: "impossible de convertir en un %{type}"
+      into_any: "impossible de convertir en un de: %{values}"
+      unknown: "type de conversion %{type} inconnu"
+    faults:
+      unspecified: "aucune raison donnée"
+    parameters:
+      required: "est un paramètre obligatoire"
+      undefined: "délègue à une méthode indéfinie %{source}"
+    validators:
+      custom: "n'est pas valide"
+      exclusion:
+        of: "ne doit pas être un de: %{values}"
+        within: "ne doit pas être entre %{min} et %{max}"
+      format: "a un format invalide"
+      inclusion:
+        of: "doit être un de: %{values}"
+        within: "doit être entre %{min} et %{max}"
+      length:
+        is: "la longueur doit être %{is}"
+        is_not: "la longueur ne doit pas être %{is_not}"
+        min: "la longueur doit être au moins %{min}"
+        max: "la longueur doit être au maximum %{max}"
+        not_within: "la longueur ne doit pas être entre %{min} et %{max}"
+        within: "la longueur doit être entre %{min} et %{max}"
+      numeric:
+        is: "doit être %{is}"
+        is_not: "ne doit pas être %{is_not}"
+        min: "doit être au moins %{min}"
+        max: "doit être au maximum %{max}"
+        not_within: "ne doit pas être entre %{min} et %{max}"
+        within: "doit être entre %{min} et %{max}"
+      presence: "ne peut pas être vide"