smart_initializer 0.1.0.alpha4 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 045121a7aff669e936532780b634d3212d6063c051534bb465efc3a81fdcfb8c
-  data.tar.gz: f3aee4d1ada5fbb1dea05a39b7b81beb34096a75b41e641a15ddee7ea04e049a
+  metadata.gz: b5f516b06f95abb4c257cf0507897bd8d9ee65a27db12f117c3f54fd8cbefab7
+  data.tar.gz: be6bf05b4dbdbca0cafde4ac3097926e4d5b45ea5f3a0c21f4e0679bf0a4e590
 SHA512:
-  metadata.gz: ede12d393005f5c9c60fb33f063bbc8cd5ae12ecdb831f7b1219538b6e66a0adb8002fe9f0608e03fbc9831ac653d0a3c9e038c65d4a26cf7b1724608b105169
-  data.tar.gz: e4b976324cdbe52f4e2a9546ff621987c9536f1faf08468b68a2bc2e25cb2b98e2560a2d46f0dd76ec5559e60f577018993a3ffb35c5f742987fd3e88a79c125
+  metadata.gz: b00d4d9be6148a7b24c6fe9b178b99d7934bb05fa6751d857a2d2c62abc1d3b5640ae6099b264f0c27c570e9e62632ae9f3f870e1a0ddb91bf51c6c3e9f23577
+  data.tar.gz: 28aad37b3850085764aed335bd93da10295f6f4e3cb32f76bf5a3dcac55fac2f1cd60de3f73fb4778f8e661662291c2c2deff3efbfd69dc8edce75c04cadd2ec

data/.rubocop.yml

@@ -5,7 +5,7 @@ inherit_gem:
     - lib/rubocop.rspec.yml
 
 AllCops:
-  TargetRubyVersion: 2.4.9
+  TargetRubyVersion: 2.7.1
   Include:
     - lib/**/*.rb
     - spec/**/*.rb

data/.travis.yml

@@ -2,19 +2,50 @@
 language: ruby
 cache: bundler
 os: linux
-before_install: gem install bundler -v 2.1.2
+dist: xenial
+before_install: gem install bundler
 script:
 - bundle exec rake rubocop
 - bundle exec rake rspec
 jobs:
   fast_finish: true
   include:
-  - rvm: 2.4.9
-  - rvm: 2.5.7
-  - rvm: 2.6.5
-  - rvm: 2.7.0
+  - rvm: 2.4.10
+    gemfile: gemfiles/with_external_deps.gemfile
+    env: TEST_PLUGINS=true FULL_TEST_COVERAGE_CHECK=true
+  - rvm: 2.5.8
+    gemfile: gemfiles/with_external_deps.gemfile
+    env: TEST_PLUGINS=true FULL_TEST_COVERAGE_CHECK=true
+  - rvm: 2.6.6
+    gemfile: gemfiles/with_external_deps.gemfile
+    env: TEST_PLUGINS=true FULL_TEST_COVERAGE_CHECK=true
+  - rvm: 2.7.1
+    gemfile: gemfiles/with_external_deps.gemfile
+    env: TEST_PLUGINS=true FULL_TEST_COVERAGE_CHECK=true
   - rvm: ruby-head
+    gemfile: gemfiles/with_external_deps.gemfile
+    env: TEST_PLUGINS=true FULL_TEST_COVERAGE_CHECK=true
   - rvm: jruby-head
+    gemfile: gemfiles/with_external_deps.gemfile
+    env: TEST_PLUGINS=true FULL_TEST_COVERAGE_CHECK=true
+  - rvm: truffleruby
+    gemfile: gemfiles/with_external_deps.gemfile
+    env: TEST_PLUGINS=true FULL_TEST_COVERAGE_CHECK=true
+  - rvm: 2.4.10
+    gemfile: gemfiles/without_external_deps.gemfile
+  - rvm: 2.5.8
+    gemfile: gemfiles/without_external_deps.gemfile
+  - rvm: 2.6.6
+    gemfile: gemfiles/without_external_deps.gemfile
+  - rvm: 2.7.1
+    gemfile: gemfiles/without_external_deps.gemfile
+  - rvm: ruby-head
+    gemfile: gemfiles/without_external_deps.gemfile
+  - rvm: jruby-head
+    gemfile: gemfiles/without_external_deps.gemfile
+  - rvm: truffleruby
+    gemfile: gemfiles/without_external_deps.gemfile
   allow_failures:
   - rvm: ruby-head
   - rvm: jruby-head
+  - rvm: truffleruby

data/CHANGELOG.md

@@ -1,2 +1,25 @@
 # Changelog
 All notable changes to this project will be documented in this file.
+
+## [0.3.2] - 2020-07-12
+### Fixed
+- Deeply inherited entities lose their `__initializer_settings__` entitiy;
+
+## [0.3.1] - 2020-07-12
+### Fixed
+- Deeply inherited entities lose their class attribute definers;
+
+## [0.3.0] - 2020-07-11
+### Added
+- `extend_initialization_flow` alias method for `SmartCore::Initializer.ext_init`;
+- Access methods to the instance attribute lists (`#__params`, `#__options__`, `#__attributes__`);
+
+### Changed
+- Updated development dependencies;
+
+## [0.2.0] - 2020-05-16
+### Changed
+- **Constructor**: disallow unknown option attributes;
+
+## [0.1.0] - 2020-05-10
+- Release :)

data/Gemfile.lock

@@ -1,80 +1,100 @@
 PATH
   remote: .
   specs:
-    smart_initializer (0.1.0.alpha3)
-      smart_engine (~> 0.5)
-      smart_types (~> 0.1.0.alpha6)
+    smart_initializer (0.3.1)
+      qonfig (~> 0.24)
+      smart_engine (~> 0.7)
+      smart_types (~> 0.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    armitage-rubocop (0.79.0)
-      rubocop (= 0.79.0)
-      rubocop-performance (= 1.5.2)
-      rubocop-rails (= 2.4.1)
-      rubocop-rake (= 0.5.0)
-      rubocop-rspec (= 1.37.1)
-    ast (2.4.0)
-    diff-lcs (1.3)
+    activesupport (6.0.3.2)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+      zeitwerk (~> 2.2, >= 2.2.2)
+    armitage-rubocop (0.87.1.2)
+      rubocop (= 0.87.1)
+      rubocop-performance (= 1.7.0)
+      rubocop-rails (= 2.6.0)
+      rubocop-rake (= 0.5.1)
+      rubocop-rspec (= 1.42.0)
+    ast (2.4.1)
+    concurrent-ruby (1.1.6)
+    diff-lcs (1.4.4)
     docile (1.3.2)
-    jaro_winkler (1.5.4)
-    json (2.3.0)
-    parallel (1.19.1)
-    parser (2.7.0.2)
-      ast (~> 2.4.0)
-    rack (2.1.1)
+    i18n (1.8.3)
+      concurrent-ruby (~> 1.0)
+    minitest (5.14.1)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      ast (~> 2.4.1)
+    qonfig (0.24.1)
+    rack (2.2.3)
     rainbow (3.0.0)
     rake (13.0.1)
+    regexp_parser (1.7.1)
+    rexml (3.2.4)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
       rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.0)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
-    rubocop (0.79.0)
-      jaro_winkler (~> 1.5.1)
+    rspec-support (3.9.3)
+    rubocop (0.87.1)
       parallel (~> 1.10)
-      parser (>= 2.7.0.1)
+      parser (>= 2.7.1.1)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.1.0, < 1.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
-    rubocop-performance (1.5.2)
-      rubocop (>= 0.71.0)
-    rubocop-rails (2.4.1)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.1.0)
+      parser (>= 2.7.0.1)
+    rubocop-performance (1.7.0)
+      rubocop (>= 0.82.0)
+    rubocop-rails (2.6.0)
+      activesupport (>= 4.2.0)
       rack (>= 1.1)
-      rubocop (>= 0.72.0)
-    rubocop-rake (0.5.0)
+      rubocop (>= 0.82.0)
+    rubocop-rake (0.5.1)
       rubocop
-    rubocop-rspec (1.37.1)
-      rubocop (>= 0.68.1)
+    rubocop-rspec (1.42.0)
+      rubocop (>= 0.87.0)
     ruby-progressbar (1.10.1)
-    simplecov (0.17.1)
+    simplecov (0.18.5)
       docile (~> 1.1)
-      json (>= 1.8, < 3)
-      simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.2)
-    smart_engine (0.5.0)
-    smart_types (0.1.0.alpha6)
-      smart_engine (~> 0.5)
-    unicode-display_width (1.6.1)
+      simplecov-html (~> 0.11)
+    simplecov-html (0.12.2)
+    smart_engine (0.7.0)
+    smart_types (0.1.0)
+      smart_engine (~> 0.6)
+    thread_safe (0.3.6)
+    tzinfo (1.2.7)
+      thread_safe (~> 0.1)
+    unicode-display_width (1.7.0)
+    zeitwerk (2.3.1)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  armitage-rubocop (~> 0.78)
+  armitage-rubocop (~> 0.87)
   bundler (~> 2.1)
   rake (~> 13.0)
   rspec (~> 3.9)
-  simplecov (~> 0.17)
+  simplecov (~> 0.18)
   smart_initializer!
 
 BUNDLED WITH
-   2.1.2
+   2.1.4

data/README.md

@@ -1,6 +1,7 @@
 # SmartCore::Initializer · [![Gem Version](https://badge.fury.io/rb/smart_initializer.svg)](https://badge.fury.io/rb/smart_initializer) [![Build Status](https://travis-ci.org/smart-rb/smart_initializer.svg?branch=master)](https://travis-ci.org/smart-rb/smart_initializer)
 
-A simple and convenient way to declare complex constructors (**in active development**).
+A simple and convenient way to declare complex constructors with a support for various commonly used type systems.
+ (**in active development**).
 
 ## Installation
 
@@ -11,11 +12,11 @@ gem 'smart_initializer'
 ```shell
 bundle install
 # --- or ---
-gem install smart_types
+gem install smart_initializer
 ```
 
 ```ruby
-require 'smart_core/types'
+require 'smart_core/initializer'
 ```
 
 ---
@@ -23,8 +24,13 @@ require 'smart_core/types'
 ## Table of contents
 
 - [Synopsis](#synopsis)
-- [Type Aliasing](#type-aliasing)
+- [Access to the instance attributes](#access-to-the-instance-attributes)
+- [Configuration](#configuration)
+- [Type aliasing](#type-aliasing)
 - [Initialization extension](#initialization-extension)
+- [Plugins](#plugins)
+  - [thy-types](#plugin-thy-types)
+- [How to run tests](#how-to-run-tests)
 
 ---
 
@@ -42,25 +48,50 @@ require 'smart_core/types'
   - `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>,
@@ -68,7 +99,8 @@ option ,
        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:
@@ -77,6 +109,8 @@ 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) }
@@ -90,37 +124,84 @@ User.new(1, 'John', 'test123', role: :admin, metadata: {}, enabled: false)
 
 ---
 
+## Access to the instance attributes
+
+- `#__params__` - returns a list of initialized params;
+- `#__options__` - returns a list of initialized options;
+- `#__attributes__` - returns a list of merged params and options;
+
+```ruby
+class User
+  include SmartCore::Initializer
+
+  param :first_name, 'string'
+  param :second_name, 'string'
+  option :age, 'numeric'
+  option :is_admin, 'boolean', default: true
+end
+
+user = User.new('Rustam', 'Ibragimov', age: 28)
+
+user.__params__ # => { first_name: 'Rustam', second_name: 'Ibragimov' }
+user.__options__ # => { age: 28, is_admin: true }
+user.__attributes__ # => { first_name: 'Rustam', second_name: 'Ibragimov', age: 28, is_admin: true }
+```
+
+---
+
+## 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
+```
 
 ---
 
@@ -129,6 +210,7 @@ end
 - `ext_init(&block)`:
   - you can define as many extensions as you want;
   - extensions are invoked in the order they are defined;
+  - alias method: `extend_initialization_flow`;
 
 ```ruby
 class User
@@ -150,6 +232,82 @@ 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', 'iamdaiver@gmail.com', { admin: true, age: 19 })
+# => new user object
+
+# invalid case (invalid age)
+User.new('daiver', 'iamdaiver@gmail.com', { 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 -n
+```
+
+- help message:
+
+```shell
+bin/rspec -h
+```
+
+---
+
 ## Contributing
 
 - Fork it ( https://github.com/smart-rb/smart_initializer )