smart_engine 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb49309ce61e395a7073af81c275aabdb9adbcf8d8b7d953da30aa87bafa7f20
-  data.tar.gz: 3e08590d5bce668b39ee3ea8893de436154dab189a6b528d1ca68156abbcb5b5
+  metadata.gz: 228fbd594308ecee71718fe059d6d8bf57f8e79f33b0607ca4b771fc498a0ac4
+  data.tar.gz: 809d274f771a7de133a1bc8986448ffca67bcefa2f0fd5f3a5d39cf730c448fa
 SHA512:
-  metadata.gz: fe721dc23e1d34a4fac5a37e49e9909758d80605f6e8bdff145e3bf532439a26d192941638896c1d7da4fdec0c8dc9f879fadab4dae4b1a341a5ded4999cba26
-  data.tar.gz: f99856596971bb98fa521e1ee77a777f17bc7c7a6541477aa243f625e58e8f21d7f9a6d5bbadd51e38241cd05cb37b0e67a229bc3a3fe2459a3e2ae30a23ed85
+  metadata.gz: 29eb3e3f8e005af66036b33c3bdb7260d8da6054dd63177b50d7a1bb0cd6b4a6ba39a61c03a77420a9d2867fbc4424a7a2718e535c0dd6afefa4f699c6c33beb
+  data.tar.gz: 70f57850d865a3dcbfbc083f444c30a86bd24745501e1816efff41db049c294ae5844f2c2bf6856316137a20d7be7b00c32964a852f576245ab0f378d40bb06e

data/.rubocop.yml

@@ -13,3 +13,7 @@ AllCops:
     - Rakefile
     - smart_engine.gemspec
     - bin/console
+
+# NOTE: for better representativeness of test examples
+RSpec/DescribedClass:
+  Enabled: false

data/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.8.0] - 2020-07-25
+### Added
+- Any object frozener (`SmartCore::Engine::Frozener`, `SmartCore::Engine::Frozener::Mixin`);
+
 ## [0.7.0] - 2020-07-03
 ### Added
 - Atomic threadsafe value container (`SmartCore::Engine::Atom`);

data/Gemfile.lock

@@ -12,12 +12,12 @@ GEM
       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)
+    armitage-rubocop (0.87.1)
+      rubocop (= 0.87.1)
+      rubocop-performance (= 1.7.0)
       rubocop-rails (= 2.6.0)
       rubocop-rake (= 0.5.1)
-      rubocop-rspec (= 1.40.0)
+      rubocop-rspec (= 1.41.0)
     ast (2.4.1)
     coderay (1.1.2)
     concurrent-ruby (1.1.6)
@@ -51,26 +51,26 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-support (3.9.3)
-    rubocop (0.85.1)
+    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.0.3)
+      rubocop-ast (>= 0.1.0, < 1.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.6.1)
-      rubocop (>= 0.71.0)
+    rubocop-performance (1.7.0)
+      rubocop (>= 0.82.0)
     rubocop-rails (2.6.0)
       activesupport (>= 4.2.0)
       rack (>= 1.1)
       rubocop (>= 0.82.0)
     rubocop-rake (0.5.1)
       rubocop
-    rubocop-rspec (1.40.0)
+    rubocop-rspec (1.41.0)
       rubocop (>= 0.68.1)
     ruby-progressbar (1.10.1)
     simplecov (0.18.5)
@@ -87,7 +87,7 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  armitage-rubocop (~> 0.85)
+  armitage-rubocop (~> 0.87)
   bundler (~> 2.1)
   pry (~> 0.13)
   rake (~> 13.0)

data/README.md

@@ -25,6 +25,7 @@ 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)
 - [Inline rescue pipe](#inline-rescue-pipe)
 
 ---
@@ -64,6 +65,36 @@ atom.value # => 14
 
 ---
 
+### Any Object Frozener
+
+- works with any type of ruby objects (event with `BasicObject`);
+
+```ruby
+# as a singleton
+
+object = BasicObject.new
+SmartCore::Engine::Frozener.frozen?(object) # => false
+
+SmartCore::Engine::Frozener.freeze(object)
+SmartCore::Engine::Frozener.frozen?(object) # => true
+```
+
+```ruby
+# as a mixin
+
+class EmptyObject < BasicObject
+  include SmartCore::Engine::Frozener::Mixin
+end
+
+object = EmptyObject.new
+
+object.frozen? # => false
+object.freeze
+object.frozen? # => true
+```
+
+---
+
 ### Inline rescue pipe
 
 - works with an array of proc objects;

data/lib/smart_core/engine.rb

@@ -7,4 +7,5 @@ module SmartCore::Engine
   require_relative 'engine/lock'
   require_relative 'engine/rescue_ext'
   require_relative 'engine/atom'
+  require_relative 'engine/frozener'
 end

data/lib/smart_core/engine/frozener.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.8.0
+module SmartCore::Engine::Frozener
+  # @api public
+  # @since 0.8.0
+  module Mixin
+    # @return [self]
+    #
+    # @api public
+    # @since 0.8.0
+    def freeze
+      SmartCore::Engine::Frozener.freeze(self)
+    end
+
+    # @return [Boolean]
+    #
+    # @api public
+    # @since 0.8.0
+    def frozen?
+      SmartCore::Engine::Frozener.frozen?(self)
+    end
+  end
+
+  # @return [UnboundMethod]
+  #
+  # @api private
+  # @since 0.8.0
+  FROZENER = Object.new.method(:freeze).unbind.tap(&:freeze)
+
+  # @return [UnboundMethod]
+  #
+  # @api private
+  # @since 0.8.0
+  FROZEN_CHECK = Object.new.method(:frozen?).unbind.tap(&:freeze)
+
+  class << self
+    # @param object [Any]
+    # @return [object]
+    #
+    # @api public
+    # @since 0.8.0
+    def freeze(object)
+      FROZENER.bind_call(object)
+    end
+
+    # @param object [Any]
+    # @return [Boolean]
+    #
+    # @api public
+    # @since 0.8.0
+    def frozen?(object)
+      FROZEN_CHECK.bind_call(object)
+    end
+  end
+end

data/lib/smart_core/engine/version.rb

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

data/smart_engine.gemspec

@@ -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.85'
+  spec.add_development_dependency 'armitage-rubocop', '~> 0.87'
   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.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-03 00:00:00.000000000 Z
+date: 2020-07-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.85'
+        version: '0.87'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.85'
+        version: '0.87'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -120,6 +120,7 @@ files:
 - lib/smart_core.rb
 - lib/smart_core/engine.rb
 - lib/smart_core/engine/atom.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