underway 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0725b18ff63695654ff86cd63ba3d4669971a8ca
+  data.tar.gz: 2804c0a2916e847b2a7a53739c1568f94e7fcd99
+SHA512:
+  metadata.gz: 19914c5e32911685356e467ea190e73ac62222b939d9234c6e9180e3483d8433b1ddea0bf59fffd1990097eb5c326b5bc26d08c50a8d2fcd55179b6ded028dec
+  data.tar.gz: 1601a1f138f9dcf6ea6a709a2d272165deaff6fa1cb4a98b0c5327111a06ab912f62a391542114b6f4b9d5070d445b290577448bb0d34e109a5633d3ec909447

data/.gitignore

@@ -0,0 +1,22 @@
+config.json
+config.json.localhost
+config.json.prod*
+*.pem
+*.db
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+test/tmp
+test/version_tmp
+tmp
+.ruby-*

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 James Martin
+
+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,73 @@
+# Underway
+
+Underway is a Ruby gem that helps developers quickly prototype [GitHub
+Apps](https://developer.github.com/apps/).
+
+Underway consists of some convenience wrappers for the GitHub REST API, with a
+particular focus on generating credentials for accessing installation resources
+associated with a GitHub App. Access tokens are cached using Sqlite3 for
+convenience.
+
+If you like rapid prototyping with [Sinatra](http://sinatrarb.com) you can use
+the included Sinatra routes, which allow you to quickly get access to a JWT or
+access token for your App and its installations. Starting with a Sinatra
+application is a fast way to build a GitHub App prototype and explore how
+GitHub Apps work with the GitHub REST API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "underway", "~> 1.0"
+```
+
+And then run:
+
+```
+bundle
+```
+
+Or install it globally with:
+
+```
+gem install underway
+```
+
+## Configuration
+
+First, follow the documentation to [create a GitHub
+App](https://developer.github.com/apps/building-github-apps/creating-a-github-app/).
+
+When you're done creating a new App you should have:
+
+- Your GitHub App's ID (an integer)
+- A private key file (.pem)
+- A webhook secret (optional)
+
+Make a copy of the [config.json.example]() file in a location readable by your
+application and edit the file to match your GitHub App's settings.
+
+At its core, Underway is just a Ruby library and can be used in virtually any
+application.  To get started quickly and test out your new GitHub App you might
+want to use the included [Sinatra](http://sinatrarb.com) routes. A complete
+[example Sinatra
+application](https://github.com/jamesmartin/underway/blob/master/example/app.rb)
+is included with Underway and shows how to configure the gem and include the
+informational routes.
+
+
+If you would prefer to configure Underway manually, or are not building a
+Sinatra application, do something like this:
+
+```ruby
+require "underway"
+
+# This assumes that your configuration file and private key file is located in
+# the same directory as the current ruby file.
+
+Underway::Settings.configure do |config|
+  config.app_root = __FILE__
+  config.config_filename = "config.json"
+end
+```

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+task default: %w[test]
+
+Rake::TestTask.new do |t|
+  t.pattern = "test/**/*_test.rb"
+end

data/config.json.example

@@ -0,0 +1,8 @@
+{
+  "webhook_secret":"secret",
+  "private_key_filename":"./path-to.private-key.pem",
+  "github_api_host":"http://api.github.localhost",
+  "app_id":"1",
+  "database_url":"sqlite://gha.db",
+  "verbose_logging":false
+}

data/example/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org" do
+  local_gem_path = File.expand_path("../../", __FILE__)
+  gem "underway", path: local_gem_path
+
+  gem "sinatra"
+end

data/example/app.rb

@@ -0,0 +1,30 @@
+require "sinatra"
+require "underway"
+
+configure do
+  Underway::Settings.configure do |config|
+    config.app_root = __FILE__
+    config.config_filename = "config.json"
+  end
+end
+
+include Sinatra::Underway
+include Sinatra::Underway::AppInfo
+
+get "/" do
+  erb <<~EOS
+    <a href="/info">Underway App Information</a>
+  EOS
+end
+
+post "/user_authz" do
+  debug_route(request)
+end
+
+get "/setup" do
+  debug_route(request)
+end
+
+post "/hook" do
+  debug_route(request)
+end

data/example/config.json.example

@@ -0,0 +1,8 @@
+{
+  "webhook_secret":"secret",
+  "private_key_filename":"./path-to.private-key.pem",
+  "github_api_host":"http://api.github.localhost",
+  "app_id":"1",
+  "database_url":"sqlite://gha.db",
+  "verbose_logging":false
+}

data/lib/underway.rb

@@ -0,0 +1,11 @@
+require "underway/api"
+require "underway/database"
+require "underway/logger"
+require "underway/sawyer_to_json"
+require "underway/settings"
+require "underway/sinatra"
+require "underway/token_cache"
+require "underway/version"
+
+module Underway
+end

data/lib/underway/api.rb

@@ -0,0 +1,82 @@
+require "jwt"
+require "octokit"
+
+module Underway
+  class Api
+    # Returns a Sawyer::Resource or PORO from the GitHub REST API
+    def self.invoke(route, headers: {}, method: :get)
+      debug_octokit! if verbose_logging?
+
+      Octokit.api_endpoint = Underway::Settings.config.raw["github_api_host"]
+
+      if !headers[:authorization] && !headers["Authorization"]
+        Octokit.bearer_token = generate_jwt
+      end
+
+      final_headers = {
+        accept: "application/vnd.github.machine-man-preview+json",
+        headers: headers
+      }
+
+      begin
+        case method
+        when :post then Octokit.post(route, final_headers)
+        else Octokit.get(route, final_headers)
+        end
+      rescue Octokit::Error => e
+        { error: e.to_s }
+      end
+    end
+
+    def self.generate_jwt
+      payload = {
+        # Issued at time:
+        iat: Time.now.to_i,
+        # JWT expiration time (10 minute maximum)
+        exp: Time.now.to_i + (10 * 60),
+        # GitHub Apps identifier
+        iss: Underway::Settings.config.app_issuer
+      }
+
+      JWT.encode(payload, Underway::Settings.config.private_key, "RS256")
+    end
+
+    # Returns a valid auth token for the installation
+    def self.installation_token(id:)
+      if token = Underway::Settings.config.token_cache.lookup_installation_auth_token(id: id)
+        log("token cache: hit")
+        return token
+      else
+        log("token cache: miss")
+        res = invoke(
+          "/app/installations/#{id}/access_tokens",
+          method: :post
+        )
+
+        if error = res[:error]
+          raise ArgumentError.new(error)
+        end
+
+        token = res.token
+        expires_at = res.expires_at.to_s
+        Underway::Settings.config.token_cache.store_installation_auth_token(id: id, token: token, expires_at: expires_at)
+        token
+      end
+    end
+
+    def self.debug_octokit!
+      stack = Faraday::RackBuilder.new do |builder|
+        builder.use Octokit::Middleware::FollowRedirects
+        builder.use Octokit::Response::RaiseError
+        builder.use Octokit::Response::FeedParser
+        builder.response :logger
+        builder.adapter Faraday.default_adapter
+      end
+      Octokit.middleware = stack
+    end
+
+    def self.verbose_logging?
+      !!Underway::Settings.config.verbose_logging
+    end
+  end
+end

data/lib/underway/database.rb

@@ -0,0 +1,31 @@
+require "sqlite3"
+require "sequel"
+require "singleton"
+
+module Underway
+  class DB
+    include Singleton
+
+    @@db = nil
+
+    def self.configure(database_url)
+      @@db = Sequel.connect(database_url)
+
+      Sequel.default_timezone = :utc
+
+      # TODO: extract to schema migration
+      @@db.create_table?(:cached_tokens) do
+        primary_key   :id
+        Fixnum        :installation_id, null: false
+        String        :token, null: false
+        DateTime      :expires_at, null: false
+
+        index [:installation_id, :expires_at]
+      end
+    end
+
+    def database
+      @@db
+    end
+  end
+end

data/lib/underway/logger.rb

@@ -0,0 +1,7 @@
+module Underway
+  class Logger
+    def info(message)
+      $stdout.puts(message)
+    end
+  end
+end

data/lib/underway/sawyer_to_json.rb

@@ -0,0 +1,18 @@
+require "json"
+require "sawyer"
+
+module Underway
+  class SawyerToJson
+    def self.convert(object)
+      JSON.generate(unwrap(object))
+    end
+
+    def self.unwrap(object)
+      case object
+      when Array then object.map { |o| unwrap(o) }
+      when Sawyer::Resource then object.to_hash
+      else object
+      end
+    end
+  end
+end

data/lib/underway/settings.rb

@@ -0,0 +1,101 @@
+require "pathname"
+require "json"
+
+module Underway
+  class Settings
+    class Configuration
+      attr_reader :config, :logger
+
+      def initialize
+        @logger = Underway::Logger.new
+      end
+
+      def load!
+        @config = JSON.parse(
+          @app_root.join(@config_filename).read
+        )
+      end
+
+      # TODO: deprecate
+      def raw
+        @config
+      end
+
+      def app_root=(directory)
+        @app_root = Pathname.new(directory).dirname
+      end
+
+      def config_filename=(filename)
+        @config_filename = filename
+      end
+
+      def logger=(logger)
+        @logger = logger
+      end
+
+      def db
+        @db ||=
+          begin
+            Underway::DB.configure(config["database_url"])
+            Underway::DB.instance.database
+          end
+      end
+
+      # The Integration ID
+      # From "About -> ID" at github.com/settings/apps/<app-name>
+      def app_issuer
+        @app_issuer ||= config["app_id"]
+      end
+
+      # Integration webhook secret (for validating that webhooks come from GitHub)
+      def webhook_secret
+        @webhook_secret ||= config["webhook_secret"]
+      end
+
+      def private_key_filename
+        @app_root.join(config["private_key_filename"])
+      end
+
+      # PEM file for request signing (PKCS#1 RSAPrivateKey format)
+      # (Download from github.com/settings/apps/<app-name> "Private key")
+      def private_pem
+        @private_pem ||= File.read(private_key_filename)
+      end
+
+      # Private Key for the App, generated based on the PEM file
+      def private_key
+        @private_key ||= OpenSSL::PKey::RSA.new(private_pem)
+      end
+
+      def verbose_logging
+        @verbose ||= config["verbose_logging"]
+      end
+
+      def token_cache
+        @token_cache ||= Underway::TokenCache.new(db)
+      end
+    end
+
+    @configuration = Configuration.new
+
+    class << self
+      attr_reader :configuration
+
+      def configure
+        if block_given?
+          yield configuration
+        else
+          raise ArgumentError.new("Please set configuration by passing a block")
+        end
+
+        configuration.load!
+      end
+
+      # TODO: remove me
+      def config
+        configuration
+      end
+    end
+
+  end
+end

data/lib/underway/sinatra.rb

@@ -0,0 +1,24 @@
+require "underway/sinatra/app_info"
+
+# Repopen Sinatra to add helpers to the app
+module Sinatra
+  module Underway
+    def debug_route(request)
+      log(request.inspect)
+    end
+
+    def verbose_logging?
+      !!::Underway::Settings.config.verbose_logging
+    end
+
+    def log(message)
+      if verbose_logging?
+        ::Underway::Settings.config.logger.info(message)
+      end
+    end
+
+    def gh_api(*args)
+      ::Underway::Api.invoke(*args)
+    end
+  end
+end

data/lib/underway/sinatra/app_info.rb

@@ -0,0 +1,81 @@
+require "sinatra/base"
+
+# Include this module in your Sinatra app to get access to these helpful
+# routes:
+#
+# /info/app => information about this App
+# /info/app/installations => a list of all installations of this App
+# /info/app/installations/:id => information about the installation
+# /info/app/installations/:id/repositories => the repositories this
+# installation has access to
+# /info/app/installations/:id/access_token => a valid access token for the
+# installation
+
+module Sinatra
+  module Underway
+    module AppInfo
+      def self.registered(app)
+        app.get "/info" do
+          erb <<~EOS
+            <h1>Underway</h1>
+            <h2>Interesting routes:</h2>
+            <pre>
+              <li>/info                                                                                           => This page</li>
+              <li><a href="/info/app">/info/app</a>                                                               => Information about the configured GitHub App</li>
+              <li><a href="/info/app/jwt">/info/app/jwt</a>                                                       => Generates a JWT for authentication as this App</li>
+              <li><a href="/info/app/installations">/info/app/installations</a>                                   => A list of installations associated with this App</li>
+              <li><a href="/info/app/installations/1">/info/app/installations/:id</a>                             => Information about the given installation of this App</li>
+              <li><a href="/info/app/installations/1/access_token">/info/app/installations/:id/access_token</a>   => A valid access token for accessing the given installation as this App</li>
+              <li><a href="/info/app/installations/1/repositories">/info/app/installations/:id/repositories</a>   => A list of all repositories accessible to the installation of this App</li>
+            </pre>
+            <h2>Private PEM file</h2>
+            <pre>
+              #{::Underway::Settings.config.private_key_filename}
+            </pre>
+          EOS
+        end
+
+        app.get "/info/app/jwt" do
+          content_type :json
+          ::Underway::Api.generate_jwt
+        end
+
+        app.get "/info/app" do
+          content_type :json
+          ::Underway::SawyerToJson.convert(gh_api("/app"))
+        end
+
+        app.get "/info/app/installations" do
+          content_type :json
+          ::Underway::SawyerToJson.convert(gh_api("/app/installations"))
+        end
+
+        app.get "/info/app/installations/:installation_id" do
+          content_type :json
+          ::Underway::SawyerToJson.convert(gh_api("/app/installations/#{params["installation_id"]}"))
+        end
+
+        app.get "/info/app/installations/:installation_id/access_token" do
+          content_type :json
+          ::Underway::SawyerToJson.convert(
+            gh_api(
+              "/app/installations/#{params["installation_id"]}/access_tokens",
+              method: :post
+            )
+          )
+        end
+
+        app.get "/info/app/installations/:installation_id/repositories" do
+          content_type :json
+          ::Underway::SawyerToJson.convert(
+            gh_api(
+              "/installation/repositories",
+              headers: { authorization: "token #{::Underway::Api.installation_token(id: params[:installation_id])}" }
+            )
+          )
+        end
+      end
+    end
+  end
+  register Underway::AppInfo
+end

data/lib/underway/token_cache.rb

@@ -0,0 +1,26 @@
+module Underway
+  class TokenCache
+    attr_accessor :db
+
+    def initialize(database)
+      @db = database
+    end
+
+    def lookup_installation_auth_token(id:)
+      results = db[:cached_tokens].where(installation_id: id)
+        .where{expires_at >= DateTime.now.new_offset(0)} # Force UTC Timezone
+        .reverse(:expires_at)
+      if results.any?
+        results.first[:token]
+      end
+    end
+
+    def store_installation_auth_token(id:, token:, expires_at:)
+      db[:cached_tokens].insert(
+        installation_id: id,
+        token: token,
+        expires_at: DateTime.parse(expires_at)
+      )
+    end
+  end
+end

data/lib/underway/version.rb

@@ -0,0 +1,3 @@
+module Underway
+  VERSION = "1.0.0"
+end

data/test/lib/sawyer_to_json_test.rb

@@ -0,0 +1,30 @@
+require_relative "../test_helper"
+
+class SawyerToJsonTest < SequelTestCase
+
+  def setup
+  end
+
+  def test_can_convert_an_empty_array
+    assert_equal "[]", Underway::SawyerToJson.convert([])
+  end
+
+  def test_can_convert_an_array_with_nested_hash
+    obj = [ { foo: "bar" } ]
+    expected = "[{\"foo\":\"bar\"}]"
+    actual = Underway::SawyerToJson.convert(obj)
+
+    assert_equal expected, actual
+  end
+
+  def test_can_convert_a_nested_sawyer_object
+    agent = Sawyer::Agent.new("/irrelevant")
+    data = "{\"foo\":\"bar\"}"
+    resource = Sawyer::Resource.new(agent, agent.decode_body(data))
+    obj = [ resource ]
+    expected = "[{\"foo\":\"bar\"}]"
+    actual = Underway::SawyerToJson.convert(obj)
+
+    assert_equal expected, actual
+  end
+end

data/test/lib/token_cache_test.rb

@@ -0,0 +1,66 @@
+require_relative "../test_helper"
+
+class TokenCacheTest < SequelTestCase
+
+  def setup
+    @cache = Underway::TokenCache.new(Underway::DB.instance.database)
+  end
+
+  def test_can_store_and_retrieve_a_token
+    Timecop.freeze(DateTime.parse("2018-02-12T09:00:00+00:00")) do
+      @cache.store_installation_auth_token(
+        id: 1,
+        token: "some-token",
+        expires_at: "2018-02-12T10:00:00Z"
+      )
+
+      assert_equal "some-token", @cache.lookup_installation_auth_token(id: 1)
+    end
+  end
+
+  def test_retrieves_the_newest_token
+    Timecop.freeze(DateTime.parse("2018-02-12T09:00:00+00:00")) do
+      @cache.store_installation_auth_token(
+        id: 1,
+        token: "first-token",
+        expires_at: "2018-02-12T10:00:00Z"
+      )
+
+      @cache.store_installation_auth_token(
+        id: 1,
+        token: "second-token",
+        expires_at: "2018-02-12T11:00:00Z"
+      )
+
+      assert_equal "second-token", @cache.lookup_installation_auth_token(id: 1)
+    end
+  end
+
+  def test_returns_nil_when_looking_up_a_token_that_does_not_exist
+    assert_nil @cache.lookup_installation_auth_token(id: "non-existent")
+  end
+
+  def test_returns_nil_for_tokens_that_have_expired
+    Timecop.freeze(DateTime.parse("2018-02-12T09:00:00+00:00")) do
+      @cache.store_installation_auth_token(
+        id: 1,
+        token: "some-token",
+        expires_at: "2018-02-12T08:00:00Z"
+      )
+
+      assert_nil @cache.lookup_installation_auth_token(id: 1)
+    end
+  end
+
+  def test_retrieves_a_token_when_the_expiry_is_equal_to_now
+    Timecop.freeze(DateTime.parse("2018-02-12T09:00:00+00:00")) do
+      @cache.store_installation_auth_token(
+        id: 1,
+        token: "some-token",
+        expires_at: "2018-02-12T09:00:00Z"
+      )
+
+      assert_equal "some-token", @cache.lookup_installation_auth_token(id: 1)
+    end
+  end
+end

data/test/sequel_helper.rb

@@ -0,0 +1,14 @@
+#require_relative "../lib/database"
+
+# http://sequel.jeremyevans.net/rdoc/files/doc/testing_rdoc.html
+
+class SequelTestCase < Minitest::Test
+  def run(*args, &block)
+    Underway::DB.configure("sqlite:/") # Always assume an in-memory database for now
+
+    Sequel::Model.db.transaction(
+      rollback: :always,
+      auto_savepoint: true
+    ){super}
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,7 @@
+#ENV["RACK_ENV"] = "test"
+require "minitest/autorun"
+require "timecop"
+require "underway"
+require_relative "./sequel_helper.rb"
+
+Timecop.safe_mode = true # Never, NEVER, allow arbitrary mutation of time without a block

data/underway.gemspec

@@ -0,0 +1,32 @@
+# encoding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "underway/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "underway"
+  spec.version       = Underway::VERSION
+  spec.authors       = ["James Martin"]
+  spec.email         = ["underway-gem@jmrtn.com"]
+  spec.summary       = %q{Quick prototyping helpers for building GitHub Apps.}
+  spec.description   = %q{Generate tokens and interact with the GitHub Rest API as a GitHub App.}
+  spec.homepage      = "https://github.com/jamesmartin/underway"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "sinatra"
+  spec.add_development_dependency "timecop"
+
+  spec.add_runtime_dependency "jwt", "~> 2.1"
+  spec.add_runtime_dependency "octokit", "~> 4.0"
+  spec.add_runtime_dependency "sequel"
+  spec.add_runtime_dependency "sqlite3", "~> 1.3"
+end

metadata

@@ -0,0 +1,213 @@
+--- !ruby/object:Gem::Specification
+name: underway
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- James Martin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-03-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  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: 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: rake
+  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: sinatra
+  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: timecop
+  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: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: sequel
+  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: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: Generate tokens and interact with the GitHub Rest API as a GitHub App.
+email:
+- underway-gem@jmrtn.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-version"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- config.json.example
+- example/Gemfile
+- example/app.rb
+- example/config.json.example
+- lib/underway.rb
+- lib/underway/api.rb
+- lib/underway/database.rb
+- lib/underway/logger.rb
+- lib/underway/sawyer_to_json.rb
+- lib/underway/settings.rb
+- lib/underway/sinatra.rb
+- lib/underway/sinatra/app_info.rb
+- lib/underway/token_cache.rb
+- lib/underway/version.rb
+- test/lib/sawyer_to_json_test.rb
+- test/lib/token_cache_test.rb
+- test/sequel_helper.rb
+- test/test_helper.rb
+- underway.gemspec
+homepage: https://github.com/jamesmartin/underway
+licenses:
+- MIT
+metadata: {}
+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.11
+signing_key: 
+specification_version: 4
+summary: Quick prototyping helpers for building GitHub Apps.
+test_files:
+- test/lib/sawyer_to_json_test.rb
+- test/lib/token_cache_test.rb
+- test/sequel_helper.rb
+- test/test_helper.rb