loogi_http 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1f1ffdc2eb3eb29ab5fe10e612b5a4289e28fa82fcae6af5b71117f29c486306
+  data.tar.gz: 99829cb003c44288e7268dc92d5c84b68b477fc87f0b72e30d3e22b8d2f19917
+SHA512:
+  metadata.gz: 69639f94f6691ff4ae76a65f915a83f27a825f5c90786c1d385a1f4a5aeb337dc15279d63c0bbe92bdbf9336bee76993fa0312fbea8b946fada9c55662c142ea
+  data.tar.gz: 74ab8aeb5a5b2f6923ed07db03dcc003555cb5672cae23b25d8ecec9c5b40928628b8fc3762b384268c2240e8bab950d691f9648683ce4d526b1a97c95ad8e07

data/.github/workflows/gem-push.yml

@@ -0,0 +1,33 @@
+name: Ruby Gem
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Ruby 2.6
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: 2.6.x
+
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push *.gem
+      env:
+        GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"

data/.github/workflows/specs.yml

@@ -0,0 +1,35 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Specs
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ['2.6', '2.7', '3.0']
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
+    # change this to (see https://github.com/ruby/setup-ruby#versioning):
+    # uses: ruby/setup-ruby@v1
+      uses: ruby/setup-ruby@473e4d8fe5dd94ee328fdfca9f8c9c7afc9dae5e
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+    - name: Run tests
+      run: bundle exec rake spec

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+Gemfile.lock
+
+# rspec failure tracking
+spec/examples.txt

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at alessandro@juul.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in loogi_http.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 JUUL Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,41 @@
+# LoogiHttp
+
+[![Specs](https://github.com/JuulLabs-OSS/loogi_http/actions/workflows/specs.yml/badge.svg)](https://github.com/JuulLabs-OSS/loogi_http/actions/workflows/specs.yml)
+
+Provides a wrapper to external requests providing JSON parsing, logging, metrics, and more.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'loogi_http'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install loogi_http
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+To execute tests, run `bundle exec rake spec`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/JuulLabs-OSS/loogi_http. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Test project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/JuulLabs-OSS/loogi_http/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'loogi_http'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/loogi_http/builder.rb

@@ -0,0 +1,39 @@
+require 'loogi_http/configuration'
+require 'loogi_http/connection'
+
+module LoogiHttp
+  # Conveniently configure `Faraday` stacks.
+  class Builder
+    # Configure a JSON stack.
+    #
+    # @return [LoogiHttp::Connection]
+    def self.json
+      new.build(&:json)
+    end
+
+    # Customize a stack with a configuration block.
+    #
+    # Example:
+    #
+    # LoogiHttp::Builder.new.configure do |config|
+    #   config.json
+    # end
+    #
+    # @yield [config] Customize the stack within this block
+    # @yieldparam config [LoogiHttp::Configuration] Configuration to customize
+    # @return [LoogiHttp::Connection]
+    def build(&block)
+      LoogiHttp::Connection.new(
+        faraday_connection do |conn|
+          LoogiHttp::Configuration.new(conn).configure(&block)
+        end
+      )
+    end
+
+    private
+
+    def faraday_connection(&block)
+      Faraday.new(&block)
+    end
+  end
+end

data/lib/loogi_http/configuration.rb

@@ -0,0 +1,92 @@
+require 'faraday_middleware'
+require 'forwardable'
+
+module LoogiHttp
+  # Configure a `Faraday::Connection` (aka a _stack_).
+  class Configuration
+    extend Forwardable
+
+    # @param faraday_connection [Faraday::Connection] Stack to be
+    #   configured
+    def initialize(faraday_connection)
+      @faraday_connection = faraday_connection
+    end
+
+    # Custom configuration of the stack in a block. By default, the
+    # stack is configured to:
+    #
+    # * instrument call with `ActiveSupport::Notifications`
+    # * follow redirects
+    # * use `Net::HTTP` adapter
+    #
+    # Example:
+    #
+    # config.configure do |config|
+    #   config.json
+    # end
+    #
+    # @yield [config] Customize the stack within this block
+    # @yieldparam config [LoogiHttp::Configuration] Configuration to customize
+    # @return [Faraday::Connection]
+    def configure(&_block)
+      use :instrumentation if defined? ::ActiveSupport::Notifications
+
+      logger = LoogiHttp.logger
+      level = LoogiHttp.log_level
+      use :log_request, logger: logger, level: level if logger
+
+      response :follow_redirects
+
+      yield self if block_given?
+
+      use :debug_http
+      faraday_connection.adapter(*adapter_args, &adapter_block)
+
+      faraday_connection
+    end
+
+    # Configure the adapter to be used by the stack. The default stack is
+    # `Net::HTTP`.
+    #
+    # Example customization of `Net::HTTP`:
+    #
+    # config.adapter :net_http do |http| # yields Net::HTTP
+    #   http.idle_timeout = 100
+    #   http.verify_callback = lambda do | preverify_ok, cert_store |
+    #     # do something here...
+    #   end
+    # end
+    #
+    # More details in the Faraday docs
+    # @see https://github.com/lostisland/faraday#ad-hoc-adapters-customization
+    #
+    # @param args [Array<Object>] Adapter arguments, name first, defaults to
+    #   `:net_http`
+    # @yield [adapter] Configure the adapter before use
+    def adapter(*args, &block)
+      @adapter_args = args
+      @adapter_block = block
+    end
+
+    # Configure the stack for JSON, using three middlewares:
+    #
+    # * Set the `Accept` header
+    # * ensure the body sent is JSON (converts non-String via `to_json`)
+    # * parse result body as JSON for JSON content type
+    def json
+      request :accept_json
+      request :json
+      response :json, content_type: 'application/json'
+    end
+
+    private
+
+    attr_reader :adapter_block, :faraday_connection
+
+    def_delegators :@faraday_connection, :request, :response, :use
+
+    def adapter_args
+      @adapter_args ||= %i[net_http]
+    end
+  end
+end

data/lib/loogi_http/connection.rb

@@ -0,0 +1,94 @@
+require 'loogi_http/response'
+require 'loogi_http/error'
+
+module LoogiHttp
+  # HTTP connection over a configured `Faraday::Connection` (aka a _stack_).
+  # Methods supported are:
+  #
+  # {#get}
+  # {#post}
+  class Connection
+    # @param faraday_connection [Faraday::Connection] The configured
+    #   `Faraday::Connection`
+    def initialize(faraday_connection)
+      @faraday_connection = faraday_connection
+    end
+
+    # HTTP GET request.
+    #
+    # @param url [String] URL
+    # @param params [Hash] Query params to be sent, defaults to `{}`
+    # @return [LoogiHttp::Response]
+    def get(url, params: {})
+      response faraday_connection.get(url, params)
+    rescue Faraday::TimeoutError => e
+      raise LoogiHttp::TimeoutError, e
+    rescue Faraday::ConnectionFailed => e
+      raise LoogiHttp::ConnectionFailed, e
+    end
+
+    # HTTP POST request.
+    #
+    # @param url [String] URL
+    # @param params [Hash] Query params to be sent, defaults to `{}`
+    # @param data [Object] POST body that will eventually be converted into a
+    #   `String`, defaults to `nil`
+    # @param options [Hash] Faraday options, defaults to `{}`
+    # @param headers [Hash] Headers for the POST, defaults to `{}`
+    # @return [LoogiHttp::Response]
+    def post(url, params: {}, data: nil, options: {}, headers: {})
+      response(faraday_connection.post(url, data, headers) do |request|
+        request.params.update params if params
+        if (debug = options.delete(:debug))
+          options[:context] ||= {}
+          options[:context][:debug] = debug
+        end
+        request.options.update options if options
+      end)
+    rescue Faraday::TimeoutError => e
+      raise LoogiHttp::TimeoutError, e
+    rescue Faraday::ConnectionFailed => e
+      raise LoogiHttp::ConnectionFailed, e
+    end
+
+    # HTTP PUT request.
+    #
+    # @param url [String] URL
+    # @param params [Hash] Query params to be sent, defaults to `{}`
+    # @param data [Object] PUT body that will eventually be converted into a
+    #   `String`, defaults to `nil`
+    # @param options [Hash] Faraday options, defaults to `{}`
+    # @param headers [Hash] Headers for the PUT, defaults to `{}`
+    # @return [LoogiHttp::Response]
+    def put(url, params: {}, data: nil, options: {}, headers: {})
+      response(faraday_connection.put(url, data, headers) do |request|
+        request.params.update params if params
+        if (debug = options.delete(:debug))
+          options[:context] ||= {}
+          options[:context][:debug] = debug
+        end
+        request.options.update options if options
+      end)
+    rescue Faraday::TimeoutError => e
+      raise LoogiHttp::TimeoutError, e
+    end
+
+    # Basic Authentication
+    #
+    # @param username [String]
+    # @param password [String]
+    #
+    # @return [void]
+    def basic_auth(username:, password:)
+      faraday_connection.basic_auth(username, password)
+    end
+
+    private
+
+    attr_reader :faraday_connection
+
+    def response(faraday_response)
+      Response.new(faraday_response)
+    end
+  end
+end

data/lib/loogi_http/error.rb

@@ -0,0 +1,20 @@
+module LoogiHttp
+  class Error < RuntimeError; end
+
+  class ServerError < Error
+    attr_reader :error
+
+    def initialize(error)
+      @error = error
+      set_backtrace(error.backtrace)
+    end
+
+    def message
+      error.message
+    end
+  end
+
+  class TimeoutError < ServerError; end
+
+  class ConnectionFailed < ServerError; end
+end

data/lib/loogi_http/middleware/debug_http.rb

@@ -0,0 +1,124 @@
+require 'faraday'
+
+module LoogiHttp
+  module Middleware
+    # Faraday middleware to debug the request and response.
+    #
+    # Turn on per request by passing a Logger as the `:debug` option:
+    #
+    # LoogiHttp.json_post url, params, data, debug: Rails.logger
+    class DebugHttp < Faraday::Middleware
+      class DebugOutput
+        def initialize(env, response, exception)
+          @env = env
+          @response = response
+          @exception = exception
+        end
+
+        def debug
+          debug_request
+
+          if response
+            debug_line
+            debug_response
+          end
+
+          return if exception.nil?
+
+          debug_line
+          debug_exception
+        end
+
+        private
+
+        attr_reader :env, :exception, :response
+
+        def debug_exception
+          klass = exception.class
+          error = exception.message
+          trace = exception.backtrace.join("\n")
+          exception_message = format(
+            "%<klass>s %<error>s\n%<trace>s",
+            klass: klass,
+            error: error,
+            trace: trace
+          )
+          logger.info exception_message
+        end
+
+        def debug_line
+          logger.info ''
+        end
+
+        def debug_request
+          url = env.url
+          method = env.method.to_s.upcase
+
+          logger.info "#{method} #{url.path}"
+          logger.info "Host: #{url.host}"
+          log_headers env.request_headers
+          log_body env.body if needs_body?
+        end
+
+        def debug_response
+          logger.info "Status: #{response.status}"
+          log_headers response.headers
+          log_body response.body
+        end
+
+        def log_body(body)
+          logger.info 'BODY' + '-' * 10
+          logger.info body
+          logger.info 'BODY' + '-' * 10
+        end
+
+        def log_headers(headers_hash)
+          headers_hash.each do |key, value|
+            logger.info "#{key}: #{value}"
+          end
+        end
+
+        def logger
+          @logger ||= env.request.context[:debug]
+        end
+
+        def needs_body?
+          Faraday::Env::MethodsWithBodies.include? env.method
+        end
+      end
+
+      # Emit debug output for every request. If an exception is raised, emit the
+      # exception and backtrace.
+      #
+      # @param env [Faraday::Env]
+      # @return [Faraday::Request]
+      def call(env)
+        if debug?(env)
+          debug_call env
+        else
+          @app.call env
+        end
+      end
+
+      private
+
+      def debug?(env)
+        env.request.context&.send(:[], :debug)
+      end
+
+      def debug_call(env)
+        exception = nil
+        response = @app.call(env)
+      rescue StandardError => e
+        exception = e
+        raise
+      ensure
+        debug_output env, response, exception
+      end
+
+      def debug_output(env, response, exception)
+        DebugOutput.new(env, response, exception).debug
+      end
+    end
+  end
+end

data/lib/loogi_http/middleware/log_request.rb

@@ -0,0 +1,74 @@
+require 'faraday'
+
+module LoogiHttp
+  module Middleware
+    # Faraday middleware to log request to `Logger`.
+    class LogRequest < Faraday::Middleware
+      # @param logger [Logger] Logger instance to log to
+      # @param level [Symbol | String] Log level to use
+      def initialize(app, logger:, level: :info)
+        super app
+        @level = level
+        @logger = logger
+      end
+
+      # Log the following for every request made:
+      #
+      # * host
+      # * HTTP method
+      # * uri
+      # * status
+      # * duration
+      #
+      # If an exception is raised, log the exception and backtrace.
+      #
+      # @param env [Faraday::Env]
+      # @return [Faraday::Request]
+      def call(env)
+        start_time = Time.now
+        exception = nil
+        @app.call env
+      rescue StandardError => e
+        exception = e
+        raise
+      ensure
+        duration = Time.now - start_time
+        log_message env, duration
+        log_exception(exception) if exception
+      end
+
+      private
+
+      attr_reader :level, :logger
+
+      def log_exception(exception)
+        klass = exception.class
+        error = exception.message
+        trace = exception.backtrace.join("\n")
+        exception_message = format(
+          "%<klass>s %<error>s\n%<trace>s",
+          klass: klass,
+          error: error,
+          trace: trace
+        )
+        logger.send level, exception_message
+      end
+
+      def log_message(env, duration)
+        url = env.url
+        method = env.method.to_s.upcase
+        status = env.status || 500
+
+        message = format(
+          '[%<host>s] %<method>s %<uri>s %<status>d (%<duration>.3f s)',
+          host: url.host,
+          method: method,
+          uri: url.path,
+          status: status,
+          duration: duration
+        )
+        logger.send level, message
+      end
+    end
+  end
+end

data/lib/loogi_http/middleware/request/accept_json.rb

@@ -0,0 +1,19 @@
+require 'faraday'
+
+module LoogiHttp
+  module Middleware
+    # Faraday middleware to set `Accept` header to `application/json`.
+    class AcceptJson < Faraday::Middleware
+      # Set the `Accept` header to `application/json`. Overwrites existing
+      # header.
+      #
+      # @param env [Faraday::Env]
+      # @return [Faraday::Response]
+      def call(env)
+        headers = env[:request_headers]
+        headers['Accept'] = 'application/json'
+        @app.call env
+      end
+    end
+  end
+end

data/lib/loogi_http/middleware.rb

@@ -0,0 +1,7 @@
+module LoogiHttp
+  module Middleware
+    autoload :AcceptJson, 'loogi_http/middleware/request/accept_json'
+    autoload :DebugHttp, 'loogi_http/middleware/debug_http'
+    autoload :LogRequest, 'loogi_http/middleware/log_request'
+  end
+end

data/lib/loogi_http/response.rb

@@ -0,0 +1,16 @@
+require 'forwardable'
+
+module LoogiHttp
+  # Wraps a `Faraday::Response`.
+  class Response
+    extend Forwardable
+
+    def_delegators :@faraday_response, :body, :finished?, :headers, :status,
+                   :success?
+
+    # @param faraday_response [Faraday::Response] The wrapped `Response`
+    def initialize(faraday_response)
+      @faraday_response = faraday_response
+    end
+  end
+end

data/lib/loogi_http/ruby2_keywords.rb

@@ -0,0 +1,25 @@
+require 'faraday'
+
+# Monkey patches to properly delegate Faraday 1.0 keyword arguments on Ruby 3
+# See https://eregon.me/blog/2021/02/13/correct-delegation-in-ruby-2-27-3.html
+
+Faraday::DependencyLoader.module_eval do
+  def new(*args, &block)
+    raise "missing dependency for #{self}: #{load_error.message}" unless loaded?
+
+    super(*args, &block)
+  end
+
+  ruby2_keywords :new if respond_to?(:ruby2_keywords, true)
+end
+
+Faraday::RackBuilder::Handler.class_eval do
+  def initialize(klass, *args, &block)
+    @name = klass.to_s
+    Faraday::RackBuilder::Handler::REGISTRY.set(klass) if klass.respond_to?(:name)
+    @args = args
+    @block = block
+  end
+
+  ruby2_keywords :initialize if respond_to?(:ruby2_keywords, true)
+end

data/lib/loogi_http/version.rb

@@ -0,0 +1,3 @@
+module LoogiHttp
+  VERSION = '1.0.0'.freeze
+end

data/lib/loogi_http.rb

@@ -0,0 +1,48 @@
+require 'loogi_http/ruby2_keywords'
+require 'loogi_http/builder'
+require 'loogi_http/version'
+require 'loogi_http/middleware'
+require 'faraday'
+
+module LoogiHttp
+  # The log level to use with the logger. Defaults to `info`.
+  def self.log_level
+    @log_level ||= :info
+  end
+
+  # Set the log level to use with the logger
+  #
+  # @param log_level [Symbol | String] Logging level
+  def self.log_level=(log_level)
+    @log_level = log_level
+  end
+
+  # The Logger to use when logging
+  def self.logger
+    @logger ||= nil # Silence warning
+  end
+
+  # Set the Logger to use when logging
+  #
+  # @param logger [Logger] The logger to log to
+  def self.logger=(logger)
+    @logger = logger
+  end
+
+  # HTTP POST with JSON data sent and expected as the response.
+  #
+  # (see LoogiHttp::Connection#post)
+  # @param options [Hash] Options for the JSON POST
+  def self.json_post(url, params: {}, data: nil, options: {})
+    LoogiHttp::Builder.json.post(
+      url,
+      params: params,
+      data: data,
+      options: options
+    )
+  end
+
+  Faraday::Request.register_middleware accept_json: -> { Middleware::AcceptJson }
+  Faraday::Middleware.register_middleware log_request: -> { Middleware::LogRequest }
+  Faraday::Middleware.register_middleware debug_http: -> { Middleware::DebugHttp }
+end

data/loogi_http.gemspec

@@ -0,0 +1,39 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'loogi_http/version'
+
+Gem::Specification.new do |spec|
+  spec.required_ruby_version = '>= 2.6'
+  spec.name          = 'loogi_http'
+  spec.version       = LoogiHttp::VERSION
+  spec.authors       = ['Juul Labs, Inc.']
+  spec.email         = ['opensource@juul.com']
+
+  spec.summary       = 'External requests wrapper.'
+  spec.description   = 'Provides a wrapper to external requests providing ' \
+                       'JSON parsing, logging, metrics, and more.'
+  spec.homepage      = 'https://github.com/JuulLabs-OSS/loogi_http'
+  spec.license       = 'MIT'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added
+  # into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.
+      split("\x0").
+      reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'faraday', '~> 1.0.1'
+  spec.add_dependency 'faraday-cookie_jar', '~> 0.0.6'
+  spec.add_dependency 'faraday_middleware', '~> 1.0.0'
+
+  spec.add_development_dependency 'bundler', '>= 2.0'
+  spec.add_development_dependency 'byebug', '~> 10.0.2'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'webmock', '~> 3.5.1'
+end

metadata

@@ -0,0 +1,180 @@
+--- !ruby/object:Gem::Specification
+name: loogi_http
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Juul Labs, Inc.
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2022-06-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: faraday-cookie_jar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.6
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.0.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.0.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.5.1
+description: Provides a wrapper to external requests providing JSON parsing, logging,
+  metrics, and more.
+email:
+- opensource@juul.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/gem-push.yml"
+- ".github/workflows/specs.yml"
+- ".gitignore"
+- ".rspec"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/loogi_http.rb
+- lib/loogi_http/builder.rb
+- lib/loogi_http/configuration.rb
+- lib/loogi_http/connection.rb
+- lib/loogi_http/error.rb
+- lib/loogi_http/middleware.rb
+- lib/loogi_http/middleware/debug_http.rb
+- lib/loogi_http/middleware/log_request.rb
+- lib/loogi_http/middleware/request/accept_json.rb
+- lib/loogi_http/response.rb
+- lib/loogi_http/ruby2_keywords.rb
+- lib/loogi_http/version.rb
+- loogi_http.gemspec
+homepage: https://github.com/JuulLabs-OSS/loogi_http
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: External requests wrapper.
+test_files: []