chimera_http_client 1.1.2 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0909ba0cb053a18ffbbe0c81e866f61692b7eadb86cf790e97e5ab8178dbb69
-  data.tar.gz: 2583f9ea44ef1d2868cb8b421e680795cb474bccc4ef3e0a006c3c02135d3f17
+  metadata.gz: d44d96daf4357f5f997f4874569c0f92bddeab9f945d5c950f8066d937c8d92b
+  data.tar.gz: 71eadaa902be940979f3fff031bddb78469beefafed2f605a19199ca54ce14f7
 SHA512:
-  metadata.gz: b193b7ed042727cc5a9c8b937cd7542b743a0f6530f47be8e842484be19cfc2edd9c9756564d3eb683d3875a65c84aefb482abb9df6d54a8c4d634c106337227
-  data.tar.gz: ad18499c13ad4bc2ca9a02a1ae52f99ca559c2dff880e19553968d06e2bd7da5ab65b258f07d58767759e08974438c050fd7f4c17b17bdc1e89a71f47208b484
+  metadata.gz: 7efe9e56feff54e326a568817cd2edde14ca7988188f67a150d6a4c507d0c87e6d4e08ab159102fdf91f6a86684acb18386cd9b433a63bc5b98e22a92b4e18d9
+  data.tar.gz: 97fa3cbea4100201f44264efccd9d5e574abbac20dcc36ef3cfdfd5b9aac16d993ba065b39fa56d2c6b31f9c1cbc2476ab58621bb0815aaa6343419e48c0dcff

data/.rubocop.yml

@@ -1,50 +1,48 @@
+require:
+  - rubocop-rake
+  - rubocop-rspec
+
 AllCops:
-  DisplayCopNames: true
   TargetRubyVersion: 2.5
+  DisplayCopNames: true
+  NewCops: enable # but feel free to disable them below
   Exclude:
       - vendor/**/*
       - config.ru
 
-Layout/AlignHash:
-  Enabled: false
+Layout/EmptyLineBetweenDefs:
+  AllowAdjacentOneLineDefs: true
 
-# Cop supports --auto-correct.
 # Configuration parameters: EnforcedStyle, SupportedStyles, IndentationWidth.
 # SupportedStyles: special_inside_parentheses, consistent, align_braces
-Layout/IndentFirstHashElement:
+Layout/FirstHashElementIndentation:
   EnforcedStyle: consistent
 
-Metrics/AbcSize:
-  Max: 35
+Layout/HashAlignment:
+  Enabled: false
 
-Metrics/BlockLength:
-  Exclude:
-    - chimera_http_client.gemspec
-    - spec/**/*
+Layout/LineLength:
+  Max: 125
 
-# Configuration parameters: CountComments.
-Metrics/ClassLength:
-  Max: 150
+Metrics:
+  Enabled: false
 
-Metrics/CyclomaticComplexity:
-  Max: 15
+RSpec/ContextWording:
+  Enabled: false
 
-# Configuration parameters: AllowHeredoc, AllowURI, URISchemes.
-# URISchemes: http, https
-Metrics/LineLength:
-  Max: 125
+RSpec/ExampleLength:
+  Max: 25
 
-# Offense count: 5
-# Configuration parameters: CountComments.
-Metrics/MethodLength:
-  Max: 32
+RSpec/MultipleExpectations:
+  Enabled: false
 
-Metrics/ParameterLists:
-  Max: 7
+RSpec/MultipleMemoizedHelpers:
+  Enabled: false
 
-# Configuration parameters: EnforcedStyle, SupportedStyles.
-# SupportedStyles: braces, no_braces, context_dependent
-Style/BracesAroundHashParameters:
+RSpec/NestedGroups:
+  Max: 4
+
+Style/CaseLikeIf:
   Enabled: false
 
 Style/CommentedKeyword:
@@ -55,7 +53,6 @@ Style/Documentation:
 
 Style/DoubleNegation:
   Enabled: true
-
 Style/FrozenStringLiteralComment:
   Enabled: false
 
@@ -71,11 +68,22 @@ Style/StringLiterals:
     - single_quotes
     - double_quotes
 
-# Cop supports --auto-correct.
 Style/NumericLiterals:
   MinDigits: 15
 
-# Cop supports --auto-correct.
+Style/PercentLiteralDelimiters:
+  PreferredDelimiters:
+    default: ()
+    "%": ()
+    "%i": ()
+    "%q": ()
+    "%Q": ()
+    "%r": "{}"
+    "%s": ()
+    "%w": ()
+    "%W": ()
+    "%x": ()
+
 # Configuration parameters: AllowAsExpressionSeparator.
 Style/Semicolon:
   AllowAsExpressionSeparator: true
@@ -83,7 +91,6 @@ Style/Semicolon:
 Style/SymbolProc:
   Enabled: false
 
-# Cop supports --auto-correct.
 # Configuration parameters: EnforcedStyleForMultiline, SupportedStyles.
 # SupportedStyles: comma, consistent_comma, no_comma
 Style/TrailingCommaInArrayLiteral:
@@ -92,7 +99,6 @@ Style/TrailingCommaInArrayLiteral:
 Style/TrailingCommaInHashLiteral:
   EnforcedStyleForMultiline: comma
 
-# Cop supports --auto-correct.
 # Configuration parameters: SupportedStyles, MinSize, WordRegex.
 # SupportedStyles: percent, brackets
 Style/WordArray:

data/.ruby-version

@@ -1 +1 @@
-2.6.3
+3.0.1

data/.travis.yml

@@ -1,7 +1,8 @@
 language: ruby
 
 rvm:
-  - ruby-head
+  - 3.0
+  - 2.7
   - 2.6
   - 2.5
   - jruby
@@ -16,10 +17,10 @@ matrix:
 before_install:
   - 'echo ''gem: --no-ri --no-rdoc'' > ~/.gemrc'
 
-bundler_args: --jobs 3 --retry 3
+bundler_args: --jobs 4 --retry 4
 
 before_script:
 
 # execute rspec tests, rubocop and bundle:audit
 script:
-  bundle exec rake
+  bundle exec rake ci

data/README.markdown

@@ -17,11 +17,14 @@ The only other runtime dependency is Ruby's latest code loader [**zeitwerk**](ht
 
 ### Ruby version
 
-| Chimera version | Ruby version |
-|:----------------|:-------------|
-| >= 1.1          | >= 2.5       |
-| =  1.0          | >= 2.4       |
-| <= 0.5          | >= 2.1       |
+| Chimera version | Ruby version                       |
+|:----------------|:-----------------------------------|
+| >= 1.4          | >= 2.5 (3.0 compatibility ensured) |
+| >= 1.1          | >= 2.5                             |
+| =  1.0          | >= 2.4, <= 3.0                     |
+| <= 0.5          | >= 2.1, <= 3.0                     |
+
+The test suite of v1.4 passes on **MRI Ruby** (2.5, 2.6, 2.7, 3.0) and on **JRuby**, but not on **TruffleRuby**.
 
 ### ENV variables
 
@@ -83,12 +86,13 @@ Setting the `base_url` is meant to be a comfort feature, as you can then pass sh
 
 The optional parameters are:
 
-* `logger` - an instance of a logger class that implements `#info` and `#warn` methods
+* `cache` - an instance of your cache solution, can be overwritten in any request
+* `deserializers` - custom methods to deserialize the response body, below more details
+* `logger` - an instance of a logger class that implements `#info`, `#warn` and `#error` methods
+* `monitor` - to collect metrics about requests, the basis for your instrumentation needs
 * `timeout` - the timeout for all requests, can be overwritten in any request, the default are 3 seconds
 * `user_agent` - if you would like your calls to identify with a specific user agent
 * `verbose` - the default is `false`, set it to true while debugging issues
-* `cache` - an instance of your cache solution, can be overwritten in any request
-* `deserializers` - custom methods to deserialize the response body, below more details
 
 ##### Custom deserializers
 
@@ -102,6 +106,23 @@ A Deserializer has to be an object on which the method `call` with the parameter
 
 where `body` is the response body (in the default case a JSON object). The class `Deserializer` contains the default objects that are used. They might help you creating your own. Don't forget to make requests with another header than the default `"Content-Type" => "application/json"`, when the API you connect to does not support JSON.
 
+##### Monitoring, metrics, instrumentation
+
+Pass an object as `:monitor` to a connection that defines the method `call` and accepts a hash as parameter.
+
+    monitor.call({...})
+
+It will receive information about every request as soon as it finished. What you do with this information is up for you to implement.
+
+| Field          | Description                                                           |
+|:---------------|:----------------------------------------------------------------------|
+| `url`          | URL of the endpoint that was called                                   |
+| `method`       | HTTP method: get, post, ...                                           |
+| `status`       | HTTP status code: 200, ...                                            |
+| `runtime`      | the time in seconds it took the request to finish                     |
+| `completed_at` | Time.now.utc.iso8601(3)                                               |
+| `context`      | Whatever you pass as `monitoring_context` to the options of a request |
+
 ### Request methods
 
 The available methods are:
@@ -142,6 +163,7 @@ All request methods expect a mandatory `endpoint` and an optional hash as parame
 * `password` - used for a BasicAuth login
 * `timeout` - set a custom timeout per request (the default is 3 seconds)
 * `cache` - optionally overwrite the cache store set in `Connection` in any request
+* `monitoring_context` - pass additional information you want to collect with your instrumentation `monitor`
 
 Example:
 
@@ -171,6 +193,17 @@ If you want to use a different timeout, you can pass the key `timeout` when init
 
 By default no logging is happening. If you need request logging, you can pass your custom Logger to the key `logger` when initializing the `Connection`. It will write to `logger.info` when starting and when completing a request.
 
+The message passed to the logger is a hash with the following fields:
+
+| Key          | Description                                 |
+|:-------------|:--------------------------------------------|
+| `message`    | indicator if a call was started or finished |
+| `method`     | the HTTP method used                        |
+| `url`        | the requested URL                           |
+| `code`       | HTTP status code                            |
+| `runtime`    | time the request took in ms                 |
+| `user_agent` | the user_agent used to open the connection  |
+
 #### Caching responses
 
 To cache all the reponses of a connection, just pass the optional parameter `cache` to its initializer. You can also overwrite the connection's cache configuration by passing the parameter `cache` to any `get` call.

data/Rakefile

@@ -1,17 +1,23 @@
 require "bundler/audit/task"
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
+require "rubocop/rake_task"
 
+# setup task bundle:audit
 Bundler::Audit::Task.new
 
+# setup taks rspec
 RSpec::Core::RakeTask.new(:rspec) do |t|
   # t.exclude_pattern = "**/server/*_spec.rb" # skip real http server specs
   # t.exclude_pattern = "**/stubbed/*_spec.rb" # skip the stubbed Typhoeus specs
 end
 
+# setup taks rubocop and rubocop:auto_correct
+RuboCop::RakeTask.new
+
 desc "Open a console with the ChimeraHttpClient loaded"
 task :console do
-  puts "Console with the gem and awesome_print loaded:"
+  puts "Console with the gem and amazing_print loaded:"
   ARGV.clear
   require "irb"
   require "ap"
@@ -19,15 +25,7 @@ task :console do
   IRB.start
 end
 
-desc "Run Rubocop"
-task :rubocop do
-  system "bundle exec rubocop -c .rubocop.yml"
-end
-
-desc "Run Rubocop and auto-correct issues"
-task :rubocopa do
-  system "bundle exec rubocop -c .rubocop.yml -a"
-end
+desc "Run rubocop and the specs and check for known CVEs"
+task ci: %i(rubocop rspec bundle:audit)
 
-desc "Run all the tests"
-task default: %i[rspec rubocop bundle:audit]
+task default: :ci

data/TODO.markdown

@@ -14,8 +14,9 @@ _none known_
 * [x] ~~include the total_time of the requests in the log~~
 * [x] ~~add (example) to README~~
 * [ ] add logger.warn / .error for error cases (?)
+* [ ] streamline log message
 
-### Custom De-serializer
+### ~~Custom De-serializer~~
 
 * [x] ~~allow to pass custom deserializer~~
 * [x] ~~use custom deserializer in #parsed_body instead of default JSON parsing~~
@@ -40,15 +41,18 @@ _none known_
 
 - [ ] Determine by parameter if 3xx Redirects should be handled as an Error or not
 - [x] ~~Add a longer description to the gemspec file~~
+- [ ] Refactor README to explain simple use case vs. all the powerful options?
 
-### Instrumentation
+### ~~Instrumentation~~
 
-- [ ] allow to pass object to collect metrics for monitoring
-  - [ ] request URL
-  - [ ] request resonse code
-  - [ ] request datetime
-  - [ ] request runtime
-- [ ] add example to README
+- [x] ~~allow to pass object to collect metrics for monitoring~~
+  - [x] ~~request URL~~
+  - [x] ~~request HTTP method~~
+  - [x] ~~request response code~~
+  - [x] ~~request datetime~~
+  - [x] ~~request runtime~~
+  - [x] ~~custom context information per request~~
+- [x] ~~add example to README~~
 
 ### Enable more Typhoeus functionality
 
@@ -93,7 +97,7 @@ _none known_
 * [x] ~~allow to set custom timeout per call~~
 * [x] ~~add (example) to README~~
 
-### Release
+### ~~Release~~
 
 * [x] ~~rename module to have unique namespace~~
 * [x] ~~release to rubygems to add to the plethora of similar gems~~

data/chimera_http_client.gemspec

@@ -32,14 +32,15 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency "zeitwerk", ">= 2.0"
 
   # general development and test dependencies
-  spec.add_development_dependency "awesome_print",      "~> 1.8"
+  spec.add_development_dependency "amazing_print",      ">= 1.2"
   spec.add_development_dependency "bundler",            ">= 1.0"
-  spec.add_development_dependency "bundler-audit",      "~> 0.6"
-  spec.add_development_dependency "irb",                "~> 1.0"
+  spec.add_development_dependency "bundler-audit",      ">= 0.6"
+  spec.add_development_dependency "irb",                ">= 1.0"
   spec.add_development_dependency "rake",               ">= 10.0"
   spec.add_development_dependency "rspec",              "~> 3.0"
-  spec.add_development_dependency "rubocop",            "~> 0.50"
-  spec.add_development_dependency "rubocop-rspec",      "~> 1.4"
+  spec.add_development_dependency "rubocop",            "~> 1.12"
+  spec.add_development_dependency "rubocop-rake",       "~> 0.5"
+  spec.add_development_dependency "rubocop-rspec",      "~> 2.2"
 
   # only for server specs with real HTTP requests
   spec.add_development_dependency "capybara",           "~> 3.0"
@@ -47,4 +48,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "sinatra",            "~> 2.0"
   spec.add_development_dependency "sinatra-contrib",    "~> 2.0"
   spec.add_development_dependency "webmock",            "~> 3.0"
+  spec.add_development_dependency "webrick"
 end

data/lib/chimera_http_client.rb

@@ -7,5 +7,5 @@ module ChimeraHttpClient
   loader.setup
 
   # as Zeitwerk can't handle innner classes properly :-/
-  require_relative "./chimera_http_client/error.rb"
+  require_relative "./chimera_http_client/error"
 end

data/lib/chimera_http_client/base.rb

@@ -8,6 +8,7 @@ module ChimeraHttpClient
       @base_url = options.fetch(:base_url)
       @deserializer = default_deserializer.merge(options.fetch(:deserializer, {}))
       @logger = options[:logger]
+      @monitor = options[:monitor]
       @timeout = options[:timeout]
 
       Typhoeus::Config.cache = options[:cache]
@@ -55,7 +56,7 @@ module ChimeraHttpClient
 
     # Remove leading and trailing "/" from a give part of a String (usually URL or endpoint)
     def trim(element)
-      element.to_s.sub(%r{^\/}, "").chomp("/")
+      element.to_s.sub(%r{^/}, "").chomp("/")
     end
   end
 end

data/lib/chimera_http_client/connection.rb

@@ -12,17 +12,18 @@ module ChimeraHttpClient
 
     def request
       options = {
-        logger: @logger,
         deserializer: @deserializer,
+        logger: @logger,
+        monitor: @monitor,
       }
 
-      @request ||= Request.new(options)
+      Request.new(options)
     end
 
     private
 
     def run(method, endpoint, options = {})
-      options[:body_optional] = true if %i[get delete head options trace].include?(method)
+      options[:body_optional] = true if %i(get delete head options trace).include?(method)
       body = extract_body(options)
       headers = extract_headers(options, default_headers)
 
@@ -36,7 +37,7 @@ module ChimeraHttpClient
     # end
     #
     def define_http_methods
-      %i[get post put patch delete head options trace].each do |method_name|
+      %i(get post put patch delete head options trace).each do |method_name|
         self.class.send(:define_method, method_name) do |endpoint, options = {}|
           send(:run, method_name, endpoint, options)
         end

data/lib/chimera_http_client/error.rb

@@ -10,6 +10,8 @@ module ChimeraHttpClient
       @response = response # contains the request
 
       @deserializer = options[:deserializer][:error]
+
+      super(response.body)
     end
 
     def error?

data/lib/chimera_http_client/queue.rb

@@ -2,7 +2,7 @@ module ChimeraHttpClient
   class Queue < Base
     def add(method, endpoint, options = {})
       http_method = method.downcase.to_sym
-      options[:body_optional] = true if %i[get delete head options trace].include?(http_method)
+      options[:body_optional] = true if %i(get delete head options trace).include?(http_method)
 
       queued_requests << create_request(
         method: http_method,
@@ -38,12 +38,13 @@ module ChimeraHttpClient
     private
 
     def create_request(method:, url:, body:, headers:, options:)
-      class_options = {
-        logger: @logger,
+      instance_options = {
         deserializer: @deserializer,
+        logger: @logger,
+        monitor: @monitor,
       }
 
-      Request.new(class_options).create(
+      Request.new(instance_options).create(
         method: method,
         url: url,
         body: body,

data/lib/chimera_http_client/request.rb

@@ -5,7 +5,6 @@ module ChimeraHttpClient
     attr_reader :request, :result
 
     def initialize(options = {})
-      @logger = options[:logger]
       @options = options
     end
 
@@ -37,13 +36,39 @@ module ChimeraHttpClient
 
       @result = nil
       @request.on_complete do |response|
-        @logger&.info("Completed HTTP request: #{method.upcase} #{url} " \
-          "in #{response.total_time&.round(3)}sec with status code #{response.code}")
+        runtime = response.total_time&.round(3)
+
+        @options[:monitor]&.call(
+          {
+            url: url, method: method, status: response.code, runtime: runtime,
+            completed_at: Time.now.utc.iso8601(3), context: options[:monitoring_context]
+          }
+        )
+
+        @options[:logger]&.info(
+          {
+            message: "Completed Chimera HTTP Request",
+            method: method.upcase,
+            url: url,
+            code: response.code,
+            runtime: runtime,
+            user_agent: Typhoeus::Config.user_agent,
+          }
+        )
 
         @result = on_complete_handler(response)
       end
 
-      @logger&.info("Starting HTTP request: #{method.upcase} #{url}")
+      @options[:logger]&.info(
+        {
+          message: "Starting Chimera HTTP Request",
+          method: method.upcase,
+          url: url,
+          code: nil,
+          runtime: 0,
+          user_agent: Typhoeus::Config.user_agent,
+        }
+      )
 
       self
     end
@@ -63,7 +88,7 @@ module ChimeraHttpClient
       when 301, 302, 303, 307
         RedirectionError.new(response, @options) # TODO: throw error conditionally
       when 200..399
-        nil
+        nil # TODO: decide to either raise error or return a Response
       when 400
         BadRequestError.new(response, @options)
       when 401

data/lib/chimera_http_client/version.rb

@@ -1,3 +1,3 @@
 module ChimeraHttpClient
-  VERSION = "1.1.2".freeze
+  VERSION = "1.4.1".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chimera_http_client
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.4.1
 platform: ruby
 authors:
 - Andreas Finger
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2019-06-15 00:00:00.000000000 Z
+date: 2021-04-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -39,19 +39,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: awesome_print
+  name: amazing_print
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '1.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -70,28 +70,28 @@ dependencies:
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.6'
 - !ruby/object:Gem::Dependency
   name: irb
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
@@ -128,28 +128,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.50'
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.50'
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: capybara
   requirement: !ruby/object:Gem::Requirement
@@ -220,6 +234,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: |
   The Chimera http client offers an easy to learn interface and consistent error handling.
   It is lightweight, fast and enables you to queue HTTP requests to run them in parallel
@@ -256,7 +284,7 @@ homepage: https://github.com/mediafinger/chimera_http_client
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -271,8 +299,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: General http client functionality to quickly connect to JSON REST API endpoints
   and any others