smart_engine 0.8.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 228fbd594308ecee71718fe059d6d8bf57f8e79f33b0607ca4b771fc498a0ac4
-  data.tar.gz: 809d274f771a7de133a1bc8986448ffca67bcefa2f0fd5f3a5d39cf730c448fa
+  metadata.gz: dc3dd0221b83c217c01e45d3f46604971eb84d04d49be0632ce49f755218d76d
+  data.tar.gz: 5b441d31174be2b6d449f7075abea95b5f0ede317db8e416f07245f9d2e3e83c
 SHA512:
-  metadata.gz: 29eb3e3f8e005af66036b33c3bdb7260d8da6054dd63177b50d7a1bb0cd6b4a6ba39a61c03a77420a9d2867fbc4424a7a2718e535c0dd6afefa4f699c6c33beb
-  data.tar.gz: 70f57850d865a3dcbfbc083f444c30a86bd24745501e1816efff41db049c294ae5844f2c2bf6856316137a20d7be7b00c32964a852f576245ab0f378d40bb06e
+  metadata.gz: 3da36f25ec0827992a15bbbb2b20ffdbddc7233ace64ec2cbcfe5c6f7d12cf5a95b35d065b8b47d362df8de5b1dd799b8d473ca7459b414b81f651afb43c3db4
+  data.tar.gz: d8efcca5893345b3fb32a0fc0bbe014c9e99bf66d70a6b3bf561a6e037b50ec1f4886894913fc6bb6bc334a92661f4f81face5ce9aec01e7587c71beb1bd7bdb

data/.rubocop.yml

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

data/CHANGELOG.md

@@ -1,6 +1,36 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.12.0] - 2021-12-09
+### Added
+- `using SmartCore::Ext::BasicObjectAsObject` provides native support for:
+  - `BasicObject#inspect`;
+
+## [0.11.0] - 2021-01-17
+### Added
+- Support for **Ruby@3**;
+
+## [0.10.0] - 2020-12-22
+### Added
+- Support for `#hash` and `#instance_of?` for `SmartCore::Ext::BasicObjectAsObject` refinement;
+
+## [0.9.0] - 2020-12-20
+### Added
+- New type of utilities: *Extensions* (`SmartCore::Ext`);
+- New extension: `SmartCore::Ext::BasicObjectAsObject` refinement:
+  - `using SmartCore::Ext::BasicObjectAsObject` provides native support for:
+    - `BasicObject#is_a?`;
+    - `BasicObject#kind_of?`;
+    - `BasicObject#freeze`;
+    - `BasicObject#frozen?`;
+
+### Changed
+- Updated development dependencies;
+- Support for *Ruby@2.4* has ended;
+
+### Fixed
+- `SmartCore::Engine::Frozener` can not be used with rubies lower than `@2.7`;
+
 ## [0.8.0] - 2020-07-25
 ### Added
 - Any object frozener (`SmartCore::Engine::Frozener`, `SmartCore::Engine::Frozener::Mixin`);

data/Gemfile.lock

@@ -1,99 +1,102 @@
 PATH
   remote: .
   specs:
-    smart_engine (0.7.0)
+    smart_engine (0.12.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.3.2)
+    activesupport (6.1.1)
       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)
-      rubocop (= 0.87.1)
-      rubocop-performance (= 1.7.0)
-      rubocop-rails (= 2.6.0)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    armitage-rubocop (1.7.0.1)
+      rubocop (= 1.7.0)
+      rubocop-performance (= 1.9.1)
+      rubocop-rails (= 2.9.1)
       rubocop-rake (= 0.5.1)
-      rubocop-rspec (= 1.41.0)
+      rubocop-rspec (= 2.1.0)
     ast (2.4.1)
-    coderay (1.1.2)
-    concurrent-ruby (1.1.6)
+    coderay (1.1.3)
+    concurrent-ruby (1.1.7)
     diff-lcs (1.4.4)
-    docile (1.3.2)
-    i18n (1.8.3)
+    docile (1.3.5)
+    i18n (1.8.7)
       concurrent-ruby (~> 1.0)
     method_source (1.0.0)
-    minitest (5.14.1)
-    parallel (1.19.2)
-    parser (2.7.1.4)
+    minitest (5.14.3)
+    parallel (1.20.1)
+    parser (3.0.0.0)
       ast (~> 2.4.1)
     pry (0.13.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
     rack (2.2.3)
     rainbow (3.0.0)
-    rake (13.0.1)
-    regexp_parser (1.7.1)
+    rake (13.0.3)
+    regexp_parser (2.0.3)
     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.2)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
-    rubocop (0.87.1)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.1)
+    rubocop (1.7.0)
       parallel (~> 1.10)
-      parser (>= 2.7.1.1)
+      parser (>= 2.7.1.5)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.7)
+      regexp_parser (>= 1.8, < 3.0)
       rexml
-      rubocop-ast (>= 0.1.0, < 1.0)
+      rubocop-ast (>= 1.2.0, < 2.0)
       ruby-progressbar (~> 1.7)
       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)
+    rubocop-ast (1.4.0)
+      parser (>= 2.7.1.5)
+    rubocop-performance (1.9.1)
+      rubocop (>= 0.90.0, < 2.0)
+      rubocop-ast (>= 0.4.0)
+    rubocop-rails (2.9.1)
       activesupport (>= 4.2.0)
       rack (>= 1.1)
-      rubocop (>= 0.82.0)
+      rubocop (>= 0.90.0, < 2.0)
     rubocop-rake (0.5.1)
       rubocop
-    rubocop-rspec (1.41.0)
-      rubocop (>= 0.68.1)
-    ruby-progressbar (1.10.1)
-    simplecov (0.18.5)
+    rubocop-rspec (2.1.0)
+      rubocop (~> 1.0)
+      rubocop-ast (>= 1.1.0)
+    ruby-progressbar (1.11.0)
+    simplecov (0.21.2)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
-    simplecov-html (0.12.2)
-    thread_safe (0.3.6)
-    tzinfo (1.2.7)
-      thread_safe (~> 0.1)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.2)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
     unicode-display_width (1.7.0)
-    zeitwerk (2.3.1)
+    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  armitage-rubocop (~> 0.87)
-  bundler (~> 2.1)
+  armitage-rubocop (~> 1.7)
+  bundler (~> 2.2)
   pry (~> 0.13)
   rake (~> 13.0)
-  rspec (~> 3.9)
-  simplecov (~> 0.18)
+  rspec (~> 3.10)
+  simplecov (~> 0.21)
   smart_engine!
 
 BUNDLED WITH
-   2.1.4
+   2.2.27

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020 Rustam Ibragimov
+Copyright (c) 2020-2021 Rustam Ibragimov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,7 +1,17 @@
-# SmartCore::Engine · [![Gem Version](https://badge.fury.io/rb/smart_engine.svg)](https://badge.fury.io/rb/smart_engine) [![Build Status](https://travis-ci.org/smart-rb/smart_engine.svg?branch=master)](https://travis-ci.org/smart-rb/smart_engine)
+# SmartCore::Engine &middot; <a target="_blank" href="https://github.com/Cado-Labs"><img src="https://github.com/Cado-Labs/cado-labs-logos/raw/main/cado_labs_badge.svg" alt="Supported by Cado Labs" style="max-width: 100%; height: 20px"></a> &middot; [![Gem Version](https://badge.fury.io/rb/smart_engine.svg)](https://badge.fury.io/rb/smart_engine)
 
 Generic SmartCore functionality.
 
+---
+
+<p>
+  <a href="https://github.com/Cado-Labs">
+    <img src="https://github.com/Cado-Labs/cado-labs-logos/blob/main/cado_labs_supporting.svg" alt="Supported by Cado Labs" />
+  </a>
+</p>
+
+---
+
 ## Installation
 
 ```ruby
@@ -25,7 +35,8 @@ require 'smart_core'
 - [Global set of error types](#global-set-of-error-types)
 - [Simple reentrant lock](#simple-reentrant-lock)
 - [Atomic thread-safe value container](#atomic-thread-safe-value-container)
-- [Any Object Frozener](#any-object-frozener)
+- [Any Object Frozener](#any-object-frozener) (classic c-level `frozen?`/`freeze`)
+- [Basic Object Refinements](#basic-object-refinements) (`SmartCore::Ext::BasicObjectAsObject`)
 - [Inline rescue pipe](#inline-rescue-pipe)
 
 ---
@@ -68,6 +79,7 @@ atom.value # => 14
 ### Any Object Frozener
 
 - works with any type of ruby objects (event with `BasicObject`);
+- uses classic Ruby C-level `frozen?`/`freeze` functionality;
 
 ```ruby
 # as a singleton
@@ -95,6 +107,55 @@ object.frozen? # => true
 
 ---
 
+### Basic Object Refinements
+
+Ruby's `BasicObject` class does not have some fundamental (extremely important for instrumenting) methods:
+
+- `is_a?` / `kind_of?`
+- `instance_of?`
+- `freeze` / `frozen?`
+- `hash`
+- `nil?`
+
+`SmartCore::Ext::BasicObjectAsObject` refinement solves this problem (by Ruby's internal API without any manualy-emulated behavior).
+
+```ruby
+# without refinement:
+basic_obj = ::BasicObject.new
+
+basic_obj.is_a?(::BasicObject) # raises ::NoMethodError
+basic_obj.kind_of?(::BasicObject) # raises ::NoMethodError
+basic_obj.instance_of?(::BasicObject) # rasies ::NoMethodError
+basic_obj.freeze # raises ::NoMethodError
+basic_obj.frozen? # raises ::NoMethodError
+basic_object.hash # raises ::NoMethodError
+basic_object.nil? # raises ::NoMethodError
+```
+
+```ruby
+# with refinement:
+using SmartCore::Ext::BasicObjectAsObject
+
+basic_obj = ::BasicObject.new
+
+basic_obj.is_a?(::BasicObject) # => true
+basic_obj.kind_of?(::BasicObject) # => true
+basic_obj.instance_of?(::BasicObject) # => true
+basic_obj.instance_of?(::Object) # => false
+basic_obj.is_a?(::Integer) # => false
+basic_obj.kind_of?(::Integer) # => false
+
+basic_obj.frozen? # => false
+basic_obj.freeze # => self
+basic_obj.frozen? # => true
+
+basic_obj.nil? # => false
+
+basic_obj.hash # => 2682859680348634421 (some Integer value)
+```
+
+---
+
 ### Inline rescue pipe
 
 - works with an array of proc objects;
@@ -141,6 +202,13 @@ end
 
 ---
 
+## Roadmap
+
+- migrate to Github Actions in CI;
+- thread-safety for BasicObject extensions;
+
+---
+
 ## Contributing
 
 - Fork it ( https://github.com/smart-rb/smart_engine )
@@ -153,6 +221,12 @@ end
 
 Released under MIT License.
 
+## Supporting
+
+<a href="https://github.com/Cado-Labs">
+  <img src="https://github.com/Cado-Labs/cado-labs-logos/blob/main/cado_labs_logo.png" alt="Supported by Cado Labs" />
+</a>
+
 ## Authors
 
 [Rustam Ibragimov](https://github.com/0exp)

data/lib/smart_core/engine/ext.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.9.0
+module SmartCore::Engine::Ext
+  require_relative 'ext/basic_object_as_object'
+end

data/lib/smart_core/engine/frozener.rb

@@ -2,6 +2,7 @@
 
 # @api public
 # @since 0.8.0
+# @version 0.9.0
 module SmartCore::Engine::Frozener
   # @api public
   # @since 0.8.0
@@ -41,8 +42,9 @@ module SmartCore::Engine::Frozener
     #
     # @api public
     # @since 0.8.0
+    # @version 0.9.0
     def freeze(object)
-      FROZENER.bind_call(object)
+      FROZENER.bind(object).call
     end
 
     # @param object [Any]
@@ -50,8 +52,9 @@ module SmartCore::Engine::Frozener
     #
     # @api public
     # @since 0.8.0
+    # @version 0.9.0
     def frozen?(object)
-      FROZEN_CHECK.bind_call(object)
+      FROZEN_CHECK.bind(object).call
     end
   end
 end

data/lib/smart_core/engine/version.rb

@@ -6,7 +6,7 @@ module SmartCore
     #
     # @api public
     # @since 0.1.0
-    # @version 0.8.0
-    VERSION = '0.8.0'
+    # @version 0.12.0
+    VERSION = '0.12.0'
   end
 end

data/lib/smart_core/ext/basic_object_as_object.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.9.0
+# @version 0.10.0
+module SmartCore::Ext::BasicObjectAsObject
+  refine BasicObject do
+    _m_obj = ::Object.new
+
+    _is_a        = _m_obj.method(:is_a?).unbind.tap(&:freeze)
+    _freeze      = _m_obj.method(:freeze).unbind.tap(&:freeze)
+    _frozen      = _m_obj.method(:frozen?).unbind.tap(&:freeze)
+    _hash        = _m_obj.method(:hash).unbind.tap(&:freeze)
+    _nil         = _m_obj.method(:nil?).unbind.tap(&:freeze)
+    _instance_of = _m_obj.method(:instance_of?).unbind.tap(&:freeze)
+    _inspect     = _m_obj.method(:inspect).unbind.tap(&:freeze)
+
+    # @note Object#is_a? behavior copy
+    # @param klass [Class]
+    # @return [Boolean]
+    #
+    # @api public
+    # @since 0.9.0
+    define_method(:is_a?) do |klass|
+      _is_a.bind(self).call(klass)
+    end
+    alias_method :kind_of?, :is_a?
+
+    # @note Object#freeze behavior copy
+    # @return [self]
+    #
+    # @api public
+    # @since 0.9.0
+    define_method(:freeze) do
+      _freeze.bind(self).call
+    end
+
+    # @note Object#frozen? behavior copy
+    # @return [Boolean]
+    #
+    # @api public
+    # @since 0.9.0
+    define_method(:frozen?) do
+      _frozen.bind(self).call
+    end
+
+    # @return [Integer]
+    #
+    # @api public
+    # @since 0.10.0
+    define_method(:hash) do
+      _hash.bind(self).call
+    end
+
+    # @return [Boolean]
+    #
+    # @api public
+    # @since 0.10.0
+    define_method(:nil?) do
+      _nil.bind(self).call
+    end
+
+    # @return [Boolean]
+    #
+    # @api public
+    # @since 0.1.0
+    define_method(:instance_of?) do |klass|
+      _instance_of.bind(self).call(klass)
+    end
+
+    # @return [String]
+    #
+    # @api public
+    # @since 0.12.0
+    define_method(:inspect) do
+      _inspect.bind(self).call
+    end
+  end
+end

data/lib/smart_core/ext.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.9.0
+module SmartCore::Ext
+  require_relative 'ext/basic_object_as_object'
+end

data/lib/smart_core.rb

@@ -5,4 +5,5 @@
 module SmartCore
   require_relative 'smart_core/errors'
   require_relative 'smart_core/engine'
+  require_relative 'smart_core/ext'
 end

data/smart_engine.gemspec

@@ -34,10 +34,10 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler',          '~> 2.1'
+  spec.add_development_dependency 'bundler',          '~> 2.2'
   spec.add_development_dependency 'rake',             '~> 13.0'
-  spec.add_development_dependency 'rspec',            '~> 3.9'
-  spec.add_development_dependency 'armitage-rubocop', '~> 0.87'
-  spec.add_development_dependency 'simplecov',        '~> 0.18'
+  spec.add_development_dependency 'rspec',            '~> 3.10'
+  spec.add_development_dependency 'armitage-rubocop', '~> 1.7'
+  spec.add_development_dependency 'simplecov',        '~> 0.21'
   spec.add_development_dependency 'pry',              '~> 0.13'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smart_engine
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Rustam Ibragimov
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-07-25 00:00:00.000000000 Z
+date: 2021-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -44,42 +44,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: '3.10'
 - !ruby/object:Gem::Dependency
   name: armitage-rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.87'
+        version: '1.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.87'
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '0.21'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '0.21'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -107,7 +107,6 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
-- ".travis.yml"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -120,11 +119,14 @@ files:
 - lib/smart_core.rb
 - lib/smart_core/engine.rb
 - lib/smart_core/engine/atom.rb
+- lib/smart_core/engine/ext.rb
 - lib/smart_core/engine/frozener.rb
 - lib/smart_core/engine/lock.rb
 - lib/smart_core/engine/rescue_ext.rb
 - lib/smart_core/engine/version.rb
 - lib/smart_core/errors.rb
+- lib/smart_core/ext.rb
+- lib/smart_core/ext/basic_object_as_object.rb
 - smart_engine.gemspec
 homepage: https://github.com/smart-rb/smart_engine
 licenses:
@@ -133,7 +135,7 @@ metadata:
   homepage_uri: https://github.com/smart-rb/smart_engine
   source_code_uri: https://github.com/smart-rb/smart_engine
   changelog_uri: https://github.com/smart-rb/smart_engine/blob/master/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -148,8 +150,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.22
+signing_key:
 specification_version: 4
 summary: SmartCore Engine - a generic subset of SmartCore's functionality.
 test_files: []

data/.travis.yml

@@ -1,21 +0,0 @@
----
-language: ruby
-cache: bundler
-before_install: gem install bundler
-os: linux
-dist: xenial
-script:
-- bundle exec rake rubocop
-- bundle exec rake rspec
-jobs:
-  fast_finish: true
-  include:
-  - rvm: 2.4.10
-  - rvm: 2.5.8
-  - rvm: 2.6.6
-  - rvm: 2.7.1
-  - rvm: ruby-head
-  - rvm: jruby-head
-  allow_failures:
-  - rvm: ruby-head
-  - rvm: jruby-head