smart_engine 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48de1362f022e1e37a6a234db4936b0077c9d5cc818ac2bb73a72157f4b949dc
-  data.tar.gz: cf4e6d5a6c51d926fc6d5186d0857006d7a114811be4d4f753283e1872575cdf
+  metadata.gz: 912e841987ba6da79b04609e0f86580d900676b10711d5e38b614099782702cf
+  data.tar.gz: 395c81f467a482cde8042dfb207df5aa70b7a865f317fcd068e110b127dfe95e
 SHA512:
-  metadata.gz: dda02f4e36e5c85f3a1117ba85013ab99120956166501c31e0178f6f58898a8a9fb87a585d80a1d9174d5f0eca72139e954bb73a1b0ea72dd7d79a36a41636e8
-  data.tar.gz: 905bb7bea34f0d101633dd64e0709f50671d81eaa8ed0b7d5880892f760e62a038605173936ea9d27f8e51680d11495f5b1de0cfefd57490450a67f7ebc3ec69
+  metadata.gz: '080a49d84507ca934dcf9435bcbe724cf8146167039e1ebbf0a56343249fbd4c39893a79508a0e08826fb9496eb6a721f5e335a0a9b19149263c8a73c4ebf9bf'
+  data.tar.gz: 0eb86cfe731f1911969025db50560148858f03d8b8842da9c3bac49fbd3c4dfe74c0c86392438c060c2ec43ff0453da8c9fc3eeed4076bc11c772e59c931ee7c

data/CHANGELOG.md

@@ -1,7 +1,11 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
-## [Unreleased]
+## [0.14.0] - 2022-09-30
+### Added
+- Read/Write locking mechanizm: `SmartCore::Engine::ReadWriteLock`;
+
+## [0.13.0] - 2022-09-30
 ### Added
 - Simplest in-memory cache storage implementation: `SmartCore::Engine::Cache`;
 ### Changed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    smart_engine (0.13.0)
+    smart_engine (0.14.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -34,6 +34,7 @@ require 'smart_core'
 
 - [Global set of error types](#global-set-of-error-types)
 - [Simple reentrant lock](#simple-reentrant-lock)
+- [Read/Write Lock](#read-write-lock)
 - [Cache Storage](#cache-storage)
 - [Atomic thread-safe value container](#atomic-thread-safe-value-container)
 - [Any Object Frozener](#any-object-frozener) (classic c-level `frozen?`/`freeze`)
@@ -62,6 +63,23 @@ lock.synchronize { your_code }
 
 ---
 
+### Read/Write Lock
+
+- non-controlable reader count;
+- readers does not lock each other;
+- readers waits for writer;
+- writer waits for readers;
+
+```ruby
+lock = SmartCore::Engine::ReadWriteLock.new
+
+lock.read_sync { ...some-read-op... } # waits for writer
+lock.read_sync { ...some-read-op... } # waits for writer
+lock.write_sync { ... some-write-op... } # waits for all readers and current writer
+```
+
+---
+
 ### Cache Storage
 
 - you can use any object as a cache key;
@@ -275,6 +293,8 @@ end
   - support for `#keys` method;
   - support for `#key?` method;
   - think about some layer of cache object serialization;
+- `SmartCore::Engine::ReadWriteLock`:
+  - an ability to set a maximum count of readers;
 
 ---
 

data/lib/smart_core/engine/lock.rb

@@ -8,7 +8,7 @@ class SmartCore::Engine::Lock
   # @api public
   # @since 0.4.0
   def initialize
-    @lock = Mutex.new
+    @lock = ::Mutex.new
   end
 
   # @param block [Block]

data/lib/smart_core/engine/read_write_lock.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.14.0
+class SmartCore::Engine::ReadWriteLock
+  # @return [void]
+  #
+  # @api public
+  # @sicne 0.14.0
+  def initialize
+    # NOTE:
+    #   ivars has no readers cuz we want to avoid
+    #   Ruby VM's context-switching during reade-method invokation.
+    @active_reader = false
+    @write_lock = ::Mutex.new
+  end
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api public
+  # @since 0.14.0
+  def read_sync(&block)
+    @active_reader = true
+    while @write_lock.locked? do; end
+    yield
+  ensure
+    @active_reader = false
+  end
+
+  # @param block [Block]
+  # @return [Any]
+  #
+  # @api public
+  # @since 0.14.0
+  def write_sync(&block)
+    while @active_reader do; end
+    @write_lock.synchronize do
+      @active_reader = true
+      begin
+        yield
+      ensure
+        @active_reader = false
+      end
+    end
+  end
+end

data/lib/smart_core/engine/version.rb

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

data/lib/smart_core/engine.rb

@@ -5,6 +5,7 @@
 module SmartCore::Engine
   require_relative 'engine/version'
   require_relative 'engine/lock'
+  require_relative 'engine/read_write_lock'
   require_relative 'engine/rescue_ext'
   require_relative 'engine/atom'
   require_relative 'engine/frozener'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smart_engine
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Rustam Ibragimov
@@ -123,6 +123,7 @@ files:
 - lib/smart_core/engine/ext.rb
 - lib/smart_core/engine/frozener.rb
 - lib/smart_core/engine/lock.rb
+- lib/smart_core/engine/read_write_lock.rb
 - lib/smart_core/engine/rescue_ext.rb
 - lib/smart_core/engine/version.rb
 - lib/smart_core/errors.rb