smart_initializer 0.1.0.alpha3 → 0.1.0.alpha4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 483a56f55f7fb7b8e67eb20b1779df0b59f33935544d19cd6c5cd0e018e9b3b1
-  data.tar.gz: 9b1fc252e8821e68b22d38fe06e0418e5792860bc6e583caafd4ff5f786f509a
+  metadata.gz: 045121a7aff669e936532780b634d3212d6063c051534bb465efc3a81fdcfb8c
+  data.tar.gz: f3aee4d1ada5fbb1dea05a39b7b81beb34096a75b41e641a15ddee7ea04e049a
 SHA512:
-  metadata.gz: d77018f9b4be1a8f0c7befa771313d01debf97144e2bdc0d10248f357347eedeb6c0734997e6946fa0a35b810a6d7a1b59c395c8855f9e708a48021f0a94c9e7
-  data.tar.gz: 9cf8e06b7d6c89951330beff5698cca00502183ed625b06c3e620a6e6df0d654db4b55788d26a68b9da390217d9eb42966b609a773ebd5baa3e71bfa6d838f17
+  metadata.gz: ede12d393005f5c9c60fb33f063bbc8cd5ae12ecdb831f7b1219538b6e66a0adb8002fe9f0608e03fbc9831ac653d0a3c9e038c65d4a26cf7b1724608b105169
+  data.tar.gz: e4b976324cdbe52f4e2a9546ff621987c9536f1faf08468b68a2bc2e25cb2b98e2560a2d46f0dd76ec5559e60f577018993a3ffb35c5f742987fd3e88a79c125

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    smart_initializer (0.1.0.alpha2)
+    smart_initializer (0.1.0.alpha3)
       smart_engine (~> 0.5)
       smart_types (~> 0.1.0.alpha6)
 

data/README.md

@@ -20,8 +20,22 @@ require 'smart_core/types'
 
 ---
 
+## Table of contents
+
+- [Synopsis](#synopsis)
+- [Type Aliasing](#type-aliasing)
+- [Initialization extension](#initialization-extension)
+
+---
+
 ## Synopsis
 
+**Initialization flow**:
+
+1. Parameter + Option definitioning;
+2. Original #initialize invokation;
+3. Initialization extensions invokation;
+
 **Constructor definition**:
 
 - `param` - defines name-like attribute:
@@ -78,6 +92,8 @@ User.new(1, 'John', 'test123', role: :admin, metadata: {}, enabled: false)
 
 ## Type aliasing
 
+- Usage:
+
 ```ruby
 # define your own type alias
 SmartCore::Initializer.type_alias(:hash, SmartCore::Types::Value::Hash)
@@ -90,6 +106,48 @@ class User
 end
 ```
 
+- Predefined aliases:
+  - `:nil` => `SmartCore::Types::Value::Nil`
+  - `:string` => `SmartCore::Types::Value::String`
+  - `:symbol` => `SmartCore::Types::Value::Symbol`
+  - `:text` => `SmartCore::Types::Value::Text`
+  - `:integer` => `SmartCore::Types::Value::Integer`
+  - `:float` => `SmartCore::Types::Value::Float`
+  - `:numeric` => `SmartCore::Types::Value::Numeric`
+  - `:boolean` => `SmartCore::Types::Value::Boolean`
+  - `:array` => `SmartCore::Types::Value::Array`
+  - `:hash` => `SmartCore::Types::Value::Hash`
+  - `:proc` => `SmartCore::Types::Value::Proc`
+  - `:class` => `SmartCore::Types::Value::Class`
+  - `:module` => `SmartCore::Types::Value::Module`
+  - `:any` => `SmartCore::Types::Value::Any`
+
+---
+
+## Initialization extension
+
+- `ext_init(&block)`:
+  - you can define as many extensions as you want;
+  - extensions are invoked in the order they are defined;
+
+```ruby
+class User
+  include SmartCore::Initializer
+
+  option :name, :name
+  option :age, :integer
+
+  ext_init { |instance| instance.define_singleton_method(:extra) { :ext1 } }
+  ext_init { |instance| instance.define_singleton_method(:extra2) { :ext2 } }
+end
+
+user = User.new(name: 'keka', age: 123)
+user.name # => 'keka'
+user.age # => 123
+user.extra # => :ext1
+user.extra2 # => :ext2
+```
+
 ---
 
 ## Contributing

data/lib/smart_core/initializer/attribute/init_extension.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+class SmartCore::Initializer::Attribute::InitExtention
+end

data/lib/smart_core/initializer/attribute.rb

@@ -6,7 +6,6 @@ class SmartCore::Initializer::Attribute
   require_relative 'attribute/parameters'
   require_relative 'attribute/list'
   require_relative 'attribute/finalizer'
-  require_relative 'attribute/definer'
   require_relative 'attribute/factory'
 
   # @since 0.1.0

data/lib/smart_core/initializer/{attribute → constructor}/definer.rb

@@ -2,7 +2,7 @@
 
 # @api private
 # @since 0.1.0
-class SmartCore::Initializer::Attribute::Definer
+class SmartCore::Initializer::Constructor::Definer
   # @param klass [Class]
   # @return [void]
   #
@@ -13,6 +13,17 @@ class SmartCore::Initializer::Attribute::Definer
     @lock = SmartCore::Engine::Lock.new
   end
 
+  # @param block [Proc]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def define_init_extension(block)
+    thread_safe do
+      add_init_extension(build_init_extension(block))
+    end
+  end
+
   # @param name [String, Symbol]
   # @param type [String, Symbol, SmartCore::Types::Primitive]
   # @param privacy [String, Symbol]
@@ -121,6 +132,15 @@ class SmartCore::Initializer::Attribute::Definer
     )
   end
 
+  # @param block [Proc]
+  # @return [SmartCore::Initializer::Extensions::ExtInit]
+  #
+  # @api private
+  # @since 0.1.0
+  def build_init_extension(block)
+    SmartCore::Initializer::Extensions::ExtInit.new(block)
+  end
+
   # @param parameter [SmartCore::Initializer::Attribute]
   # @return [void]
   #
@@ -143,6 +163,15 @@ class SmartCore::Initializer::Attribute::Definer
     klass.send(option.privacy, option.name)
   end
 
+  # @param extension [SmartCore::Initializer::Extensions::ExtInit]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def add_init_extension(extension)
+    klass.__init_extensions__ << extension
+  end
+
   # @param parameter [SmartCore::Initializer::Attribute]
   # @return [void]
   #

data/lib/smart_core/initializer/constructor.rb

@@ -3,6 +3,8 @@
 # @api private
 # @since 0.1.0
 class SmartCore::Initializer::Constructor
+  require_relative 'constructor/definer'
+
   # @param klass [Class<SmartCore::Initializer>]
   # @param arguments [Array<Any>]
   # @param block [Proc, NilClass]
@@ -27,6 +29,7 @@ class SmartCore::Initializer::Constructor
       initialize_parameters(instance)
       initialize_options(instance)
       process_original_initializer(instance)
+      process_init_extensions(instance)
     end
   end
 
@@ -143,6 +146,17 @@ class SmartCore::Initializer::Constructor
     instance.send(:initialize, *arguments, &block)
   end
 
+  # @param instance [Any]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def process_init_extensions(instance)
+    klass.__init_extensions__.each do |extension|
+      extension.call(instance)
+    end
+  end
+
   # @param arguments [Array<Any>]
   # @return [Array<Array<Any>,Hash<Symbol,Any>>]
   #

data/lib/smart_core/initializer/dsl/inheritance.rb

@@ -13,6 +13,7 @@ module SmartCore::Initializer::DSL::Inheritance
     def inherit(base:, child:)
       child.__params__.concat(base.__params__)
       child.__options__.concat(base.__options__)
+      child.__init_extensions__.concat(base.__init_extensions__)
     end
   end
 end

data/lib/smart_core/initializer/dsl.rb

@@ -13,9 +13,10 @@ module SmartCore::Initializer::DSL
     # @since 0.1.0
     def extended(base_klass)
       base_klass.instance_eval do
-        instance_variable_set(:@__params__,  SmartCore::Initializer::Attribute::List.new)
+        instance_variable_set(:@__params__, SmartCore::Initializer::Attribute::List.new)
         instance_variable_set(:@__options__, SmartCore::Initializer::Attribute::List.new)
-        instance_variable_set(:@__definer__, SmartCore::Initializer::Attribute::Definer.new(self))
+        instance_variable_set(:@__init_extensions__, SmartCore::Initializer::Extensions::List.new)
+        instance_variable_set(:@__definer__, SmartCore::Initializer::Constructor::Definer.new(self))
         instance_variable_set(:@__deflock__, SmartCore::Engine::Lock.new)
       end
       base_klass.extend(ClassMethods)
@@ -33,9 +34,10 @@ module SmartCore::Initializer::DSL
     # @since 0.1.0
     def inherited(child_klass)
       child_klass.instance_eval do
-        instance_variable_set(:@__params__,  SmartCore::Initializer::Attribute::List.new)
+        instance_variable_set(:@__params__, SmartCore::Initializer::Attribute::List.new)
         instance_variable_set(:@__options__, SmartCore::Initializer::Attribute::List.new)
-        instance_variable_set(:@__definer__, SmartCore::Initializer::Attribute::Definer.new(self))
+        instance_variable_set(:@__init_extensions__, SmartCore::Initializer::Extensions::List.new)
+        instance_variable_set(:@__definer__, SmartCore::Initializer::Constructor::Definer.new(self))
         instance_variable_set(:@__deflock__, SmartCore::Engine::Lock.new)
       end
       child_klass.extend(ClassMethods)
@@ -63,6 +65,14 @@ module SmartCore::Initializer::DSL
       @__options__
     end
 
+    # @return [SmartCore::Initializer::Extentions::List]
+    #
+    # @api private
+    # @since 0.1.0
+    def __init_extensions__
+      @__init_extensions__
+    end
+
     # @return [SmartCore::Initializer::Attribute::Definer]
     #
     # @api private
@@ -140,5 +150,14 @@ module SmartCore::Initializer::DSL
     def options(*names)
       __definer__.define_options(*names)
     end
+
+    # @param block [Block]
+    # @return [void]
+    #
+    # @api public
+    # @since 0.1.0
+    def ext_init(&block)
+      __definer__.define_init_extension(block)
+    end
   end
 end

data/lib/smart_core/initializer/extensions/abstract.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Initializer::Extensions::Abstract
+  # @!method dup
+  #   @return [SmartCore::Initializer::Extensions::Abstract]
+end

data/lib/smart_core/initializer/extensions/ext_init.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Initializer::Extensions::ExtInit < SmartCore::Initializer::Extensions::Abstract
+  # @param extender [Proc]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize(extender)
+    @extender = extender
+  end
+
+  # @param instance [Any]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def call(instance)
+    extender.call(instance)
+  end
+
+  private
+
+  # @return [Proc]
+  #
+  # @api private
+  # @since0 0.1.0
+  attr_reader :extender
+end

data/lib/smart_core/initializer/extensions/list.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+class SmartCore::Initializer::Extensions::List
+  # @since 0.1.0
+  include Enumerable
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def initialize
+    @extensions = []
+    @lock = SmartCore::Engine::Lock.new
+  end
+
+  # @param extension [SmartCore::Initializer::Extensions::Abstract]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def add(extension)
+    thread_safe { extensions << extension }
+  end
+  alias_method :<<, :add
+
+  # @param list [SmartCore::Initializer::Extensions::List]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.1.0
+  def concat(list)
+    thread_safe do
+      list.each { |extension| add(extension.dup) }
+    end
+  end
+
+  # @param block [Block]
+  # @return [Enumerable]
+  #
+  # @api private
+  # @since 0.1.0
+  def each(&block)
+    thread_safe do
+      block_given? ? extensions.each(&block) : extensions.each
+    end
+  end
+
+  # @return [Integer]
+  #
+  # @api private
+  # @since 0.1.0
+  def size
+    thread_safe { extensions.size }
+  end
+
+  private
+
+  # @return [Array<SmartCore::Initializer::Extensions::Abstract>]
+  #
+  # @api private
+  # @since 0.1.0
+  attr_reader :extensions
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def thread_safe(&block)
+    @lock.synchronize(&block)
+  end
+end

data/lib/smart_core/initializer/extensions.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.1.0
+module SmartCore::Initializer::Extensions
+  require_relative 'extensions/abstract'
+  require_relative 'extensions/ext_init'
+  require_relative 'extensions/list'
+end

data/lib/smart_core/initializer/version.rb

@@ -6,6 +6,6 @@ module SmartCore
     #
     # @api public
     # @since 0.1.0
-    VERSION = '0.1.0.alpha3'
+    VERSION = '0.1.0.alpha4'
   end
 end

data/lib/smart_core/initializer.rb

@@ -10,6 +10,7 @@ module SmartCore::Initializer
   require_relative 'initializer/version'
   require_relative 'initializer/errors'
   require_relative 'initializer/attribute'
+  require_relative 'initializer/extensions'
   require_relative 'initializer/constructor'
   require_relative 'initializer/dsl'
   require_relative 'initializer/type_aliasing'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smart_initializer
 version: !ruby/object:Gem::Version
-  version: 0.1.0.alpha3
+  version: 0.1.0.alpha4
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-02-01 00:00:00.000000000 Z
+date: 2020-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: smart_engine
@@ -130,18 +130,23 @@ files:
 - bin/setup
 - lib/smart_core/initializer.rb
 - lib/smart_core/initializer/attribute.rb
-- lib/smart_core/initializer/attribute/definer.rb
 - lib/smart_core/initializer/attribute/factory.rb
 - lib/smart_core/initializer/attribute/finalizer.rb
 - lib/smart_core/initializer/attribute/finalizer/abstract.rb
 - lib/smart_core/initializer/attribute/finalizer/anonymous_block.rb
 - lib/smart_core/initializer/attribute/finalizer/instance_method.rb
+- lib/smart_core/initializer/attribute/init_extension.rb
 - lib/smart_core/initializer/attribute/list.rb
 - lib/smart_core/initializer/attribute/parameters.rb
 - lib/smart_core/initializer/constructor.rb
+- lib/smart_core/initializer/constructor/definer.rb
 - lib/smart_core/initializer/dsl.rb
 - lib/smart_core/initializer/dsl/inheritance.rb
 - lib/smart_core/initializer/errors.rb
+- lib/smart_core/initializer/extensions.rb
+- lib/smart_core/initializer/extensions/abstract.rb
+- lib/smart_core/initializer/extensions/ext_init.rb
+- lib/smart_core/initializer/extensions/list.rb
 - lib/smart_core/initializer/type_aliasing.rb
 - lib/smart_core/initializer/type_aliasing/alias_list.rb
 - lib/smart_core/initializer/version.rb