voltron-defender 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e7cf7bed8a5c60c7cc41aa090e7f454a08b2617c
+  data.tar.gz: b06dd07931a378149bf1c4db962c7f2382d871c6
+SHA512:
+  metadata.gz: acaa9c19c64a89f11bdec77c0c0035c0454aaefc64b750257a2592a80fb6dcc2438e9160907f1ebfaf85efe833be151fed71a056ecfbf5eca66b904b20aee9cd
+  data.tar.gz: b02a90da721bc4db78a9ad1d55152e82066de8f057e607ecba73cfd2346312ead925f8b1289df3c38219d388942d0a3f83df2433de1b519d09c306ec313f0000

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.12.5

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+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.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at eric.hainer@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+source 'https://gem.minow.io'
+
+# Specify your gem's dependencies in voltron-rack.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Eric Hainer
+
+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 @@
+# Voltron::Rack
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/voltron/rack`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'voltron-rack'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install voltron-rack
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. 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).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/voltron-rack. 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](http://opensource.org/licenses/MIT).
+

data/Rakefile

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

data/app/models/voltron/defender/error.rb

@@ -0,0 +1,29 @@
+module Voltron
+  class Defender
+    class Error < ActiveRecord::Base
+
+      self.table_name = 'voltron_defender_errors'
+
+      def name
+        "Exception ##{id}"
+      end
+
+      def message
+        output = []
+        output << "*Message:* #{::Slack::Messages::Formatting.unescape(error)}"
+        output << "*File:* #{::Slack::Messages::Formatting.unescape(file)}"
+        output << "*Line:* #{::Slack::Messages::Formatting.unescape(line)}"
+        output.join("\n")
+      end
+
+      def http_headers
+        JSON.parse(headers) rescue {}
+      end
+
+      def in_trello?
+        status == 'trello'
+      end
+
+    end
+  end
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "voltron/rack"
+
+# 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/generators/templates/db/migrate/create_voltron_defender_errors.rb

@@ -0,0 +1,14 @@
+class CreateVoltronDefenderErrors < ActiveRecord::Migration
+  def change
+    create_table :voltron_defender_errors do |t|
+      t.string :status
+      t.string :error
+      t.string :file
+      t.string :line
+      t.text :trace
+      t.text :headers
+
+      t.timestamps null: false
+    end
+  end
+end

data/lib/generators/voltron/defender/install_generator.rb

@@ -0,0 +1,92 @@
+module Voltron
+  class Defender
+    module Generators
+      class InstallGenerator < Rails::Generators::Base
+
+        source_root File.expand_path("../../../templates", __FILE__)
+
+        desc "Add Voltron Defender initializer"
+
+        def inject_initializer
+
+          voltron_initialzer_path = Rails.root.join('config', 'initializers', 'voltron.rb')
+
+          unless File.exist? voltron_initialzer_path
+            unless system("cd #{Rails.root.to_s} && rails generate voltron:install")
+              puts "Voltron initializer does not exist. Please ensure you have the 'voltron' gem installed and run `rails g voltron:install` to create it"
+              return false
+            end
+          end
+
+          current_initiailzer = File.read voltron_initialzer_path
+
+          unless current_initiailzer.match(Regexp.new(/# === Voltron Defender Configuration ===/))
+            inject_into_file(voltron_initialzer_path, after: "Voltron.setup do |config|\n") do
+<<-CONTENT
+
+  # === Voltron Defender Configuration ===
+
+  # Whether or not to enable Slack/Trello integration
+  # IP restricted detailed error pages are not affected by this setting
+  config.defender.enabled = false
+
+  # Slack API token
+  config.defender.slack_api_token = ''
+
+  # The Slack channel name in which to report exceptions
+  config.defender.slack_channel = ''
+
+  # Trello API key
+  config.defender.trello_key = ''
+
+  # Trello API token
+  config.defender.trello_token = ''
+
+  # Whether or not to allow showing error details based on IP address
+  # If false, the value of Rails.application.config.consider_all_requests_local
+  # and the corresponding behavior will always be respected
+  config.defender.ip_restrict_errors = true
+
+  # An array of IP addresses or Regexp objects to compare to the REMOTE_ADDR
+  # value to determine whether or not to show detailed error messages
+  config.defender.ips = []
+CONTENT
+            end
+          end
+        end
+
+        def copy_migrations
+          copy_migration "create_voltron_defender_errors"
+        end
+
+        protected
+
+          def copy_migration(filename)
+            if migration_exists?(Rails.root.join("db", "migrate"), filename)
+              say_status("skipped", "Migration #{filename}.rb already exists")
+            else
+              copy_file "db/migrate/#{filename}.rb", Rails.root.join("db", "migrate", "#{migration_number}_#{filename}.rb")
+            end
+          end
+
+          def migration_exists?(dirname, filename)
+            Dir.glob("#{dirname}/[0-9]*_*.rb").grep(/\d+_#{filename}.rb$/).first
+          end
+
+          def migration_id_exists?(dirname, id)
+            Dir.glob("#{dirname}/#{id}*").length > 0
+          end
+
+          def migration_number
+            @migration_number ||= Time.now.strftime("%Y%m%d%H%M%S").to_i
+
+            while migration_id_exists?(Rails.root.join("db", "migrate"), @migration_number) do
+              @migration_number += 1
+            end
+
+            @migration_number
+          end
+      end
+    end
+  end
+end

data/lib/voltron/config/defender.rb

@@ -0,0 +1,40 @@
+module Voltron
+  class Config
+
+    def defender
+      @defender ||= Defender.new
+    end
+
+    class Defender
+
+      attr_accessor :enabled, :slack_api_token, :slack_channel, :trello_key, :trello_token, :trello_board, :ip_restrict_errors, :ips
+
+      def initialize
+        @enabled ||= false
+        @ip_restrict_errors ||= true
+        @ips ||= []
+      end
+
+      def enabled?
+        enabled == true
+      end
+
+      def has_ip?(ip)
+        return false if ip.blank?
+
+        candidates = [ips].flatten.compact
+        
+        candidates.each do |candidate|
+          if candidate.is_a?(Regexp)
+            return true if candidate =~ ip.to_s
+          else
+            return true if candidate.to_s == ip.to_s
+          end
+        end
+
+        false
+      end
+
+    end
+  end
+end

data/lib/voltron/defender.rb

@@ -0,0 +1,70 @@
+require 'voltron'
+require 'tempfile'
+require 'voltron/defender/version'
+require 'voltron/config/defender'
+require 'voltron/defender/slack_adapter'
+require 'voltron/defender/trello_adapter'
+require 'voltron/defender/commands/when'
+require 'voltron/defender/commands/trace'
+require 'voltron/defender/commands/http'
+require 'voltron/defender/commands/trello'
+require 'voltron/defender/commands/help'
+require 'voltron/defender/commands/stop'
+require 'voltron/defender/commands/defender'
+
+module Voltron
+  class Defender
+
+    def initialize(app)
+      @app = app
+
+      @slack = ::Voltron::Defender::SlackAdapter.new
+
+      @slack.commander.listen_to(::Voltron::Defender::When)
+      @slack.commander.listen_to(::Voltron::Defender::Trace)
+      @slack.commander.listen_to(::Voltron::Defender::Http)
+      @slack.commander.listen_to(::Voltron::Defender::Trello)
+      @slack.commander.listen_to(::Voltron::Defender::Stop)
+      @slack.commander.listen_to(::Voltron::Defender::Help)
+      @slack.commander.listen_to(::Voltron::Defender::Defender)
+    end
+
+    def call(env)
+      begin
+        @app.call(env)
+      rescue Exception => e
+        if Voltron.config.defender.enabled?
+          error = Voltron::Defender::Error.new(exception_params(e, env))
+          handle(error) if error.save
+        end
+
+        if Voltron.config.defender.ip_restrict_errors
+          if Voltron.config.defender.has_ip?(env.try(:[], 'REMOTE_ADDR'))
+            env['action_dispatch.show_detailed_exceptions'] = true
+          end
+        end
+        raise e
+      end
+    end
+
+    def handle(error)
+      @slack.client.start_async unless @slack.client.started?
+
+      if @slack.client.started?
+        @slack.attach(error.name, error.message, :danger)
+      end
+    end
+
+    private
+
+      def exception_params(ex, env)
+        last_line = (ex.backtrace.first || 'Unknown:Unknown').split(':')
+        headers = (env ||= {}).select { |k,v| /^[A-Z_]+$/.match(k.to_s) }
+
+        { error: ex.message, file: last_line[0], line: last_line[1], trace: ex.backtrace.join("\n"), headers: headers.to_json }
+      end
+
+  end
+end
+
+require "voltron/defender/engine" if defined?(Rails)

data/lib/voltron/defender/command.rb

@@ -0,0 +1,47 @@
+module Voltron
+  class Defender
+    class Command
+
+      attr_accessor :input
+
+      def parse(text)
+        text.downcase!
+        @input = /^\.(?<command>[a-z]+)\s*(?<id>[0-9]+)*\s*(?<args>.*)/.match(text) || {}
+      end
+
+      def matches?(text)
+        parse(text)
+        Array.wrap(responds_to).include?(command)
+      end
+
+      def error
+        if ::Voltron::Defender::Error.exists?(id)
+          ::Voltron::Defender::Error.find(id)
+        elsif ::Voltron::Defender::Error.count > 0
+          ::Voltron::Defender::Error.last
+        else
+          false
+        end
+      end
+
+      def command
+        @input[:command].to_s
+      end
+
+      def id
+        @input[:id].to_i
+      end
+
+      def args
+        @input[:args].to_s.split(/\s+/)
+      end
+
+      def answer(text, adapter)
+      end
+
+      def help
+      end
+
+    end
+  end
+end

data/lib/voltron/defender/commander.rb

@@ -0,0 +1,29 @@
+module Voltron
+  class Defender
+    class Commander
+
+      def initialize
+        @listeners = []
+      end
+
+      def matches?(text)
+        processor(text).present?
+      end
+
+      def processor(text)
+        @listeners.find do |listener|
+          listener.matches?(text)
+        end
+      end
+
+      def listeners
+        @listeners || []
+      end
+
+      def listen_to(klass)
+        @listeners << klass.new
+      end
+
+    end
+  end
+end

data/lib/voltron/defender/commands/defender.rb

@@ -0,0 +1,18 @@
+require 'voltron/defender/command'
+
+module Voltron
+  class Defender
+    class Defender < Command
+
+      def responds_to
+        ['defender']
+      end
+
+      def respond_with(adapter)
+        output = "MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMNdMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMdNMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMm+.-MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM..+mMMMMMMMMMMMMM\nMMMMMMMMMMMMm`---MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM.--`mMMMMMMMMMMMM\nMMMMMMMMMMMMh ...mMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMm`.. hMMMMMMMMMMMM\nMMMMMMMMMMMM:.--`sMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMo`--.:MMMMMMMMMMMM\nMMMMMMMMMMMM:.--.oMMMMMMmhhhhhhhho/ooooo/ohhhhhhhhmMMMMMMo.--.:MMMMMMMMMMMM\nMMMMMMMMMMMM:.--.oMMMMMy.--------.:MMMMM-.--------.oNMMMMo.--.:MMMMMMMMMMMM\nMMMMMMMMMMMM:.---.odmd/..::::::::-yNNNNNy-::::::::..:dmdo.---.:MMMMMMMMMMMM\nMMMMMMMMMMMMh:.-------..sNNNNNNNNNMhhhhhNNNNNNNNNNh-.-------.:hMMMMMMMMMMMM\nMMMMMMMMMMMMMNd/..---.-dMMMMMMMMMMNyyyyymMMMMMMMMMMN/.---..+dNMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMm+`-.:NMMMMMMMMMMMmhhhhhdMMMMMMMMMMMMo`-`/mMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMm`--./MMMsydmNNMMMMNNNNNMMMMNNmmhomMMh`--`yMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMM/.:smMMMh+/+++odMMMMMMMMMMoo++/+oMMMNh/..NMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMM.hNMMMMMMNmdhyshMMMMMMMMMNosyhdmNMMMMMMm-dMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMM-dMNmMMmddhhysooMMMMMMMMMdosyhhddmMMdmMM`NMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMM/yNooMM+`       mMMMMMMMM+      `+MMoodN`MMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMooNoodMm-`      ymdNMNmdM-     `-NMmoomd-MMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMy:Mo+sMMNho+/:-.smhhhhyhM--:/+oo/mMh++my/MMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMm.MsoomMMN...-:/+yhmmmdyo/:-.`` .MMsooMooMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMM`Ny++hMMMo       `:No.        `oMN++oM:yMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMs/msooNyMdo/:-...shdhh:`..-:+odyMyooms/NMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMy/dsodyyymooooohNdhhmNooooohydoNooho+NMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMh:msoN-mMMhysomMh//smssyyydM:msom++MMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMh:dsdo-NMy/+omMy ./ho+/+NMs:msh+oMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMdoss-`/md//+yMy .oy///dNs`.+ssyMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMs..`ydymMMdoss////h-`--NMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMM:-``dMMMNdhyyss/s: :`dMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMm`:`.hmMh///+yh+o --+MMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMMs.:  -/`    .:` .:-NMMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMMM:::::`      -::/`dMMMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMMMNs/-:`-::::..:-+hMMMMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMNhyyyyyyyydMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM\nMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM"
+        adapter.message("```#{output.gsub('`', '\'')}```")
+      end
+
+    end
+  end
+end

data/lib/voltron/defender/commands/help.rb

@@ -0,0 +1,23 @@
+require 'voltron/defender/command'
+
+module Voltron
+  class Defender
+    class Help < Command
+
+      def help
+        "# Get a list of all commands I understand\n.help\n"
+      end
+
+      def responds_to
+        ['help']
+      end
+
+      def respond_with(adapter)
+        output = []
+        adapter.commander.listeners.each { |l| output << l.help }
+        adapter.message("Here are all the commands I'll respond to. Anything in `[]` is considered an optional argument. ```#{output.compact.join("\n")}```")
+      end
+
+    end
+  end
+end

data/lib/voltron/defender/commands/http.rb

@@ -0,0 +1,47 @@
+require 'voltron/defender/command'
+
+module Voltron
+  class Defender
+    class Http < Command
+
+      def help
+        "# Fetch specific HTTP headers, or all headers if no header names are provided\n.http|.head|.header|.headers [id] [header name] [header name] ...\n"
+      end
+
+      def responds_to
+        ['http', 'head', 'header', 'headers']
+      end
+
+      def respond_with(adapter)
+        if error
+          if args.length > 0
+            found = []
+            missing = []
+            headers = error.http_headers
+            args.each do |arg|
+              if headers.has_key?(arg.upcase)
+                found << "#{arg.upcase}: #{headers[arg.upcase].to_s.gsub('%', '%%')}"
+              else
+                missing << arg.upcase
+              end
+            end
+
+            if found.length > 0 && missing.length == 0
+              adapter.message("Here's what I found ```#{found.join("\n")}```")
+            elsif found.length > 0 && missing.length > 0
+              adapter.message("Below are the HTTP headers I managed to find. I wasn't able to find headers with the name `#{missing.to_sentence(words_connector: '`, `', two_words_connector: '` or `', last_word_connector: '`, or `')}` ```#{found.join("\n")}```")
+            elsif found.length == 0 && missing.length > 0
+              adapter.message("I couldn't find HTTP headers matching `#{missing.to_sentence(words_connector: '`, `', two_words_connector: '` or `', last_word_connector: '`, or `')}`")
+            end
+          else
+            output = error.http_headers.map { |k,v| "#{k}: #{v.to_s.gsub('%', '%%')}" }.join("\n")
+            adapter.message("Here's all the headers that were present when #{error.name.downcase} happened ```#{output}```")
+          end
+        else
+          adapter.message('Sorry, I wasn\'t able to find any exception to provide information on. Try specifying an exception id, like `.<command> <id>`')
+        end
+      end
+
+    end
+  end
+end

data/lib/voltron/defender/commands/stop.rb

@@ -0,0 +1,23 @@
+require 'voltron/defender/command'
+
+module Voltron
+  class Defender
+    class Stop < Command
+
+      def help
+        "# Stop and close the connection. It will be restarted if/when another exception occurs\n.stop|.close|.end|.disconnect\n"
+      end
+
+      def responds_to
+        ['stop', 'close', 'end', 'disconnect']
+      end
+
+      def respond_with(adapter)
+        if adapter.client.started?
+          adapter.client.stop!
+        end
+      end
+
+    end
+  end
+end

data/lib/voltron/defender/commands/trace.rb

@@ -0,0 +1,25 @@
+require 'voltron/defender/command'
+
+module Voltron
+  class Defender
+    class Trace < Command
+
+      def help
+        "# Retrieve the stack trace for the most recent exception id, or the specific exception if an id is provided\n.trace|.backtrace|.stack|.stacktrace [id]\n"
+      end
+
+      def responds_to
+        ['trace', 'backtrace', 'stack', 'stacktrace']
+      end
+
+      def respond_with(adapter)
+        if error
+          adapter.upload("Stack Trace ##{error.id}", "Here's the stack trace for #{error.name.downcase}", error.trace)
+        else
+          adapter.message('Sorry, I wasn\'t able to find any exception to provide information on. Try specifying an exception id, like `.<command> <id>`')
+        end
+      end
+
+    end
+  end
+end

data/lib/voltron/defender/commands/trello.rb

@@ -0,0 +1,74 @@
+require 'voltron/defender/command'
+
+module Voltron
+  class Defender
+    class Trello < Command
+
+      def help
+        "# Create a Trello card for the most recent exception, or the specific exception if an id is provided\n.trello [id] [lane]\n"
+      end
+
+      def answer(text, adapter)
+        adapter.message('One second, I\'m working on it...')
+        lane, is_new = find_or_create_lane(text)
+        card = add_card(lane)
+        if is_new
+          adapter.message("Okay, I created the lane `#{lane.name}` and added the card for #{error.name.downcase} to it. #{card.short_url}")
+        else
+          adapter.message("Okay, I've added the card for #{error.name.downcase} to the `#{lane.name}` lane. #{card.short_url}")
+        end
+      end
+
+      def responds_to
+        ['trello']
+      end
+
+      def add_card(lane)
+        File.open("trace-#{error.id}.log", 'w+') { |f| f.write(error.trace) }
+        File.open("headers-#{error.id}.log", 'w+') { |f| error.http_headers.each { |h,v| f.write("#{h}: #{v}\n") } }
+        
+        card = ::Trello::Card.create(name: error.name, desc: error.error, list_id: lane.id)
+        card.add_attachment(File.open("trace-#{error.id}.log", 'r'), 'Stack Trace')
+        card.add_attachment(File.open("headers-#{error.id}.log", 'r'), 'HTTP Headers')
+
+        error.update(status: :trello)
+        card
+      end
+
+      def find_or_create_lane(name)
+        lane = trello.lane(name)
+        if lane.blank?
+          lane = ::Trello::List.create(name: name, board_id: trello.board.id)
+          [lane, true]
+        else
+          [lane, false]
+        end
+      end
+
+      def respond_with(adapter)
+        if error
+          if error.in_trello? && !args.include?('-f')
+            adapter.message("My records indicate that a card for #{error.name.downcase} was already created. If you want to create it anyways, use `.trello #{error.id} #{args.length > 0 ? args.join(' ') + ' ' : ''}-f`")
+          else
+            params = args.reject { |a| a == '-f' }
+            if params.length > 0
+              answer(params.join(' '), adapter)
+            else
+              adapter.message('One second, I\'m getting a list of Trello lanes...')
+              adapter.ask("What lane should I add the card to? If you specify something not in this list I'll create it for you. ```#{trello.lanes.join("\n")}```", self)
+            end
+          end
+        else
+          adapter.message('Sorry, I wasn\'t able to find any exception to provide information on. Try specifying an exception id, like `.<command> <id>`')
+        end
+      end
+
+      private
+
+        def trello
+          @trello ||= ::Voltron::Defender::TrelloAdapter.new
+        end
+
+    end
+  end
+end

data/lib/voltron/defender/commands/when.rb

@@ -0,0 +1,27 @@
+require 'voltron/defender/command'
+
+module Voltron
+  class Defender
+    class When < Command
+
+      include ::ActionView::Helpers::DateHelper
+
+      def help
+        "# Find out when the most recent exception occurred, or a specific exception if an id is given\n.when|.time [id]\n"
+      end
+
+      def responds_to
+        ['when', 'time']
+      end
+
+      def respond_with(adapter)
+        if error
+          adapter.message("#{error.name} happened #{distance_of_time_in_words(Time.now, error.created_at)} ago")
+        else
+          adapter.message('Sorry, I wasn\'t able to find any exception to provide information on. Try specifying an exception id, like `.<command> <id>`')
+        end
+      end
+
+    end
+  end
+end

data/lib/voltron/defender/engine.rb

@@ -0,0 +1,9 @@
+module Voltron
+  class Defender
+    class Engine < Rails::Engine
+
+      isolate_namespace Voltron
+
+    end
+  end
+end

data/lib/voltron/defender/slack_adapter.rb

@@ -0,0 +1,83 @@
+require 'slack'
+require 'voltron/defender/commander'
+
+module Voltron
+  class Defender
+    class SlackAdapter
+
+      attr_accessor :questioned, :asker
+
+      def initialize
+        client.on(:message) { |message| message_received(message) }
+        client.on(:close) { socket_closed }
+      end
+
+      def message_received(message)
+        # The bot is the user that posted the message, ignore whatever it said
+        return if client.self.id == message.user
+
+        nvm if is_command?(message.text)
+
+        if waiting?
+          client.typing channel: channel
+          asker.answer(message.text, self)
+          nvm
+        elsif commander.matches?(message.text)
+          client.typing channel: channel
+          commander.processor(message.text).respond_with(self)
+        end
+      end
+
+      def socket_closed
+        message "Connection has been closed, I'm no longer listening for commands"
+      end
+
+      def ask(question, asker, **args)
+        @questioned = true
+        @asker = asker
+        message(question, args)
+      end
+
+      def nvm
+        @questioned = false
+        @asker = nil
+      end
+
+      def attach(title=nil, text=nil, color=nil, **args)
+        payload = { pretext: title, color: color, text: text, mrkdwn_in: ['text', 'pretext'] }.compact.merge(args)
+        client.web_client.chat_postMessage channel: channel, attachments: [payload].to_json, as_user: true
+      end
+
+      def message(text, **args)
+        client.web_client.chat_postMessage channel: channel, text: (text % args), mrkdwn: true, as_user: true
+      end
+
+      def upload(name, title, content)
+        client.web_client.files_upload channels: channel, filename: name, title: title, content: content, as_user: true
+      end
+
+      def commander
+        @commander ||= ::Voltron::Defender::Commander.new
+      end
+
+      def waiting?
+        questioned == true
+      end
+
+      def is_command?(text)
+        text.to_s.strip.starts_with?('.')
+      end
+
+      def client
+        @client ||= ::Slack::RealTime::Client.new(token: Voltron.config.defender.slack_api_token, timeout: 10, open_timeout: 15)
+      end
+
+      private
+
+        def channel
+          '#' + Voltron.config.defender.slack_channel.to_s.gsub(/[^a-z0-9\-]/i, '')
+        end
+
+    end
+  end
+end

data/lib/voltron/defender/trello_adapter.rb

@@ -0,0 +1,32 @@
+require 'trello'
+
+module Voltron
+  class Defender
+    class TrelloAdapter
+
+      def initialize
+        ::Trello.configure do |config|
+          config.developer_public_key = Voltron.config.defender.trello_key
+          config.member_token = Voltron.config.defender.trello_token
+        end
+      end
+
+      def has_lane?(name)
+        lane.present?
+      end
+
+      def lane(name)
+        board.lists.find { |list| list.name.downcase == name.downcase }
+      end
+
+      def lanes
+        board.lists.map(&:name)
+      end
+
+      def board
+        @board ||= ::Trello::Board.find(Voltron.config.defender.trello_board)
+      end
+
+    end
+  end
+end

data/lib/voltron/defender/version.rb

@@ -0,0 +1,5 @@
+module Voltron
+  class Defender
+    VERSION = '0.1.0'.freeze
+  end
+end

data/voltron-defender.gemspec

@@ -0,0 +1,37 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'voltron/defender/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'voltron-defender'
+  spec.version       = Voltron::Defender::VERSION
+  spec.authors       = ['Eric Hainer']
+  spec.email         = ['eric@commercekitchen.com']
+
+  spec.summary       = %q{Catch exceptions and report them to Slack}
+  spec.homepage      = 'https://github.com/ehainer/voltron-defender'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'rails', '>= 4.2'
+  spec.add_dependency 'rack', '>= 1.6'
+  spec.add_dependency 'slack-ruby-client', '~> 0.8'
+  spec.add_dependency 'voltron', '>= 0.2.0'
+  spec.add_dependency 'eventmachine', '~> 1.2'
+  spec.add_dependency 'faye-websocket', '~> 0.10.7'
+  spec.add_dependency 'ruby-trello', '~> 2.0'
+
+  spec.add_development_dependency 'byebug'
+  spec.add_development_dependency 'simplecov', '0.11.0'
+  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rspec-rails', '>= 3.4'
+  spec.add_development_dependency 'sqlite3', '>= 1.2'
+
+end

metadata

@@ -0,0 +1,269 @@
+--- !ruby/object:Gem::Specification
+name: voltron-defender
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Eric Hainer
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-11-03 00:00:00.000000000 Z
+dependencies:
+- !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: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: slack-ruby-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: voltron
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: faye-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.7
+- !ruby/object:Gem::Dependency
+  name: ruby-trello
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  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: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: 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: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+description: 
+email:
+- eric@commercekitchen.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- app/models/voltron/defender/error.rb
+- bin/console
+- bin/setup
+- lib/generators/templates/db/migrate/create_voltron_defender_errors.rb
+- lib/generators/voltron/defender/install_generator.rb
+- lib/voltron/config/defender.rb
+- lib/voltron/defender.rb
+- lib/voltron/defender/command.rb
+- lib/voltron/defender/commander.rb
+- lib/voltron/defender/commands/defender.rb
+- lib/voltron/defender/commands/help.rb
+- lib/voltron/defender/commands/http.rb
+- lib/voltron/defender/commands/stop.rb
+- lib/voltron/defender/commands/trace.rb
+- lib/voltron/defender/commands/trello.rb
+- lib/voltron/defender/commands/when.rb
+- lib/voltron/defender/engine.rb
+- lib/voltron/defender/slack_adapter.rb
+- lib/voltron/defender/trello_adapter.rb
+- lib/voltron/defender/version.rb
+- voltron-defender.gemspec
+homepage: https://github.com/ehainer/voltron-defender
+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.13
+signing_key: 
+specification_version: 4
+summary: Catch exceptions and report them to Slack
+test_files: []