baza.rb 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44a77b9084f7de4be77127285ca1b33ab3966a7d984b50c3c84dfaa72e98a36c
-  data.tar.gz: 8d8e3368ff7ee202b794c88195842183b92982e4d816ba3a83a688a870bd9cda
+  metadata.gz: f6ee64c99f7aa6a6254d2a98ffd0a49f33cb5c33992094afedf2d926905b7a24
+  data.tar.gz: 76722a8fdafbc741e314213ae3912ff8e8c6d7368cbde7edbe3ab89c87448916
 SHA512:
-  metadata.gz: 6f7f2c3dc38e59b28eb9cbc57099544f4762119eb66b2af45c5e2b17205e67121a5a96629a71b38d53b07517face93dce74b73bf270fc4d38fa0a69a5a4e5d2a
-  data.tar.gz: be736e44829b1384a724e31f026d8e1f7568de5867da240c0c27feec74ab1eb2a8148f3657035a4fcf0ee39376774637a44e60238a48255ca56b179d06675cf8
+  metadata.gz: 351ef08d92a9d637b51b163db95e26b8927abed703a51a1362e4fe51a10714c97afa7b16700bc348cfa4de168788929f5abb89c62e59a4ecf53ce2cd588b3cec
+  data.tar.gz: 6560d77ff5939235f2db005c6151e3cf83ea0d8b40f4c0b7e84c6dde97caaa25daad25beb4cd3dbb936e837601783454b9eefad8bc0a56320d4a4c44d6e1b555

data/Gemfile

@@ -6,21 +6,21 @@
 source 'https://rubygems.org'
 gemspec
 
-gem 'base64', '>0', require: false
-gem 'factbase', '>0', require: false
+gem 'base64', '~>0.3', require: false
+gem 'factbase', '~>0.11', require: false
 gem 'minitest', '~>5.25', require: false
 gem 'minitest-reporters', '~>1.7', require: false
-gem 'os', '>0', require: false
-gem 'qbash', '>0', require: false
+gem 'os', '~>1.1', require: false
+gem 'qbash', '~>0.4', require: false
 gem 'rake', '~>13.2', require: false
-gem 'random-port', '>0', require: false
+gem 'random-port', '~>0.7', require: false
 gem 'rubocop', '~>1.73', require: false
-gem 'rubocop-minitest', '>0', require: false
+gem 'rubocop-minitest', '~>0.38', require: false
 gem 'rubocop-performance', '~>1.23', require: false
-gem 'rubocop-rake', '>0', require: false
+gem 'rubocop-rake', '~>0.7', require: false
 gem 'simplecov', '~>0.22', require: false
 gem 'simplecov-cobertura', '~>2.1', require: false
-gem 'wait_for', '~>0', require: false
+gem 'wait_for', '~>0.1', require: false
 gem 'webmock', '~>3.24', require: false
 gem 'webrick', '~>1.9', require: false
 gem 'yard', '~>0.9', require: false

data/Gemfile.lock

@@ -2,17 +2,17 @@ PATH
   remote: .
   specs:
     baza.rb (0.0.0)
-      backtrace (> 0)
-      elapsed (> 0)
-      faraday (> 0)
-      faraday-http-cache (> 0)
-      faraday-multipart (> 0)
-      faraday-retry (> 0)
-      iri (> 0)
-      loog (> 0)
-      retries (~> 0)
-      tago (~> 0)
-      typhoeus (~> 1.3)
+      backtrace (~> 0.4)
+      elapsed (~> 0.0)
+      faraday (~> 2.13)
+      faraday-http-cache (~> 2.5)
+      faraday-multipart (~> 1.1)
+      faraday-retry (~> 2.3)
+      iri (~> 0.11)
+      loog (~> 0.6)
+      retries (~> 0.0)
+      tago (~> 0.0)
+      typhoeus (~> 1.4)
 
 GEM
   remote: https://rubygems.org/
@@ -21,9 +21,9 @@ GEM
       public_suffix (>= 2.0.2, < 7.0)
     ansi (1.5.0)
     ast (2.4.3)
-    backtrace (0.4.0)
+    backtrace (0.4.1)
     base64 (0.3.0)
-    bigdecimal (3.2.1)
+    bigdecimal (3.2.2)
     builder (3.3.0)
     crack (1.0.0)
       bigdecimal
@@ -35,7 +35,7 @@ GEM
       tago (> 0)
     ethon (0.16.0)
       ffi (>= 1.15.0)
-    factbase (0.10.2)
+    factbase (0.11.0)
       backtrace (~> 0.4)
       decoor (~> 0.0)
       json (~> 2.7)
@@ -107,7 +107,7 @@ GEM
     regexp_parser (2.10.0)
     retries (0.0.5)
     rexml (3.4.1)
-    rubocop (1.75.8)
+    rubocop (1.76.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -115,10 +115,10 @@ 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.45.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.44.1)
+    rubocop-ast (1.45.1)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
     rubocop-minitest (0.38.1)
@@ -168,22 +168,22 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  base64 (> 0)
+  base64 (~> 0.3)
   baza.rb!
-  factbase (> 0)
+  factbase (~> 0.11)
   minitest (~> 5.25)
   minitest-reporters (~> 1.7)
-  os (> 0)
-  qbash (> 0)
+  os (~> 1.1)
+  qbash (~> 0.4)
   rake (~> 13.2)
-  random-port (> 0)
+  random-port (~> 0.7)
   rubocop (~> 1.73)
-  rubocop-minitest (> 0)
+  rubocop-minitest (~> 0.38)
   rubocop-performance (~> 1.23)
-  rubocop-rake (> 0)
+  rubocop-rake (~> 0.7)
   simplecov (~> 0.22)
   simplecov-cobertura (~> 2.1)
-  wait_for (~> 0)
+  wait_for (~> 0.1)
   webmock (~> 3.24)
   webrick (~> 1.9)
   yard (~> 0.9)

data/baza.rb.gemspec

@@ -23,16 +23,16 @@ Gem::Specification.new do |s|
   s.files = `git ls-files`.split($RS)
   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'
-  s.add_dependency 'faraday-retry', '>0'
-  s.add_dependency 'iri', '>0'
-  s.add_dependency 'loog', '>0'
-  s.add_dependency 'retries', '~>0'
-  s.add_dependency 'tago', '~>0'
-  s.add_dependency 'typhoeus', '~>1.3'
+  s.add_dependency 'backtrace', '~>0.4'
+  s.add_dependency 'elapsed', '~>0.0'
+  s.add_dependency 'faraday', '~>2.13'
+  s.add_dependency 'faraday-http-cache', '~>2.5'
+  s.add_dependency 'faraday-multipart', '~>1.1'
+  s.add_dependency 'faraday-retry', '~>2.3'
+  s.add_dependency 'iri', '~>0.11'
+  s.add_dependency 'loog', '~>0.6'
+  s.add_dependency 'retries', '~>0.0'
+  s.add_dependency 'tago', '~>0.0'
+  s.add_dependency 'typhoeus', '~>1.4'
   s.metadata['rubygems_mfa_required'] = 'true'
 end

data/lib/baza-rb/fake.rb

@@ -123,6 +123,17 @@ class BazaRb::Fake
     true
   end
 
+  # Find a single durable.
+  #
+  # @param [String] jname The name of the job on the server
+  # @param [String] file The path to the file to upload
+  # @return [Integer] Always returns 42 as the fake durable ID
+  def durable_find(jname, file)
+    assert_name(jname)
+    assert_file(file)
+    42
+  end
+
   # Place a single durable file on the server.
   #
   # @param [String] jname The name of the job on the server
@@ -213,12 +224,14 @@ class BazaRb::Fake
   # @param [String] owner Identifier of who is taking the job
   # @param [String] zip The local file path where the job's ZIP will be saved
   # @return [Boolean] Always returns TRUE and creates an empty file
+  # rubocop:disable Naming/PredicateMethod
   def pop(owner, zip)
     assert_owner(owner)
     FileUtils.mkdir_p(File.dirname(zip))
     FileUtils.touch(zip)
     true
   end
+  # rubocop:enable Naming/PredicateMethod
 
   # Submit a ZIP archive to finish a previously popped job.
   #

data/lib/baza-rb/version.rb

@@ -13,5 +13,5 @@
 # Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
 # License:: MIT
 class BazaRb
-  VERSION = '0.5.1'
+  VERSION = '0.7.0'
 end

data/lib/baza-rb.rb

@@ -158,25 +158,7 @@ class BazaRb
     data = ''
     elapsed(@loog) do
       Tempfile.open do |file|
-        File.open(file, 'wb') do |f|
-          request = Typhoeus::Request.new(
-            home.append('pull').append("#{id}.fb").to_s,
-            method: :get,
-            headers: headers.merge(
-              'Accept' => 'application/zip, application/factbase'
-            ),
-            accept_encoding: 'gzip',
-            connecttimeout: @timeout,
-            timeout: @timeout
-          )
-          request.on_body do |chunk|
-            f.write(chunk)
-          end
-          retry_it do
-            request.run
-          end
-          checked(request.response)
-        end
+        download(home.append('pull').append("#{id}.fb").to_s, file.path)
         data = File.binread(file)
         throw :"Pulled #{data.bytesize} bytes of job ##{id} factbase at #{@host}"
       end
@@ -446,26 +428,8 @@ class BazaRb
     raise 'The ID of the durable is nil' if id.nil?
     raise 'The ID of the durable must be a positive integer' unless id.positive?
     raise 'The "file" of the durable is nil' if file.nil?
-    FileUtils.mkdir_p(File.dirname(file))
     elapsed(@loog) do
-      File.open(file, 'wb') do |f|
-        request = Typhoeus::Request.new(
-          home.append('durables').append(id).to_s,
-          method: :get,
-          headers: headers.merge(
-            'Accept' => 'application/octet-stream'
-          ),
-          connecttimeout: @timeout,
-          timeout: @timeout
-        )
-        request.on_body do |chunk|
-          f.write(chunk)
-        end
-        retry_it do
-          request.run
-        end
-        checked(request.response)
-      end
+      download(home.append('durables').append(id).to_s, file)
       throw :"Durable ##{id} loaded #{File.size(file)} bytes from #{@host}"
     end
   end
@@ -516,6 +480,38 @@ class BazaRb
     end
   end
 
+  # Find a durable by job name and file name.
+  #
+  # @param [String] jname The name of the job
+  # @param [String] file The file name
+  # @return [Integer, nil] The ID of the durable if found, nil if not found
+  def durable_find(jname, file)
+    raise 'The "jname" is nil' if jname.nil?
+    raise 'The "jname" may not be empty' if jname.empty?
+    raise 'The "file" is nil' if file.nil?
+    raise 'The "file" may not be empty' if file.empty?
+    id = nil
+    elapsed(@loog) do
+      ret =
+        retry_it do
+          checked(
+            Typhoeus::Request.get(
+              home.append('durables').append('find').add(jname:, file:).to_s,
+              headers:
+            ),
+            [200, 404]
+          )
+        end
+      if ret.code == 200
+        id = ret.body.to_i
+        throw :"Found durable ##{id} for job \"#{jname}\" file \"#{file}\" at #{@host}"
+      else
+        throw :"Durable not found for job \"#{jname}\" file \"#{file}\" at #{@host}"
+      end
+    end
+    id
+  end
+
   # Transfer funds to another user.
   #
   # @param [String] recipient GitHub username of the recipient (e.g. "yegor256")
@@ -607,55 +603,28 @@ class BazaRb
   # @return [Boolean] TRUE if a job was successfully popped, FALSE if queue is empty
   # @raise [ServerFailure] If the pop operation fails
   def pop(owner, zip)
-    raise 'The "zip" of the job is nil' if zip.nil?
     success = false
-    FileUtils.rm_f(zip)
-    job = nil
     elapsed(@loog) do
-      File.open(zip, 'wb+') do |f|
-        loop do
-          uri = home.append('pop').add(owner:)
-          uri = uri.add(job:) if job
-          request = Typhoeus::Request.new(
-            uri.to_s,
-            method: :get,
-            headers: headers.merge(
-              'Accept' => 'application/octet-stream',
-              'Range' => "bytes=#{f.size}-"
+      uri = home.append('pop').add(owner:)
+      ret =
+        retry_it do
+          checked(
+            Typhoeus::Request.get(
+              uri.to_s,
+              headers:
             ),
-            connecttimeout: @timeout,
-            timeout: @timeout
+            [200, 204, 206]
           )
-          request.on_body do |chunk|
-            f.write(chunk)
-          end
-          retry_it do
-            request.run
-          end
-          ret = request.response
-          checked(ret, [200, 204, 206])
-          success = ret.code != 204
-          break unless ret.code == 206
-          job = ret.headers['X-Zerocracy-JobId']
-          raise 'Job ID is not returned in X-Zerocracy-JobId' if job.nil?
-          raise "Job ID returned in X-Zerocracy-JobId is not valid (#{job.inspect})" unless job.match?(/^[0-9]+$/)
-          _, v = ret.headers['Content-Range'].split
-          range, total = v.split('/')
-          raise "Total size is not valid (#{total.inspect})" unless total.match?(/^\*|[0-9]+$/)
-          b, e = range.split('-')
-          raise "Range is not valid (#{range.inspect})" unless e.match?(/^[0-9]+$/)
-          len = ret.headers['Content-Length'].to_i
-          unless len.zero?
-            raise "Range size (#{range.inspect}) is not equal to Content-Length" unless len - 1 == e.to_i - b.to_i
-            raise "Range end (#{range.inspect}) is not equal to #{f.size}" if e.to_i != f.size - 1
-          end
-          break if e.to_i == total.to_i - 1
         end
-      end
-      unless success
+      if ret.code == 204
         FileUtils.rm_f(zip)
-        throw :"Nothing to pop at #{@host}"
+        throw :"Nothing to pop at #{uri}"
       end
+      job = ret.headers['X-Zerocracy-JobId']
+      raise 'Job ID is not returned in X-Zerocracy-JobId' if job.nil?
+      raise "Job ID returned in X-Zerocracy-JobId is not valid (#{job.inspect})" unless job.match?(/^[0-9]+$/)
+      download(uri.add(job:), zip)
+      success = true
       throw :"Popped #{File.size(zip)} bytes in ZIP archive at #{@host}"
     end
     success
@@ -851,4 +820,49 @@ class BazaRb
     @loog.error(msg)
     raise ServerFailure, msg
   end
+
+  # Download file via GET, in ranges.
+  # @param [String] uri The URI
+  # @param [String] file The path to save to
+  def download(uri, file)
+    raise 'The "file" is nil' if file.nil?
+    FileUtils.mkdir_p(File.dirname(file))
+    elapsed(@loog) do
+      File.open(file, 'wb+') do |f|
+        loop do
+          request = Typhoeus::Request.new(
+            uri.to_s,
+            method: :get,
+            headers: headers.merge(
+              'Accept' => 'application/octet-stream',
+              'Range' => "bytes=#{f.size}-"
+            ),
+            connecttimeout: @timeout,
+            timeout: @timeout
+          )
+          request.on_body do |chunk|
+            f.write(chunk)
+          end
+          retry_it do
+            request.run
+          end
+          ret = request.response
+          checked(ret, [200, 206])
+          break if ret.code == 200
+          _, v = ret.headers['Content-Range'].split
+          range, total = v.split('/')
+          raise "Total size is not valid (#{total.inspect})" unless total.match?(/^\*|[0-9]+$/)
+          b, e = range.split('-')
+          raise "Range is not valid (#{range.inspect})" unless e.match?(/^[0-9]+$/)
+          len = ret.headers['Content-Length'].to_i
+          unless len.zero?
+            raise "Range size (#{range.inspect}) is not equal to Content-Length" unless len - 1 == e.to_i - b.to_i
+            raise "Range end (#{range.inspect}) is not equal to #{f.size}" if e.to_i != f.size - 1
+          end
+          break if e.to_i == total.to_i - 1
+        end
+      end
+      throw :"Downloaded #{File.size(file)} bytes from #{uri}"
+    end
+  end
 end

data/test/test_baza-rb.rb

@@ -22,7 +22,7 @@ require_relative '../lib/baza-rb'
 # License:: MIT
 class TestBazaRb < Minitest::Test
   # The token to use for testing, in Zerocracy.com:
-  TOKEN = '00000000-0000-0000-0000-000000000000'
+  TOKEN = 'ZRCY-00000000-0000-0000-0000-000000000000'
 
   # The host of the production platform:
   HOST = 'api.zerocracy.com'
@@ -95,7 +95,10 @@ class TestBazaRb < Minitest::Test
     Dir.mktmpdir do |dir|
       file = File.join(dir, "#{fake_name}.bin")
       File.binwrite(file, 'hello')
-      id = LIVE.durable_place(fake_name, file)
+      jname = fake_name
+      refute(LIVE.durable_find(jname, File.basename(file)))
+      id = LIVE.durable_place(jname, file)
+      assert_equal(id, LIVE.durable_find(jname, File.basename(file)))
       owner = fake_name
       LIVE.durable_lock(id, owner)
       LIVE.durable_load(id, file)
@@ -519,6 +522,24 @@ class TestBazaRb < Minitest::Test
     assert_equal('new result', result)
   end
 
+  def test_durable_find_found
+    WebMock.disable_net_connect!
+    stub_request(:get, 'https://example.org:443/durables/find?jname=test-job&file=test.txt')
+      .with(headers: { 'X-Zerocracy-Token' => '000' })
+      .to_return(status: 200, body: '42')
+    id = fake_baza.durable_find('test-job', 'test.txt')
+    assert_equal(42, id)
+  end
+
+  def test_durable_find_not_found
+    WebMock.disable_net_connect!
+    stub_request(:get, 'https://example.org:443/durables/find?jname=test-job&file=test.txt')
+      .with(headers: { 'X-Zerocracy-Token' => '000' })
+      .to_return(status: 404)
+    id = fake_baza.durable_find('test-job', 'test.txt')
+    assert_nil(id)
+  end
+
   def test_checked_with_500_error
     WebMock.disable_net_connect!
     stub_request(:get, 'https://example.org:443/test')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: baza.rb
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -13,156 +13,156 @@ dependencies:
   name: backtrace
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: elapsed
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.0'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.13'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.13'
 - !ruby/object:Gem::Dependency
   name: faraday-http-cache
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.5'
 - !ruby/object:Gem::Dependency
   name: faraday-multipart
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: faraday-retry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: iri
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.11'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.11'
 - !ruby/object:Gem::Dependency
   name: loog
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: retries
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.0'
 - !ruby/object:Gem::Dependency
   name: tago
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.0'
 - !ruby/object:Gem::Dependency
   name: typhoeus
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.4'
 description: It is a Ruby client for Zerocracy API, allowing you to check your job
   statuses, upload and download binaries, lock/unlock them, manage durables, and do
   everything else that is possible to do via the HTTP API.