README.md in smart_initializer-0.1.0.alpha4 vs README.md in smart_initializer-0.1.0

@@ -23,10 +23,13 @@
 ## Table of contents
 
 - [Synopsis](#synopsis)
 - [Type Aliasing](#type-aliasing)
 - [Initialization extension](#initialization-extension)
+- [Plugins](#plugins)
+  - [thy-types](#plugin-thy-types)
+- [How to run tests](#how-to-run-tests)
 
 ---
 
 ## Synopsis
 
@@ -40,45 +43,73 @@
 
 - `param` - defines name-like attribute:
   - `cast` - type-cast received value if value has invalid type;
   - `privacy` - reader incapsulation level;
   - `finalize` - value post-processing (receives method name or proc);
+  - `type_system` - differently chosen type system for the current attribute;
   - (limitation) param has no `:default` option;
 - `option` - defined kwarg-like attribute:
   - `cast` - type-cast received value if value has invalid type;
   - `privacy` - reader incapsulation level;
   - `finalize` - value post-processing (receives method name or proc);
   - `default` - defalut value (if an attribute is not provided);
+  - `type_system` - differently chosen type system for the current attribute;
 - last `Hash` argument will be treated as `kwarg`s;
 
-`param` signautre:
+#### initializer integration
 
 ```ruby
+# with pre-configured type system (:smart_types, see Configuration doc)
+
+class MyStructure
+  include SmartCore::Initializer
+end
+```
+
+```ruby
+# with manually chosen type system
+
+class MyStructure
+  include SmartCore::Initializer(type_system: :smart_types)
+end
+
+class AnotherStructure
+  include SmartCore::Initializer(type_system: :thy_types)
+end
+```
+
+#### `param` signautre:
+
+```ruby
 param <attribute_name>,
       <type=SmartCore::Types::Value::Any>, # Any by default
       cast: false, # false by default
       privacy: :public, # :public by default
-      finalize: proc { |value| value } # no finalization by default
+      finalize: proc { |value| value }, # no finalization by default
+      type_system: :smart_types # used by default
 ```
 
-`option` signature:
+#### `option` signature:
 
 ```ruby
 option <attribute_name>,
        <type=SmartCore::Types::Value::Any>, # Any by default
        cast: false, # false by default
        privacy: :public, # :public by default
        finalize: proc { |value| value }, # no finalization by default
-       default: 123 # no default value by default
+       default: 123, # no default value by default
+       type_system: :smart_types # used by default
 ```
 
 Example:
 
 
 ```ruby
 class User
   include SmartCore::Initializer
+  # --- or ---
+  include SmartCore::Initializer(type_system: :smart_types)
 
   param :user_id, SmartCore::Types::Value::Integer, cast: false, privacy: :public
   option :role, default: :user, finalize: -> { |value| Role.find(name: value) }
 
   params :name, :password
@@ -88,42 +119,64 @@
 User.new(1, 'John', 'test123', role: :admin, metadata: {}, enabled: false)
 ```
 
 ---
 
+## Configuration
+
+- based on `Qonfig` gem;
+- you can read config values via `[]` or `.config.settings` or `.config[key]`;
+- setitngs:
+  - `default_type_system` - default type system (`smart_types` by default);
+
+```ruby
+# configure:
+SmartCore::Initializer::Configuration.configure do |config|
+  config.default_type_system = :smart_types # default setting value
+end
+```
+
+```ruby
+# read:
+SmartCore::Initializer::Configuration[:default_type_system]
+SmartCore::Initializer::Configuration.config[:default_type_system]
+SmartCore::Initializer::Configuration.config.settings.default_type_system
+```
+
+---
+
 ## Type aliasing
 
 - Usage:
 
 ```ruby
-# define your own type alias
-SmartCore::Initializer.type_alias(:hash, SmartCore::Types::Value::Hash)
+# for smart_types:
+SmartCore::Initializer::TypeSystem::SmartTypes.type_alias('hsh', SmartCore::Types::Value::Hash)
 
+# for thy:
+SmartCore::Initializer::TypeSystem::ThyTypes.type_alias('int', Thy::Tyhes::Integer)
+
 class User
   include SmartCore::Initializer
 
-  param :data, :hash # use your new defined type alias
-  option :metadata, :hash # use your new defined type alias
+  param :data, 'hsh' # use your new defined type alias
+  option :metadata, :hsh # use your new defined type alias
+
+  param :age, 'int', type_system: :thy_types
 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`
 
+```ruby
+# for smart_types:
+SmartCore::Initializer::TypeSystem::SmartTypes.type_aliases
+
+# for thy_types:
+SmartCore::Initializer::TypeSystem::ThyTypes.type_aliases
+```
+
 ---
 
 ## Initialization extension
 
 - `ext_init(&block)`:
@@ -144,9 +197,85 @@
 user = User.new(name: 'keka', age: 123)
 user.name # => 'keka'
 user.age # => 123
 user.extra # => :ext1
 user.extra2 # => :ext2
+```
+
+---
+
+## Plugins
+
+- [thy-types](#plugin-thy-types)
+
+---
+
+## Plugin: thy-types
+
+Support for `Thy::Types` type system ([gem](https://github.com/akxcv/thy))
+
+- install `thy` types (`gem install thy`):
+
+```ruby
+gem 'thy'
+```
+
+```shell
+bundle install
+```
+
+- enable `thy_types` plugin:
+
+```ruby
+require 'thy'
+SmartCore::Initializer::Configuration.plugin(:thy_types)
+```
+
+- usage:
+
+```ruby
+class User
+  include SmartCore::Initializer(type_system: :thy_types)
+
+  param :nickname, 'string'
+  param :email, 'value.text', type_system: :smart_types # mixing with smart_types
+  option :admin, Thy::Types::Boolean, default: false
+  option :age, (Thy::Type.new { |value| value > 18 }) # custom thy type is supported too
+end
+
+# valid case:
+User.new('daiver', '[e-mail]', { admin: true, age: 19 })
+# => new user object
+
+# invalid case (invalid age)
+User.new('daiver', '[e-mail]', { age: 17 })
+# SmartCore::Initializer::ThyTypeValidationError
+
+# invaldi case (invalid nickname)
+User.new(123, 'test', { admin: true, age: 22 })
+# => SmartCore::Initializer::ThyTypeValidationError
+```
+
+---
+
+## How to run tests
+
+- with plugin tests:
+
+```shell
+bin/rspec -w
+```
+
+- without plugin tests:
+
+```shell
+bin/rspec -g
+```
+
+- help message:
+
+```shell
+bin/rspec -h
 ```
 
 ---
 
 ## Contributing