smart_initializer 0.1.0.alpha4 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 045121a7aff669e936532780b634d3212d6063c051534bb465efc3a81fdcfb8c
-  data.tar.gz: f3aee4d1ada5fbb1dea05a39b7b81beb34096a75b41e641a15ddee7ea04e049a
+  metadata.gz: 756d03ef9a7c4f10bb075d1669bb4abe856d0dd6a68c0bd632b927a3a32662e6
+  data.tar.gz: 7deaef19a44a8e9a813bb5548aef332df88087b62f5cf6265929875f7eb20000
 SHA512:
-  metadata.gz: ede12d393005f5c9c60fb33f063bbc8cd5ae12ecdb831f7b1219538b6e66a0adb8002fe9f0608e03fbc9831ac653d0a3c9e038c65d4a26cf7b1724608b105169
-  data.tar.gz: e4b976324cdbe52f4e2a9546ff621987c9536f1faf08468b68a2bc2e25cb2b98e2560a2d46f0dd76ec5559e60f577018993a3ffb35c5f742987fd3e88a79c125
+  metadata.gz: 1c04e15b4f1896201bf08aec13c9bb2e5d770b65115960a9ca01d307088b04171f0c81beaa1b71d54fc2bf6888406d9e63ce0a49b5695baf41523f89b89ac85a
+  data.tar.gz: 3f3ff4b2fa17bb7727abdb1d73839bc954b0e0c2dba9f19ad8a46a95cfa9df3a17549bdfc73775d6753d799052a14f4e7a9732fefbb5dafbec5f20f72b8063b4

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,5 @@
 # Changelog
 All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2020-05-10
+- Release :)

data/Gemfile.lock

@@ -1,80 +1,97 @@
 PATH
   remote: .
   specs:
-    smart_initializer (0.1.0.alpha3)
-      smart_engine (~> 0.5)
-      smart_types (~> 0.1.0.alpha6)
+    smart_initializer (0.1.0.alpha4)
+      qonfig (~> 0.24)
+      smart_engine (~> 0.6)
+      smart_types (~> 0.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    armitage-rubocop (0.79.0)
-      rubocop (= 0.79.0)
+    activesupport (6.0.3)
+      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.82.0.2)
+      rubocop (= 0.82.0)
       rubocop-performance (= 1.5.2)
-      rubocop-rails (= 2.4.1)
-      rubocop-rake (= 0.5.0)
-      rubocop-rspec (= 1.37.1)
+      rubocop-rails (= 2.5.2)
+      rubocop-rake (= 0.5.1)
+      rubocop-rspec (= 1.39.0)
     ast (2.4.0)
+    concurrent-ruby (1.1.6)
     diff-lcs (1.3)
     docile (1.3.2)
+    i18n (1.8.2)
+      concurrent-ruby (~> 1.0)
     jaro_winkler (1.5.4)
-    json (2.3.0)
+    minitest (5.14.0)
     parallel (1.19.1)
-    parser (2.7.0.2)
+    parser (2.7.1.2)
       ast (~> 2.4.0)
-    rack (2.1.1)
+    qonfig (0.24.1)
+    rack (2.2.2)
     rainbow (3.0.0)
     rake (13.0.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)
+    rspec-support (3.9.3)
+    rubocop (0.82.0)
       jaro_winkler (~> 1.5.1)
       parallel (~> 1.10)
       parser (>= 2.7.0.1)
       rainbow (>= 2.2.2, < 4.0)
+      rexml
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
     rubocop-performance (1.5.2)
       rubocop (>= 0.71.0)
-    rubocop-rails (2.4.1)
+    rubocop-rails (2.5.2)
+      activesupport
       rack (>= 1.1)
       rubocop (>= 0.72.0)
-    rubocop-rake (0.5.0)
+    rubocop-rake (0.5.1)
       rubocop
-    rubocop-rspec (1.37.1)
+    rubocop-rspec (1.39.0)
       rubocop (>= 0.68.1)
     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.6.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.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  armitage-rubocop (~> 0.78)
+  armitage-rubocop (~> 0.81)
   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

@@ -25,6 +25,9 @@ require 'smart_core/types'
 - [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)
 
 ---
 
@@ -42,25 +45,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 +96,8 @@ option <attribute_name>,
        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 +106,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 +121,59 @@ 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
+```
 
 ---
 
@@ -150,6 +203,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 -g
+```
+
+- help message:
+
+```shell
+bin/rspec -h
+```
+
+---
+
 ## Contributing
 
 - Fork it ( https://github.com/smart-rb/smart_initializer )