github-rundeck 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 47d1b7364c0c57961c587257fd0cd862652a2386
-  data.tar.gz: 2c1627c159047cd8de857e371e1ac3ad1a98e2b7
+  metadata.gz: c22589f9897857c2ab82a2fa78a699e80f56f286
+  data.tar.gz: fd0d2db2e364a4bb4a4958e3bb92f6475b0faaf3
 SHA512:
-  metadata.gz: 3732824f6d991df279724a9db58461198bf4f3e30eec8c6528cef34afdf08de0bba10b23996517eb5fa87d10c5aff7005a6f99c8e9d1bc8f683be1e5d874acaf
-  data.tar.gz: 5db88ee35bf05004fc8c688dbfa13e52cc775dfeeaea761531df6ebd47f207111c5f7a8d3b8e051953f2fb34d879b429a9409711ab43830b060e995f0970b6bf
+  metadata.gz: 33e0165857fcc814954f92c71378afad328c245b933553951e6f91a554843cdf8e56164dbc0f8331e057e5be8aa64435c3dd433672708350521f233f9a0d81fd
+  data.tar.gz: d319b4720817de27b937ed2b035fe06b08790106ae96f1cbabb31dc3daa5c44ffb0a9b955592e8d8f648fecd1ec954384a4fe21c56321834110bba5a1aa5c855

data/Gemfile

@@ -1,13 +1,2 @@
 source 'https://rubygems.org'
-
-gem 'github_api'
-gem 'mixlib-cli'
-gem 'rack-cache'
-gem 'sinatra'
-gem 'sinatra-contrib'
-
-group :development do
-  gem 'rake'
-  gem 'rspec'
-  gem 'rubocop'
-end
+gemspec

data/Gemfile.lock

@@ -1,3 +1,13 @@
+PATH
+  remote: .
+  specs:
+    github-rundeck (0.1.3)
+      github_api (~> 0.14)
+      mixlib-cli (~> 1.6)
+      rack-cache (~> 1.6)
+      sinatra (~> 1.4)
+      sinatra-contrib (~> 1.4)
+
 GEM
   remote: https://rubygems.org/
   specs:
@@ -9,51 +19,51 @@ GEM
     diff-lcs (1.2.5)
     faraday (0.9.2)
       multipart-post (>= 1.2, < 3)
-    github_api (0.14.0)
+    github_api (0.14.5)
       addressable (~> 2.4.0)
       descendants_tracker (~> 0.0.4)
       faraday (~> 0.8, < 0.10)
       hashie (>= 3.4)
-      oauth2
-    hashie (3.4.4)
-    jwt (1.5.1)
-    mixlib-cli (1.6.0)
+      oauth2 (~> 1.0)
+    hashie (3.4.6)
+    jwt (1.5.6)
+    mixlib-cli (1.7.0)
     multi_json (1.12.1)
-    multi_xml (0.5.5)
+    multi_xml (0.6.0)
     multipart-post (2.0.0)
-    oauth2 (1.1.0)
-      faraday (>= 0.8, < 0.10)
-      jwt (~> 1.0, < 1.5.2)
+    oauth2 (1.3.0)
+      faraday (>= 0.8, < 0.11)
+      jwt (~> 1.0)
       multi_json (~> 1.3)
       multi_xml (~> 0.5)
       rack (>= 1.2, < 3)
-    parser (2.3.1.2)
+    parser (2.3.3.1)
       ast (~> 2.2)
     powerpack (0.1.1)
-    rack (1.6.4)
+    rack (1.6.5)
     rack-cache (1.6.1)
       rack (>= 0.4)
     rack-protection (1.5.3)
       rack
     rack-test (0.6.3)
       rack (>= 1.0)
-    rainbow (2.1.0)
-    rake (11.1.2)
-    rspec (3.4.0)
-      rspec-core (~> 3.4.0)
-      rspec-expectations (~> 3.4.0)
-      rspec-mocks (~> 3.4.0)
-    rspec-core (3.4.4)
-      rspec-support (~> 3.4.0)
-    rspec-expectations (3.4.0)
+    rainbow (2.2.1)
+    rake (10.5.0)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.4)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.4.0)
-    rspec-mocks (3.4.1)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.4.0)
-    rspec-support (3.4.1)
-    rubocop (0.40.0)
-      parser (>= 2.3.1.0, < 3.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    rubocop (0.47.1)
+      parser (>= 2.3.3.1, < 3.0)
       powerpack (~> 0.1)
       rainbow (>= 1.99.1, < 3.0)
       ruby-progressbar (~> 1.7)
@@ -72,20 +82,17 @@ GEM
       tilt (>= 1.3, < 3)
     thread_safe (0.3.5)
     tilt (2.0.5)
-    unicode-display_width (1.0.5)
+    unicode-display_width (1.1.3)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  github_api
-  mixlib-cli
-  rack-cache
-  rake
-  rspec
+  bundler (~> 1.12)
+  github-rundeck!
+  rake (~> 10.0)
+  rspec (~> 3.0)
   rubocop
-  sinatra
-  sinatra-contrib
 
 BUNDLED WITH
-   1.12.3
+   1.13.7

data/README.md

@@ -8,7 +8,7 @@ This gem delivers RunDeck options in the supported JSON format
 * List of Branch/Tag Names for a Repo - `GET` - *http://localhost:9125/github/v1/revisions/${ORGNAME}/${REPONAME}*
 
 ### OAuth Key
-You can feed a GitHub OAuth key via local configuration, or as the Query Parameter `oauth_token`
+You can feed a GitHub OAuth key via local configuration, or as the Query Parameter `gh_oauth_token`
 
 
 ## Installation

data/exe/github-rundeck

@@ -1,82 +1,15 @@
 #!/usr/bin/env ruby
 # encoding: UTF-8
-# rubocop: disable LineLength
 # RunDeck Options Provider - GitHub Repositories
 # Brian Dwyer - Intelligent Digital Services - 5/14/16
 
 lib = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
-require 'rubygems'
-require 'github-rundeck'
-require 'mixlib/cli'
-require 'json'
-
-# => Github-RunDeck Launcher
-class GithubRunDeckCLI
-  include Mixlib::CLI
-
-  option :github_oauth_token,
-         short: '-o TOKEN',
-         long: '--github-oauth-token TOKEN',
-         description: 'OAuth Token to use for querying GitHub',
-         default: nil
-
-  option :cache_timeout,
-         short: '-t CACHE_TIMEOUT',
-         long: '--timeout CACHE_TIMEOUT',
-         description: 'Sets the response timeout in seconds for the query data.',
-         default: 30
-
-  option :config_file,
-         short: '-c CONFIG',
-         long: '--config CONFIG',
-         description: 'The configuration file to use, as opposed to command-line parameters (optional)',
-         default: nil
-
-  option :host,
-         short: '-h HOST',
-         long: '--host HOST',
-         description: 'Listen on HOST (default: localhost)',
-         default: 'localhost'
-
-  option :port,
-         short: '-p PORT',
-         long: '--port PORT',
-         description: 'The port to run on, default 9123',
-         default: 9123
+# => Catch Ctrl+C's to avoid stack traces
+Signal.trap('INT') { abort }
 
-  option :env,
-         short: '-e ENV',
-         long: '--env ENV',
-         description: 'Sets the environment for chef-rundeck to execute under. Use "development" for more logging.',
-         default: 'production'
-end
-
-cli = GithubRunDeckCLI.new
-cli.parse_options
-
-# => Define JSON Parser
-def parse_json_config(file = nil)
-  return unless file && ::File.exist?(file.to_s)
-  begin
-    ::JSON.parse(::File.read(file.to_s), symbolize_names: true)
-  rescue JSON::ParserError
-    return
-  end
-end
-
-# => Parse JSON Config File
-json_config = parse_json_config(cli.config[:config_file])
-
-# => Merge Configuration (JSON File Wins)
-config = [cli.config, json_config].compact.reduce(:merge)
-
-# => Apply Configuration
-GithubRunDeck.github_oauth_token = config[:github_oauth_token]
-GithubRunDeck.cache_timeout = config[:cache_timeout].to_i
-GithubRunDeck.config_file = config[:config_file] if json_config
-GithubRunDeck.environment = config[:env].to_sym
+require 'github-rundeck'
 
-# => Launch the Application
-GithubRunDeck.run! bind: config[:host], port: config[:port]
+# => Launch the Plugin
+GithubRunDeck::CLI.run(ARGV)

data/github-rundeck.gemspec

@@ -3,7 +3,7 @@
 
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'github-rundeck'
+require 'github-rundeck/version'
 
 Gem::Specification.new do |spec|
   spec.name          = 'github-rundeck'

data/lib/github-rundeck.rb

@@ -3,139 +3,10 @@
 # GitHub Repo Poller for RunDeck
 # Brian Dwyer - Intelligent Digital Services - 5/14/16
 
-require 'sinatra/base'
-require 'sinatra/namespace'
-require 'github_api'
-require 'json'
-require 'rack/cache'
+require 'github-rundeck/cli'
 
-# => GitHub RunDeck
-class GithubRunDeck < Sinatra::Base
-  register Sinatra::Namespace
-
-  class << self
-    attr_accessor :config_file
-    attr_accessor :cache_timeout
-    attr_accessor :github_oauth_token
-  end
-
-  if development?
-    require 'sinatra/reloader'
-    register Sinatra::Reloader
-  end
-
-  VERSION = '0.1.2'.freeze
-
-  ######################
-  # =>  Definitions  <=#
-  ######################
-
-  def ghclient
-    # => Instantiate a new GitHub Client
-    Github::Client.new
-  end
-
-  def serialize(response)
-    # => Serialize Object into JSON Array
-    JSON.pretty_generate(response.map(&:name).sort_by(&:downcase))
-  end
-
-  def serialize_revisions(branches, tags)
-    # => Serialize Branches/Tags into JSON Array
-    # => Branches = String, Tags = Key/Value
-    branches = branches.map(&:name).sort_by(&:downcase)
-    tags = tags.map(&:name).sort_by(&:downcase).reverse.map { |tag| { name: "Tag: #{tag}", value: tag } }
-    JSON.pretty_generate(branches + tags)
-  end
-
-  ######################
-  # =>    Sinatra    <=#
-  ######################
-
-  use Rack::Cache do
-    set :verbose, true
-    set :metastore,   'file:' + File.join(Dir.tmpdir, 'rack', 'meta')
-    set :entitystore, 'file:' + File.join(Dir.tmpdir, 'rack', 'body')
-  end
-
-  # => Current Configuration & Healthcheck Endpoint
-  get '/' do
-    content_type 'application/json'
-    JSON.pretty_generate(
-      Status: "#{self.class} is up and running!",
-      ConfigFile: GithubRunDeck.config_file,
-      CacheTimeout: GithubRunDeck.cache_timeout,
-      GithubOAuthToken: GithubRunDeck.github_oauth_token,
-      Params: params.inspect
-    )
-  end
-
-  #######################
-  # =>    JSON API    <=#
-  #######################
-
-  namespace '/github/v1' do
-    # => Define our common namespace parameters
-    before do
-      # => This is a JSON API
-      content_type 'application/json'
-
-      # => Cache GitHub Responses
-      cache_control :public, max_age: GithubRunDeck.cache_timeout || 30
-
-      # => Parameter Overrides
-      Github.configure do |cfg|
-        cfg.oauth_token = params['oauth_token'] || GithubRunDeck.github_oauth_token
-      end
-    end
-
-    # => Get Organization Repo List
-    get '/repos/org/:org' do |org|
-      ghresponse = ghclient.repos.list(org: org, per_page: 100)
-      etag ghresponse.headers.etag
-      body serialize(ghresponse)
-    end
-
-    # => Get User Repo List
-    get '/repos/user/:user' do |user|
-      ghresponse = ghclient.repos.list(user: user, per_page: 100)
-      etag ghresponse.headers.etag
-      body serialize(ghresponse)
-    end
-
-    # => Get Branch/Tag Names
-    get '/revisions/:user/:repo' do |user, repo|
-      branches = ghclient.repos.branches(user: user, repo: repo)
-      tags = ghclient.repos.tags(user: user, repo: repo)
-      body serialize_revisions(branches, tags)
-    end
-
-    # => Compare Branch/Tags
-    get '/compare/:user/:repo' do |user, repo|
-      # => Check Parameters - Default to Master
-      refs = [
-        { 'target' => params['ref1'] || 'master' },
-        { 'target' => params['ref2'] || 'master' }
-      ]
-
-      begin
-        refs.each do |ref|
-          # => Pull the SHA
-          ref['sha'] = ghclient.git_data.trees.get(user, repo, ref['target']).first[1]
-        end
-
-        if refs[0]['sha'] == refs[1]['sha']
-          return "ref1(#{user}/#{repo}/#{refs[0]['target']}) is the same as ref2(#{user}/#{repo}/#{refs[1]['target']})".to_json
-        else
-          status 500 unless params['errorok'] == '1'
-          return "ALERT!!! - ref1(#{user}/#{repo}/#{refs[0]['target']}) is different than ref2(#{user}/#{repo}/#{refs[1]['target']})".to_json
-        end
-
-      # => Catch any GitHub Errors
-      rescue Github::Error::GithubError => e
-        status 500 unless params['errorok'] == '1'
-        e.message.to_json
-      end
-    end
-  end
+# => GitHub RunDeck Options Provider API
+module GithubRunDeck
+  # => The Sinatra API should be Lazily-Loaded, such that the CLI arguments and/or configuration files are respected
+  autoload :API, 'github-rundeck/api'
 end

data/lib/github-rundeck/api.rb

@@ -0,0 +1,154 @@
+# Encoding: UTF-8
+# rubocop: disable LineLength
+#
+# Gem Name:: github-rundeck
+# GithubRunDeck:: API
+#
+# Copyright (C) 2017 Brian Dwyer - Intelligent Digital Services
+#
+# All rights reserved - Do Not Redistribute
+#
+
+# => NOTE: Anything other than a STATUS 200 will trigger an error in the RunDeck plugin due to a hardcode in org.boon.HTTP
+
+require 'sinatra/base'
+require 'sinatra/namespace'
+require 'json'
+require 'rack/cache'
+require 'github-rundeck/config'
+require 'github-rundeck/git'
+require 'github-rundeck/util'
+
+# => Deployment Information Provider for RunDeck
+module GithubRunDeck
+  # => HTTP API
+  class API < Sinatra::Base
+    #######################
+    # =>    Sinatra    <= #
+    #######################
+
+    # => Configure Sinatra
+    enable :logging, :static, :raise_errors # => disable :dump_errors, :show_exceptions
+    set :port, Config.port || 8080
+    set :bind, Config.bind || 'localhost'
+    set :environment, Config.environment.to_sym.downcase || :production
+
+    # => Enable NameSpace Support
+    register Sinatra::Namespace
+
+    if development?
+      require 'sinatra/reloader'
+      register Sinatra::Reloader
+    end
+
+    use Rack::Cache do
+      set :verbose, true
+      set :metastore,   'file:' + File.join(Dir.tmpdir, 'rack', 'meta')
+      set :entitystore, 'file:' + File.join(Dir.tmpdir, 'rack', 'body')
+    end
+
+    ########################
+    # =>    JSON API    <= #
+    ########################
+
+    # => Current Configuration & Healthcheck Endpoint
+    if development?
+      get '/config' do
+        content_type 'application/json'
+        JSON.pretty_generate(
+          [
+            DeployInfo.inspect + ' is up and running!',
+            'Author: ' + Config.author,
+            'Environment: ' + Config.environment.to_s,
+            'Root: ' + Config.root.to_s,
+            'Config File: ' + (Config.config_file if File.exist?(Config.config_file)).to_s,
+            'Params: ' + params.inspect,
+            'Cache Timeout: ' + Config.cache_timeout.to_s,
+            { AppConfig: Config.options },
+            { 'Sinatra Info' => env }
+          ].compact
+        )
+      end
+    end
+
+    get '/state' do
+      content_type 'application/json'
+      State.state.to_json
+    end
+
+    ########################
+    # =>    JSON API    <= #
+    ########################
+
+    namespace '/github/v1' do # rubocop: disable BlockLength
+      # => Define our common namespace parameters
+      before do
+        # => This is a JSON API
+        content_type 'application/json'
+
+        # => Make the Params Globally Accessible
+        Config.define_setting :query_params, params
+
+        # => Parameter Overrides
+        Github.configure do |cfg|
+          cfg.oauth_token = params['gh_oauth_token'] || Config.github_oauth_token
+        end
+      end
+
+      # => Clean Up
+      after do
+        # => Reset the API Client to Default Values
+        # => Notifier.reset!
+      end
+
+      # => Get Organization Repo List
+      get '/repos/org/:org' do |org|
+        ghresponse = Git.repos.list(org: org, per_page: 100)
+        etag ghresponse.headers.etag
+        body Util.serialize(ghresponse)
+      end
+
+      # => Get User Repo List
+      get '/repos/user/:user' do |user|
+        ghresponse = Git.repos.list(user: user, per_page: 100)
+        etag ghresponse.headers.etag
+        body Util.serialize(ghresponse)
+      end
+
+      # => Get Branch/Tag Names
+      get '/revisions/:user/:repo' do |user, repo|
+        branches = Git.repos.branches(user: user, repo: repo, per_page: 100)
+        tags = Git.repos.tags(user: user, repo: repo, per_page: 100)
+        body Util.serialize_revisions(branches, tags)
+      end
+
+      # => Compare Branch/Tags
+      get '/compare/:user/:repo' do |user, repo|
+        # => Check Parameters - Default to Master
+        refs = [
+          { 'target' => params['ref1'] || 'master' },
+          { 'target' => params['ref2'] || 'master' }
+        ]
+
+        begin
+          refs.each do |ref|
+            # => Pull the SHA
+            ref['sha'] = ghclient.git_data.trees.get(user, repo, ref['target']).first[1]
+          end
+
+          if refs[0]['sha'] == refs[1]['sha']
+            return "ref1(#{user}/#{repo}/#{refs[0]['target']}) is the same as ref2(#{user}/#{repo}/#{refs[1]['target']})".to_json
+          else
+            status 500 unless params['errorok'] == '1'
+            return "ALERT!!! - ref1(#{user}/#{repo}/#{refs[0]['target']}) is different than ref2(#{user}/#{repo}/#{refs[1]['target']})".to_json
+          end
+
+        # => Catch any GitHub Errors
+        rescue Github::Error::GithubError => e
+          status 500 unless params['errorok'] == '1'
+          e.message.to_json
+        end
+      end
+    end
+  end
+end

data/lib/github-rundeck/cli.rb

@@ -0,0 +1,85 @@
+# Encoding: UTF-8
+# rubocop: disable LineLength
+#
+# Gem Name:: github-rundeck
+# GithubRunDeck:: CLI
+#
+# Copyright (C) 2017 Brian Dwyer - Intelligent Digital Services
+#
+# All rights reserved - Do Not Redistribute
+#
+
+require 'mixlib/cli'
+require 'github-rundeck/config'
+require 'github-rundeck/util'
+
+module GithubRunDeck
+  #
+  # => GitHub-RunDeck Launcher
+  #
+  module CLI
+    module_function
+
+    #
+    # => Options Parser
+    #
+    class Options
+      # => Mix-In the CLI Option Parser
+      include Mixlib::CLI
+
+      option :github_oauth_token,
+             short: '-g TOKEN',
+             long: '--github-oauth-token TOKEN',
+             description: 'OAuth Token to use for querying GitHub'
+
+      option :cache_timeout,
+             short: '-t CACHE_TIMEOUT',
+             long: '--timeout CACHE_TIMEOUT',
+             description: 'Sets the cache timeout in seconds for API query response data.'
+
+      option :config_file,
+             short: '-c CONFIG',
+             long: '--config CONFIG',
+             description: 'The configuration file to use, as opposed to command-line parameters (optional)'
+
+      option :bind,
+             short: '-b HOST',
+             long: '--bind HOST',
+             description: "Listen on Interface or IP (Default: #{Config.bind})"
+
+      option :port,
+             short: '-p PORT',
+             long: '--port PORT',
+             description: "The port to run on. (Default: #{Config.port})"
+
+      option :environment,
+             short: '-e ENV',
+             long: '--env ENV',
+             description: "Sets the environment for deploy-info to execute under. Use 'development' for more logging. (Default: #{Config.environment})"
+    end
+
+    def configure(argv = ARGV)
+      # => Parse CLI Configuration
+      cli = Options.new
+      cli.parse_options(argv)
+
+      # => Parse JSON Config File (If Specified & Exists)
+      json_config = Util.parse_json(cli.config[:config_file] || Config.config_file)
+
+      # => Merge Configuration (CLI Wins)
+      config = [json_config, cli.config].compact.reduce(:merge)
+
+      # => Apply Configuration
+      config.each { |k, v| Config.send("#{k}=", v) }
+    end
+
+    # => Launch the Application
+    def run(argv = ARGV)
+      # => Parse the Params
+      configure(argv)
+
+      # => Launch the API
+      API.run!
+    end
+  end
+end

data/lib/github-rundeck/config.rb

@@ -0,0 +1,78 @@
+# Encoding: UTF-8
+#
+# Gem Name:: github-rundeck
+# GithubRunDeck:: Config
+#
+# Copyright (C) 2017 Brian Dwyer - Intelligent Digital Services
+#
+# All rights reserved - Do Not Redistribute
+#
+
+require 'github-rundeck/helpers/configuration'
+require 'pathname'
+
+module GithubRunDeck
+  # => This is the Configuration module.
+  module Config
+    module_function
+
+    extend Configuration
+
+    # => Gem Root Directory
+    define_setting :root, Pathname.new(File.expand_path('../../../', __FILE__))
+
+    # => My Name
+    define_setting :author, 'Brian Dwyer - Intelligent Digital Services'
+
+    # => Application Environment
+    define_setting :environment, :production
+
+    # => Sinatra Configuration
+    define_setting :port, '9123'
+    define_setting :bind, 'localhost'
+    define_setting :cache_timeout, 30
+
+    # => Config File
+    define_setting :config_file, File.join(root, 'config', 'config.json')
+
+    #
+    # => API Configuration
+    #
+    # => Github OAuth Token
+    define_setting :github_oauth_token
+
+    #
+    # => Facilitate Dynamic Addition of Configuration Values
+    #
+    # => @return [class_variable]
+    #
+    def add(config = {})
+      config.each do |key, value|
+        define_setting key.to_sym, value
+      end
+    end
+
+    #
+    # => Facilitate Dynamic Removal of Configuration Values
+    #
+    # => @return nil
+    #
+    def clear(config)
+      Array(config).each do |setting|
+        delete_setting setting
+      end
+    end
+
+    #
+    # => List the Configurable Keys as a Hash
+    #
+    # @return [Hash]
+    #
+    def options
+      map = Config.class_variables.map do |key|
+        [key.to_s.tr('@', '').to_sym, class_variable_get(:"#{key}")]
+      end
+      Hash[map]
+    end
+  end
+end

data/lib/github-rundeck/git.rb

@@ -0,0 +1,51 @@
+# Encoding: UTF-8
+# rubocop: disable LineLength
+#
+# Gem Name:: github-rundeck
+# GithubRunDeck:: Git
+#
+# Copyright (C) 2017 Brian Dwyer - Intelligent Digital Services
+#
+# All rights reserved - Do Not Redistribute
+#
+
+require 'github-rundeck/config'
+require 'github_api'
+
+module GithubRunDeck
+  # => This is the Git Module. It interacts with Git resources.
+  module Git
+    extend self
+
+    def ghclient
+      # => Instantiate a new GitHub Client
+      Github::Client.new
+    end
+
+    def repos
+      ghclient.repos
+    end
+
+    def tags
+      ghclient.tags
+    end
+
+    def revision # rubocop: disable AbcSize
+      # => Grab the Supplied Revision
+      rev = Config.query_params['revision'] || return
+      return rev unless Config.query_params['gh_repo']
+
+      # => Break down the Params
+      org, repo = Config.query_params['gh_repo'].split('/').map { |r| String(r) }
+      return rev unless org && repo
+
+      begin
+        # => Pull the Shorthand SHA
+        ghclient.git_data.trees.get(org, repo, rev).first[1][0, 7]
+      rescue Github::Error::NotFound
+        # => Return the Supplied Revision if Github Borks
+        rev
+      end
+    end
+  end
+end

data/lib/github-rundeck/helpers/configuration.rb

@@ -0,0 +1,57 @@
+# Encoding: UTF-8
+#
+# Gem Name:: github-rundeck
+# Helper:: Configuration
+#
+# Author: Eli Fatsi - https://www.viget.com/articles/easy-gem-configuration-variables-with-defaults
+# Contributor: Brian Dwyer - Intelligent Digital Services
+#
+
+# => Configuration Helper Module
+module Configuration
+  #
+  # => Provides a method to configure an Application
+  # => Example:
+  #      DeployInfo::Config.setup do |cfg|
+  #        cfg.config_file = 'abc.json'
+  #        cfg.app_name = 'GemBase'
+  #      end
+  #
+  def setup
+    yield self
+  end
+
+  def define_setting(name, default = nil)
+    class_variable_set("@@#{name}", default)
+
+    define_class_method "#{name}=" do |value|
+      class_variable_set("@@#{name}", value)
+    end
+
+    define_class_method name do
+      class_variable_get("@@#{name}")
+    end
+  end
+
+  def delete_setting(name)
+    remove_class_variable("@@#{name}")
+
+    delete_class_method(name)
+  rescue NameError # => Handle Non-Existent Settings
+    return
+  end
+
+  private
+
+  def define_class_method(name, &block)
+    (class << self; self; end).instance_eval do
+      define_method name, &block
+    end
+  end
+
+  def delete_class_method(name)
+    (class << self; self; end).instance_eval do
+      undef_method name
+    end
+  end
+end

data/lib/github-rundeck/util.rb

@@ -0,0 +1,64 @@
+# Encoding: UTF-8
+# rubocop: disable LineLength
+#
+# Gem Name:: github-rundeck
+# GithubRunDeck:: Util
+#
+# Copyright (C) 2017 Brian Dwyer - Intelligent Digital Services
+#
+# All rights reserved - Do Not Redistribute
+#
+
+require 'json'
+
+module GithubRunDeck
+  # => Utility Methods
+  module Util
+    extend self
+
+    ########################
+    # =>    File I/O    <= #
+    ########################
+
+    # => Define JSON Parser
+    def parse_json(file = nil, symbolize = true)
+      return unless file && ::File.exist?(file.to_s)
+      begin
+        ::JSON.parse(::File.read(file.to_s), symbolize_names: symbolize)
+      rescue JSON::ParserError
+        return
+      end
+    end
+
+    # => Define JSON Writer
+    def write_json(file, object)
+      return unless file && object
+      begin
+        File.open(file, 'w') { |f| f.write(JSON.pretty_generate(object)) }
+      end
+    end
+
+    #############################
+    # =>    Serialization    <= #
+    #############################
+
+    def serialize(response)
+      # => Serialize Object into JSON Array
+      JSON.pretty_generate(response.map(&:name).sort_by(&:downcase))
+    end
+
+    def serialize_csv(csv)
+      # => Serialize a CSV String into an Array
+      return unless csv && csv.is_a?(String)
+      csv.split(',')
+    end
+
+    def serialize_revisions(branches, tags)
+      # => Serialize Branches/Tags into JSON Array
+      # => Branches = String, Tags = Key/Value
+      branches = branches.map(&:name).sort_by(&:downcase)
+      tags = tags.map(&:name).sort_by(&:downcase).reverse.map { |tag| { name: "Tag: #{tag}", value: tag } }
+      JSON.pretty_generate(branches + tags)
+    end
+  end
+end

data/lib/github-rundeck/version.rb

@@ -0,0 +1,3 @@
+module GithubRunDeck
+  VERSION = '0.1.3'.freeze
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: github-rundeck
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Brian Dwyer
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-08-08 00:00:00.000000000 Z
+date: 2017-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: github_api
@@ -154,10 +154,17 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
-- config.json
+- config/config.json
 - exe/github-rundeck
 - github-rundeck.gemspec
 - lib/github-rundeck.rb
+- lib/github-rundeck/api.rb
+- lib/github-rundeck/cli.rb
+- lib/github-rundeck/config.rb
+- lib/github-rundeck/git.rb
+- lib/github-rundeck/helpers/configuration.rb
+- lib/github-rundeck/util.rb
+- lib/github-rundeck/version.rb
 homepage: https://github.com/bdwyertech/github-rundeck
 licenses:
 - MIT
@@ -179,7 +186,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.6
+rubygems_version: 2.6.12
 signing_key: 
 specification_version: 4
 summary: Github Options Provider for RunDeck