smart_initializer 0.11.1 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fe201fc92a2d434aa3b1172e41d9087198d77e63282a9e98ed1da9a9aab6668
-  data.tar.gz: 23898d45402508f8baba6f377f60833c0388a269fbef4ab25a31e11f48578f12
+  metadata.gz: 8922071ca9c220e11db62245ad51d3fbf4d5f7e1a50d8177aab85c6ece63c88f
+  data.tar.gz: 34c3c45abfd4f574946579445022c707b386faf95e31356411b5b9cf38dbc9a5
 SHA512:
-  metadata.gz: 8df5d054733685007a706f980e5f2fb4e7a6155d617c6726f6bcb977a7833af4850c8e69b187870dd02330fbe9a821587c8ee40270f225f0324aa75b02bcfdb6
-  data.tar.gz: 2796450e1c53a909d692916d5087bcb3059bfd1165078d3758d79aa372f62cdbde7c7b6d6bbe97a41c811239e7595d2a49b76b9ef675e6186b10ef3f907ba5a9
+  metadata.gz: 2f3d0002ef6c50389675207c17e7b8ff21cadeab73dd28d22b6bbc5dc903caf717f6990ffb1e6c168ab42617e16e4a5c4fad435ad7d419ed547603cafb462e6c
+  data.tar.gz: 14f0fb464ca7bde0e50720d960959ad648851b9c91e8b3aed7bda4c05ad89d6e785976bd3dbea2845408611a72801e0ab0e87053f92c45f12c267721ba705e8f

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    smart_initializer (0.11.1)
+    smart_initializer (0.12.0)
       qonfig (~> 0.24)
       smart_engine (~> 0.16)
       smart_types (~> 0.8)
@@ -21,6 +21,7 @@ GEM
       rubocop-rake (= 0.6.0)
       rubocop-rspec (= 2.13.2)
     ast (2.4.2)
+    bigdecimal (3.1.8)
     coderay (1.1.3)
     concurrent-ruby (1.1.10)
     diff-lcs (1.5.0)
@@ -30,6 +31,7 @@ GEM
     json (2.6.2)
     method_source (1.0.0)
     minitest (5.16.3)
+    ostruct (0.6.0)
     parallel (1.22.1)
     parser (3.1.2.1)
       ast (~> 2.4.1)
@@ -94,10 +96,13 @@ GEM
 
 PLATFORMS
   arm64-darwin-21
+  arm64-darwin-23
 
 DEPENDENCIES
   armitage-rubocop (~> 1.30)
+  bigdecimal
   bundler (~> 2.3)
+  ostruct
   pry (~> 0.14)
   rake (~> 13.0)
   rspec (~> 3.11)
@@ -105,4 +110,4 @@ DEPENDENCIES
   smart_initializer!
 
 BUNDLED WITH
-   2.3.17
+   2.5.19

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020-2021 Rustam Ibragimov
+Copyright (c) 2020-2024 Rustam Ibragimov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -527,6 +527,7 @@ User.new(123, 'test', { admin: true, age: 22 })
 
 ## Roadmap
 
+- an ability to re-define existing options and parameters in children classes;
 - More semantic attribute declaration errors (more domain-related attribute error objects);
   - incorrect `:finalize` argument type: `ArgumentError` => `FinalizeArgumentError`;
   - incorrect `:as` argument type: `ArguemntError` => `AsArgumentError`;
@@ -535,6 +536,7 @@ User.new(123, 'test', { admin: true, age: 22 })
 - Specs restructuring;
 - Migrate from `TravisCI` to `GitHub Actions`;
 - Extract `Type Interop` system to `smart_type-system`;
+- an ability to define nested-`option` (or `param`) for structure-like object (for object with "nested" nature like `a.b.c` or `a[:b][:c]`) with data type validaitons and with a support of (almost) full attribute DSL;
 
 ---
 

data/lib/smart_core/initializer/attribute/factory/base.rb

@@ -132,7 +132,7 @@ class SmartCore::Initializer::Attribute::Factory::Base
     #
     # @api private
     # @since 0.4.0
-    def preapre_as_param(as)
+    def prepare_as_param(as)
       unless as.is_a?(::NilClass) || as.is_a?(::String) || as.is_a?(::Symbol)
         raise(SmartCore::Initializer::ArgumentError, <<~ERROR_MESSAGE)
           Attribute alias should be a type of String or Symbol

data/lib/smart_core/initializer/attribute/factory/option.rb

@@ -5,6 +5,7 @@ module SmartCore::Initializer::Attribute::Factory
   # @since 0.8.0
   class Option < Base
     class << self
+      # @param klass [Class]
       # @param name [String, Symbol]
       # @param type [String, Symbol, Any]
       # @param type_system [String, Symbol]
@@ -19,7 +20,7 @@ module SmartCore::Initializer::Attribute::Factory
       #
       # @api private
       # @since 0.8.0
-      def create(name, type, type_system, privacy, finalize, cast, mutable, as, default, optional)
+      def create(klass, name, type, type_system, privacy, finalize, cast, mutable, as, default, optional)
         prepared_name        = prepare_name_param(name)
         prepared_privacy     = prepare_privacy_param(privacy)
         prepared_finalize    = prepare_finalize_param(finalize)
@@ -27,11 +28,12 @@ module SmartCore::Initializer::Attribute::Factory
         prepared_type_system = prepare_type_system_param(type_system)
         prepared_type        = prepare_type_param(type, prepared_type_system)
         prepared_mutable     = prepare_mutable_param(mutable)
-        prepared_as          = preapre_as_param(as)
+        prepared_as          = prepare_as_param(as)
         prepared_default     = prepare_default_param(default)
         prepared_optional    = prepare_optional_param(optional)
 
         create_attribute(
+          klass,
           prepared_name,
           prepared_type,
           prepared_type_system,
@@ -47,6 +49,7 @@ module SmartCore::Initializer::Attribute::Factory
 
       private
 
+      # @param klass [Class]
       # @param name [String]
       # @param type [SmartCore::Initializer::TypeSystem::Interop]
       # @param type_system [Class<SmartCore::Initializer::TypeSystem::Interop>]
@@ -62,6 +65,7 @@ module SmartCore::Initializer::Attribute::Factory
       # @api private
       # @since 0.8.0
       def create_attribute(
+        klass,
         name,
         type,
         type_system,
@@ -74,7 +78,7 @@ module SmartCore::Initializer::Attribute::Factory
         optional
       )
         SmartCore::Initializer::Attribute::Value::Option.new(
-          name, type, type_system, privacy, finalize, cast, mutable, as, default, optional
+          klass, name, type, type_system, privacy, finalize, cast, mutable, as, default, optional
         )
       end
 

data/lib/smart_core/initializer/attribute/factory/param.rb

@@ -5,6 +5,7 @@ module SmartCore::Initializer::Attribute::Factory
   # @since 0.8.0
   class Param < Base
     class << self
+      # @param klass [Class]
       # @param name [String, Symbol]
       # @param type [String, Symbol, Any]
       # @param type_system [String, Symbol]
@@ -17,7 +18,7 @@ module SmartCore::Initializer::Attribute::Factory
       #
       # @api private
       # @since 0.8.0
-      def create(name, type, type_system, privacy, finalize, cast, mutable, as)
+      def create(klass, name, type, type_system, privacy, finalize, cast, mutable, as)
         prepared_name        = prepare_name_param(name)
         prepared_privacy     = prepare_privacy_param(privacy)
         prepared_finalize    = prepare_finalize_param(finalize)
@@ -25,9 +26,10 @@ module SmartCore::Initializer::Attribute::Factory
         prepared_type_system = prepare_type_system_param(type_system)
         prepared_type        = prepare_type_param(type, prepared_type_system)
         prepared_mutable     = prepare_mutable_param(mutable)
-        prepared_as          = preapre_as_param(as)
+        prepared_as          = prepare_as_param(as)
 
         create_attribute(
+          klass,
           prepared_name,
           prepared_type,
           prepared_type_system,
@@ -53,9 +55,9 @@ module SmartCore::Initializer::Attribute::Factory
       #
       # @api private
       # @since 0.8.0
-      def create_attribute(name, type, type_system, privacy, finalize, cast, mutable, as)
+      def create_attribute(klass, name, type, type_system, privacy, finalize, cast, mutable, as)
         SmartCore::Initializer::Attribute::Value::Param.new(
-          name, type, type_system, privacy, finalize, cast, mutable, as
+          klass, name, type, type_system, privacy, finalize, cast, mutable, as
         )
       end
     end

data/lib/smart_core/initializer/attribute/value/base.rb

@@ -38,6 +38,12 @@ class SmartCore::Initializer::Attribute::Value::Base
   # @since 0.8.0
   DEFAULT_MUTABLE = false
 
+  # @return [Class]
+  #
+  # @api private
+  # @since 0.12.0
+  attr_reader :klass
+
   # @return [Symbol]
   #
   # @api private
@@ -89,6 +95,7 @@ class SmartCore::Initializer::Attribute::Value::Base
   # @since 0.8.0
   attr_reader :as
 
+  # @param klass [Class]
   # @param name [Symbol]
   # @param type [SmartCore::Initializer::TypeSystem::Interop]
   # @param type_system [Class<SmartCore::Initializer::TypeSystem::Interop>]
@@ -101,7 +108,8 @@ class SmartCore::Initializer::Attribute::Value::Base
   #
   # @api private
   # @since 0.8.0
-  def initialize(name, type, type_system, privacy, finalizer, cast, mutable, as)
+  def initialize(klass, name, type, type_system, privacy, finalizer, cast, mutable, as)
+    @klass = klass
     @name = name
     @type = type
     @type_system = type_system
@@ -121,10 +129,20 @@ class SmartCore::Initializer::Attribute::Value::Base
   # @since 0.8.0
   # @version 0.11.0
   def validate!(value)
-    raise(
-      SmartCore::Initializer::IncorrectTypeError,
-      "Validation of attribute `#{name}` failed:" \
-      "(expected: #{type.identifier}, got: #{value.class})"
-    ) unless type.valid?(value)
+    unless type.valid?(value)
+      raise(
+        SmartCore::Initializer::IncorrectTypeError,
+        "Validation of attribute `#{klass}##{name}` failed. " \
+        "Expected: #{type.identifier}, got: #{truncate(value.inspect, 100)}",
+      )
+    end
+  end
+
+  private
+
+  def truncate(string, max_length)
+    return string unless string.size > max_length
+    omission = "..."
+    "#{string[0, max_length - omission.size]}#{omission}"
   end
 end

data/lib/smart_core/initializer/attribute/value/option.rb

@@ -23,6 +23,7 @@ module SmartCore::Initializer::Attribute::Value
     attr_reader :optional
     alias_method :optional?, :optional
 
+    # @param klass [Class]
     # @param name [Symbol]
     # @param type [SmartCore::Initializer::TypeSystem::Interop]
     # @param type_system [Class<SmartCore::Initializer::TypeSystem::Interop>]
@@ -38,6 +39,7 @@ module SmartCore::Initializer::Attribute::Value
     # @api private
     # @since 0.8.0
     def initialize(
+      klass,
       name,
       type,
       type_system,
@@ -49,7 +51,7 @@ module SmartCore::Initializer::Attribute::Value
       default,
       optional
     )
-      super(name, type, type_system, privacy, finalizer, cast, mutable, as)
+      super(klass, name, type, type_system, privacy, finalizer, cast, mutable, as)
       @default = default
       @optional = optional
     end
@@ -85,6 +87,7 @@ module SmartCore::Initializer::Attribute::Value
       default = @default.equal?(UNDEFINED_DEFAULT) ? @default : @default.dup
 
       self.class.new(
+        klass,
         name.dup,
         type,
         type_system,

data/lib/smart_core/initializer/attribute/value/param.rb

@@ -10,6 +10,7 @@ module SmartCore::Initializer::Attribute::Value
     # @since 0.8.0
     def dup
       self.class.new(
+        klass,
         name.dup,
         type,
         type_system,

data/lib/smart_core/initializer/constructor/definer.rb

@@ -204,7 +204,7 @@ class SmartCore::Initializer::Constructor::Definer
     as
   )
     SmartCore::Initializer::Attribute::Factory::Param.create(
-      name, type, type_system, privacy, finalize, cast, mutable, as
+      klass, name, type, type_system, privacy, finalize, cast, mutable, as
     )
   end
 
@@ -236,7 +236,7 @@ class SmartCore::Initializer::Constructor::Definer
     optional
   )
     SmartCore::Initializer::Attribute::Factory::Option.create(
-      name, type, type_system, privacy, finalize, cast, mutable, as, default, optional
+      klass, name, type, type_system, privacy, finalize, cast, mutable, as, default, optional
     )
   end
 

data/lib/smart_core/initializer/version.rb

@@ -7,6 +7,6 @@ module SmartCore
     # @api public
     # @since 0.1.0
     # @version 0.11.1
-    VERSION = '0.11.1'
+    VERSION = '0.12.0'
   end
 end

data/smart_initializer.gemspec

@@ -40,4 +40,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'armitage-rubocop', '~> 1.30'
   spec.add_development_dependency 'simplecov',        '~> 0.21'
   spec.add_development_dependency 'pry',              '~> 0.14'
+  spec.add_development_dependency 'ostruct'
+  spec.add_development_dependency 'bigdecimal'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smart_initializer
 version: !ruby/object:Gem::Version
-  version: 0.11.1
+  version: 0.12.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-11-25 00:00:00.000000000 Z
+date: 2025-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: smart_engine
@@ -136,6 +136,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A simple and convenient way to declare complex constructors
 email:
 - iamdaiver@gmail.com
@@ -246,7 +274,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: Initializer DSL