baza.rb 0.0.7 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cec6d23dff978b5dcf080a6940a875ee1f9a67eb07b61ee5ee4b8a98348113c4
-  data.tar.gz: 98eb41907e61acc9beeb0397da3b1ec0c9cbb8a1ebd7c8f57422f8be18947cf4
+  metadata.gz: f06c63d179589bfc28c89fb3d60d4df8232fca069fdf1b225c830091765cef74
+  data.tar.gz: de1e9b335a7b34f702f3367980400d0667b08e78817ecef533eef0f81a38e1a5
 SHA512:
-  metadata.gz: 1df697ec1d35721c3d23e6ef0b05d0d1c7e99b47c959b8150e413b18f5fd131efb9d3ca28bbdff4343ab4f012ce86217f4b1ffc8508c92eec2842633b6bef354
-  data.tar.gz: 9f74b8782d6a5ad2bfa1f0d8450e1c033cf5c8ad22c2a083f20fb2d96f94a8abbdd572b612a9440edf74f1d40d3b09356c471e2befd85fdd8c020b69884f60f3
+  metadata.gz: 80c39feaf4cd305ba697f38225203f7a6917899cdc89a0ecf0735196b9f54691ebcac0b3742659e546e083d7d7e472f54c1d7648c9722ab478968e5b8a3bfcb4
+  data.tar.gz: 2f37dce17730366ae52e4a4cdd1e69651038402b2a2ab9e806829c275a9140fa0164bbdc31b550a4d809235615d976bd7705ab00e5e7a9186f29898ebece114b

data/.github/workflows/actionlint.yml

@@ -28,7 +28,7 @@ name: actionlint
       - master
 jobs:
   actionlint:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - name: Download actionlint

data/.github/workflows/codecov.yml

@@ -25,7 +25,7 @@ name: codecov
       - master
 jobs:
   codecov:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1

data/.github/workflows/copyrights.yml

@@ -24,7 +24,7 @@ name: copyrights
   pull_request:
 jobs:
   copyrights:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: yegor256/copyrights-action@0.0.5

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

@@ -32,7 +32,7 @@ concurrency:
   cancel-in-progress: true
 jobs:
   markdown-lint:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: articulate/actions-markdownlint@v1

data/.github/workflows/pdd.yml

@@ -28,7 +28,7 @@ name: pdd
       - master
 jobs:
   pdd:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: volodya-lombrozo/pdd-action@master

data/.github/workflows/xcop.yml

@@ -24,7 +24,7 @@ name: xcop
   pull_request:
 jobs:
   xcop:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: g4s8/xcop-action@master

data/.github/workflows/yamllint.yml

@@ -28,7 +28,7 @@ name: yamllint
       - master
 jobs:
   yamllint:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: ibiqlik/action-yamllint@v3

data/Gemfile

@@ -29,12 +29,12 @@ gem 'minitest-reporters', '1.7.1', require: false
 gem 'net-ping', '2.0.8', require: false
 gem 'rake', '13.2.1', require: false
 gem 'random-port', '>0', require: false
-gem 'rspec-rails', '6.1.4', require: false
-gem 'rubocop', '1.65.1', require: false
-gem 'rubocop-performance', '1.21.1', require: false
-gem 'rubocop-rspec', '3.0.4', require: false
+gem 'rspec-rails', '7.0.1', require: false
+gem 'rubocop', '1.66.1', require: false
+gem 'rubocop-performance', '1.22.1', require: false
+gem 'rubocop-rspec', '3.1.0', require: false
 gem 'simplecov', '0.22.0', require: false
 gem 'simplecov-cobertura', '2.1.0', require: false
 gem 'wait_for', '~>0', require: false
-gem 'webmock', '3.23.1', require: false
-gem 'yard', '0.9.36', require: false
+gem 'webmock', '3.24.0', require: false
+gem 'yard', '0.9.37', require: false

data/Gemfile.lock

@@ -3,6 +3,7 @@ PATH
   specs:
     baza.rb (0.0.0)
       backtrace (> 0)
+      elapsed (> 0)
       faraday (> 0)
       faraday-http-cache (> 0)
       faraday-multipart (> 0)
@@ -16,9 +17,9 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    actionpack (7.2.0)
-      actionview (= 7.2.0)
-      activesupport (= 7.2.0)
+    actionpack (7.2.1)
+      actionview (= 7.2.1)
+      activesupport (= 7.2.1)
       nokogiri (>= 1.8.5)
       racc
       rack (>= 2.2.4, < 3.2)
@@ -27,13 +28,13 @@ GEM
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
       useragent (~> 0.16)
-    actionview (7.2.0)
-      activesupport (= 7.2.0)
+    actionview (7.2.1)
+      activesupport (= 7.2.1)
       builder (~> 3.1)
       erubi (~> 1.11)
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
-    activesupport (7.2.0)
+    activesupport (7.2.1)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
@@ -62,6 +63,9 @@ GEM
     diff-lcs (1.5.1)
     docile (1.4.1)
     drb (2.2.1)
+    elapsed (0.0.1)
+      loog (> 0)
+      tago (> 0)
     erubi (1.13.0)
     ethon (0.16.0)
       ffi (>= 1.15.0)
@@ -74,14 +78,15 @@ GEM
       others (> 0)
       tago (> 0)
       yaml (~> 0.3)
-    faraday (2.10.1)
-      faraday-net_http (>= 2.0, < 3.2)
+    faraday (2.12.0)
+      faraday-net_http (>= 2.0, < 3.4)
+      json
       logger
     faraday-http-cache (2.5.1)
       faraday (>= 0.8)
     faraday-multipart (1.0.4)
       multipart-post (~> 2)
-    faraday-net_http (3.1.1)
+    faraday-net_http (3.3.0)
       net-http
     faraday-retry (2.2.1)
       faraday (~> 2.0)
@@ -90,16 +95,16 @@ GEM
     ffi (1.17.0-x86_64-darwin)
     ffi (1.17.0-x86_64-linux-gnu)
     hashdiff (1.1.1)
-    i18n (1.14.5)
+    i18n (1.14.6)
       concurrent-ruby (~> 1.0)
     io-console (0.7.2)
-    irb (1.14.0)
+    irb (1.14.1)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
     iri (0.8.0)
     json (2.7.2)
     language_server-protocol (3.17.0.3)
-    logger (1.6.0)
+    logger (1.6.1)
     loofah (2.22.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.12.0)
@@ -123,15 +128,15 @@ GEM
     nokogiri (1.16.7-x86_64-linux)
       racc (~> 1.4)
     others (0.0.3)
-    parallel (1.26.2)
-    parser (3.3.4.2)
+    parallel (1.26.3)
+    parser (3.3.5.0)
       ast (~> 2.4.1)
       racc
     psych (5.1.2)
       stringio
     public_suffix (6.0.1)
     racc (1.8.1)
-    rack (3.1.7)
+    rack (3.1.8)
     rack-session (2.0.0)
       rack (>= 3.0.0)
     rack-test (2.1.0)
@@ -146,9 +151,9 @@ GEM
     rails-html-sanitizer (1.6.0)
       loofah (~> 2.21)
       nokogiri (~> 1.14)
-    railties (7.2.0)
-      actionpack (= 7.2.0)
-      activesupport (= 7.2.0)
+    railties (7.2.1)
+      actionpack (= 7.2.1)
+      activesupport (= 7.2.1)
       irb (~> 1.13)
       rackup (>= 1.0.0)
       rake (>= 12.2)
@@ -160,45 +165,43 @@ GEM
     rdoc (6.7.0)
       psych (>= 4.0.0)
     regexp_parser (2.9.2)
-    reline (0.5.9)
+    reline (0.5.10)
       io-console (~> 0.5)
     retries (0.0.5)
-    rexml (3.3.5)
-      strscan
-    rspec-core (3.13.0)
+    rexml (3.3.8)
+    rspec-core (3.13.1)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.1)
+    rspec-expectations (3.13.3)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.1)
+    rspec-mocks (3.13.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-rails (6.1.4)
-      actionpack (>= 6.1)
-      activesupport (>= 6.1)
-      railties (>= 6.1)
+    rspec-rails (7.0.1)
+      actionpack (>= 7.0)
+      activesupport (>= 7.0)
+      railties (>= 7.0)
       rspec-core (~> 3.13)
       rspec-expectations (~> 3.13)
       rspec-mocks (~> 3.13)
       rspec-support (~> 3.13)
     rspec-support (3.13.1)
-    rubocop (1.65.1)
+    rubocop (1.66.1)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.4, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
+      rubocop-ast (>= 1.32.2, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.32.0)
+    rubocop-ast (1.32.3)
       parser (>= 3.3.1.0)
-    rubocop-performance (1.21.1)
+    rubocop-performance (1.22.1)
       rubocop (>= 1.48.1, < 2.0)
       rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-rspec (3.0.4)
+    rubocop-rspec (3.1.0)
       rubocop (~> 1.61)
     ruby-progressbar (1.13.0)
     securerandom (0.3.1)
@@ -209,28 +212,27 @@ GEM
     simplecov-cobertura (2.1.0)
       rexml
       simplecov (~> 0.19)
-    simplecov-html (0.12.3)
+    simplecov-html (0.13.1)
     simplecov_json_formatter (0.1.4)
     stringio (3.1.1)
-    strscan (3.1.0)
     tago (0.0.2)
-    thor (1.3.1)
+    thor (1.3.2)
     typhoeus (1.4.1)
       ethon (>= 0.9.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.5.0)
-    uri (0.13.0)
+    unicode-display_width (2.6.0)
+    uri (0.13.1)
     useragent (0.16.10)
     wait_for (0.1.1)
-    webmock (3.23.1)
+    webmock (3.24.0)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    webrick (1.8.1)
+    webrick (1.8.2)
     yaml (0.3.0)
-    yard (0.9.36)
-    zeitwerk (2.6.17)
+    yard (0.9.37)
+    zeitwerk (2.7.0)
 
 PLATFORMS
   arm64-darwin-22
@@ -247,15 +249,15 @@ DEPENDENCIES
   net-ping (= 2.0.8)
   rake (= 13.2.1)
   random-port (> 0)
-  rspec-rails (= 6.1.4)
-  rubocop (= 1.65.1)
-  rubocop-performance (= 1.21.1)
-  rubocop-rspec (= 3.0.4)
+  rspec-rails (= 7.0.1)
+  rubocop (= 1.66.1)
+  rubocop-performance (= 1.22.1)
+  rubocop-rspec (= 3.1.0)
   simplecov (= 0.22.0)
   simplecov-cobertura (= 2.1.0)
   wait_for (~> 0)
-  webmock (= 3.23.1)
-  yard (= 0.9.36)
+  webmock (= 3.24.0)
+  yard (= 0.9.37)
 
 BUNDLED WITH
    2.4.22

data/README.md

@@ -10,7 +10,7 @@
 [![Hits-of-Code](https://hitsofcode.com/github/zerocracy/baza.rb)](https://hitsofcode.com/view/github/zerocracy/baza.rb)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/zerocracy/baza.rb/blob/master/LICENSE.txt)
 
-It's an clinet for [Zerocracy API](https://www.zerocracy.com), in Ruby.
+It's an client for [Zerocracy API](https://www.zerocracy.com), in Ruby.
 
 ## How to contribute
 

data/baza.rb.gemspec

@@ -41,6 +41,7 @@ Gem::Specification.new do |s|
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = ['README.md', 'LICENSE.txt']
   s.add_dependency 'backtrace', '>0'
+  s.add_dependency 'elapsed', '>0'
   s.add_dependency 'faraday', '>0'
   s.add_dependency 'faraday-http-cache', '>0'
   s.add_dependency 'faraday-multipart', '>0'

data/lib/baza-rb/version.rb

@@ -22,9 +22,13 @@
 
 # Just a version.
 #
+# We keep this file separate from the "baza-rb.rb" in order to have an
+# ability to include it from the ".gemspec" script, without including all
+# other packages (thus failing the build).
+#
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2024 Yegor Bugayenko
 # License:: MIT
 class BazaRb
-  VERSION = '0.0.7'
+  VERSION = '0.0.9'
 end

data/lib/baza-rb.rb

@@ -21,6 +21,8 @@
 # SOFTWARE.
 
 require 'base64'
+require 'elapsed'
+require 'fileutils'
 require 'iri'
 require 'loog'
 require 'retries'
@@ -38,7 +40,26 @@ require_relative 'baza-rb/version'
 # Copyright:: Copyright (c) 2024 Yegor Bugayenko
 # License:: MIT
 class BazaRb
-  def initialize(host, port, token, ssl: true, timeout: 30, retries: 3, loog: Loog::NULL, compression: true)
+  # When the server failed (503).
+  class ServerFailure < StandardError; end
+
+  # When request timeout.
+  class TimedOut < StandardError; end
+
+  # Unexpected response arrived from the server.
+  class BadResponse < StandardError; end
+
+  # Ctor.
+  #
+  # @param [String] host Host name
+  # @param [Integer] port TCP port
+  # @param [String] token Secret token of zerocracy.com
+  # @param [Boolean] ssl Should we use SSL?
+  # @param [Float] timeout Connect timeout and session timeout, in seconds
+  # @param [Integer] retries How many times to retry on connection failure?
+  # @param [Loog] loog The logging facility
+  # @param [Boolean] compress Set to TRUE if need to use GZIP while pulling and sending
+  def initialize(host, port, token, ssl: true, timeout: 30, retries: 3, loog: Loog::NULL, compress: true)
     @host = host
     @port = port
     @ssl = ssl
@@ -46,10 +67,11 @@ class BazaRb
     @timeout = timeout
     @loog = loog
     @retries = retries
-    @compression = compression
+    @compress = compress
   end
 
   # Push factbase to the server.
+  #
   # @param [String] name The name of the job on the server
   # @param [Bytes] data The data to push to the server (binary)
   # @param [Array<String>] meta List of metas, possibly empty
@@ -75,11 +97,11 @@ class BazaRb
     }
     elapsed(@loog) do
       ret =
-        with_retries(max_tries: @retries) do
+        with_retries(max_tries: @retries, rescue: TimedOut) do
           checked(
             Typhoeus::Request.put(
               home.append('push').append(name).to_s,
-              @compression ? zipped(params) : params
+              @compress ? zipped(params) : params
             )
           )
         end
@@ -90,6 +112,7 @@ class BazaRb
   end
 
   # Pull factbase from the server.
+  #
   # @param [Integer] id The ID of the job on the server
   # @return [Bytes] Binary data pulled
   def pull(id)
@@ -112,7 +135,7 @@ class BazaRb
           request.on_body do |chunk|
             f.write(chunk)
           end
-          with_retries(max_tries: @retries) do
+          with_retries(max_tries: @retries, rescue: TimedOut) do
             request.run
           end
           checked(request.response)
@@ -125,6 +148,7 @@ class BazaRb
   end
 
   # The job with this ID is finished already?
+  #
   # @param [Integer] id The ID of the job on the server
   # @return [Boolean] TRUE if the job is already finished
   def finished?(id)
@@ -133,7 +157,7 @@ class BazaRb
     finished = false
     elapsed(@loog) do
       ret =
-        with_retries(max_tries: @retries) do
+        with_retries(max_tries: @retries, rescue: TimedOut) do
           checked(
             Typhoeus::Request.get(
               home.append('finished').append(id).to_s,
@@ -148,6 +172,7 @@ class BazaRb
   end
 
   # Read and return the stdout of the job.
+  #
   # @param [Integer] id The ID of the job on the server
   # @return [String] The stdout, as a text
   def stdout(id)
@@ -156,7 +181,7 @@ class BazaRb
     stdout = ''
     elapsed(@loog) do
       ret =
-        with_retries(max_tries: @retries) do
+        with_retries(max_tries: @retries, rescue: TimedOut) do
           checked(
             Typhoeus::Request.get(
               home.append('stdout').append("#{id}.txt").to_s,
@@ -171,6 +196,7 @@ class BazaRb
   end
 
   # Read and return the exit code of the job.
+  #
   # @param [Integer] id The ID of the job on the server
   # @return [Integer] The exit code
   def exit_code(id)
@@ -179,7 +205,7 @@ class BazaRb
     code = 0
     elapsed(@loog) do
       ret =
-        with_retries(max_tries: @retries) do
+        with_retries(max_tries: @retries, rescue: TimedOut) do
           checked(
             Typhoeus::Request.get(
               home.append('exit').append("#{id}.txt").to_s,
@@ -194,6 +220,7 @@ class BazaRb
   end
 
   # Read and return the verification verdict of the job.
+  #
   # @param [Integer] id The ID of the job on the server
   # @return [String] The verdict
   def verified(id)
@@ -202,7 +229,7 @@ class BazaRb
     verdict = 0
     elapsed(@loog) do
       ret =
-        with_retries(max_tries: @retries) do
+        with_retries(max_tries: @retries, rescue: TimedOut) do
           checked(
             Typhoeus::Request.get(
               home.append('jobs').append(id).append('verified.txt').to_s,
@@ -217,6 +244,7 @@ class BazaRb
   end
 
   # Lock the name.
+  #
   # @param [String] name The name of the job on the server
   # @param [String] owner The owner of the lock (any string)
   def lock(name, owner)
@@ -224,7 +252,7 @@ class BazaRb
     raise 'The "name" of the job may not be empty' if name.empty?
     raise 'The "owner" of the lock is nil' if owner.nil?
     elapsed(@loog) do
-      with_retries(max_tries: @retries) do
+      with_retries(max_tries: @retries, rescue: TimedOut) do
         checked(
           Typhoeus::Request.get(
             home.append('lock').append(name).add(owner:).to_s,
@@ -238,6 +266,7 @@ class BazaRb
   end
 
   # Unlock the name.
+  #
   # @param [String] name The name of the job on the server
   # @param [String] owner The owner of the lock (any string)
   def unlock(name, owner)
@@ -245,7 +274,7 @@ class BazaRb
     raise 'The "name" of the job may not be empty' if name.empty?
     raise 'The "owner" of the lock is nil' if owner.nil?
     elapsed(@loog) do
-      with_retries(max_tries: @retries) do
+      with_retries(max_tries: @retries, rescue: TimedOut) do
         checked(
           Typhoeus::Request.get(
             home.append('unlock').append(name).add(owner:).to_s,
@@ -259,6 +288,7 @@ class BazaRb
   end
 
   # Get the ID of the job by the name.
+  #
   # @param [String] name The name of the job on the server
   # @return [Integer] The ID of the job on the server
   def recent(name)
@@ -267,7 +297,7 @@ class BazaRb
     job = 0
     elapsed(@loog) do
       ret =
-        with_retries(max_tries: @retries) do
+        with_retries(max_tries: @retries, rescue: TimedOut) do
           checked(
             Typhoeus::Request.get(
               home.append('recent').append("#{name}.txt").to_s,
@@ -282,6 +312,7 @@ class BazaRb
   end
 
   # Check whether the name of the job exists on the server.
+  #
   # @param [String] name The name of the job on the server
   # @return [Boolean] TRUE if such name exists
   def name_exists?(name)
@@ -290,7 +321,7 @@ class BazaRb
     exists = 0
     elapsed(@loog) do
       ret =
-        with_retries(max_tries: @retries) do
+        with_retries(max_tries: @retries, rescue: TimedOut) do
           checked(
             Typhoeus::Request.get(
               home.append('exists').append(name).to_s,
@@ -305,6 +336,7 @@ class BazaRb
   end
 
   # Place a single durable.
+  #
   # @param [String] jname The name of the job on the server
   # @param [String] file The file name
   def durable_place(jname, file)
@@ -315,7 +347,7 @@ class BazaRb
     id = nil
     elapsed(@loog) do
       ret =
-        with_retries(max_tries: @retries) do
+        with_retries(max_tries: @retries, rescue: TimedOut) do
           checked(
             Typhoeus::Request.post(
               home.append('durables').append('place').to_s,
@@ -338,6 +370,7 @@ class BazaRb
   end
 
   # Save a single durable from local file to server.
+  #
   # @param [Integer] id The ID of the durable
   # @param [String] file The file to upload
   def durable_save(id, file)
@@ -346,7 +379,7 @@ class BazaRb
     raise 'The "file" of the durable is nil' if file.nil?
     raise "The file '#{file}' is absent" unless File.exist?(file)
     elapsed(@loog) do
-      with_retries(max_tries: @retries) do
+      with_retries(max_tries: @retries, rescue: TimedOut) do
         checked(
           Typhoeus::Request.put(
             home.append('durables').append(id).to_s,
@@ -362,6 +395,7 @@ class BazaRb
   end
 
   # Load a single durable from server to local file.
+  #
   # @param [Integer] id The ID of the durable
   # @param [String] file The file to upload
   def durable_load(id, file)
@@ -383,7 +417,7 @@ class BazaRb
         request.on_body do |chunk|
           f.write(chunk)
         end
-        with_retries(max_tries: @retries) do
+        with_retries(max_tries: @retries, rescue: TimedOut) do
           request.run
         end
         checked(request.response)
@@ -393,6 +427,7 @@ class BazaRb
   end
 
   # Lock a single durable.
+  #
   # @param [Integer] id The ID of the durable
   # @param [String] owner The owner of the lock
   def durable_lock(id, owner)
@@ -401,7 +436,7 @@ class BazaRb
     raise 'The "owner" of the lock is nil' if owner.nil?
     raise 'The "owner" of the lock may not be empty' if owner.empty?
     elapsed(@loog) do
-      with_retries(max_tries: @retries) do
+      with_retries(max_tries: @retries, rescue: TimedOut) do
         checked(
           Typhoeus::Request.get(
             home.append('durables').append(id).append('lock').add(owner:).to_s,
@@ -415,6 +450,7 @@ class BazaRb
   end
 
   # Unlock a single durable.
+  #
   # @param [Integer] id The ID of the durable
   # @param [String] owner The owner of the lock
   def durable_unlock(id, owner)
@@ -423,7 +459,7 @@ class BazaRb
     raise 'The "owner" of the lock is nil' if owner.nil?
     raise 'The "owner" of the lock may not be empty' if owner.empty?
     elapsed(@loog) do
-      with_retries(max_tries: @retries) do
+      with_retries(max_tries: @retries, rescue: TimedOut) do
         checked(
           Typhoeus::Request.get(
             home.append('durables').append(id).append('unlock').add(owner:).to_s,
@@ -436,6 +472,104 @@ class BazaRb
     end
   end
 
+  # Pop job from the server.
+  #
+  # @param [String] owner Who is acting (could be any text)
+  # @param [String] zip The path to ZIP archive to take
+  # @return [Boolean] TRUE if job taken, otherwise false
+  def pop(owner, zip)
+    raise 'The "zip" of the job is nil' if zip.nil?
+    success = false
+    FileUtils.rm_f(zip)
+    elapsed(@loog) do
+      File.open(zip, 'wb') do |f|
+        request = Typhoeus::Request.new(
+          home.append('pop').add(owner:).to_s,
+          method: :get,
+          headers: headers.merge(
+            'Accept' => 'application/octet-stream'
+          ),
+          connecttimeout: @timeout,
+          timeout: @timeout
+        )
+        request.on_body do |chunk|
+          f.write(chunk)
+        end
+        with_retries(max_tries: @retries, rescue: TimedOut) do
+          request.run
+        end
+        ret = request.response
+        checked(ret, [200, 204])
+        success = ret.code == 200
+      end
+      unless success
+        FileUtils.rm_f(zip)
+        throw :"Nothing to pop at #{@host}"
+      end
+      throw :"Popped #{File.size(zip)} bytes in ZIP archive at #{@host}"
+    end
+    success
+  end
+
+  # Submit a ZIP archvie to finish a job.
+  #
+  # @param [Integer] id The ID of the job on the server
+  # @param [String] zip The path to the ZIP file with the content of the archive
+  def finish(id, zip)
+    raise 'The "id" of the job is nil' if id.nil?
+    raise 'The "id" of the job must be an integer' unless id.is_a?(Integer)
+    raise 'The "zip" of the job is nil' if zip.nil?
+    raise "The 'zip' file is absent: #{zip}" unless File.exist?(zip)
+    elapsed(@loog) do
+      with_retries(max_tries: @retries, rescue: TimedOut) do
+        checked(
+          Typhoeus::Request.put(
+            home.append('finish').add(id:).to_s,
+            connecttimeout: @timeout,
+            timeout: @timeout,
+            body: File.binread(zip),
+            headers: headers.merge(
+              'Content-Type' => 'application/octet-stream',
+              'Content-Length' => File.size(zip)
+            )
+          )
+        )
+      end
+      throw :"Pushed #{File.size(zip)} bytes to #{@host}, finished job ##{id}"
+    end
+  end
+
+  # Enter a valve.
+  #
+  # @param [String] name Name of the job
+  # @param [String] badge Unique badge of the valve
+  # @param [String] why The reason
+  # @param [nil|Integer] job The ID of the job
+  # @return [String] The result just calculated or retrieved
+  def enter(name, badge, why, job)
+    elapsed(@loog, intro: "Entered valve #{badge} to #{name}") do
+      with_retries(max_tries: @retries, rescue: TimedOut) do
+        ret = checked(
+          Typhoeus::Request.get(
+            home.append('valves').append('result').add(badge:).to_s,
+            headers:
+          ),
+          [200, 204]
+        )
+        return ret.body if ret.code == 200
+        r = yield
+        uri = home.append('valves').append('add')
+          .add(name:)
+          .add(badge:)
+          .add(why:)
+          .add(result: r.to_s)
+        uri = uri.add(job:) unless job.nil?
+        checked(Typhoeus::Request.post(uri.to_s, headers:), 302)
+        r
+      end
+    end
+  end
+
   private
 
   def headers
@@ -460,17 +594,6 @@ class BazaRb
     params.merge(body:, headers:)
   end
 
-  def elapsed(loog)
-    start = Time.now
-    begin
-      yield
-    rescue UncaughtThrowError => e
-      tag = e.tag
-      throw e unless tag.is_a?(Symbol)
-      loog.info("#{tag} in #{start.ago}")
-    end
-  end
-
   def gzip(data)
     ''.dup.tap do |result|
       io = StringIO.new(result)
@@ -487,14 +610,19 @@ class BazaRb
       .scheme(@ssl ? 'https' : 'http')
   end
 
+  # Check the HTTP response and return it.
+  #
+  # @param [Typhoeus::Response] ret The response
+  # @param [Array<Integer>] allowed List of acceptable HTTP codes
+  # @return [Typhoeus::Response] The same response
   def checked(ret, allowed = [200])
     allowed = [allowed] unless allowed.is_a?(Array)
     mtd = (ret.request.original_options[:method] || '???').upcase
     url = ret.effective_url
     if ret.return_code == :operation_timedout
       msg = "#{mtd} #{url} timed out in #{ret.total_time}s"
-      @loog.debug(msg)
-      raise msg
+      @loog.error(msg)
+      raise TimedOut, msg
     end
     log = "#{mtd} #{url} -> #{ret.code} (#{format('%0.2f', ret.total_time)}s)"
     if allowed.include?(ret.code)
@@ -524,6 +652,7 @@ class BazaRb
     when 0
       msg += ', most likely an internal error'
     end
-    raise msg
+    @loog.error(msg)
+    raise ServerFailure, msg
   end
 end

data/test/test_baza-rb.rb

@@ -70,7 +70,7 @@ class TestBazaRb < Minitest::Test
     fb = Factbase.new
     fb.insert.foo = 'test-' * 10_000
     fb.insert
-    baza = BazaRb.new(HOST, PORT, TOKEN, compression: false)
+    baza = BazaRb.new(HOST, PORT, TOKEN, compress: false)
     assert(baza.push(fake_name, fb.export, []).positive?)
   end
 
@@ -89,6 +89,16 @@ class TestBazaRb < Minitest::Test
     end
   end
 
+  def test_live_enter_valve
+    WebMock.enable_net_connect!
+    skip unless we_are_online
+    r = 'something'
+    n = fake_name
+    badge = fake_name
+    assert_equal(r, LIVE.enter(n, badge, 'no reason', nil) { r })
+    assert_equal(r, LIVE.enter(n, badge, 'no reason', nil) { nil })
+  end
+
   def test_durable_place
     WebMock.disable_net_connect!
     stub_request(:post, 'https://example.org/durables/place').to_return(
@@ -112,6 +122,23 @@ class TestBazaRb < Minitest::Test
     )
   end
 
+  def test_simple_pop
+    WebMock.disable_net_connect!
+    stub_request(:get, 'https://example.org/pop?owner=me').to_return(status: 204)
+    Tempfile.open do |zip|
+      assert(!BazaRb.new('example.org', 443, '000').pop('me', zip.path))
+      assert(!File.exist?(zip.path))
+    end
+  end
+
+  def test_simple_finish
+    WebMock.disable_net_connect!
+    stub_request(:put, 'https://example.org/finish?id=42').to_return(status: 200)
+    Tempfile.open do |zip|
+      BazaRb.new('example.org', 443, '000').finish(42, zip.path)
+    end
+  end
+
   def test_simple_recent_check
     WebMock.disable_net_connect!
     stub_request(:get, 'https://example.org/recent/simple.txt')
@@ -163,7 +190,20 @@ class TestBazaRb < Minitest::Test
     )
   end
 
+  def test_push_with_server_failure
+    WebMock.disable_net_connect!
+    stub_request(:put, 'https://example.org/push/foo')
+      .to_return(status: 503, body: 'oops', headers: { 'X-Zerocracy-Failure': 'the failure' })
+      .to_raise('why second time?')
+    e = assert_raises { BazaRb.new('example.org', 443, '000').push('foo', 'data', []) }
+    [
+      'Invalid response code #503',
+      '"the failure"'
+    ].each { |t| assert(e.message.include?(t), "Can't find '#{t}' in #{e.message.inspect}") }
+  end
+
   def test_real_http
+    WebMock.enable_net_connect!
     req =
       with_http_server(200, 'yes') do |baza|
         baza.name_exists?('simple')
@@ -172,6 +212,7 @@ class TestBazaRb < Minitest::Test
   end
 
   def test_push_with_meta
+    WebMock.enable_net_connect!
     req =
       with_http_server(200, 'yes') do |baza|
         baza.push('simple', 'hello, world!', ['boom!', 'хей!'])
@@ -180,6 +221,7 @@ class TestBazaRb < Minitest::Test
   end
 
   def test_push_with_big_meta
+    WebMock.enable_net_connect!
     req =
       with_http_server(200, 'yes') do |baza|
         baza.push(
@@ -196,6 +238,7 @@ class TestBazaRb < Minitest::Test
   end
 
   def test_push_compressed_content
+    WebMock.enable_net_connect!
     req =
       with_http_server(200, 'yes') do |baza|
         baza.push('simple', 'hello, world!', %w[meta1 meta2 meta3])
@@ -207,8 +250,9 @@ class TestBazaRb < Minitest::Test
   end
 
   def test_push_compression_disabled
+    WebMock.enable_net_connect!
     req =
-      with_http_server(200, 'yes', compression: false) do |baza|
+      with_http_server(200, 'yes', compress: false) do |baza|
         baza.push('simple', 'hello, world!', %w[meta1 meta2 meta3])
       end
     assert_equal('application/octet-stream', req.content_type)
@@ -263,7 +307,7 @@ class TestBazaRb < Minitest::Test
   end
 
   def fake_name
-    "fake-#{SecureRandom.hex(8)}"
+    "fake#{SecureRandom.hex(8)}"
   end
 
   def we_are_online

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: baza.rb
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.9
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-18 00:00:00.000000000 Z
+date: 2024-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: backtrace
@@ -24,6 +24,20 @@ dependencies:
     - - ">"
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: elapsed
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement