smart_initializer 0.7.0 → 0.8.0

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

@@ -31,13 +31,13 @@ class SmartCore::Initializer::Constructor::Definer
   # @param privacy [String, Symbol]
   # @param finalize [String, Symbol, Proc]
   # @param cast [Boolean]
-  # @param read_only [Boolean]
+  # @param mutable [Boolean]
   # @param as [String, Symbol, NilClass]
-  # @param dynamic_options [Hash<Symbol,Any>]
   # @return [void]
   #
   # @api private
   # @since 0.1.0
+  # @version 0.8.0
   def define_parameter(
     name,
     type,
@@ -45,21 +45,19 @@ class SmartCore::Initializer::Constructor::Definer
     privacy,
     finalize,
     cast,
-    read_only,
-    as,
-    dynamic_options
+    mutable,
+    as
   )
     thread_safe do
-      attribute = build_attribute(
+      attribute = build_param_attribute(
         name,
         type,
         type_system,
         privacy,
         finalize,
         cast,
-        read_only,
-        as,
-        dynamic_options
+        mutable,
+        as
       )
       prevent_option_overlap(attribute)
       add_parameter(attribute)
@@ -67,23 +65,25 @@ class SmartCore::Initializer::Constructor::Definer
   end
 
   # @param names [Array<String, Symbol>]
+  # @option mutable [Boolean]
+  # @option privacy [String, Symbol]
   # @return [void]
   #
   # @api private
   # @since 0.1.0
-  def define_parameters(*names)
+  # @version 0.8.0
+  def define_parameters(*names, mutable:, privacy:)
     thread_safe do
       names.map do |name|
-        build_attribute(
+        build_param_attribute(
           name,
           klass.__initializer_settings__.generic_type_object,
           klass.__initializer_settings__.type_system,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_PRIVACY_MODE,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_FINALIZER,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_CAST_BEHAVIOUR,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_READ_ONLY,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_AS,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_DYNAMIC_OPTIONS.dup
+          privacy,
+          SmartCore::Initializer::Attribute::Value::Param::DEFAULT_FINALIZER,
+          klass.__initializer_settings__.auto_cast,
+          mutable,
+          SmartCore::Initializer::Attribute::Value::Param::DEFAULT_AS
         ).tap do |attribute|
           prevent_option_overlap(attribute)
         end
@@ -99,13 +99,15 @@ class SmartCore::Initializer::Constructor::Definer
   # @param privacy [String, Symbol]
   # @param finalize [String, Symbol, Proc]
   # @param cast [Boolean]
-  # @param read_only [Boolean]
+  # @param mutable [Boolean]
   # @param as [String, Symbol, NilClass]
-  # @param dynamic_options [Hash<Symbol,Any>]
+  # @param default [Proc, Any]
+  # @param optional [Boolean]
   # @return [void]
   #
   # @api private
   # @since 0.1.0
+  # @version 0.8.0
   def define_option(
     name,
     type,
@@ -113,21 +115,23 @@ class SmartCore::Initializer::Constructor::Definer
     privacy,
     finalize,
     cast,
-    read_only,
+    mutable,
     as,
-    dynamic_options
+    default,
+    optional
   )
     thread_safe do
-      attribute = build_attribute(
+      attribute = build_option_attribute(
         name,
         type,
         type_system,
         privacy,
         finalize,
         cast,
-        read_only,
+        mutable,
         as,
-        dynamic_options
+        default,
+        optional
       )
       prevent_parameter_overlap(attribute)
       add_option(attribute)
@@ -135,23 +139,27 @@ class SmartCore::Initializer::Constructor::Definer
   end
 
   # @param names [Array<String, Symbol>]
+  # @option mutable [Boolean]
+  # @option privacy [String, Symbol]
   # @return [void]
   #
   # @api private
   # @since 0.1.0
-  def define_options(*names)
+  # @version 0.8.0
+  def define_options(*names, mutable:, privacy:)
     thread_safe do
       names.map do |name|
-        build_attribute(
+        build_option_attribute(
           name,
           klass.__initializer_settings__.generic_type_object,
           klass.__initializer_settings__.type_system,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_PRIVACY_MODE,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_FINALIZER,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_CAST_BEHAVIOUR,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_READ_ONLY,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_AS,
-          SmartCore::Initializer::Attribute::Parameters::DEFAULT_DYNAMIC_OPTIONS.dup
+          privacy,
+          SmartCore::Initializer::Attribute::Value::Option::DEFAULT_FINALIZER,
+          klass.__initializer_settings__.auto_cast,
+          mutable,
+          SmartCore::Initializer::Attribute::Value::Option::DEFAULT_AS,
+          SmartCore::Initializer::Attribute::Value::Option::UNDEFINED_DEFAULT,
+          SmartCore::Initializer::Attribute::Value::Option::DEFAULT_OPTIONAL
         ).tap do |attribute|
           prevent_parameter_overlap(attribute)
         end
@@ -175,26 +183,57 @@ class SmartCore::Initializer::Constructor::Definer
   # @param privacy [String, Symbol]
   # @param finalize [String, Symbol, Proc]
   # @param cast [Boolean]
-  # @param read_only [Boolean]
+  # @param mutable [Boolean]
+  # @param as [String, Symbol, NilClass]
+  # @return [SmartCore::Initializer::Attribute::Value::Param]
+  #
+  # @api private
+  # @since 0.1.0
+  # @version 0.8.0
+  def build_param_attribute(
+    name,
+    type,
+    type_system,
+    privacy,
+    finalize,
+    cast,
+    mutable,
+    as
+  )
+    SmartCore::Initializer::Attribute::Factory::Param.create(
+      name, type, type_system, privacy, finalize, cast, mutable, as
+    )
+  end
+
+  # @param name [String, Symbol]
+  # @param type [String, Symbol, Any]
+  # @param type_system [String, Symbol]
+  # @param privacy [String, Symbol]
+  # @param finalize [String, Symbol, Proc]
+  # @param cast [Boolean]
+  # @param mutable [Boolean]
   # @param as [String, Symbol, NilClass]
-  # @param dynamic_options [Hash<Symbol,Any>]
-  # @return [SmartCore::Initializer::Attribute]
+  # @param default [Proc, Any]
+  # @param optional [Boolean]
+  # @return [SmartCore::Initializer::Attribute::Value::Option]
   #
   # @api private
   # @since 0.1.0
-  def build_attribute(
+  # @version 0.8.0
+  def build_option_attribute(
     name,
     type,
     type_system,
     privacy,
     finalize,
     cast,
-    read_only,
+    mutable,
     as,
-    dynamic_options
+    default,
+    optional
   )
-    SmartCore::Initializer::Attribute::Factory.create(
-      name, type, type_system, privacy, finalize, cast, read_only, as, dynamic_options
+    SmartCore::Initializer::Attribute::Factory::Option.create(
+      name, type, type_system, privacy, finalize, cast, mutable, as, default, optional
     )
   end
 
@@ -207,27 +246,77 @@ class SmartCore::Initializer::Constructor::Definer
     SmartCore::Initializer::Extensions::ExtInit.new(block)
   end
 
-  # @param parameter [SmartCore::Initializer::Attribute]
+  # @param parameter [SmartCore::Initializer::Attribute::Value::Param]
   # @return [void]
   #
   # @api private
   # @since 0.1.0
+  # @version 0.8.0
+  # rubocop:disable Metrics/AbcSize
   def add_parameter(parameter)
     klass.__params__ << parameter
-    klass.send(:attr_reader, parameter.name)
-    klass.send(parameter.privacy, parameter.name)
+    klass.__send__(:attr_reader, parameter.name)
+    klass.__send__(parameter.privacy, parameter.name)
+
+    if parameter.mutable?
+      # NOTE:
+      #   code evaluation approach is used instead of `define_method` approach in order
+      #   to avoid the `clojure`-context binding inside the new method (this context can
+      #   access the current context or the current variable set and the way to avoid this by
+      #   ruby method is more diffcult to support and read insead of the real `code` evaluation)
+      klass.class_eval(<<~METHOD_CODE, __FILE__, __LINE__ + 1)
+        #{parameter.privacy} def #{parameter.name}=(new_value)
+          self.class.__params__[:#{parameter.name}].validate!(new_value)
+          @#{parameter.name} = new_value
+        end
+      METHOD_CODE
+    end
+
+    if parameter.as
+      klass.__send__(:alias_method, parameter.as, parameter.name)
+      klass.__send__(:alias_method, "#{parameter.as}=", "#{parameter.name}=") if parameter.mutable?
+
+      klass.__send__(parameter.privacy, parameter.as)
+      klass.__send__(parameter.privacy, "#{parameter.as}=") if parameter.mutable?
+    end
   end
+  # rubocop:enable Metrics/AbcSize
 
-  # @param option [SmartCore::Initializer::Attribute]
+  # @param option [SmartCore::Initializer::Attribute::Value::Option]
   # @return [void]
   #
   # @api private
   # @since 0.1.0
+  # @version 0.8.0
+  # rubocop:disable Metrics/AbcSize
   def add_option(option)
     klass.__options__ << option
-    klass.send(:attr_reader, option.name)
-    klass.send(option.privacy, option.name)
+    klass.__send__(:attr_reader, option.name)
+    klass.__send__(option.privacy, option.name)
+
+    if option.mutable?
+      # NOTE:
+      #   code evaluation approach is used instead of `define_method` approach in order
+      #   to avoid the `clojure`-context binding inside the new method (this context can
+      #   access the current context or the current variable set and the way to avoid this by
+      #   ruby method is more diffcult to support and read insead of the real `code` evaluation)
+      klass.class_eval(<<~METHOD_CODE, __FILE__, __LINE__ + 1)
+        #{option.privacy} def #{option.name}=(new_value)
+          self.class.__options__[:#{option.name}].validate!(new_value)
+          @#{option.name} = new_value
+        end
+      METHOD_CODE
+    end
+
+    if option.as
+      klass.__send__(:alias_method, option.as, option.name)
+      klass.__send__(:alias_method, "#{option.as}=", "#{option.name}=") if option.mutable?
+
+      klass.__send__(option.privacy, option.as)
+      klass.__send__(option.privacy, "#{option.as}=") if option.mutable?
+    end
   end
+  # rubocop:enable Metrics/AbcSize
 
   # @param extension [SmartCore::Initializer::Extensions::ExtInit]
   # @return [void]

data/lib/smart_core/initializer/constructor.rb

@@ -72,7 +72,7 @@ class SmartCore::Initializer::Constructor
   #
   # @api private
   # @since 0.1.0
-  # @version 0.7.0
+  # @version 0.8.0
   # rubocop:disable Metrics/AbcSize
   def prevent_attribute_insufficiency
     required_parameter_count = klass.__params__.size
@@ -83,8 +83,8 @@ class SmartCore::Initializer::Constructor
       "(given #{parameters.size}, expected #{required_parameter_count})"
     ) unless parameters.size == required_parameter_count
 
-    required_options = klass.__options__.reject(&:has_default?).map(&:name)
-    missing_options  = required_options.reject { |option| options.key?(option) }
+    required_options = klass.__options__.reject(&:has_default?).reject(&:optional?).map(&:name)
+    missing_options  = required_options.reject { |option_name| options.key?(option_name) }
 
     raise(
       SmartCore::Initializer::OptionArgumentError,
@@ -97,7 +97,7 @@ class SmartCore::Initializer::Constructor
     raise(
       SmartCore::Initializer::OptionArgumentError,
       "Unknown options: #{unknown_options.join(', ')}"
-    ) if unknown_options.any? && SmartCore::Initializer::Configuration[:strict_options]
+    ) if klass.__initializer_settings__.strict_options && unknown_options.any?
   end
   # rubocop:enable Metrics/AbcSize
 
@@ -124,8 +124,9 @@ class SmartCore::Initializer::Constructor
       end
 
       attribute.validate!(parameter_value)
-
       final_value = attribute.finalizer.call(parameter_value, instance)
+      attribute.validate!(final_value)
+
       instance.instance_variable_set("@#{attribute.name}", final_value)
     end
   end
@@ -135,21 +136,38 @@ class SmartCore::Initializer::Constructor
   #
   # @api private
   # @since 0.1.0
-  # @version 0.5.1
+  # @version 0.8.0
+  # rubocop:disable Metrics/AbcSize
   def initialize_options(instance)
     klass.__options__.each do |attribute|
-      option_value = options.fetch(attribute.name) { attribute.default }
-
-      if !attribute.type.valid?(option_value) && attribute.cast?
-        option_value = attribute.type.cast(option_value)
+      option_value = options.fetch(attribute.name) do
+        # NOTE: `nil` case is a case when an option is `optional`
+        attribute.has_default? ? attribute.default : nil
       end
 
-      attribute.validate!(option_value)
+      if options.key?(attribute.name) || attribute.has_default?
+        if !attribute.type.valid?(option_value) && attribute.cast?
+          option_value = attribute.type.cast(option_value)
+        end
+
+        attribute.validate!(option_value)
+      end
+      # NOTE: (if-block: what if `if` receives `false`?):
+      #   For other case passed `attribute` is optional and
+      #   should not be type-checked/type-casted/etc.
+      #   But optional attributes with defined `default` setting should be
+      #   type-checked and type-casted.
+      #
+      #   TODO: it should be covered by tests
 
       final_value = attribute.finalizer.call(option_value, instance)
+      # NOTE: validae `final_value` if only the `option` is provided (passed to constructor)
+      attribute.validate!(final_value) if options.key?(attribute.name)
+
       instance.instance_variable_set("@#{attribute.name}", final_value)
     end
   end
+  # rubocop:enable Metrics/AbcSize
 
   # @param instance [Any]
   # @return [void]
@@ -157,7 +175,7 @@ class SmartCore::Initializer::Constructor
   # @api private
   # @since 0.1.0
   def process_original_initializer(instance)
-    instance.send(:initialize, *arguments, &block)
+    instance.__send__(:initialize, *arguments, &block)
   end
 
   # @param instance [Any]

data/lib/smart_core/initializer/dsl.rb

@@ -108,37 +108,42 @@ module SmartCore::Initializer::DSL
     # @option cast [Boolean]
     # @option privacy [String, Symbol]
     # @option finalize [String, Symbol, Proc]
-    # @option read_only [Boolean]
+    # @option mutable [Boolean]
     # @option as [NilClass, String, Symbol]
-    # @param dynamic_options [Hash<Symbol,Any>]
     # @return [void]
     #
     # @api public
     # @since 0.1.0
-    # @version 0.4.0
+    # @version 0.8.0
     def param(
       name,
       type = __initializer_settings__.generic_type_object,
-      privacy: SmartCore::Initializer::Attribute::Parameters::DEFAULT_PRIVACY_MODE,
-      finalize: SmartCore::Initializer::Attribute::Parameters::DEFAULT_FINALIZER,
-      cast: SmartCore::Initializer::Attribute::Parameters::DEFAULT_CAST_BEHAVIOUR,
+      privacy: SmartCore::Initializer::Attribute::Value::Param::DEFAULT_PRIVACY_MODE,
+      finalize: SmartCore::Initializer::Attribute::Value::Param::DEFAULT_FINALIZER,
+      cast: __initializer_settings__.auto_cast,
       type_system: __initializer_settings__.type_system,
-      read_only: SmartCore::Initializer::Attribute::Parameters::DEFAULT_READ_ONLY,
-      as: SmartCore::Initializer::Attribute::Parameters::DEFAULT_AS,
-      **dynamic_options
+      mutable: SmartCore::Initializer::Attribute::Value::Param::DEFAULT_MUTABLE,
+      as: SmartCore::Initializer::Attribute::Value::Param::DEFAULT_AS
     )
       __definer__.define_parameter(
-        name, type, type_system, privacy, finalize, cast, read_only, as, dynamic_options
+        name, type, type_system, privacy, finalize, cast, mutable, as
       )
     end
 
     # @param names [Array<String, Symbol>]
+    # @option mutable [Boolean]
+    # @option privacy [String, Symbol]
     # @return [void]
     #
     # @api public
     # @since 0.1.0
-    def params(*names)
-      __definer__.define_parameters(*names)
+    # @verison 0.8.0
+    def params(
+      *names,
+      mutable: SmartCore::Initializer::Attribute::Value::Param::DEFAULT_MUTABLE,
+      privacy: SmartCore::Initializer::Attribute::Value::Param::DEFAULT_PRIVACY_MODE
+    )
+      __definer__.define_parameters(*names, mutable: mutable, privacy: privacy)
     end
 
     # @param name [String, Symbol]
@@ -147,37 +152,46 @@ module SmartCore::Initializer::DSL
     # @option privacy [String, Symbol]
     # @option finalize [String, Symbol, Proc]
     # @option type_system [String, Symbol]
-    # @option read_only [Boolean]
+    # @option mutable [Boolean]
     # @option as [NilClass, String, Symbol]
-    # @param dynamic_options [Hash<Symbol,Any>]
+    # @option default [Proc, Any]
+    # @option optional [Boolean]
     # @return [void]
     #
     # @api public
     # @since 0.1.0
-    # @version 0.4.0
+    # @version 0.8.0
     def option(
       name,
       type = __initializer_settings__.generic_type_object,
-      privacy: SmartCore::Initializer::Attribute::Parameters::DEFAULT_PRIVACY_MODE,
-      finalize: SmartCore::Initializer::Attribute::Parameters::DEFAULT_FINALIZER,
-      cast: SmartCore::Initializer::Attribute::Parameters::DEFAULT_CAST_BEHAVIOUR,
+      privacy: SmartCore::Initializer::Attribute::Value::Option::DEFAULT_PRIVACY_MODE,
+      finalize: SmartCore::Initializer::Attribute::Value::Option::DEFAULT_FINALIZER,
+      cast: __initializer_settings__.auto_cast,
       type_system: __initializer_settings__.type_system,
-      read_only: SmartCore::Initializer::Attribute::Parameters::DEFAULT_READ_ONLY,
-      as: SmartCore::Initializer::Attribute::Parameters::DEFAULT_AS,
-      **dynamic_options
+      mutable: SmartCore::Initializer::Attribute::Value::Option::DEFAULT_MUTABLE,
+      as: SmartCore::Initializer::Attribute::Value::Option::DEFAULT_AS,
+      default: SmartCore::Initializer::Attribute::Value::Option::UNDEFINED_DEFAULT,
+      optional: SmartCore::Initializer::Attribute::Value::Option::DEFAULT_OPTIONAL
     )
       __definer__.define_option(
-        name, type, type_system, privacy, finalize, cast, read_only, as, dynamic_options
+        name, type, type_system, privacy, finalize, cast, mutable, as, default, optional
       )
     end
 
     # @param names [Array<String, Symbol>]
+    # @option mutable [Boolean]
+    # @option privacy [String, Symbol]
     # @return [void]
     #
     # @api public
     # @since 0.1.0
-    def options(*names)
-      __definer__.define_options(*names)
+    # @version 0.8.0
+    def options(
+      *names,
+      mutable: SmartCore::Initializer::Attribute::Value::Option::DEFAULT_MUTABLE,
+      privacy: SmartCore::Initializer::Attribute::Value::Option::DEFAULT_PRIVACY_MODE
+    )
+      __definer__.define_options(*names, mutable: mutable, privacy: privacy)
     end
 
     # @param block [Block]

data/lib/smart_core/initializer/errors.rb

@@ -9,6 +9,14 @@ module SmartCore::Initializer
   # @since 0.1.0
   ArgumentError = Class.new(SmartCore::ArgumentError)
 
+  # @api public
+  # @since 0.8.0
+  AttributeError = Class.new(Error)
+
+  # @api public
+  # @since 0.8.0
+  UndefinedAttributeError = Class.new(AttributeError)
+
   # @api public
   # @since 0.1.0
   ParameterArgumentError = Class.new(ArgumentError)
@@ -17,6 +25,14 @@ module SmartCore::Initializer
   # @since 0.1.0
   OptionArgumentError = Class.new(ArgumentError)
 
+  # @api public
+  # @since 0.8.0
+  AliasArgumentError = Class.new(ArgumentError)
+
+  # @api public
+  # @since 0.8.0
+  SettingArgumentError = Class.new(ArgumentError)
+
   # @api public
   # @since 0.1.0
   NoDefaultValueError = Class.new(Error)
@@ -53,6 +69,10 @@ module SmartCore::Initializer
   # @since 0.1.0
   TypeSystemError = Class.new(Error)
 
+  # @api public
+  # @since 0.5.1
+  IncorrectTypeError = Class.new(TypeSystemError)
+
   # @api public
   # @since 0.1.0
   TypeAliasNotFoundError = Class.new(TypeSystemError)
@@ -73,10 +93,6 @@ module SmartCore::Initializer
   # @since 0.1.0
   UnsupportedTypeOperationError = Class.new(TypeSystemError)
 
-  # @api public
-  # @since 0.5.1
-  IncorrectTypeError = Class.new(TypeSystemError)
-
   # @api public
   # @since 0.1.0
   TypeCastingUnsupportedError = Class.new(UnsupportedTypeOperationError)

data/lib/smart_core/initializer/functionality.rb

@@ -3,23 +3,22 @@
 # @api private
 # @since 0.3.0
 module SmartCore::Initializer::Functionality
-  # @return [NilClass]
-  #
-  # @api private
-  # @since 0.3.0
-  INITIAL_TYPE_SYSTEM = nil
-
   class << self
-    # @option type_system [String, Symbol, NilClass]
+    # @option type_system [String, Symbol]
+    # @option strict_option [Boolean]
+    # @option auto_cast [Boolean]
     # @return [Module]
     #
     # @api private
     # @since 0.3.0
-    def includable_module(type_system: INITIAL_TYPE_SYSTEM)
+    # @version 0.8.0
+    def includable_module(type_system:, strict_options:, auto_cast:)
       Module.new.tap do |extension|
         extension.singleton_class.define_method(:included) do |base_klass|
           base_klass.include(::SmartCore::Initializer)
           base_klass.__initializer_settings__.type_system = type_system
+          base_klass.__initializer_settings__.strict_options = strict_options
+          base_klass.__initializer_settings__.auto_cast = auto_cast
         end
       end
     end

data/lib/smart_core/initializer/settings/auto_cast.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.8.0
+class SmartCore::Initializer::Settings::AutoCast < SmartCore::Initializer::Settings::Base
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def initialize
+    @value = nil
+    @lock = SmartCore::Engine::Lock.new
+  end
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.8.0
+  def resolve
+    thread_safe do
+      @value == nil ? SmartCore::Initializer::Configuration[:auto_cast] : @value
+    end
+  end
+
+  # @param value [Boolean]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def assign(value)
+    thread_safe do
+      raise(
+        SmartCore::Initializer::SettingArgumentError,
+        ":auto_cast setting should be a type of boolean (got: `#{value.class}`)"
+      ) unless value.is_a?(::TrueClass) || value.is_a?(::FalseClass)
+
+      @value = value
+    end
+  end
+end

data/lib/smart_core/initializer/settings/base.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.8.0
+class SmartCore::Initializer::Settings::Base
+  # @return [void]
+  #
+  # @api private
+  # @since 0.8.0
+  def initialize
+    @value = nil
+    @lock = SmartCore::Engine::Lock.new
+  end
+
+  # @!method resolve
+  #   @return [Any]
+  #   @api private
+  #   @since 0.8.0
+
+  # @!method assign(value)
+  #   @param value [Any]
+  #   @return [void]
+  #   @raise [SmartCore::Initializer::SettingArgumentError]
+  #   @api private
+  #   @since 0.8.0
+
+  # @return [SmartCore::Initializer::Settings::Base]
+  #
+  # @api private
+  # @since 0.8.0
+  def dup
+    thread_safe do
+      self.class.new.tap do |duplicate|
+        duplicate.instance_variable_set(:@value, @value)
+      end
+    end
+  end
+
+  private
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.8.0
+  def thread_safe(&block)
+    @lock.synchronize(&block)
+  end
+end