smart_engine 0.2.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70cda20326ebd513f16c9d3ff9529b56f7e083b85a4843fe3f7640e7b8d1da1c
-  data.tar.gz: 416c6ec9229b668b3cd6dbe779c99a80afe34debbc8d70dc9c0ac3c6d318348b
+  metadata.gz: fb49309ce61e395a7073af81c275aabdb9adbcf8d8b7d953da30aa87bafa7f20
+  data.tar.gz: 3e08590d5bce668b39ee3ea8893de436154dab189a6b528d1ca68156abbcb5b5
 SHA512:
-  metadata.gz: 7fa576346189eaaaaa0e48818ee0688904c900792449c6595ca8885f428a18f345ab24b7257b4cc0c5b0b0842c9383e5d885572d37220b1a0a9dcaf5c6ccc11a
-  data.tar.gz: 7386071b2ed63e7760747b8c7f0c5cbf01a78fc4f7e3c8442ac9c4139c924bd07300943383105589327c9b68365012829e9c9a7eac617f9455c44cc6f159ca0c
+  metadata.gz: fe721dc23e1d34a4fac5a37e49e9909758d80605f6e8bdff145e3bf532439a26d192941638896c1d7da4fdec0c8dc9f879fadab4dae4b1a341a5ded4999cba26
+  data.tar.gz: f99856596971bb98fa521e1ee77a777f17bc7c7a6541477aa243f625e58e8f21d7f9a6d5bbadd51e38241cd05cb37b0e67a229bc3a3fe2459a3e2ae30a23ed85

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

@@ -1,25 +1,21 @@
 ---
 language: ruby
 cache: bundler
-before_install: gem install bundler -v 2.1.2
+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.9
-    os: [linux, osx]
-  - rvm: 2.5.7
-    os: [linux, osx]
-  - rvm: 2.6.5
-    os: [linux, osx]
-  - rvm: 2.7.0
-    os: [linux, osx]
+  - rvm: 2.4.10
+  - rvm: 2.5.8
+  - rvm: 2.6.6
+  - rvm: 2.7.1
   - rvm: ruby-head
-    os: [linux, osx]
   - rvm: jruby-head
-    os: [linux, osx]
   allow_failures:
   - rvm: ruby-head
   - rvm: jruby-head

data/CHANGELOG.md

@@ -1,9 +1,36 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.7.0] - 2020-07-03
+### Added
+- Atomic threadsafe value container (`SmartCore::Engine::Atom`);
+
+## [0.6.0] - 2020-05-03
+### Added
+- Inline rescue pipe (`SmartCore::Engine::RescueExt.inline_rescue_pipe`);
+- Actualized development dependencies and test environment;
+
+## [0.5.0] - 2020-01-22
+### Added
+- Global error type `SmartCore::TypeError` inherited from `::TypeError`;
+
+## [0.4.0] - 2020-01-19
+### Added
+- `SmartCore::Engine::Lock` - simple reentrant-based locking primitive;
+
+## [0.3.0] - 2020-01-17
+### Added
+- Global error type `SmartCore::NameError` inherited from `::NameError`;
+
+### Changed
+- Actualized development dependencies;
+
+### Fixed
+- Invalid gem requirement in `bin/console`;
+
 ## [0.2.0] - 2020-01-02
 ### Changed
-- `SmartCore::FrozenError` inherits classic `::FrozenError` behaviour for `Ruby >= 2.5.0` and old `::RuntimeError` behaviour for `Ruby < 2.5.0;
+- `SmartCore::FrozenError` inherits classic `::FrozenError` behaviour for `Ruby >= 2.5.0` and old `::RuntimeError` behaviour for `Ruby < 2.5.0`;
 
 ## [0.1.0] - 2020-01-02
 

data/Gemfile.lock

@@ -1,81 +1,99 @@
 PATH
   remote: .
   specs:
-    smart_engine (0.2.0)
+    smart_engine (0.7.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    armitage-rubocop (0.78.0)
-      rubocop (= 0.78.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)
+    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.85.1)
+      rubocop (= 0.85.1)
+      rubocop-performance (= 1.6.1)
+      rubocop-rails (= 2.6.0)
+      rubocop-rake (= 0.5.1)
+      rubocop-rspec (= 1.40.0)
+    ast (2.4.1)
     coderay (1.1.2)
-    diff-lcs (1.3)
+    concurrent-ruby (1.1.6)
+    diff-lcs (1.4.4)
     docile (1.3.2)
-    jaro_winkler (1.5.4)
-    json (2.3.0)
-    method_source (0.9.2)
-    parallel (1.19.1)
-    parser (2.7.0.0)
-      ast (~> 2.4.0)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    rack (2.0.8)
+    i18n (1.8.3)
+      concurrent-ruby (~> 1.0)
+    method_source (1.0.0)
+    minitest (5.14.1)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      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)
+    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.0)
+    rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
-    rspec-support (3.9.1)
-    rubocop (0.78.0)
-      jaro_winkler (~> 1.5.1)
+    rspec-support (3.9.3)
+    rubocop (0.85.1)
       parallel (~> 1.10)
-      parser (>= 2.6)
+      parser (>= 2.7.0.1)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.0.3)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
-    rubocop-performance (1.5.2)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.1.0)
+      parser (>= 2.7.0.1)
+    rubocop-performance (1.6.1)
       rubocop (>= 0.71.0)
-    rubocop-rails (2.4.1)
+    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-rspec (1.40.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)
-    unicode-display_width (1.6.0)
+      simplecov-html (~> 0.11)
+    simplecov-html (0.12.2)
+    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.85)
   bundler (~> 2.1)
-  pry (~> 0.12)
+  pry (~> 0.13)
   rake (~> 13.0)
   rspec (~> 3.9)
-  simplecov (~> 0.17)
+  simplecov (~> 0.18)
   smart_engine!
 
 BUNDLED WITH
-   2.1.2
+   2.1.4

data/README.md

@@ -20,6 +20,96 @@ require 'smart_core'
 
 ---
 
+## Technologies
+
+- [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)
+- [Inline rescue pipe](#inline-rescue-pipe)
+
+---
+
+### Global set of error types
+
+- `SmartCore::Error` (inherited from `::StandardError`);
+- `SmartCore::ArgumentError` (inherited from `::ArgumentError`);
+- `SmartCore::FrozenError` (inherited from `::FrozenError`);
+- `SmartCore::NameError` (inherited from `::NameError`);
+- `SmartCore::TypeError` (inherited from `::TypeError`);
+
+---
+
+### Simple reentrant lock
+
+```ruby
+lock = SmartCore::Engine::Lock.new
+lock.synchronize { your_code }
+```
+
+---
+
+### Atomic thread-safe value container
+
+```ruby
+atom = SmartCore::Engine::Atom.new # initial value - nil
+atom.value # => nil
+# --- or ---
+atom = SmartCore::Engine::Atom.new(7) # initial value - 7
+atom.value # => 7
+
+# set new value (thread-safely)
+atom.swap { |original_value| original_value * 2 }
+atom.value # => 14
+```
+
+---
+
+### Inline rescue pipe
+
+- works with an array of proc objects;
+- returns the result of the first non-failed proc;
+- provides an error interception interface (a block argument);
+- fails with the last failed proc exception (if all procs were failed and interceptor was not passed);
+
+#### Return the result of the first non-failed proc
+
+```ruby
+SmartCore::Engine::RescueExt.inline_rescue_pipe(
+  -> { raise },
+  -> { raise },
+  -> { 123 },
+  -> { 567 },
+  -> { raise },
+)
+# => output: 123
+```
+
+#### Fail with the last failed proc exception
+
+```ruby
+SmartCore::Engine::RescueExt.inline_rescue_pipe(
+  -> { raise(::ArgumentError) },
+  -> { raise(::TypeError) },
+  -> { raise(::ZeroDivisionError) }
+)
+# => fails with ZeroDivisionError
+```
+
+#### Error interception
+
+```ruby
+SmartCore::Engine::RescueExt.inline_rescue_pipe(
+  -> { raise(::ArgumentError) },
+  -> { raise(::TypeError) },
+  -> { raise(::ZeroDivisionError, 'Intercepted exception') }
+) do |error|
+  error.message
+end
+# => output: "Intercepted exception"
+```
+
+---
+
 ## Contributing
 
 - Fork it ( https://github.com/smart-rb/smart_engine )

data/Rakefile

@@ -4,6 +4,7 @@ require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 require 'rubocop'
 require 'rubocop/rake_task'
+require 'rubocop-rails'
 require 'rubocop-performance'
 require 'rubocop-rspec'
 require 'rubocop-rake'
@@ -11,8 +12,8 @@ require 'rubocop-rake'
 RuboCop::RakeTask.new(:rubocop) do |t|
   config_path = File.expand_path(File.join('.rubocop.yml'), __dir__)
   t.options = ['--config', config_path]
-  t.requires << 'rubocop-performance'
   t.requires << 'rubocop-rspec'
+  t.requires << 'rubocop-performance'
   t.requires << 'rubocop-rake'
 end
 

data/bin/console

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 require 'bundler/setup'
-require 'smart_engine'
+require 'smart_core'
 
 require 'pry'
 Pry.start

data/lib/smart_core/engine.rb

@@ -4,4 +4,7 @@
 # @since 0.1.0
 module SmartCore::Engine
   require_relative 'engine/version'
+  require_relative 'engine/lock'
+  require_relative 'engine/rescue_ext'
+  require_relative 'engine/atom'
 end

data/lib/smart_core/engine/atom.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.7.0
+class SmartCore::Engine::Atom
+  # @param initial_value [Any]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.7.0
+  def initialize(initial_value = nil)
+    @value = initial_value
+    @barrier = SmartCore::Engine::Lock.new
+  end
+
+  # @return [Any]
+  #
+  # @api public
+  # @since 0.7.0
+  def value
+    with_barrier { @value }
+  end
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api public
+  # @since 0.7.0
+  def swap(&block)
+    with_barrier { @value = yield(@value) }
+  end
+
+  private
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.1.0
+  def with_barrier(&block)
+    @barrier.synchronize(&block)
+  end
+end

data/lib/smart_core/engine/lock.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.4.0
+class SmartCore::Engine::Lock
+  # @return [void]
+  #
+  # @api public
+  # @since 0.4.0
+  def initialize
+    @lock = Mutex.new
+  end
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api public
+  # @since 0.4.0
+  def synchronize(&block)
+    @lock.owned? ? yield : @lock.synchronize(&block)
+  end
+end

data/lib/smart_core/engine/rescue_ext.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.6.0
+module SmartCore::Engine::RescueExt
+  # REASON:
+  #   {module_funciton} is used to be able to include/extend any module/class
+  #   and at the same time to use without any inclusion/extending logic as a service
+
+  module_function
+
+  # @param proks [Array<Proc>]
+  # @param error_interceptor [Block]
+  # @return [Any]
+  #
+  # @api public
+  # @since 0.6.0
+  # rubocop:disable Performance/RedundantBlockCall
+  def inline_rescue_pipe(*proks, &error_interceptor)
+    unless proks.all? { |prok| prok.is_a?(::Proc) }
+      raise(SmartCore::ArgumentError, 'Invalid proc object')
+    end
+
+    interceptable_bloks = proks.to_enum
+    pipe_invokation_result = nil
+    last_exception = nil
+
+    begin
+      while current_block = interceptable_bloks.next
+        begin
+          pipe_invokation_result = current_block.call
+          break
+        rescue => error
+          last_exception = error
+        end
+      end
+
+      pipe_invokation_result
+    rescue ::StopIteration
+      error_interceptor ? error_interceptor.call(last_exception) : raise(last_exception)
+    end
+  end
+  # rubocop:enable Performance/RedundantBlockCall
+end

data/lib/smart_core/engine/version.rb

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

data/lib/smart_core/errors.rb

@@ -9,6 +9,14 @@ module SmartCore
   # @since 0.1.0
   ArgumentError = Class.new(::ArgumentError)
 
+  # @api public
+  # @since 0.3.0
+  NameError = Class.new(::NameError)
+
+  # @api public
+  # @since 0.5.0
+  TypeError = Class.new(::TypeError)
+
   # @api public
   # @since 0.2.0
   FrozenError = begin # rubocop:disable Naming/ConstantName

data/smart_engine.gemspec

@@ -3,7 +3,7 @@
 require_relative 'lib/smart_core/engine/version'
 
 Gem::Specification.new do |spec|
-  spec.required_ruby_version = Gem::Requirement.new('>= 2.4.9')
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.4.10')
 
   spec.name     = 'smart_engine'
   spec.version  = SmartCore::Engine::VERSION
@@ -37,7 +37,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler',          '~> 2.1'
   spec.add_development_dependency 'rake',             '~> 13.0'
   spec.add_development_dependency 'rspec',            '~> 3.9'
-  spec.add_development_dependency 'armitage-rubocop', '~> 0.78'
-  spec.add_development_dependency 'simplecov',        '~> 0.17'
-  spec.add_development_dependency 'pry',              '~> 0.12'
+  spec.add_development_dependency 'armitage-rubocop', '~> 0.85'
+  spec.add_development_dependency 'simplecov',        '~> 0.18'
+  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.2.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-01-02 00:00:00.000000000 Z
+date: 2020-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -58,42 +58,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.78'
+        version: '0.85'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.78'
+        version: '0.85'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0.18'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: '0.18'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.13'
 description: 'SmartCore Engine - a set of core functionality shared beetwen a series
   of SmartCore gems.
 
@@ -119,6 +119,9 @@ files:
 - bin/setup
 - lib/smart_core.rb
 - lib/smart_core/engine.rb
+- lib/smart_core/engine/atom.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
 - smart_engine.gemspec
@@ -137,7 +140,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.9
+      version: 2.4.10
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="