cmdx 1.13.0 → 1.15.0

data/.rubocop.yml

@@ -1,95 +0,0 @@
-plugins:
-  - rubocop-performance
-  - rubocop-rake
-  - rubocop-rspec
-AllCops:
-  NewCops: enable
-  DisplayCopNames: true
-  DisplayStyleGuide: true
-  TargetRubyVersion: 3.1
-Gemspec/DevelopmentDependencies:
-  EnforcedStyle: gemspec
-Layout/EmptyLinesAroundAttributeAccessor:
-  Enabled: true
-Layout/EmptyLinesAroundClassBody:
-  EnforcedStyle: empty_lines_except_namespace
-Layout/EmptyLinesAroundModuleBody:
-  EnforcedStyle: empty_lines_except_namespace
-Layout/FirstHashElementIndentation:
-  EnforcedStyle: consistent
-Layout/LineLength:
-  Enabled: false
-Lint/MissingSuper:
-  Exclude:
-    - 'spec/**/**/*'
-Lint/ShadowedException:
-  Enabled: false
-Lint/UnusedMethodArgument:
-  Exclude:
-    - 'lib/cmdx/coercions/**/*'
-    - 'lib/cmdx/log_formatters/**/*'
-    - 'lib/cmdx/middlewares/**/*'
-    - 'lib/cmdx/validators/**/*'
-Metrics/AbcSize:
-  Enabled: false
-Metrics/BlockLength:
-  Enabled: false
-Metrics/ClassLength:
-  Enabled: false
-Metrics/CyclomaticComplexity:
-  Enabled: false
-Metrics/MethodLength:
-  Enabled: false
-Metrics/ModuleLength:
-  Enabled: false
-Metrics/PerceivedComplexity:
-  Enabled: false
-Naming/MethodParameterName:
-  Enabled: false
-RSpec/DescribeClass:
-  Exclude:
-    - 'spec/integrations/**/*'
-RSpec/ExampleLength:
-  Enabled: false
-RSpec/IndexedLet:
-  Enabled: false
-RSpec/MessageSpies:
-  EnforcedStyle: receive
-RSpec/MultipleExpectations:
-  Enabled: false
-RSpec/MultipleMemoizedHelpers:
-  Enabled: false
-RSpec/NestedGroups:
-  Enabled: false
-RSpec/SpecFilePathFormat:
-  CustomTransform:
-    CMDx: cmdx
-RSpec/SubjectStub:
-  Enabled: false
-RSpec/StubbedMock:
-  Enabled: false
-RSpec/VerifiedDoubleReference:
-  Enabled: false
-Style/ArgumentsForwarding:
-  Exclude:
-    - 'lib/cmdx/utils/call.rb'
-Style/CaseEquality:
-  Enabled: false
-Style/DocumentDynamicEvalDefinition:
-  Enabled: false
-Style/Documentation:
-  Enabled: false
-Style/DoubleNegation:
-  Enabled: false
-Style/FrozenStringLiteralComment:
-  Enabled: true
-  EnforcedStyle: always_true
-  SafeAutoCorrect: true
-Style/ModuleFunction:
-  EnforcedStyle: extend_self
-Style/OptionalBooleanParameter:
-  Enabled: false
-Style/StringConcatenation:
-  Enabled: false
-Style/StringLiterals:
-  EnforcedStyle: double_quotes

data/.ruby-version

@@ -1 +0,0 @@
-3.4.5

data/.yard-lint.yml

@@ -1,174 +0,0 @@
-# YARD-Lint Configuration
-# See https://github.com/mensfeld/yard-lint for documentation
-
-# Global settings for all validators
-AllValidators:
-  # YARD command-line options (applied to all validators by default)
-  YardOptions:
-    - --private
-    - --protected
-
-  # Global file exclusion patterns
-  Exclude:
-    - '\.git'
-    - 'vendor/**/*'
-    - 'node_modules/**/*'
-    - 'spec/**/*'
-    - 'test/**/*'
-
-  # Exit code behavior (error, warning, convention, never)
-  FailOnSeverity: warning
-
-  # Minimum documentation coverage percentage (0-100)
-  # Fails if coverage is below this threshold
-  # MinCoverage: 80.0
-
-  # Diff mode settings
-  DiffMode:
-    # Default base ref for --diff (auto-detects main/master if not specified)
-    DefaultBaseRef: ~
-
-# Documentation validators
-Documentation/UndocumentedObjects:
-  Description: 'Checks for classes, modules, and methods without documentation.'
-  Enabled: false
-  Severity: warning
-  ExcludedMethods:
-    - 'initialize/0'  # Exclude parameter-less initialize
-    - '/^_/'          # Exclude private methods (by convention)
-
-Documentation/UndocumentedMethodArguments:
-  Description: 'Checks for method parameters without @param tags.'
-  Enabled: true
-  Severity: warning
-
-Documentation/UndocumentedBooleanMethods:
-  Description: 'Checks that question mark methods document their boolean return.'
-  Enabled: true
-  Severity: warning
-
-Documentation/UndocumentedOptions:
-  Description: 'Detects methods with options hash parameters but no @option tags.'
-  Enabled: true
-  Severity: warning
-
-Documentation/MarkdownSyntax:
-  Description: 'Detects common markdown syntax errors in documentation.'
-  Enabled: true
-  Severity: warning
-
-# Tags validators
-Tags/Order:
-  Description: 'Enforces consistent ordering of YARD tags.'
-  Enabled: true
-  Severity: convention
-  EnforcedOrder:
-    - param
-    - option
-    - return
-    - raise
-    - example
-
-Tags/InvalidTypes:
-  Description: 'Validates type definitions in @param, @return, @option tags.'
-  Enabled: true
-  Severity: warning
-  ValidatedTags:
-    - param
-    - option
-    - return
-
-Tags/TypeSyntax:
-  Description: 'Validates YARD type syntax using YARD parser.'
-  Enabled: true
-  Severity: warning
-  ValidatedTags:
-    - param
-    - option
-    - return
-    - yieldreturn
-
-Tags/MeaninglessTag:
-  Description: 'Detects @param/@option tags on classes, modules, or constants.'
-  Enabled: true
-  Severity: warning
-  CheckedTags:
-    - param
-    - option
-  InvalidObjectTypes:
-    - class
-    - module
-    - constant
-
-Tags/CollectionType:
-  Description: 'Validates Hash collection syntax consistency.'
-  Enabled: true
-  Severity: convention
-  EnforcedStyle: long  # 'long' for Hash{K => V} (YARD standard), 'short' for {K => V}
-  ValidatedTags:
-    - param
-    - option
-    - return
-    - yieldreturn
-
-Tags/TagTypePosition:
-  Description: 'Validates type annotation position in tags.'
-  Enabled: true
-  Severity: convention
-  CheckedTags:
-    - param
-    - option
-  # EnforcedStyle: 'type_after_name' (YARD standard: @param name [Type])
-  #                or 'type_first' (@param [Type] name)
-  EnforcedStyle: type_after_name
-
-Tags/ApiTags:
-  Description: 'Enforces @api tags on public objects.'
-  Enabled: false  # Opt-in validator
-  Severity: warning
-  AllowedApis:
-    - public
-    - private
-    - internal
-
-Tags/OptionTags:
-  Description: 'Requires @option tags for methods with options parameters.'
-  Enabled: true
-  Severity: warning
-
-# Warnings validators - catches YARD parser errors
-Warnings/UnknownTag:
-  Description: 'Detects unknown YARD tags.'
-  Enabled: false
-  Severity: error
-
-Warnings/UnknownDirective:
-  Description: 'Detects unknown YARD directives.'
-  Enabled: true
-  Severity: error
-
-Warnings/InvalidTagFormat:
-  Description: 'Detects malformed tag syntax.'
-  Enabled: true
-  Severity: error
-
-Warnings/InvalidDirectiveFormat:
-  Description: 'Detects malformed directive syntax.'
-  Enabled: true
-  Severity: error
-
-Warnings/DuplicatedParameterName:
-  Description: 'Detects duplicate @param tags.'
-  Enabled: true
-  Severity: error
-
-Warnings/UnknownParameterName:
-  Description: 'Detects @param tags for non-existent parameters.'
-  Enabled: true
-  Severity: error
-
-# Semantic validators
-Semantic/AbstractMethods:
-  Description: 'Ensures @abstract methods do not have real implementations.'
-  Enabled: true
-  Severity: warning

data/.yardopts

@@ -1,7 +0,0 @@
---no-private
---output-dir
-docs/api
---exclude
-lib/generators/**/*.rb
-lib/cmdx/railtie.rb
-lib/**/*.rb

data/docs/assets/favicon.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="1000" height="1000"><g clip-path="url(#SvgjsClipPath1038)"><rect width="1000" height="1000" fill="#ffffff"></rect><g transform="matrix(6.235191420376605,0,0,6.235191420376605,175.46452176081812,150)"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" width="104.098" height="112.266"><svg width="104.098" height="112.266" viewBox="0 0 60 64.708" xmlns="http://www.w3.org/2000/svg"><path d="M29.907 17.723 26.4 23.17 13.384 3.323h3.507l9.508 14.77 1.938-3.139L18.737 0H7.291L26.4 29.262 45.045 0h-3.97L30 17.54zM9.23 61.293H6.091l18.646-29.447L4.43.093H.46l20.308 31.846L0 64.708l10.985-.092 39.138-61.2h3.323L31.57 37.754l13.662 21.415h3.97L35.445 37.754 59.537.093H48.37zm29.63-23.262 15.047 23.262H43.384l-13.662-20.77-15.508 24.093h3.97l11.63-18 11.723 18H60L41.17 35.354l-.278-.461z" fill="#000"></path></svg></svg></g></g><defs><clipPath id="SvgjsClipPath1038"><rect width="1000" height="1000" x="0" y="0" rx="150" ry="150"></rect></clipPath></defs></svg>

data/docs/attributes/coercions.md

@@ -1,155 +0,0 @@
-# Attributes - Coercions
-
-Automatically convert inputs to expected types. Coercions handle everything from simple string-to-integer conversions to JSON parsing.
-
-See [Global Configuration](../getting_started.md#coercions) for custom coercion setup.
-
-## Usage
-
-Define attribute types to enable automatic coercion:
-
-```ruby
-class ParseMetrics < CMDx::Task
-  # Coerce into a symbol
-  attribute :measurement_type, type: :symbol
-
-  # Coerce into a rational fallback to big decimal
-  attribute :value, type: [:rational, :big_decimal]
-
-  # Coerce with options
-  attribute :recorded_at, type: :date, strptime: "%m-%d-%Y"
-
-  def work
-    measurement_type #=> :temperature
-    recorded_at      #=> <Date 2024-01-23>
-    value            #=> 98.6 (Float)
-  end
-end
-
-ParseMetrics.execute(
-  measurement_type: "temperature",
-  recorded_at: "01-23-2020",
-  value: "98.6"
-)
-```
-
-!!! tip
-
-    Specify multiple coercion types for attributes that could be a variety of value formats. CMDx attempts each type in order until one succeeds.
-
-## Built-in Coercions
-
-| Type | Options | Description | Examples |
-|------|---------|-------------|----------|
-| `:array` | | Array conversion with JSON support | `"val"` → `["val"]`<br>`"[1,2,3]"` → `[1, 2, 3]` |
-| `:big_decimal` | `:precision` | High-precision decimal | `"123.456"` → `BigDecimal("123.456")` |
-| `:boolean` | | Boolean with text patterns | `"yes"` → `true`, `"no"` → `false` |
-| `:complex` | | Complex numbers | `"1+2i"` → `Complex(1, 2)` |
-| `:date` | `:strptime` | Date objects | `"2024-01-23"` → `Date.new(2024, 1, 23)` |
-| `:datetime` | `:strptime` | DateTime objects | `"2024-01-23 10:30"` → `DateTime.new(2024, 1, 23, 10, 30)` |
-| `:float` | | Floating-point numbers | `"123.45"` → `123.45` |
-| `:hash` | | Hash conversion with JSON support | `'{"a":1}'` → `{"a" => 1}` |
-| `:integer` | | Integer with hex/octal support | `"0xFF"` → `255`, `"077"` → `63` |
-| `:rational` | | Rational numbers | `"1/2"` → `Rational(1, 2)` |
-| `:string` | | String conversion | `123` → `"123"` |
-| `:symbol` | | Symbol conversion | `"abc"` → `:abc` |
-| `:time` | `:strptime` | Time objects | `"10:30:00"` → `Time.new(2024, 1, 23, 10, 30)` |
-
-## Declarations
-
-!!! warning "Important"
-
-    Custom coercions must raise `CMDx::CoercionError` with a descriptive message.
-
-### Proc or Lambda
-
-Use anonymous functions for simple coercion logic:
-
-```ruby
-class TransformCoordinates < CMDx::Task
-  # Proc
-  register :callback, :geolocation, proc do |value, options = {}|
-    begin
-      Geolocation(value)
-    rescue StandardError
-      raise CMDx::CoercionError, "could not convert into a geolocation"
-    end
-  end
-
-  # Lambda
-  register :callback, :geolocation, ->(value, options = {}) {
-    begin
-      Geolocation(value)
-    rescue StandardError
-      raise CMDx::CoercionError, "could not convert into a geolocation"
-    end
-  }
-end
-```
-
-### Class or Module
-
-Register custom coercion logic for specialized type handling:
-
-```ruby
-class GeolocationCoercion
-  def self.call(value, options = {})
-    Geolocation(value)
-  rescue StandardError
-    raise CMDx::CoercionError, "could not convert into a geolocation"
-  end
-end
-
-class TransformCoordinates < CMDx::Task
-  register :coercion, :geolocation, GeolocationCoercion
-
-  attribute :latitude, type: :geolocation
-end
-```
-
-## Removals
-
-Remove unwanted coercions:
-
-!!! warning
-
-    Each `deregister` call removes one coercion. Use multiple calls for batch removals.
-
-```ruby
-class TransformCoordinates < CMDx::Task
-  deregister :coercion, :geolocation
-end
-```
-
-## Error Handling
-
-Coercion failures provide detailed error information including attribute paths, attempted types, and specific failure reasons:
-
-```ruby
-class AnalyzePerformance < CMDx::Task
-  attribute  :iterations, type: :integer
-  attribute  :score, type: [:float, :big_decimal]
-
-  def work
-    # Your logic here...
-  end
-end
-
-result = AnalyzePerformance.execute(
-  iterations: "not-a-number",
-  score: "invalid-float"
-)
-
-result.state    #=> "interrupted"
-result.status   #=> "failed"
-result.reason   #=> "Invalid"
-result.metadata #=> {
-                #     errors: {
-                #       full_message: "iterations could not coerce into an integer. score could not coerce into one of: float, big_decimal.",
-                #       messages: {
-                #         iterations: ["could not coerce into an integer"],
-                #         score: ["could not coerce into one of: float, big_decimal"]
-                #       }
-                #     }
-                #   }
-```

data/docs/attributes/defaults.md

@@ -1,77 +0,0 @@
-# Attributes - Defaults
-
-Provide fallback values for optional attributes. Defaults kick in when values aren't provided or are `nil`.
-
-## Declarations
-
-Defaults work seamlessly with coercions, validations, and nested attributes:
-
-### Static Values
-
-```ruby
-class OptimizeDatabase < CMDx::Task
-  attribute :strategy, default: :incremental
-  attribute :level, default: "basic"
-  attribute :notify_admin, default: true
-  attribute :timeout_minutes, default: 30
-  attribute :indexes, default: []
-  attribute :options, default: {}
-
-  def work
-    strategy        #=> :incremental
-    level           #=> "basic"
-    notify_admin    #=> true
-    timeout_minutes #=> 30
-    indexes         #=> []
-    options         #=> {}
-  end
-end
-```
-
-### Symbol References
-
-Reference instance methods by symbol for dynamic default values:
-
-```ruby
-class ProcessAnalytics < CMDx::Task
-  attribute :granularity, default: :default_granularity
-
-  def work
-    # Your logic here...
-  end
-
-  private
-
-  def default_granularity
-    Current.user.premium? ? "hourly" : "daily"
-  end
-end
-```
-
-### Proc or Lambda
-
-Use anonymous functions for dynamic default values:
-
-```ruby
-class CacheContent < CMDx::Task
-  # Proc
-  attribute :expire_hours, default: proc { Current.tenant.cache_duration || 24 }
-
-  # Lambda
-  attribute :compression, default: -> { Current.tenant.premium? ? "gzip" : "none" }
-end
-```
-
-## Coercions and Validations
-
-Defaults follow the same coercion and validation rules as provided values:
-
-```ruby
-class ScheduleBackup < CMDx::Task
-  # Coercions
-  attribute :retention_days, default: "7", type: :integer
-
-  # Validations
-  optional :frequency, default: "daily", inclusion: { in: %w[hourly daily weekly monthly] }
-end
-```