castkit 0.2.0 → 0.3.1

data/lib/castkit/types/boolean.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
-require_relative "generic"
+require_relative "base"
+require_relative "../validators/boolean_validator"
 
 module Castkit
   module Types
@@ -10,7 +11,7 @@ module Castkit
     #
     # This class is used internally by Castkit when an attribute is defined with:
     #   `boolean :is_active`
-    class Boolean < Generic
+    class Boolean < Base
       # Deserializes the input into a boolean value.
       #
       # Accepts:
@@ -21,14 +22,7 @@ module Castkit
       # @return [Boolean]
       # @raise [Castkit::TypeError] if the value cannot be coerced to a boolean
       def deserialize(value)
-        case value.to_s.downcase
-        when "true", "1"
-          true
-        when "false", "0"
-          false
-        else
-          type_error!(:boolean, value)
-        end
+        value
       end
 
       # Serializes the boolean value (pass-through).
@@ -38,6 +32,16 @@ module Castkit
       def serialize(value)
         value
       end
+
+      # Validates the Boolean value.
+      #
+      # @param value [Object]
+      # @param options [Hash] validation options
+      # @param context [Symbol, String] attribute context for error messages
+      # @return [void]
+      def validate!(value, options: {}, context: {})
+        Castkit::Validators::BooleanValidator.call(value, options: options, context: context)
+      end
     end
   end
 end

data/lib/castkit/types/collection.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
-require_relative "generic"
+require_relative "base"
+require_relative "../validators/collection_validator"
 
 module Castkit
   module Types
@@ -11,7 +12,7 @@ module Castkit
     #
     # This class is used internally by Castkit when an attribute is defined with:
     #   `array :tags, of: :string`
-    class Collection < Generic
+    class Collection < Base
       # Deserializes the value into an array using `Array(value)`.
       #
       # @param value [Object]
@@ -19,6 +20,16 @@ module Castkit
       def deserialize(value)
         Array(value)
       end
+
+      # Validates the Array value.
+      #
+      # @param value [Object]
+      # @param options [Hash] validation options
+      # @param context [Symbol, String, nil] attribute context for error messages
+      # @return [void]
+      def validate!(value, options: {}, context: nil)
+        Castkit::Validators::CollectionValidator.call(value, options: options, context: context)
+      end
     end
   end
 end

data/lib/castkit/types/date.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "date"
-require_relative "generic"
+require_relative "base"
 
 module Castkit
   module Types
@@ -12,7 +12,7 @@ module Castkit
     #
     # This class is used internally by Castkit when an attribute is defined with:
     #   `date :published_on`
-    class Date < Generic
+    class Date < Base
       # Deserializes the input value to a `Date` instance.
       #
       # @param value [Object]

data/lib/castkit/types/date_time.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "date"
-require_relative "generic"
+require_relative "base"
 
 module Castkit
   module Types
@@ -12,7 +12,7 @@ module Castkit
     #
     # This class is used internally by Castkit when an attribute is defined with:
     #   `datetime :published_ad`
-    class DateTime < Generic
+    class DateTime < Base
       # Deserializes the input value to a `DateTime` instance.
       #
       # @param value [Object]

data/lib/castkit/types/float.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require_relative "generic"
-require_relative "../validators/numeric_validator"
+require_relative "base"
+require_relative "../validators/float_validator"
 
 module Castkit
   module Types
@@ -13,7 +13,7 @@ module Castkit
     #
     # This class is used internally by Castkit when an attribute is defined with:
     #   `integer :count`
-    class Float < Generic
+    class Float < Base
       # Deserializes the input value to an Float.
       #
       # @param value [Object]
@@ -30,7 +30,7 @@ module Castkit
         value
       end
 
-      # Validates the Float value using Castkit's NumericValidator.
+      # Validates the Float value using Castkit's FloatValidator.
       #
       # Supports options like `min:` and `max:`.
       #
@@ -39,7 +39,7 @@ module Castkit
       # @param context [Symbol, String] attribute context for error messages
       # @return [void]
       def validate!(value, options: {}, context: {})
-        Castkit::Validators::NumericValidator.call(value, options: options, context: context)
+        Castkit::Validators::FloatValidator.call(value, options: options, context: context)
       end
     end
   end

data/lib/castkit/types/integer.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require_relative "generic"
-require_relative "../validators/numeric_validator"
+require_relative "base"
+require_relative "../validators/integer_validator"
 
 module Castkit
   module Types
@@ -13,7 +13,7 @@ module Castkit
     #
     # This class is used internally by Castkit when an attribute is defined with:
     #   `integer :count`
-    class Integer < Generic
+    class Integer < Base
       # Deserializes the input value to an Integer.
       #
       # @param value [Object]
@@ -30,7 +30,7 @@ module Castkit
         value
       end
 
-      # Validates the Integer value using Castkit's NumericValidator.
+      # Validates the Integer value using Castkit's IntegerValidator.
       #
       # Supports options like `min:` and `max:`.
       #
@@ -39,7 +39,7 @@ module Castkit
       # @param context [Symbol, String] attribute context for error messages
       # @return [void]
       def validate!(value, options: {}, context: {})
-        Castkit::Validators::NumericValidator.call(value, options: options, context: context)
+        Castkit::Validators::IntegerValidator.call(value, options: options, context: context)
       end
     end
   end

data/lib/castkit/types/string.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "generic"
+require_relative "base"
 require_relative "../validators/string_validator"
 
 module Castkit
@@ -12,7 +12,7 @@ module Castkit
     #
     # This class is used internally by Castkit when an attribute is defined with:
     #   `string :id`
-    class String < Generic
+    class String < Base
       # Deserializes the value by coercing it to a string using `to_s`.
       #
       # @param value [Object]

data/lib/castkit/types.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
+require_relative "types/base"
 require_relative "types/collection"
 require_relative "types/boolean"
 require_relative "types/date"
 require_relative "types/date_time"
 require_relative "types/float"
-require_relative "types/generic"
 require_relative "types/integer"
 require_relative "types/string"
 

data/lib/castkit/validators/base.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Castkit
+  module Validators
+    # Abstract base class for all attribute validators.
+    #
+    # Validators are responsible for enforcing value constraints (e.g., type checks,
+    # format rules, numerical bounds). All validators must inherit from this base class
+    # and implement the `#call` instance method.
+    #
+    # Supports both instance-level and class-level invocation via `.call`.
+    #
+    # @abstract Subclasses must implement `#call`.
+    class Base
+      class << self
+        # Entry point for validating a value using the validator class.
+        #
+        # Instantiates the validator and invokes `#call` with the provided arguments.
+        #
+        # @param value [Object] the value to validate
+        # @param options [Hash] additional validation options (e.g., `min`, `max`, `format`)
+        # @param context [Symbol, String, Hash] context for the validation (usually the attribute name)
+        # @return [void]
+        # @raise [Castkit::AttributeError] if validation fails and `raise_type_errors` is true
+        def call(value, options:, context:)
+          new.call(value, options: options, context: context)
+        end
+      end
+
+      # Validates the value.
+      #
+      # @abstract
+      # @param value [Object] the value to validate
+      # @param options [Hash] validation options (e.g., min, max, format)
+      # @param context [Symbol, String, Hash] context for validation errors
+      # @return [void]
+      # @raise [NotImplementedError] if not implemented in subclass
+      def call(value, options:, context:)
+        raise NotImplementedError, "#{self.class.name} must implement `#call`"
+      end
+
+      protected
+
+      # Emits or raises a type error depending on global configuration.
+      #
+      # @param type [Symbol] the expected type (e.g., `:integer`)
+      # @param value [Object, nil] the received value
+      # @param context [Symbol, String, nil] context to include in error messages
+      # @raise [Castkit::AttributeError] if `raise_type_errors` is enabled
+      # @return [void]
+      def type_error!(type, value, context: nil)
+        message = "#{context || "value"} must be a #{type}, got #{value}"
+        raise Castkit::AttributeError, message if Castkit.configuration.raise_type_errors
+
+        Castkit.warning "[Castkit] #{message}" if Castkit.configuration.enable_warnings
+      end
+    end
+  end
+end

data/lib/castkit/validators/boolean_validator.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Castkit
+  module Validators
+    # Validator for boolean attributes.
+    #
+    # Accepts various representations of boolean values, including strings and integers.
+    # Converts common truthy/falsy string values into booleans, otherwise raises a type error.
+    #
+    # This validator is typically used internally by `Castkit::Types::Boolean`.
+    #
+    # @example
+    #   validator = Castkit::Validators::BooleanValidator.new
+    #   validator.call("true", _options: {}, context: :enabled) # => true
+    #   validator.call("0", _options: {}, context: :enabled)    # => false
+    #   validator.call("nope", _options: {}, context: :enabled) # raises Castkit::AttributeError
+    class BooleanValidator < Castkit::Validators::Base
+      # Validates the Boolean value.
+      #
+      # @param value [Object] the input to validate
+      # @param options [Hash] unused, provided for consistency with other validators
+      # @param context [Symbol, String] the attribute name or path for error messages
+      # @return [Boolean]
+      # @raise [Castkit::AttributeError] if the value is not a recognizable boolean
+      def call(value, options:, context:) # rubocop:disable Lint/UnusedMethodArgument
+        case value.to_s.downcase
+        when "true", "1"
+          true
+        when "false", "0"
+          false
+        else
+          type_error!(:boolean, value, context: context)
+        end
+      end
+    end
+  end
+end

data/lib/castkit/validators/collection_validator.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "../validators/base"
+
+module Castkit
+  module Validators
+    # Validator for array (collection) attributes.
+    #
+    # Ensures that the provided value is an instance of `Array`. This validator is
+    # typically used by `Castkit::Types::Collection` for attributes defined as arrays.
+    #
+    # @example
+    #   validator = Castkit::Validators::CollectionValidator.new
+    #   validator.call([1, 2, 3], _options: {}, context: :tags) # => passes
+    #   validator.call("foo", _options: {}, context: :tags)     # raises Castkit::AttributeError
+    class CollectionValidator < Castkit::Validators::Base
+      # Validates that the value is an Array.
+      #
+      # @param value [Object] the value to validate
+      # @param _options [Hash] unused, for interface consistency
+      # @param context [Symbol, String] the field or context for error messaging
+      # @return [void]
+      # @raise [Castkit::AttributeError] if value is not an Array
+      def call(value, _options:, context:)
+        type_error!(:array, value, context: context) unless value.is_a?(::Array)
+      end
+    end
+  end
+end

data/lib/castkit/validators/float_validator.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative "numeric_validator"
+
+module Castkit
+  module Validators
+    # Validator for Float attributes.
+    #
+    # Ensures the value is a `Float`, and applies any numeric bounds (`min`, `max`)
+    # defined in the attribute options. Inherits shared logic from `NumericValidator`.
+    #
+    # @example
+    #   validator = Castkit::Validators::FloatValidator.new
+    #   validator.call(3.14, options: { min: 0.0 }, context: :price) # => passes
+    #   validator.call(42, options: {}, context: :price)             # raises Castkit::AttributeError
+    class FloatValidator < Castkit::Validators::NumericValidator
+      # Validates that the value is a Float and within optional bounds.
+      #
+      # @param value [Object, nil] the value to validate
+      # @param options [Hash] validation options (e.g., `min`, `max`)
+      # @param context [Symbol, String] the attribute name or key for error messages
+      # @raise [Castkit::AttributeError] if value is not a Float or out of range
+      # @return [void]
+      def call(value, options:, context:)
+        return type_error!(:float, value, context: context) unless value.is_a?(::Float)
+
+        super
+      end
+    end
+  end
+end

data/lib/castkit/validators/integer_validator.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative "numeric_validator"
+
+module Castkit
+  module Validators
+    # Validator for Integer attributes.
+    #
+    # Ensures the value is an instance of `Integer` and optionally checks numerical constraints
+    # such as `min` and `max`, inherited from `Castkit::Validators::NumericValidator`.
+    #
+    # @example Validating an Integer attribute
+    #   IntegerValidator.call(42, options: { min: 10, max: 100 }, context: :count)
+    #
+    # @see Castkit::Validators::NumericValidator
+    class IntegerValidator < Castkit::Validators::NumericValidator
+      # Validates the Integer value.
+      #
+      # @param value [Object, nil] the value to validate
+      # @param options [Hash] validation options (e.g., `min`, `max`)
+      # @param context [Symbol, String] the attribute name or context for error messages
+      # @raise [Castkit::AttributeError] if the value is not an Integer or fails validation rules
+      # @return [void]
+      def call(value, options:, context:)
+        return type_error!(:integer, value, context: context) unless value.is_a?(::Integer)
+
+        super
+      end
+    end
+  end
+end

data/lib/castkit/validators/numeric_validator.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-require_relative "base_validator"
+require_relative "base"
 
 module Castkit
   module Validators
     # Validates that a numeric value falls within the allowed range.
     #
     # Supports `:min` and `:max` options to enforce bounds.
-    class NumericValidator < Castkit::Validators::BaseValidator
+    class NumericValidator < Castkit::Validators::Base
       # Validates the numeric value.
       #
       # @param value [Numeric] the value to validate

data/lib/castkit/validators/string_validator.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-require_relative "base_validator"
+require_relative "base"
 
 module Castkit
   module Validators
     # Validates that a value is a String and optionally conforms to a format.
     #
     # Supports format validation using a Regexp or a custom Proc.
-    class StringValidator < Castkit::Validators::BaseValidator
+    class StringValidator < Castkit::Validators::Base
       # Validates the string value.
       #
       # @param value [Object] the value to validate
@@ -16,8 +16,7 @@ module Castkit
       # @raise [Castkit::AttributeError] if value is not a string or fails format validation
       # @return [void]
       def call(value, options:, context:)
-        raise Castkit::AttributeError, "#{context} must be a string" unless value.is_a?(String)
-
+        return type_error!(:string, value, context: context) unless value.is_a?(::String)
         return unless options[:format]
 
         case options[:format]

data/lib/castkit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Castkit
-  VERSION = "0.2.0"
+  VERSION = "0.3.1"
 end

data/lib/castkit.rb

@@ -1,9 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "castkit/version"
-require_relative "castkit/attribute"
-require_relative "castkit/contract"
-require_relative "castkit/data_object"
+require_relative "castkit/castkit"
 
 # Castkit is a lightweight, type-safe data object system for Ruby.
 #

data/lib/generators/attribute.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "thor/group"
+require "castkit/inflector"
+require_relative "base"
+
+module Castkit
+  module Generators
+    # Generator for creating Castkit attribute definitions.
+    #
+    # Generates a class inheriting from `Castkit::Attributes::Definition`
+    # and an optional spec file.
+    #
+    # Example:
+    #   $ castkit generate attribute OptionalString required:false default:"N/A"
+    #
+    # This will generate:
+    # - lib/castkit/attributes/optional_string.rb
+    # - spec/castkit/attributes/optional_string_spec.rb
+    #
+    # @see Castkit::Generators::Base
+    class Attribute < Castkit::Generators::Base
+      component :attribute
+
+      argument :type,
+               type: :string,
+               desc: "The base type (e.g., string, integer)"
+
+      private
+
+      # @return [Hash] configuration passed into templates
+      def config
+        super.merge(
+          type: type.first.gsub(/^:/, "")
+        )
+      end
+    end
+  end
+end

data/lib/generators/base.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require "thor/group"
+require "castkit/inflector"
+
+module Castkit
+  module Generators
+    # Abstract base class for all Castkit generators.
+    #
+    # Provides standard behavior for generating a component and optional spec file from
+    # ERB templates. Subclasses must define a `component` (e.g., `:type`, `:contract`)
+    # and may override `config` or `default_values`.
+    #
+    # Template variables are injected using the `config` hash, which includes:
+    # - `:name`        – underscored version of the component name
+    # - `:class_name`  – PascalCase version of the component name
+    #
+    # @abstract
+    class Base < Thor::Group
+      include Thor::Actions
+
+      class << self
+        # Sets or retrieves the component type (e.g., :type, :data_object).
+        #
+        # @param value [Symbol, nil]
+        # @return [Symbol]
+        def component(value = nil)
+          value.nil? ? @component : (@component = value)
+        end
+
+        # @return [String] the root path to look for templates
+        def source_root
+          File.expand_path("templates", __dir__)
+        end
+      end
+
+      argument :name, desc: "The name of the component to generate"
+      class_option :spec, type: :boolean, default: true, desc: "Also generate a spec file"
+
+      # Creates the main component file using a template.
+      #
+      # Template: `component.rb.tt`
+      # Target: `lib/castkit/#{component}s/#{name}.rb`
+      #
+      # @return [void]
+      def create_component
+        template(
+          "#{self.class.component}.rb.tt",
+          "lib/castkit/#{self.class.component}s/#{config[:name]}.rb", **config
+        )
+      end
+
+      # Creates the associated spec file, if enabled.
+      #
+      # Template: `component_spec.rb.tt`
+      # Target: `spec/castkit/#{component}s/#{name}_spec.rb`
+      #
+      # @return [void]
+      def create_spec
+        return unless options[:spec]
+
+        template(
+          "#{self.class.component}_spec.rb.tt",
+          "spec/castkit/#{self.class.component}s/#{config[:name]}_spec.rb", **config
+        )
+      end
+
+      private
+
+      # Default values for test inputs based on type.
+      #
+      # These are used in spec templates to provide sample data.
+      #
+      # @return [Hash{Symbol => Object}]
+      def default_values
+        {
+          string: '"example"',
+          integer: 42,
+          float: 3.14,
+          boolean: true,
+          array: [],
+          hash: {}
+        }
+      end
+
+      # Returns the default config hash passed into templates.
+      #
+      # @return [Hash{Symbol => Object}]
+      def config
+        {
+          name: Castkit::Inflector.underscore(name),
+          class_name: Castkit::Inflector.pascalize(name)
+        }
+      end
+    end
+  end
+end