we-call 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2b5f8847896e17a2fec34ca12c0f3de5ac7a3462
+  data.tar.gz: 40f62ebf46c1096cdbb427e9b59314c5cc9b108b
+SHA512:
+  metadata.gz: 5b3df1717cb053439ce90d57ce8087014959a47a65ac7b8ea42edf0dc15cbd672f60d0487076a0d3f5c2f30cbfe17711fc53d9e23946ac7a911f0886ec5edb9c
+  data.tar.gz: 28867ed3ab8fc0c9583ce732b288d81fcc50f9e1c802190da690f3ac9727b7074f18e337f3bb890c9cf82736da1e6183b8c45d3c76650e58703c3b42caf9a312

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.idea
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/gemfiles/
+/pkg/
+/spec/reports/
+/tmp/
+.byebug_history

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,25 @@
+language: ruby
+before_install:
+  - gem install bundler
+before_script:
+  - appraisal install
+script:
+  - bundle exec appraisal rspec
+gemfiles:
+  - faraday_0.9.gemfile
+  - faraday_0.10.gemfile
+  - faraday_0.11.gemfile
+  - faraday_0.12.gemfile
+  - faraday_0.13.gemfile
+  - rails_4.2.gemfile
+  - rails_5.0.gemfile
+  - rails_5.1.gemfile
+rvm:
+  - 2.2.7
+  - 2.3.4
+  - 2.4.1
+  - ruby-head
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+  fast_finish: true

data/Appraisals

@@ -0,0 +1,31 @@
+appraise "faraday-0.13" do
+  gem "faraday", "~> 0.13.0"
+end
+
+appraise "faraday-0.12" do
+  gem "faraday", "~> 0.12.0"
+end
+
+appraise "faraday-0.11" do
+  gem "faraday", "~> 0.11.0"
+end
+
+appraise "faraday-0.10" do
+  gem "faraday", "~> 0.10.0"
+end
+
+appraise "faraday-0.9" do
+  gem "faraday", "~> 0.9.0"
+end
+
+appraise "rails-5.1" do
+  gem "rails", "~> 5.1.0"
+end
+
+appraise "rails-5.0" do
+  gem "rails", "~> 5.0.0"
+end
+
+appraise "rails-4.2" do
+  gem "rails", "~> 4.2.0"
+end

data/CHANGELOG

@@ -0,0 +1,38 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## Unreleased
+
+### Added
+- Configurable `We::Call.configure` which accepts a config block
+- Config option `config.app_name` to avoid providing `app:` in every connection initializer
+- Added the concept of Annotations. Simply `extend We::Call::Annotations` in a base controller to get cool stuff
+- First annotation: `We::Call::Deprecated` added to mark controller methods as deprecated
+- Added `We::Call::Middleware::Client::DetectDeprecations` that automatically registers as a faraday response middleware to report deprecated endpoints
+
+### Changed
+- Defaults to setting `X-App-Name` instead of `X-WeWork-App` (override with config.app_name_header)
+- Defaults to setting `X-App-Env` instead of `X-WeWork-Env` (override with config.app_env_header)
+
+### Fixed
+- Switched from manually requiring to using module autoload to reduce memory footprint
+
+## v0.4.2
+
+### Fixed
+- Manually setting `conn.adapter` would result in double adapters (two requests made!)
+
+## v0.4.1
+
+### Fixed
+- Improved support for Faraday 0.8 - 0.9.
+
+## v0.4.0
+
+### Added
+- `We::Call::Connection.new` requires `timeout: 1` where 1 is seconds.
+- `We::Call::Connection.new` accepts `open_timeout: 1` where 1 is seconds.

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in we-call.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 WeWork Projects
+
+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,189 @@
+# We::Call
+
+[![Build Status][travis-image]][travis-url]
+[![Coverage Status][coveralls-image]][coveralls-url]
+[![MIT License][license-image]][license-url]
+
+![Call me Maybe](https://cloud.githubusercontent.com/assets/67381/25590846/0c3145ea-2e80-11e7-9166-76448e0134a8.jpeg)
+
+Requires metadata and offers client/server middleware for making HTTP requests, tracking calls, raising deprecations, supporting trace IDs, throttling, etc.
+
+## Goals
+
+- Work just like Faraday out of the box
+- Remove some of the guesswork that comes with HTTP service orientated architecures
+- Provide sane defaults whenever possible, but ask for more information if required
+- Facilitate [HTTP Evolution](https://www.mnot.net/blog/2012/12/04/api-evolution.html)
+
+## Usage
+
+
+```ruby
+gem 'we-call'
+```
+
+```ruby
+# config/initializers/we-call.rb
+
+We::Call.configure do |config|
+  config.app_name = 'service-a'       # default nil (Connection class falls back to APP_NAME or Rails name)
+  config.app_env = 'staging'          # default nil (Connection class back to RACK_ENV || RAILS_ENV)
+  config.detect_deprecations = false  # default true
+end
+```
+
+As this is a Faraday wrapper, the only thing that will change from normal Faraday usage is initialization.
+
+```ruby
+connection = We::Call::Connection.new(host: 'https://some-service.example.com/', timeout: 5)
+
+# or with a Faraday connection block
+connection = We::Call::Connection.new(host: 'https://some-service.example.com/', timeout: 5) do |conn|
+  conn.token_auth('abc123token')
+  conn.headers['Foo'] = 'bar'
+end
+```
+
+See more connection block options in the [Faraday documentation](https://github.com/lostisland/faraday).
+
+### Provide an App
+
+An application should provide its own name in the user agent when calling other services. This is important in case this app busts a local cache, causing it to stampeding herd other service(s).
+
+Other services need to know which server is causing the problem, so no connections are allowed through `We::Call` without an app being set.
+
+```ruby
+# Provided at config
+connection = We::Call.configure do |config|
+  config.app_name = 'Service A'
+end
+
+# Provided at initialization
+connection = We::Call::Connection.new(host: 'https://service-b.example.com/', app: 'Service A', timeout: 5)
+```
+
+_Ofc services could lie about this, so do not use App Name for any sort of security. For that you need to use tokens assigned to applications. This is essentially just forcing a user agent._
+
+### Provide an Env
+
+```ruby
+# Provided at config
+connection = We::Call.configure do |config|
+  config.app_env = 'staging'
+end
+
+# Provided at initialization
+connection = We::Call::Connection.new(host: 'https://service-b.example.com/', env: 'staging', timeout: 5)
+```
+
+Not only is knowing the app name important, but knowing the env is necessary too. Sometimes people configure stuff wrong, and Service A (staging) will hit Service B (production) 😨.
+
+If you are using Rack or Rails, you should not need to do this, as it'll use RACK_ENV or RAILS_ENV by default.
+
+### Timeouts
+
+By default Faraday will let HTTP calls go on forever. In reality this is often 30 seconds for e.g: a Heroku app. Asking developers to make a choice about how long they're willing to wait on this call gives them a chance to consider an acceptable timeout.
+
+The lower this number can be the better, as it reduces time web threads spend waiting for calls that are unlikely to respond anyway.
+
+```ruby
+# Provided at initialization
+connection = We::Call::Connection.new(host: 'https://service-b.example.com/', timeout: 5)
+```
+
+Timeouts can only be provided at initialization of a connection, as they should be different for each service. This is down to the sad reality that some internal services are more performant than others, and various third-parties will have different SLAs.
+
+As well as `timeout: num_seconds` which can set the entire open/read (essentially the total response time of the server), another optional argument exists for `open_timeout: numseconds`. This is how long We::Call should spend waiting for a vague sign of life from the server, which by default is 2.
+
+### Deprecations
+
+We::Call helps with a bunch of things, such as the logic to go on client and server side to handle deprecations, both logging calls made to this servies deprecated endpoints, and alerting services when they make calls to deprecated endpoints.
+
+Currently this is done using a simple annotation.
+
+```ruby
+# app/controllers/api_controller.rb
+
+extend We::Call::Annotations
+```
+
+Then a controller can be annotated as such:
+
+```ruby
+# app/controllers/foo_controller.rb
+
+class FooController < ApiController
+  +We::Call::Deprecated.new(date: '2018-01-07 00:00:00 EDT')
+  def show
+    # ...
+  end
+end
+```
+
+It's as simple as that. This annotation will inject a [Sunset header](https://tools.ietf.org/html/draft-wilde-sunset-header-03) and everyone will know its being deprecated.
+
+## Middleware
+
+### Client
+
+**DetectDeprecations**
+
+Automatically enabled, this Faraday middleware will watch for the [Sunset header](https://tools.ietf.org/html/draft-wilde-sunset-header-03) and send warning to `ActiveSupport::Deprecation` if enabled, or to whatever is in `ENV['rake.logger']`.
+
+### Server
+
+**LogUserAgent**
+
+_(Optional)_ Log the User Agent, which might just be browser information (merely kinda handy), or could be an app name, like the one `We::Call::Connection` asks you for.
+
+```ruby
+config.middleware.insert_after Rails::Rack::Logger, We::Call::Middleware::Server::LogUserAgent
+```
+
+Easy! Check your logs for `user_agent=service-name; app_name=service-name;` The `app_name` will only show up if this was called by `We::Call::Connection` (as this is the only thing setting the `X-App-Name` header.)
+
+## Requirements
+
+- **Ruby:** v2.2 - v2.4
+- **Rails:** v4.2 - v5.1
+- **Faraday:** v0.8 - v0.13
+
+_For now this gem requires Rails 4.2+ due to some ActiveController functionality we are taking advantage of. Future work will include making this purely rack based._
+
+## TODO
+
+- [ ] Support adding href to Deprecate to make a `Link` with rel=sunset as per Sunset RFC draft 03
+- [ ] Remove Rails as a dependency (soft requirement on `ActiveSupport::Deprecated` is fine)
+- [ ] Split DetectDeprecations into standalone `faraday-sunset` gem
+- [ ] Pass Trace IDs along
+- [ ] Work on sane defaults for retries and error raising
+
+## Testing
+
+To run tests and modify locally, you'll want to `bundle install` in this directory.
+
+```
+bundle exec rspec
+```
+
+## Development
+
+If you want to test this gem within an application, update your Gemfile to have something like this: `gem 'we-call', github: 'wework/we-call', branch: 'BRANCHNAME'` and set your local config: `bundle config --local local.we-call path/to/we-call`
+
+Simply revert the Gemfile change (updating the version as necessary!) and remove the config with `bundle config --delete local.we-call`.
+
+References: [Blog Post](https://rossta.net/blog/how-to-specify-local-ruby-gems-in-your-gemfile.html) and [Bundle Documentation](https://bundler.io/v1.2/git.html#local)
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at [wework/we-call](https://github.com/wework/we-call). 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.
+
+
+[coveralls-image]:https://coveralls.io/repos/github/wework/we-call/badge.svg?branch=master
+[coveralls-url]:https://coveralls.io/github/wework/we-call?branch=master
+
+[travis-url]:https://travis-ci.org/wework/we-js-logger
+[travis-image]: https://travis-ci.org/wework/we-js-logger.svg?branch=master
+
+[license-url]: LICENSE
+[license-image]: http://img.shields.io/badge/license-MIT-000000.svg?style=flat-square

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 "we/call"
+
+# 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

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/we-call.rb

@@ -0,0 +1 @@
+require 'we/call'

data/lib/we/call.rb

@@ -0,0 +1,22 @@
+module We
+  module Call
+    autoload :Annotations,   "we/call/annotations"
+    autoload :Connection,    "we/call/connection"
+    autoload :Configuration, "we/call/configuration"
+    autoload :Deprecated,    "we/call/deprecated"
+    autoload :Middleware,    "we/call/middleware"
+    autoload :VERSION,       "we/call/version"
+
+    class << self
+      attr_accessor :configuration
+    end
+
+    def self.configuration
+      @configuration ||= Configuration.new
+    end
+
+    def self.configure
+      yield(configuration)
+    end
+  end
+end

data/lib/we/call/annotations.rb

@@ -0,0 +1,34 @@
+module We
+  module Call
+    module Annotations
+      # Enable annotations
+      include RubyDecorators
+
+      def self.extended(base)
+        base.class_eval do
+          # TODO Maybe this after_action could be a really simple call in base controllers
+          # Having it here obviously ties We::Call to Rails, and is probably more than the annotations
+          # class should be doing
+          after_action do |controller|
+
+            # TODO Maybe controller.class and params action could be passed to something in We::Call::Deprecated
+            klass = controller.class
+            method = params['action']
+            deprecation = We::Call::Deprecated.get("#{klass}##{method}")
+
+            if deprecation.present?
+              # Shove a deprecation warning into the console or wherever it goes
+              if defined? ActiveSupport
+                ActiveSupport::Deprecation.warn("#{klass}##{method} is deprecated for removal on #{deprecation[:date].iso8601}")
+              end
+
+              # Shove a Sunset header into HTTP Response for clients to sniff on
+              # https://tools.ietf.org/html/draft-wilde-sunset-header-03
+              response.headers['Sunset'] = deprecation[:date].httpdate
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/we/call/configuration.rb

@@ -0,0 +1,16 @@
+require 'faraday'
+require 'faraday_middleware'
+
+module We
+  module Call
+    class Configuration
+      attr_accessor :app_env, :app_env_header, :app_name, :app_name_header, :detect_deprecations
+
+      def initialize
+        @app_env_header = 'X-App-Env'
+        @app_name_header = 'X-App-Name'
+        @detect_deprecations = true
+      end
+    end
+  end
+end

data/lib/we/call/connection.rb

@@ -0,0 +1,115 @@
+require 'faraday'
+require 'faraday_middleware'
+
+module We
+  module Call
+    module Connection
+      Faraday::Response.register_middleware detect_deprecations: We::Call::Middleware::Client::DetectDeprecations
+
+      extend self
+
+      OPEN_TIMEOUT = 2
+
+      class MissingApp < ArgumentError; end
+      class MissingEnv < ArgumentError; end
+      class MissingTimeout < ArgumentError; end
+      class MissingOpenTimeout < ArgumentError; end
+
+      parent_builder_class = defined?(Faraday::RackBuilder) ? Faraday::RackBuilder : Faraday::Builder
+
+      QueryableBuilder = Class.new(parent_builder_class) do
+        def adapter?
+          @has_adapter || false
+        end
+
+        def adapter(key, *args, &block)
+          super
+          @has_adapter = true
+        end
+      end
+
+      # @param [Object] host
+      # @param [Integer] timeout
+      # @param [Integer] open_timeout
+      # @param [String] app
+      # @param [String] env
+      # @yieldparam [Faraday::Connection] Faraday connection object is yielded to a block
+      def new(host:, timeout: nil, open_timeout: OPEN_TIMEOUT, app: guess_app, env: guess_env, &block)
+        @host = host
+        @app = app or raise_missing_app!
+        @env = env or raise_missing_env!
+        @timeout = timeout or raise_missing_timeout!
+        @open_timeout = open_timeout or raise_missing_open_timeout!
+        create(&block)
+      end
+
+      private
+
+      attr_reader :app, :env, :host, :timeout, :open_timeout
+
+      # @return [Faraday::Connection] Preconfigured Faraday Connection object, for hitting get, post, etc.
+      def create
+        builder = QueryableBuilder.new(&Proc.new { |_| })
+
+        ::Faraday.new(url: host, builder: builder) do |faraday|
+          faraday.headers['User-Agent'] = app
+          faraday.headers[config.app_name_header] = app
+          faraday.headers[config.app_env_header] = env
+          faraday.options[:timeout] = timeout
+          faraday.options[:open_timeout] = open_timeout
+
+          if config.detect_deprecations
+            if defined? ActiveSupport::Deprecation
+              faraday.response :detect_deprecations, active_support: true
+            else
+              faraday.response :detect_deprecations, logger: ENV['rack.logger']
+            end
+          end
+
+          yield faraday if block_given?
+
+          faraday.adapter Faraday.default_adapter unless faraday.builder.adapter?
+        end
+      end
+
+      def config
+        We::Call.configuration
+      end
+
+      def raise_missing_app!
+        raise MissingApp, 'app must be set, e.g: pokedex'
+      end
+
+      def raise_missing_env!
+        raise MissingEnv, 'env must be set, e.g: staging'
+      end
+
+      def raise_missing_timeout!
+        raise MissingTimeout, 'timeout must be set, maybe 5 (seconds) would be a good value. This is the open & read timeout, a.k.a max response time.'
+      end
+
+      def raise_missing_open_timeout!
+        raise MissingOpenTimeout, 'open_timeout must be set, and defaults to 1 second. This is the time until a connection is established with another server, and after 1 sec it\'s probably not there.'
+      end
+
+      # @return [String] Environment (usually 'development', 'staging', 'production', etc.)
+      def guess_env
+        return config.app_env if config.app_env
+        ENV['RAILS_ENV'] || ENV['RACK_ENV']
+      end
+
+      # @return [String] Check for config.app_name, or detect name from Rails application
+      def guess_app
+        return config.app_name if config.app_name
+        return ENV['APP_NAME'] if ENV['APP_NAME']
+        rails_app_name
+      end
+
+      def rails_app_name
+        if (defined? ::Rails) && !::Rails.application.nil?
+          ::Rails.application.class.parent_name.underscore.dasherize
+        end
+      end
+    end
+  end
+end

data/lib/we/call/deprecated.rb

@@ -0,0 +1,40 @@
+require "ruby_decorators"
+
+module We
+  module Call
+    class Deprecated < RubyDecorator
+      @@methods = {}
+
+      def initialize(date:)
+        @date = date
+      end
+
+      def set(method, value)
+        @@methods[method] = value
+      end
+
+      def self.get(method)
+        @@methods[method]
+      end
+
+      def self.methods
+        @@methods
+      end
+
+      # Called when annotation is used
+      def call(this, *args, &blk)
+        set("#{this.owner}##{this.name}", date: normalize_datetime(@date))
+        this.call(*args, &blk)
+      end
+
+      protected
+
+      def normalize_datetime(datetime)
+        datetime = DateTime.parse(datetime) if datetime.is_a? String
+        datetime = datetime.to_datetime if datetime.respond_to? :to_datetime
+        return datetime if datetime.respond_to? :httpdate
+        raise TypeError, 'The date should be a Date, DateTime, Time or string containing a valid date and time'
+      end
+    end
+  end
+end

data/lib/we/call/middleware.rb

@@ -0,0 +1,8 @@
+module We
+  module Call
+    module Middleware
+      autoload :Client, 'we/call/middleware/client'
+      autoload :Server, 'we/call/middleware/server'
+    end
+  end
+end

data/lib/we/call/middleware/client.rb

@@ -0,0 +1,9 @@
+module We
+  module Call
+    module Middleware
+      module Client
+        autoload :DetectDeprecations, "we/call/middleware/client/detect_deprecations"
+      end
+    end
+  end
+end

data/lib/we/call/middleware/client/detect_deprecations.rb

@@ -0,0 +1,58 @@
+# This class is going to be split into its own faraday-sunset soon, but I want to get the functionality nailed first
+module We
+  module Call
+    module Middleware
+      module Client
+        class DetectDeprecations < Faraday::Middleware
+          class NoOutputForWarning < StandardError; end
+
+          # Initialize the middleware
+          #
+          # @param [Type] app describe app
+          # @param [Hash] options = {}
+          # @return void
+          def initialize(app, options = {})
+            super(app)
+            @options = options
+          end
+
+          # @param [Faraday::Env] no idea what this does
+          # @return [Faraday::Response] response from the middleware
+          def call(env)
+            @app.call(env).on_complete do |response_env|
+              datetime = sunset_header(response_env.response_headers)
+              report_deprecated_usage(env, datetime) unless datetime.nil?
+            end
+          end
+
+          protected
+
+          # Check to see if there is a Sunset header, which contains deprecation date
+          #
+          # @param [Faraday::Response] response object with headers and whatnot
+          # @return [DateTime|nil] date time object of the expected deprecation date
+          def sunset_header(headers)
+            return if headers[:sunset].nil?
+            DateTime.parse(headers[:sunset])
+          end
+
+          def report_deprecated_usage(env, datetime)
+            if datetime > DateTime.now
+              warning = "Endpoint #{env.url} is deprecated for removal on #{datetime.iso8601}"
+            else
+              warning = "Endpoint #{env.url} was deprecated for removal on #{datetime.iso8601} and could be removed AT ANY TIME"
+            end
+
+            if @options[:active_support]
+              ActiveSupport::Deprecation.warn(warning)
+            elsif @options[:logger] && @options[:logger].respond_to?(:warn)
+              @options[:logger].warn(warning)
+            else
+              raise NoOutputForWarning, "Pass active_support: true or logger: SomeLoggerWithWriteMethod when registering middleware"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/we/call/middleware/server.rb

@@ -0,0 +1,9 @@
+module We
+  module Call
+    module Middleware
+      module Server
+        autoload :LogUserAgent, 'we/call/middleware/server/log_user_agent'
+      end
+    end
+  end
+end

data/lib/we/call/middleware/server/log_user_agent.rb

@@ -0,0 +1,39 @@
+module We
+  module Call
+    module Middleware
+      module Server
+        class LogUserAgent
+          def initialize app
+            @app = app
+          end
+
+          def call(env)
+            line = "user_agent=#{env['HTTP_USER_AGENT']};"
+            line += " app_name=#{env[incoming_app_name_header]};" if env[incoming_app_name_header]
+            line += " app_env=#{env[incoming_app_env_header]};" if env[incoming_app_env_header]
+            output(line)
+            @app.call(env)
+          end
+
+          private
+
+          def output(line)
+            puts line
+          end
+
+          def config
+            We::Call.configuration
+          end
+
+          def incoming_app_env_header
+            @incoming_app_env_header ||= "HTTP_#{config.app_env_header.upcase.gsub!(/-/, '_')}"
+          end
+
+          def incoming_app_name_header
+            @incoming_app_name_header ||= "HTTP_#{config.app_name_header.upcase.gsub!(/-/, '_')}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/we/call/version.rb

@@ -0,0 +1,5 @@
+module We
+  module Call
+    VERSION = "0.5.0"
+  end
+end

data/we-call.gemspec

@@ -0,0 +1,39 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'we/call/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "we-call"
+  spec.version       = We::Call::VERSION
+  spec.authors       = ["WeWork Engineering"]
+  spec.email         = ["engineering@wework.com"]
+
+  spec.summary       = "Making healthy happy HTTP calls"
+  spec.description   = "Handles conventions of making calls to other services, with required metadata for tracking calls between services, deprecations of endpoints, trace IDs, throttling, etc."
+  spec.homepage      = "https://github.com/wework/we-call-gem"
+  spec.licenses      = ['MIT']
+
+  spec.files                = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(spec)/})
+  end
+  spec.bindir               = "bin"
+  spec.require_paths        = ["lib"]
+  spec.metadata["yard.run"] = "yri"
+
+  spec.add_dependency "faraday", ">= 0.9.0", "< 0.14"
+  spec.add_dependency "faraday_middleware", '~> 0'
+  spec.add_dependency "ruby_decorators", '~> 0.0'
+  spec.add_dependency "rails", ">= 4.2"
+
+  spec.add_development_dependency "appraisal", "~> 2"
+  spec.add_development_dependency "coveralls", '~> 0.7'
+  spec.add_development_dependency "bundler", "~> 1.14"
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rspec", "~> 3.5"
+  spec.add_development_dependency "simplecov", '~> 0.15'
+  spec.add_development_dependency "hashie", "~> 3.5"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "yard"
+  spec.add_development_dependency "vcr", '~> 3'
+end

metadata

@@ -0,0 +1,274 @@
+--- !ruby/object:Gem::Specification
+name: we-call
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- WeWork Engineering
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-08-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  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: ruby_decorators
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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'
+- !ruby/object:Gem::Dependency
+  name: yard
+  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'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+description: Handles conventions of making calls to other services, with required
+  metadata for tracking calls between services, deprecations of endpoints, trace IDs,
+  throttling, etc.
+email:
+- engineering@wework.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Appraisals
+- CHANGELOG
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/we-call.rb
+- lib/we/call.rb
+- lib/we/call/annotations.rb
+- lib/we/call/configuration.rb
+- lib/we/call/connection.rb
+- lib/we/call/deprecated.rb
+- lib/we/call/middleware.rb
+- lib/we/call/middleware/client.rb
+- lib/we/call/middleware/client/detect_deprecations.rb
+- lib/we/call/middleware/server.rb
+- lib/we/call/middleware/server/log_user_agent.rb
+- lib/we/call/version.rb
+- we-call.gemspec
+homepage: https://github.com/wework/we-call-gem
+licenses:
+- MIT
+metadata:
+  yard.run: yri
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Making healthy happy HTTP calls
+test_files: []