zache 0.14.0 → 0.15.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c247c0f146ef35562b8d56169fdb69ef0a9a02796d0e49dfb6c8ed83094dfd24
-  data.tar.gz: d0b659e1315eee6f19b6c708da5b49073d3e0d9a5d5809a424c9b641d330e992
+  metadata.gz: 0ed02e68e04482b0ac7df8addc19dd0c02683191c53b3f3b391930e9b8ed4842
+  data.tar.gz: ec695943e4b8e9ba6793dd8db9dde826e6bc23cbd2ba92122aae5f52567aace2
 SHA512:
-  metadata.gz: 23c14258f92e749ee9876b4fae20274a954d71a34a95b427dafd9bef201d17c91c1731d1733345ed564f9e7d74e340c68d9325127a55ab73e5d654ac8d5cb866
-  data.tar.gz: 9232c93c2027dbe83015974315e5c609f3392216c77a96f465cc13f0ddd309fc11d4147234ff23892037619491bb037bc466e28f0075a8be424ef60c28014327
+  metadata.gz: d8758c5554cc1686ec3b82819977982103754cccebefb4b4e3df38d23b77541d82b13ef36626677b5fc4685ea6c7013e14f6e2da113b8cc6d6af376feb56fef3
+  data.tar.gz: 261616852da299a0376422d7f86bd62c3e89497874e859c620ba71017825f3e6be9db1cc6beca6feeacb091432137d2fac0fe8b79b1bd8a4595c67f322900810

data/Gemfile

@@ -12,11 +12,12 @@ gem 'minitest-reporters', '~>1.7', require: false
 gem 'os', '>0', require: false
 gem 'qbash', '>0', require: false
 gem 'rake', '~>13.2', require: false
+gem 'rdoc', '~>6.15', require: false
 gem 'rubocop', '~>1.75', require: false
-gem 'rubocop-minitest', '>0', require: false
-gem 'rubocop-performance', '>0', require: false
-gem 'rubocop-rake', '>0', require: false
+gem 'rubocop-minitest', '~>0.38', require: false
+gem 'rubocop-performance', '~>1.25', require: false
+gem 'rubocop-rake', '~>0.7', require: false
 gem 'simplecov', '~>0.22', require: false
-gem 'simplecov-cobertura', '~>2.1', require: false
+gem 'simplecov-cobertura', '~>3.0', require: false
 gem 'threads', '~>0.4', require: false
 gem 'yard', '~>0.9', require: false

data/Gemfile.lock

@@ -8,40 +8,51 @@ GEM
   specs:
     ansi (1.5.0)
     ast (2.4.3)
-    backtrace (0.4.0)
+    backtrace (0.4.1)
     builder (3.3.0)
     concurrent-ruby (1.3.5)
+    date (3.5.0)
     docile (1.4.1)
-    elapsed (0.0.1)
-      loog (> 0)
-      tago (> 0)
-    json (2.10.2)
-    language_server-protocol (3.17.0.4)
+    elapsed (0.2.0)
+      loog (~> 0.6)
+      tago (~> 0.1)
+    erb (6.0.0)
+    json (2.16.0)
+    language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    loog (0.6.0)
-    minitest (5.25.5)
+    logger (1.7.0)
+    loog (0.6.1)
+      logger (~> 1.0)
+    minitest (5.26.2)
     minitest-reporters (1.7.1)
       ansi
       builder
       minitest (>= 5.0)
       ruby-progressbar
     os (1.1.4)
-    parallel (1.26.3)
-    parser (3.3.7.4)
+    parallel (1.27.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
-    prism (1.4.0)
-    qbash (0.4.0)
+    prism (1.6.0)
+    psych (5.2.6)
+      date
+      stringio
+    qbash (0.4.8)
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
       tago (> 0)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
-    regexp_parser (2.10.0)
-    rexml (3.4.1)
-    rubocop (1.75.2)
+    rake (13.3.1)
+    rdoc (6.15.1)
+      erb
+      psych (>= 4.0.0)
+      tsort
+    regexp_parser (2.11.3)
+    rexml (3.4.4)
+    rubocop (1.81.7)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -49,20 +60,20 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.44.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.44.1)
+    rubocop-ast (1.48.0)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
-    rubocop-minitest (0.38.0)
+    rubocop-minitest (0.38.2)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
       rubocop-ast (>= 1.38.0, < 2.0)
-    rubocop-performance (1.25.0)
+    rubocop-performance (1.26.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
-      rubocop-ast (>= 1.38.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
@@ -71,18 +82,20 @@ GEM
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
-    simplecov-cobertura (2.1.0)
+    simplecov-cobertura (3.1.0)
       rexml
       simplecov (~> 0.19)
-    simplecov-html (0.13.1)
+    simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    tago (0.1.0)
-    threads (0.4.1)
+    stringio (3.1.8)
+    tago (0.4.0)
+    threads (0.5.0)
       backtrace (~> 0)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (3.1.4)
-      unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
+    tsort (0.2.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
     yard (0.9.37)
 
 PLATFORMS
@@ -101,12 +114,13 @@ DEPENDENCIES
   os (> 0)
   qbash (> 0)
   rake (~> 13.2)
+  rdoc (~> 6.15)
   rubocop (~> 1.75)
-  rubocop-minitest (> 0)
-  rubocop-performance (> 0)
-  rubocop-rake (> 0)
+  rubocop-minitest (~> 0.38)
+  rubocop-performance (~> 1.25)
+  rubocop-rake (~> 0.7)
   simplecov (~> 0.22)
-  simplecov-cobertura (~> 2.1)
+  simplecov-cobertura (~> 3.0)
   threads (~> 0.4)
   yard (~> 0.9)
   zache!

data/README.md

@@ -13,8 +13,7 @@
 [![Hits-of-Code](https://hitsofcode.com/github/yegor256/zache)](https://hitsofcode.com/view/github/yegor256/zache)
 
 This is a simple Ruby gem for in-memory caching.
-Read [this blog post](https://www.yegor256.com/2019/02/05/zache.html)
-to understand what Zache is designed for.
+Read this [blog post] to understand what Zache is designed for.
 
 First, install it:
 
@@ -31,22 +30,26 @@ zache = Zache.new
 v = zache.get(:count, lifetime: 5 * 60) { expensive_calculation() }
 ```
 
-If you omit the `lifetime` parameter, the key will never expire.
+If you omit the `lifetime` parameter or set it to `nil`,
+  the key will never expire.
 
-By default `Zache` is thread-safe. It locks the entire cache on each
-`get` call. You can turn that off by using the `sync` argument:
+By default `Zache` is thread-safe.
+It locks the entire cache on each `get` call.
+You can turn that off by using the `sync` argument:
 
 ```ruby
 zache = Zache.new(sync: false)
 v = zache.get(:count) { expensive_calculation() }
 ```
 
-You may use "dirty" mode, which will return an expired value while
-calculation is in progress. For example, if you have a value in the cache that's
-expired, and you call `get` with a long-running block, the thread waits.
-If another thread calls `get` again, that second thread won't wait, but will
-receive the expired value from the cache. This is a very convenient mode for situations
-where absolute data accuracy is less important than performance:
+You may use "dirty" mode, which will return
+  an expired value while calculation is in progress.
+For example, if you have a value in the cache that's expired,
+  and you call `get` with a long-running block, the thread waits.
+If another thread calls `get` again, that second thread won't wait,
+  but will receive the expired value from the cache.
+This is a very convenient mode for situations
+  where absolute data accuracy is less important than performance:
 
 ```ruby
 zache = Zache.new(dirty: true)
@@ -54,8 +57,19 @@ zache = Zache.new(dirty: true)
 value = zache.get(:key, dirty: true) { expensive_calculation() }
 ```
 
-The entire API is documented
-[here](https://www.rubydoc.info/github/yegor256/zache/master/Zache).
+You may use "eager" mode with a placeholder value to return immediately
+  while the calculation happens in the background.
+The cache returns the placeholder instantly and spawns
+  a thread to calculate the actual value.
+This is useful when you need to avoid blocking
+  while expensive operations complete:
+
+```ruby
+# Returns 0 immediately, calculates in background
+value = zache.get(:key, eager: true, placeholder: 0) { expensive_calculation() }
+```
+
+The entire API is [documented][rubydoc].
 Here are some additional useful methods:
 
 ```ruby
@@ -80,12 +94,11 @@ zache.empty?
 
 ## How to contribute
 
-Read
-[these guidelines](https://www.yegor256.com/2014/04/15/github-guidelines.html).
-Make sure your build is green before you contribute
-your pull request. You will need to have
-[Ruby](https://www.ruby-lang.org/en/) 2.3+ and
-[Bundler](https://bundler.io/) installed. Then:
+Read these [guidelines].
+Make sure your build is green before you contribute your pull request.
+You will need to have [Ruby](https://www.ruby-lang.org/en/) 2.3+ and
+  [Bundler](https://bundler.io/) installed.
+Then:
 
 ```bash
 bundle update
@@ -93,3 +106,7 @@ bundle exec rake
 ```
 
 If it's clean and you don't see any error messages, submit your pull request.
+
+[blog post]: https://www.yegor256.com/2019/02/05/zache.html
+[rubydoc]: https://www.rubydoc.info/github/yegor256/zache/master/Zache
+[guidelines]: https://www.yegor256.com/2014/04/15/github-guidelines.html

data/REUSE.toml

@@ -4,6 +4,18 @@
 version = 1
 [[annotations]]
 path = [
+    ".DS_Store",
+    ".gitattributes",
+    ".gitignore",
+    ".pdd",
+    "**.json",
+    "**.md",
+    "**.png",
+    "**.svg",
+    "**.txt",
+    "**/.DS_Store",
+    "**/.gitignore",
+    "**/.pdd",
     "**/*.csv",
     "**/*.jpg",
     "**/*.json",
@@ -13,15 +25,8 @@ path = [
     "**/*.svg",
     "**/*.txt",
     "**/*.vm",
-    "**/.DS_Store",
-    "**/.gitignore",
-    "**/.pdd",
     "**/CNAME",
     "**/Gemfile.lock",
-    ".DS_Store",
-    ".gitattributes",
-    ".gitignore",
-    ".pdd",
     "Gemfile.lock",
     "README.md",
     "renovate.json",

data/Rakefile

@@ -8,6 +8,7 @@ require 'qbash'
 require 'rubygems'
 require 'rake'
 require 'rake/clean'
+require 'shellwords'
 
 CLEAN = FileList['coverage']
 
@@ -43,6 +44,7 @@ require 'yard'
 desc 'Build Yard documentation'
 YARD::Rake::YardocTask.new do |t|
   t.files = ['lib/**/*.rb']
+  t.options = ['--fail-on-warning']
 end
 
 require 'rubocop/rake_task'

data/lib/zache.rb

@@ -29,8 +29,6 @@ class Zache
     end
 
     # Always returns the result of the block, never caches.
-    # @param [Object] key Ignored
-    # @param [Hash] opts Ignored
     # @yield Block that provides the value
     # @return [Object] The result of the block
     def get(*)
@@ -38,23 +36,19 @@ class Zache
     end
 
     # Always returns true regardless of the key.
-    # @param [Object] key Ignored
-    # @param [Hash] opts Ignored
     # @return [Boolean] Always returns true
     def exists?(*)
       true
     end
 
     # Always returns false.
+    # @param [Object] _key Ignored
     # @return [Boolean] Always returns false
-    def locked?
+    def locked?(_key)
       false
     end
 
     # No-op method that ignores the input.
-    # @param [Object] key Ignored
-    # @param [Object] value Ignored
-    # @param [Hash] opts Ignored
     # @return [nil] Always returns nil
     def put(*); end
 
@@ -89,13 +83,14 @@ class Zache
     @sync = sync
     @dirty = dirty
     @mutex = Mutex.new
+    @locks = {}
   end
 
   # Total number of keys currently in cache.
   #
   # @return [Integer] Number of keys in the cache
   def size
-    @hash.size
+    synchronize_all { @hash.size }
   end
 
   # Gets the value from the cache by the provided key.
@@ -120,30 +115,33 @@ class Zache
   # @return [Object] The cached value
   def get(key, lifetime: 2**32, dirty: false, placeholder: nil, eager: false, &block)
     if block_given?
-      return @hash[key][:value] if (dirty || @dirty) && locked? && expired?(key) && @hash.key?(key)
+      if (dirty || @dirty) && locked?(key)
+        synchronize_all do
+          return @hash[key][:value] if expired_unsafe?(key) && @hash.key?(key)
+        end
+      end
       if eager
-        return @hash[key][:value] if @hash.key?(key)
+        has_key = synchronize_all { @hash.key?(key) }
+        return synchronize_all { @hash[key][:value] } if has_key
         put(key, placeholder, lifetime: 0)
         Thread.new do
-          synchronized do
-            calc(key, lifetime, &block)
-          end
+          synchronize_one(key) { calc(key, lifetime, &block) }
         end
         placeholder
       else
-        synchronized do
-          calc(key, lifetime, &block)
-        end
+        synchronize_one(key) { calc(key, lifetime, &block) }
       end
     else
-      rec = @hash[key]
-      if expired?(key)
-        return rec[:value] if dirty || @dirty
-        @hash.delete(key)
-        rec = nil
+      synchronize_all do
+        rec = @hash[key]
+        if expired_unsafe?(key)
+          return rec[:value] if dirty || @dirty
+          @hash.delete(key)
+          rec = nil
+        end
+        raise 'The key is absent in the cache' if rec.nil?
+        rec[:value]
       end
-      raise 'The key is absent in the cache' if rec.nil?
-      rec[:value]
     end
   end
 
@@ -155,12 +153,14 @@ class Zache
   # @param dirty [Boolean] Whether to consider expired values as existing
   # @return [Boolean] True if the key exists and is not expired (unless dirty is true)
   def exists?(key, dirty: false)
-    rec = @hash[key]
-    if expired?(key) && !dirty && !@dirty
-      @hash.delete(key)
-      rec = nil
+    synchronize_all do
+      rec = @hash[key]
+      if expired_unsafe?(key) && !dirty && !@dirty
+        @hash.delete(key)
+        rec = nil
+      end
+      !rec.nil?
     end
-    !rec.nil?
   end
 
   # Checks whether the key exists in the cache and is expired. If the
@@ -169,8 +169,7 @@ class Zache
   # @param key [Object] The key to check in the cache
   # @return [Boolean] True if the key exists and is expired
   def expired?(key)
-    rec = @hash[key]
-    !rec.nil? && rec[:start] < Time.now - rec[:lifetime]
+    synchronize_all { expired_unsafe?(key) }
   end
 
   # Returns the modification time of the key, if it exists.
@@ -179,15 +178,18 @@ class Zache
   # @param key [Object] The key to get the modification time for
   # @return [Time] The modification time of the key or current time if key doesn't exist
   def mtime(key)
-    rec = @hash[key]
-    rec.nil? ? Time.now : rec[:start]
+    synchronize_all do
+      rec = @hash[key]
+      rec.nil? ? Time.now : rec[:start]
+    end
   end
 
-  # Is cache currently locked doing something?
+  # Is key currently locked doing something?
   #
+  # @param [Object] key The key to check
   # @return [Boolean] True if the cache is locked
-  def locked?
-    @mutex.locked?
+  def locked?(key)
+    synchronize_all { @locks[key]&.locked? }
   end
 
   # Put a value into the cache.
@@ -197,7 +199,7 @@ class Zache
   # @param lifetime [Integer] Time in seconds until the key expires (default: never expires)
   # @return [Object] The value stored
   def put(key, value, lifetime: 2**32)
-    synchronized do
+    synchronize_one(key) do
       @hash[key] = {
         value: value,
         start: Time.now,
@@ -213,14 +215,14 @@ class Zache
   # @yield Block to call if the key is not found
   # @return [Object] The removed value or the result of the block
   def remove(key)
-    synchronized { @hash.delete(key) { yield if block_given? } }
+    synchronize_one(key) { @hash.delete(key) { yield if block_given? } }
   end
 
   # Remove all keys from the cache.
   #
   # @return [Hash] Empty hash
   def remove_all
-    synchronized { @hash = {} }
+    synchronize_all { @hash = {} }
   end
 
   # Remove all keys that match the block.
@@ -229,7 +231,7 @@ class Zache
   # @yieldparam key [Object] The cache key to evaluate
   # @return [Integer] Number of keys removed
   def remove_by
-    synchronized do
+    synchronize_all do
       count = 0
       @hash.each_key do |k|
         if yield(k)
@@ -246,9 +248,9 @@ class Zache
   #
   # @return [Integer] Number of keys removed
   def clean
-    synchronized do
+    synchronize_all do
       size_before = @hash.size
-      @hash.delete_if { |key, _value| expired?(key) }
+      @hash.delete_if { |key, _value| expired_unsafe?(key) }
       size_before - @hash.size
     end
   end
@@ -257,7 +259,7 @@ class Zache
   #
   # @return [Boolean] True if the cache is empty
   def empty?
-    @hash.empty?
+    synchronize_all { @hash.empty? }
   end
 
   private
@@ -269,26 +271,46 @@ class Zache
   # @return [Object] The cached or newly calculated value
   def calc(key, lifetime)
     rec = @hash[key]
-    rec = nil if expired?(key)
+    rec = nil if expired_unsafe?(key)
     if rec.nil?
-      @hash[key] = {
+      rec = {
         value: yield,
         start: Time.now,
         lifetime: lifetime
       }
+      @hash[key] = rec
     end
-    @hash[key][:value]
+    rec[:value]
+  end
+
+  # Internal method that checks if a key is expired without acquiring locks.
+  # This should only be called from within a synchronized block.
+  # @param key [Object] The key to check in the cache
+  # @return [Boolean] True if the key exists and is expired
+  def expired_unsafe?(key)
+    rec = @hash[key]
+    !rec.nil? && rec[:lifetime] && rec[:start] < Time.now - rec[:lifetime]
   end
 
   # Executes a block within a synchronized context if sync is enabled.
   # @param block [Proc] The block to execute
   # @yield The block to execute in a synchronized context
   # @return [Object] The result of the block
-  def synchronized(&block)
-    if @sync
-      @mutex.synchronize(&block)
-    else
-      yield
+  def synchronize_all(&block)
+    return yield unless @sync
+    @mutex.synchronize(&block)
+  end
+
+  # Executes a block within a synchronized context if sync is enabled.
+  # @param key [Object] The object to sync
+  # @param block [Proc] The block to execute
+  # @yield The block to execute in a synchronized context
+  # @return [Object] The result of the block
+  def synchronize_one(key, &block)
+    return yield unless @sync
+    @mutex.synchronize do
+      @locks[key] ||= Mutex.new
     end
+    @locks[key].synchronize(&block)
   end
 end

data/zache.gemspec

@@ -8,14 +8,14 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>= 2.5'
   s.name = 'zache'
-  s.version = '0.14.0' # Version should be updated before release
+  s.version = '0.15.1' # Version should be updated before release
   s.license = 'MIT'
   s.summary = 'In-memory Cache'
   s.description = 'Zero-footprint in-memory thread-safe cache'
   s.authors = ['Yegor Bugayenko']
   s.email = 'yegor256@gmail.com'
   s.homepage = 'https://github.com/yegor256/zache'
-  s.files = `git ls-files`.split($RS)
+  s.files = `git ls-files | grep -v -E '^(test/|\\.|renovate)'`.split($RS)
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = ['README.md']
   s.metadata['rubygems_mfa_required'] = 'true'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: zache
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.1
 platform: ruby
 authors:
 - Yegor Bugayenko
 bindir: bin
 cert_chain: []
-date: 2025-04-12 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Zero-footprint in-memory thread-safe cache
 email: yegor256@gmail.com
@@ -16,21 +16,6 @@ extensions: []
 extra_rdoc_files:
 - README.md
 files:
-- ".0pdd.yml"
-- ".github/workflows/actionlint.yml"
-- ".github/workflows/codecov.yml"
-- ".github/workflows/copyrights.yml"
-- ".github/workflows/license.yml"
-- ".github/workflows/markdown-lint.yml"
-- ".github/workflows/pdd.yml"
-- ".github/workflows/rake.yml"
-- ".github/workflows/reuse.yml"
-- ".github/workflows/xcop.yml"
-- ".github/workflows/yamllint.yml"
-- ".gitignore"
-- ".pdd"
-- ".rubocop.yml"
-- ".rultor.yml"
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -40,9 +25,6 @@ files:
 - Rakefile
 - lib/zache.rb
 - logo.svg
-- renovate.json
-- test/test__helper.rb
-- test/test_zache.rb
 - zache.gemspec
 homepage: https://github.com/yegor256/zache
 licenses:
@@ -64,7 +46,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: In-memory Cache
 test_files: []

data/.0pdd.yml

@@ -1,12 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-errors:
-  - yegor256@gmail.com
-# alerts:
-#   github:
-#     - yegor256
-
-tags:
-  - pdd
-  - bug

data/.github/workflows/actionlint.yml

@@ -1,25 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: actionlint
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  actionlint:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - name: Download actionlint
-        id: get_actionlint
-        run: bash <(curl https://raw.githubusercontent.com/rhysd/actionlint/main/scripts/download-actionlint.bash)
-        shell: bash
-      - name: Check workflow files
-        run: ${{ steps.get_actionlint.outputs.executable }} -color
-        shell: bash

data/.github/workflows/codecov.yml

@@ -1,25 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: codecov
-'on':
-  push:
-    branches:
-      - master
-jobs:
-  codecov:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-ruby@v1
-        with:
-          ruby-version: 3.3
-          bundler-cache: true
-      - run: bundle config set --global path "$(pwd)/vendor/bundle"
-      - run: bundle install --no-color
-      - run: bundle exec rake
-      - uses: codecov/codecov-action@v5
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}

data/.github/workflows/copyrights.yml

@@ -1,15 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: copyrights
-'on':
-  push:
-  pull_request:
-jobs:
-  copyrights:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: yegor256/copyrights-action@0.0.8

data/.github/workflows/license.yml

@@ -1,42 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: license
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  license:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - shell: bash
-        run: |
-          header="Copyright (c) 2018-$(date +%Y) Yegor Bugayenko"
-          failed="false"
-          while IFS= read -r file; do
-            if ! grep -q "${header}" "${file}"; then
-              failed="true"
-              echo "⚠️ Copyright header is not found in: ${file}"
-            else
-              echo "File looks good: ${file}"
-            fi
-          done < <(find . -type f \( \
-            -name "Dockerfile" -o \
-            -name "LICENSE.txt" -o \
-            -name "Makefile" -o \
-            -name "Rakefile" -o \
-            -name "*.sh" -o \
-            -name "*.rb" -o \
-            -name "*.fe" -o \
-            -name "*.yml" \
-            \) -print)
-          if [ "${failed}" = "true" ]; then
-            exit 1
-          fi

data/.github/workflows/markdown-lint.yml

@@ -1,23 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: markdown-lint
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-    paths-ignore: ['paper/**', 'sandbox/**']
-concurrency:
-  group: markdown-lint-${{ github.ref }}
-  cancel-in-progress: true
-jobs:
-  markdown-lint:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: articulate/actions-markdownlint@v1

data/.github/workflows/pdd.yml

@@ -1,19 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: pdd
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  pdd:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: volodya-lombrozo/pdd-action@master

data/.github/workflows/rake.yml

@@ -1,28 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: rake
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  test:
-    strategy:
-      matrix:
-        os: [ubuntu-24.04, macos-15]
-        ruby: [3.3]
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-      - run: bundle config set --global path "$(pwd)/vendor/bundle"
-      - run: bundle install --no-color
-      - run: bundle exec rake

data/.github/workflows/reuse.yml

@@ -1,19 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: reuse
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  reuse:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: fsfe/reuse-action@v5

data/.github/workflows/xcop.yml

@@ -1,21 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: xcop
-"on":
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  xcop:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: g4s8/xcop-action@master
-        with:
-          files: '**/*.xml'

data/.github/workflows/yamllint.yml

@@ -1,19 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-name: yamllint
-'on':
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-jobs:
-  yamllint:
-    timeout-minutes: 15
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ibiqlik/action-yamllint@v3

data/.gitignore

@@ -1,10 +0,0 @@
-*.gem
-.DS_Store
-.bundle/
-.idea/
-.yardoc/
-coverage/
-doc/
-node_modules/
-rdoc/
-vendor/

data/.pdd

@@ -1,5 +0,0 @@
---source=.
---verbose
---rule min-words:20
---rule min-estimate:15
---rule max-estimate:90

data/.rubocop.yml

@@ -1,40 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-AllCops:
-  Exclude:
-    - 'bin/**/*'
-    - 'assets/**/*'
-    - 'vendor/**/**'
-  DisplayCopNames: true
-  TargetRubyVersion: 2.5
-  NewCops: enable
-  SuggestExtensions: false
-plugins:
-  - rubocop-rake
-  - rubocop-minitest
-  - rubocop-performance
-Minitest/EmptyLineBeforeAssertionMethods:
-  Enabled: false
-Minitest/AssertOperator:
-  Enabled: false
-Layout/EmptyLineAfterGuardClause:
-  Enabled: false
-Layout/MultilineMethodCallIndentation:
-  Enabled: false
-Metrics/ClassLength:
-  Max: 300
-Minitest/MultipleAssertions:
-  Max: 5
-Metrics/AbcSize:
-  Max: 30
-Metrics/MethodLength:
-  Max: 30
-Metrics/CyclomaticComplexity:
-  Max: 20
-Metrics/PerceivedComplexity:
-  Max: 20
-Layout/EndOfLine:
-  EnforcedStyle: lf
-Metrics/BlockLength:
-  Max: 28

data/.rultor.yml

@@ -1,26 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
----
-# yamllint disable rule:line-length
-docker:
-  image: yegor256/ruby
-assets:
-  rubygems.yml: yegor256/home#assets/rubygems.yml
-install: |
-  pdd -f /dev/null
-  sudo bundle install --no-color "--gemfile=$(pwd)/Gemfile"
-release:
-  pre: false
-  script: |-
-    bundle exec rake
-    pdd -f /dev/null
-    rm -rf *.gem
-    sed -i "s/0\.0\.0/${tag}/g" zache.gemspec
-    git add zache.gemspec
-    git commit -m "Version set to ${tag}"
-    gem build zache.gemspec
-    chmod 0600 ../rubygems.yml
-    gem push *.gem --config-file ../rubygems.yml
-merge:
-  script: |-
-    bundle exec rake clean test rubocop copyright

data/renovate.json

@@ -1,6 +0,0 @@
-{
-  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": [
-    "config:base"
-  ]
-}

data/test/test__helper.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
-
-$stdout.sync = true
-
-require 'simplecov'
-require 'simplecov-cobertura'
-unless SimpleCov.running || ENV['PICKS']
-  SimpleCov.command_name('test')
-  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new(
-    [
-      SimpleCov::Formatter::HTMLFormatter,
-      SimpleCov::Formatter::CoberturaFormatter
-    ]
-  )
-  SimpleCov.minimum_coverage 90
-  SimpleCov.minimum_coverage_by_file 90
-  SimpleCov.start do
-    add_filter 'test/'
-    add_filter 'vendor/'
-    add_filter 'target/'
-    track_files 'lib/**/*.rb'
-    track_files '*.rb'
-  end
-end
-
-require 'minitest/autorun'
-require 'minitest/reporters'
-Minitest::Reporters.use! [Minitest::Reporters::SpecReporter.new]

data/test/test_zache.rb

@@ -1,297 +0,0 @@
-# frozen_string_literal: true
-
-# SPDX-FileCopyrightText: Copyright (c) 2018-2025 Yegor Bugayenko
-# SPDX-License-Identifier: MIT
-
-require 'concurrent'
-require 'minitest/autorun'
-require 'securerandom'
-require 'threads'
-require 'timeout'
-require_relative '../lib/zache'
-require_relative 'test__helper'
-
-Thread.report_on_exception = true
-
-# Cache test.
-# Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2018-2025 Yegor Bugayenko
-# License:: MIT
-class ZacheTest < Minitest::Test
-  def test_caches
-    cache = Zache.new(sync: false)
-    first = cache.get(:hey, lifetime: 5) { rand }
-    second = cache.get(:hey) { rand }
-    assert_equal(first, second)
-    assert_equal(1, cache.size)
-  end
-
-  def test_caches_and_expires
-    cache = Zache.new
-    first = cache.get(:hey, lifetime: 0.01) { rand }
-    sleep 0.1
-    second = cache.get(:hey) { rand }
-    refute_equal(first, second)
-  end
-
-  def test_calculates_age
-    cache = Zache.new
-    cache.get(:hey) { rand }
-    sleep 0.1
-    assert_operator(cache.mtime(:hey), :<, Time.now - 0.05)
-  end
-
-  def test_caches_in_threads
-    cache = Zache.new
-    Threads.new(10).assert(100) do
-      cache.get(:hey, lifetime: 0.0001) { rand }
-    end
-  end
-
-  def test_key_exists
-    cache = Zache.new
-    cache.get(:hey) { rand }
-    exists_result = cache.exists?(:hey)
-    not_exists_result = cache.exists?(:bye)
-    assert(exists_result)
-    refute(not_exists_result)
-  end
-
-  def test_put_and_exists
-    cache = Zache.new
-    cache.put(:hey, 'hello', lifetime: 0.1)
-    sleep 0.2
-    refute(cache.exists?(:hey))
-  end
-
-  def test_remove_key
-    cache = Zache.new
-    cache.get(:hey) { rand }
-    cache.get(:wey) { rand }
-    assert(cache.exists?(:hey))
-    assert(cache.exists?(:wey))
-    cache.remove(:hey)
-    refute(cache.exists?(:hey))
-    assert(cache.exists?(:wey))
-  end
-
-  def test_remove_by_block
-    cache = Zache.new
-    cache.get('first') { rand }
-    cache.get('second') { rand }
-    cache.remove_by { |k| k == 'first' }
-    refute(cache.exists?('first'))
-    assert(cache.exists?('second'))
-  end
-
-  def test_remove_key_with_sync_false
-    cache = Zache.new(sync: false)
-    cache.get(:hey) { rand }
-    cache.get(:wey) { rand }
-    assert(cache.exists?(:hey))
-    assert(cache.exists?(:wey))
-    cache.remove(:hey)
-    refute(cache.exists?(:hey))
-    assert(cache.exists?(:wey))
-  end
-
-  def test_clean_with_threads
-    cache = Zache.new
-    Threads.new(300).assert(3000) do
-      cache.get(:hey) { rand }
-      cache.get(:bye, lifetime: 0.01) { rand }
-      sleep 0.1
-      cache.clean
-    end
-    assert(cache.exists?(:hey))
-    refute(cache.exists?(:bye))
-  end
-
-  def test_clean
-    cache = Zache.new
-    cache.get(:hey) { rand }
-    cache.get(:bye, lifetime: 0.01) { rand }
-    sleep 0.1
-    cache.clean
-    assert(cache.exists?(:hey))
-    refute(cache.exists?(:bye))
-  end
-
-  def test_clean_size
-    cache = Zache.new
-    cache.get(:hey, lifetime: 0.01) { rand }
-    sleep 0.1
-    cache.clean
-    assert_empty(cache)
-  end
-
-  def test_clean_with_sync_false
-    cache = Zache.new(sync: false)
-    cache.get(:hey) { rand }
-    cache.get(:bye, lifetime: 0.01) { rand }
-    sleep 0.1
-    cache.clean
-    assert(cache.exists?(:hey))
-    refute(cache.exists?(:bye))
-  end
-
-  def test_remove_absent_key
-    cache = Zache.new
-    cache.remove(:hey)
-  end
-
-  def test_check_and_remove
-    cache = Zache.new
-    cache.get(:hey, lifetime: 0) { rand }
-    refute(cache.exists?(:hey))
-  end
-
-  def test_remove_all_with_threads
-    cache = Zache.new
-    Threads.new(10).assert(100) do |i|
-      cache.get(:"hey#{i}") { rand }
-      assert(cache.exists?(:"hey#{i}"))
-      cache.remove_all
-    end
-    10.times do |i|
-      refute(cache.exists?(:"hey#{i}"))
-    end
-  end
-
-  def test_remove_all_with_sync
-    cache = Zache.new
-    cache.get(:hey) { rand }
-    cache.get(:bye) { rand }
-    cache.remove_all
-    refute(cache.exists?(:hey))
-    refute(cache.exists?(:bye))
-  end
-
-  def test_remove_all_without_sync
-    cache = Zache.new(sync: false)
-    cache.get(:hey) { rand }
-    cache.get(:bye) { rand }
-    cache.remove_all
-    refute(cache.exists?(:hey))
-    refute(cache.exists?(:bye))
-  end
-
-  def test_puts_something_in
-    cache = Zache.new(sync: false)
-    cache.get(:hey) { rand }
-    cache.put(:hey, 123)
-    assert_equal(123, cache.get(:hey))
-  end
-
-  def test_sync_zache_is_not_reentrant
-    cache = Zache.new
-    assert_raises ThreadError do
-      cache.get(:first) { cache.get(:second) { 1 } }
-    end
-  end
-
-  def test_calculates_only_once
-    cache = Zache.new
-    long = Thread.start do
-      cache.get(:x) do
-        sleep 0.5
-        'first'
-      end
-    end
-    sleep 0.1
-    assert_predicate(cache, :locked?)
-    cache.get(:x) { 'second' }
-    refute_predicate(cache, :locked?)
-    long.kill
-  end
-
-  def test_checks_locked_status_from_inside
-    cache = Zache.new
-    cache.get(:x) do
-      assert_predicate(cache, :locked?)
-      'done'
-    end
-    refute_predicate(cache, :locked?)
-  end
-
-  def test_returns_dirty_result
-    cache = Zache.new(dirty: true)
-    cache.get(:x, lifetime: 0) { 1 }
-    long = Thread.start do
-      cache.get(:x) do
-        sleep 1000
-        2
-      end
-    end
-    sleep 0.1
-    Timeout.timeout(1) do
-      assert(cache.exists?(:x))
-      assert(cache.expired?(:x))
-      assert_equal(1, cache.get(:x))
-      assert_equal(1, cache.get(:x) { 2 })
-    end
-    long.kill
-  end
-
-  def test_returns_dirty_result_when_not_locked
-    cache = Zache.new(dirty: true)
-    cache.get(:x, lifetime: 0) { 1 }
-    assert(cache.exists?(:x))
-    assert_equal(1, cache.get(:x))
-    assert_equal(2, cache.get(:x) { 2 })
-  end
-
-  def test_fetches_multiple_keys_in_many_threads_in_dirty_mode
-    cache = Zache.new(dirty: true)
-    set = Concurrent::Set.new
-    threads = 50
-    barrier = Concurrent::CyclicBarrier.new(threads)
-    Threads.new(threads).assert(threads * 2) do |i|
-      barrier.wait if i < threads
-      set << cache.get(i, lifetime: 0.001) { i }
-    end
-    assert_equal(threads, set.size)
-  end
-
-  def test_fetches_multiple_keys_in_many_threads
-    cache = Zache.new
-    set = Concurrent::Set.new
-    threads = 50
-    barrier = Concurrent::CyclicBarrier.new(threads)
-    Threads.new(threads).assert(threads * 2) do |i|
-      barrier.wait if i < threads
-      set << cache.get(i) { i }
-    end
-    assert_equal(threads, set.size)
-  end
-
-  def test_fake_class_works
-    cache = Zache::Fake.new
-    assert_equal(1, cache.get(:x) { 1 })
-  end
-
-  def test_rethrows
-    cache = Zache.new
-    assert_raises RuntimeError do
-      cache.get(:hey) { raise 'intentional' }
-    end
-  end
-
-  def test_returns_placeholder_in_eager_mode
-    cache = Zache.new
-    a = cache.get(:me, placeholder: 42, eager: true) do
-      sleep 0.1
-      43
-    end
-    assert_equal(42, a)
-    sleep 0.2
-    b = cache.get(:me)
-    assert_equal(43, b)
-  end
-
-  private
-
-  def rand
-    SecureRandom.uuid
-  end
-end