castkit 0.1.1 → 0.2.0

data/lib/castkit/attribute_extensions/validation.rb

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "error_handling"
-require_relative "options"
-
-module Castkit
-  module AttributeExtensions
-    # Provides validation logic for attribute configuration.
-    #
-    # These checks are typically performed at attribute initialization to catch misconfigurations early.
-    module Validation
-      include Castkit::AttributeExtensions::ErrorHandling
-
-      private
-
-      # Runs all validation checks on the attribute definition.
-      #
-      # This includes:
-      # - Custom validator integrity
-      # - Access mode validity
-      # - Unwrapped prefix usage
-      # - Array `of:` type presence
-      #
-      # @return [void]
-      def validate!
-        validate_custom_validator!
-        validate_access!
-        validate_unwrapped_options!
-        validate_array_options!
-      end
-
-      # Validates the presence and interface of a custom validator.
-      #
-      # @return [void]
-      # @raise [Castkit::AttributeError] if the validator is not callable
-      def validate_custom_validator!
-        return unless options[:validator]
-        return if options[:validator].respond_to?(:call)
-
-        raise_error!("Custom validator for `#{field}` must respond to `.call`")
-      end
-
-      # Validates that each declared access mode is valid.
-      #
-      # @return [void]
-      # @raise [Castkit::AttributeError] if any access mode is invalid and enforcement is enabled
-      def validate_access!
-        access.each do |mode|
-          next if Castkit::AttributeExtensions::Options::DEFAULT_OPTIONS[:access].include?(mode)
-
-          handle_error(:access, mode: mode, context: to_h)
-        end
-      end
-
-      # Ensures prefix is only used with unwrapped attributes.
-      #
-      # @return [void]
-      # @raise [Castkit::AttributeError] if prefix is used without `unwrapped: true`
-      def validate_unwrapped_options!
-        handle_error(:unwrapped, context: to_h) if prefix && !unwrapped?
-      end
-
-      # Ensures `of:` is provided for array-typed attributes.
-      #
-      # @return [void]
-      # @raise [Castkit::AttributeError] if `of:` is missing for `type: :array`
-      def validate_array_options!
-        handle_error(:array_options, context: to_h) if type == :array && options[:of].nil?
-      end
-    end
-  end
-end

data/lib/castkit/data_object_extensions/config.rb

@@ -1,105 +0,0 @@
-# frozen_string_literal: true
-
-module Castkit
-  module DataObjectExtensions
-    # Provides per-class configuration for a Castkit::DataObject,
-    # including root key handling, strict mode, and unknown key behavior.
-    module Config
-      # Automatically extends class-level methods when included.
-      #
-      # @param base [Class]
-      def self.included(base)
-        base.extend(ClassMethods)
-      end
-
-      # Class-level configuration methods.
-      module ClassMethods
-        # Sets or retrieves the root key to wrap the object under during (de)serialization.
-        #
-        # @param value [String, Symbol, nil] optional root key
-        # @return [Symbol, nil]
-        def root(value = nil)
-          @root = value.to_s.strip.to_sym if value
-          @root
-        end
-
-        # Sets or retrieves whether to skip `nil` values in output.
-        #
-        # @param value [Boolean, nil]
-        # @return [Boolean, nil]
-        def ignore_nil(value = nil)
-          value.nil? ? @ignore_nil : (@ignore_nil = value)
-        end
-
-        # Sets or retrieves whether to skip blank values (`[]`, `{}`, `""`, etc.) in output.
-        #
-        # Defaults to true unless explicitly set to false.
-        #
-        # @param value [Boolean, nil]
-        # @return [Boolean]
-        def ignore_blank(value = nil)
-          @ignore_blank = value.nil? || value
-        end
-
-        # Sets or retrieves strict mode behavior.
-        #
-        # In strict mode, unknown keys during deserialization raise errors.
-        #
-        # @param value [Boolean, nil]
-        # @return [Boolean]
-        def strict(value = nil)
-          if value.nil?
-            @strict.nil? || @strict
-          else
-            @strict = value
-          end
-        end
-
-        # Enables or disables ignoring unknown keys during deserialization.
-        #
-        # This is the inverse of `strict`.
-        #
-        # @param value [Boolean]
-        # @return [void]
-        def ignore_unknown(value = nil)
-          @strict = !value
-        end
-
-        # Sets or retrieves whether to emit warnings when unknown keys are encountered.
-        #
-        # @param value [Boolean, nil]
-        # @return [Boolean, nil]
-        def warn_on_unknown(value = nil)
-          value.nil? ? @warn_unknown_keys : (@warn_unknown_keys = value)
-        end
-
-        # Returns a relaxed version of the current class with strict mode off.
-        #
-        # Useful for tolerant parsing scenarios.
-        #
-        # @param warn_on_unknown [Boolean]
-        # @return [Class] a subclass with relaxed rules
-        def relaxed(warn_on_unknown: true)
-          klass = Class.new(self)
-          klass.strict(false)
-          klass.warn_on_unknown(warn_on_unknown)
-          klass
-        end
-      end
-
-      # Returns the root key for this instance.
-      #
-      # @return [Symbol]
-      def root_key
-        self.class.root.to_s.strip.to_sym
-      end
-
-      # Whether a root key is configured for this instance.
-      #
-      # @return [Boolean]
-      def root_key_set?
-        !self.class.root.to_s.strip.empty?
-      end
-    end
-  end
-end

data/lib/castkit/data_object_extensions/deserialization.rb

@@ -1,110 +0,0 @@
-# frozen_string_literal: true
-
-module Castkit
-  module DataObjectExtensions
-    # Adds deserialization support for Castkit::DataObject instances.
-    #
-    # Handles attribute loading, alias resolution, and unwrapped field extraction.
-    module Deserialization
-      # Hooks in class methods like `.from_hash` when included.
-      #
-      # @param base [Class]
-      def self.included(base)
-        base.extend(ClassMethods)
-      end
-
-      # Class-level deserialization helpers.
-      module ClassMethods
-        # Builds a new instance from a Hash, symbolizing keys as needed.
-        #
-        # @param hash [Hash]
-        # @return [Castkit::DataObject]
-        def from_hash(hash)
-          hash = hash.transform_keys { |k| k.respond_to?(:to_sym) ? k.to_sym : k }
-          new(hash)
-        end
-
-        # @!method from_h(hash)
-        #   Alias for {.from_hash}
-        #
-        # @!method creator(hash)
-        #   Alias for {.from_hash}
-        alias from_h from_hash
-        alias creator from_hash
-      end
-
-      private
-
-      # Loads attribute values from the given hash.
-      #
-      # Respects access control (e.g., `writeable?`) and uses `.load` for casting/validation.
-      #
-      # @param data [Hash]
-      # @return [void]
-      def deserialize_attributes!(data)
-        self.class.attributes.each do |field, attribute|
-          next if attribute.skip_deserialization?
-
-          value = fetch_attribute_key(data, attribute)
-          value = attribute.load(value, context: field)
-
-          instance_variable_set("@#{field}", value)
-        end
-      end
-
-      # Fetches the best matching value from the hash using attribute key and aliases.
-      #
-      # @param data [Hash]
-      # @param attribute [Castkit::Attribute]
-      # @return [Object]
-      def fetch_attribute_key(data, attribute)
-        attribute.key_path(with_aliases: true).each do |path|
-          value = path.reduce(data) { |memo, key| memo.is_a?(Hash) ? memo[key] : nil }
-          return value unless value.nil?
-        end
-
-        nil
-      end
-
-      # Extracts prefixed fields for unwrapped attributes and groups them under the original field key.
-      #
-      # @param data [Hash]
-      # @return [Hash] modified input hash with unwrapped values nested under their base field
-      def unwrap_prefixed_fields!(data)
-        self.class.attributes.each_value do |attribute|
-          next unless attribute.unwrapped?
-
-          unwrapped, keys_to_remove = unwrap_prefixed_values(data, attribute)
-          next if unwrapped.empty?
-
-          data[attribute.field] = unwrapped
-          keys_to_remove.each { |k| data.delete(k) }
-        end
-
-        data
-      end
-
-      # Returns the prefixed key-value pairs for a given unwrapped attribute.
-      #
-      # @param data [Hash]
-      # @param attribute [Castkit::Attribute]
-      # @return [Array<Hash, Array<Symbol>>] extracted key-value pairs and keys to delete
-      def unwrap_prefixed_values(data, attribute)
-        prefix = attribute.prefix.to_s
-        unwrapped_data = {}
-        keys_to_remove = []
-
-        data.each do |k, v|
-          k_str = k.to_s
-          next unless k_str.start_with?(prefix)
-
-          stripped = k_str.sub(prefix, "").to_sym
-          unwrapped_data[stripped] = v
-          keys_to_remove << k
-        end
-
-        [unwrapped_data, keys_to_remove]
-      end
-    end
-  end
-end

data/lib/castkit/validators.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "validators/numeric_validator"
-require_relative "validators/string_validator"