lita-lbcfg 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8dc3039476b7f7c9144df73795aad96ad54f91b6
+  data.tar.gz: 0be0e424b5a064e73228b3d13568d3fb0ea6ad77
+SHA512:
+  metadata.gz: d679d7f740277385c323baa326fedec32e1f0a2be58712bb0e8c508196a43ad26b5be2f87b7f43c205c5df71ce87e5bacdcdbd7346c3d45e218bed613d7bde6b
+  data.tar.gz: e6c6eec1cff7861f5f0dfedf85fa594354871e89b220614c3f1a18d06c8bbe69404ba5fa24ea383d0046ec2804905d69cb11d158e8797d763fee0931940d8e75

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Copyright 2016 DoubleDutch, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,169 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object
+code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form,
+made available under the License, as indicated by a copyright notice that is
+included in or attached to the work (an example is provided in the Appendix
+below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative Works
+thereof, that is intentionally submitted to Licensor for inclusion in the Work
+by the copyright owner or by an individual or Legal Entity authorized to submit
+on behalf of the copyright owner. For the purposes of this definition,
+"submitted" means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems, and
+issue tracking systems that are managed by, or on behalf of, the Licensor for
+the purpose of discussing and improving the Work, but excluding communication
+that is conspicuously marked or otherwise designated in writing by the copyright
+owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License.
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the Work and such
+Derivative Works in Source or Object form.
+
+3. Grant of Patent License.
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable (except as stated in this section) patent license to make, have
+made, use, offer to sell, sell, import, and otherwise transfer the Work, where
+such license applies only to those patent claims licensable by such Contributor
+that are necessarily infringed by their Contribution(s) alone or by combination
+of their Contribution(s) with the Work to which such Contribution(s) was
+submitted. If You institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work or a
+Contribution incorporated within the Work constitutes direct or contributory
+patent infringement, then any patent licenses granted to You under this License
+for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution.
+
+You may reproduce and distribute copies of the Work or Derivative Works thereof
+in any medium, with or without modifications, and in Source or Object form,
+provided that You meet the following conditions:
+
+1. You must give any other recipients of the Work or Derivative Works a copy of
+   this License; and
+2. You must cause any modified files to carry prominent notices stating that You
+   changed the files; and
+3. You must retain, in the Source form of any Derivative Works that You
+   distribute, all copyright, patent, trademark, and attribution notices from
+   the Source form of the Work, excluding those notices that do not pertain to
+   any part of the Derivative Works; and
+4. If the Work includes a "NOTICE" text file as part of its distribution, then
+   any Derivative Works that You distribute must include a readable copy of the
+   attribution notices contained within such NOTICE file, excluding those
+   notices that do not pertain to any part of the Derivative Works, in at least
+   one of the following places: within a NOTICE text file distributed as part of
+   the Derivative Works; within the Source form or documentation, if provided
+   along with the Derivative Works; or, within a display generated by the
+   Derivative Works, if and wherever such third-party notices normally appear.
+   The contents of the NOTICE file are for informational purposes only and do
+   not modify the License. You may add Your own attribution notices within
+   Derivative Works that You distribute, alongside or as an addendum to the
+   NOTICE text from the Work, provided that such additional attribution notices
+   cannot be construed as modifying the License.
+
+You may add Your own copyright statement to Your modifications and may provide
+additional or different license terms and conditions for use, reproduction, or
+distribution of Your modifications, or for any such Derivative Works as a whole,
+provided Your use, reproduction, and distribution of the Work otherwise complies
+with the conditions stated in this License.
+
+5. Submission of Contributions.
+
+Unless You explicitly state otherwise, any Contribution intentionally submitted
+for inclusion in the Work by You to the Licensor shall be under the terms and
+conditions of this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify the terms of
+any separate license agreement you may have executed with Licensor regarding
+such Contributions.
+
+6. Trademarks.
+
+This License does not grant permission to use the trade names, trademarks,
+service marks, or product names of the Licensor, except as required for
+reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty.
+
+Unless required by applicable law or agreed to in writing, Licensor provides the
+Work (and each Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied,
+including, without limitation, any warranties or conditions of TITLE,
+NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are
+solely responsible for determining the appropriateness of using or
+redistributing the Work and assume any risks associated with Your exercise of
+permissions under this License.
+
+8. Limitation of Liability.
+
+In no event and under no legal theory, whether in tort (including negligence),
+contract, or otherwise, unless required by applicable law (such as deliberate
+and grossly negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special, incidental,
+or consequential damages of any character arising as a result of this License
+or out of the use or inability to use the Work (including but not limited to
+damages for loss of goodwill, work stoppage, computer failure or malfunction,
+or any and all other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability.
+
+While redistributing the Work or Derivative Works thereof, You may choose to
+offer, and charge a fee for, acceptance of support, warranty, indemnity, or
+other liability obligations and/or rights consistent with this License. However,
+in accepting such obligations, You may act only on Your own behalf and on Your
+sole responsibility, not on behalf of any other Contributor, and only if You
+agree to indemnify, defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason of your
+accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

data/README.md

@@ -0,0 +1 @@
+# lita-lbcfg

data/Rakefile

@@ -0,0 +1,20 @@
+# Copyright 2016 DoubleDutch, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/lita/handlers/lbcfg.rb

@@ -0,0 +1,248 @@
+# Copyright 2016 DoubleDutch, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'dd_spacecadet/error'
+require 'lita-lbcfg/loader'
+
+module Lita
+  module Handlers
+    class LBCfgErr < StandardError; end
+    class MissingKey < LBCfgErr; end
+
+    class Lbcfg < Handler
+      include LitaLBCfg::Loader
+
+      # {
+      #   '<region>' => {
+      #     '<environment>' => {
+      #       '<balancer>' => [
+      #         0,
+      #         1
+      #       ]
+      #     }
+      #   }
+      # }
+      config :lb_hash, default: {}
+      config :credentials, default: []
+
+      on :loaded, :set_up_spacecadet # from LitaLBCfg::Loader
+      on :unhandled_message, :not_found
+
+      # route for getting the status of the load balancer
+      route(
+        /^lbcfg\sstatus\s(?<region>\w+)\s(?<environment>\w+)\s(?<balancer>\w+)/,
+        :status,
+        command: true,
+        help: {
+          'lbcfg status <region> <environment> <balancer>' => 'show the current status of the balancer in the region.environment'
+        }
+      )
+
+      # route for taking actions on a load balancer
+      route(
+        /^lbcfg\s(?<action>\w+)\s(?<region>\w+)\s(?<environment>\w+)\s(?<balancer>\w+)\s(?<node>[A-Za-z0-9\-]+)/,
+        :lbcfg_router,
+        command: true,
+        help: {
+          'lbcfg enable <region> <environment> <balancer> <node>' => 'enable the backend within the load balancer',
+          'lbcfg drain <region> <environment> <balancer> <node>' => 'drain the backend within the load balancer'
+        }
+      )
+
+      # handler for command_not_found replies
+      def not_found(h)
+        return unless h[:message].command?
+
+        dest = h[:message].source
+        msg = t('not_found', body: h[:message].body)
+
+        robot.send_message(dest, msg)
+      end
+
+      # handler function for getting the status of a load balancer
+      def status(response)
+        region, environment, balancer = split_params(response)
+
+        client = new_client("#{region}-#{environment}")
+
+        # get the IDs from the config and add it to the client
+        # respond with an error if we don't recognize the user input
+
+        begin
+          balancer_ids(region, environment, balancer).each { |id| client.add_lb(id) }
+        rescue MissingKey => e
+          return response.reply(e.to_s)
+        end
+
+        # get the status of the LBs
+        # do it within a begin block so we can catch
+        # the exceptions thrown by SpaceCadet
+        begin
+          # get the details for all LBs we care about
+          details = client.status
+
+          # if we don't have any details, bail
+          return response.reply(t('status.no_details', region: region, env: environment, balancer: balancer)) if details.empty?
+
+          # otherwise, render the proper output and print it
+          response.reply(render_template('status', output: render_status(details)))
+
+        rescue DoubleDutch::SpaceCadet::Error => e # catch all SpaceCadet errors
+          title = "An error has occured trying to get the status of #{region}.#{environment}.#{balancer}:"
+          reply = render_template('exception', title: title, exception: e.class, message: e.message)
+          response.reply(reply)
+
+        rescue StandardError => e # catch all remaining errors
+          title = "A generic excpetion has been caught trying to get the status of #{region}.#{environment}.#{balancer}:"
+          reply = render_template('exception', title: title, exception: e.class, message: e.message)
+          response.reply(reply)
+        end
+      end
+
+      # router for taking !lbcfg <action> commands and calling appropriate functions
+      def lbcfg_router(response)
+        # we don't want to allow updating LBs in private
+        # so if this is a DM, return a helpful message to tell them "no"
+        return response.reply(t('general.private_message')) if is_dm?(response)
+
+        action = response.match_data['action'].downcase
+
+        # if the action is unknown, return an error message
+        return response.reply(t('router.invalid_action', action: action)) unless %w(enable drain).include?(action)
+
+        # wrap the call to the appropriation action function in a rescue block
+        # both functions would need similar rescue statements, so let's do it here
+        begin
+          # call lbcfg_<action> on this Class
+          # so if action == 'drain' it'll call lbcfg_drain
+          response.reply(send("lbcfg_#{action}".to_sym, response))
+
+        rescue DoubleDutch::SpaceCadet::Error => e # catch all SpaceCadet errors
+          title = "An error has occured trying to #{action} the requested node:"
+          reply = render_template('exception', title: title, exception: e.class, message: e.message)
+          response.reply(reply)
+
+        rescue StandardError => e # catch all remaining errors
+          title = "A generic excpetion has been caught trying to #{action} the requested node:"
+          reply = render_template('exception', title: title, exception: e.class, message: e.message)
+          response.reply(reply)
+        end
+      end
+
+      private
+
+      def new_client(env)
+        DoubleDutch::SpaceCadet::LB.new(env)
+      end
+
+      def render_status(details)
+        out = ''
+
+        # loop over each LB returned and add its formatted status
+        # to the end of the `out` string
+        details.each do |lb|
+          out << "#{lb[:name]} (#{lb[:id]})\n"
+
+          lb[:nodes].each do |node|
+            out << "  #{node[:name]}  #{node[:condition]}  #{node[:ip]}  #{node[:id]}\n"
+          end
+
+          out << "---\n"
+        end
+
+        out
+      end
+
+      def lbcfg_drain(response)
+        region, environment, balancer, node = split_long_params(response)
+
+        client = new_client("#{region}-#{environment}")
+
+        begin
+          balancer_ids(region, environment, balancer).each { |id| client.add_lb(id) }
+        rescue MissingKey => e
+          return e.to_s
+        end
+
+        response.reply(t('drain.starting_update', node: node, region: region, env: environment, balancer: balancer))
+        client.update_node(node, :draining)
+        t('general.update_done', balancer: balancer)
+      end
+
+      def lbcfg_enable(response)
+        region, environment, balancer, node = split_long_params(response)
+
+        client = new_client("#{region}-#{environment}")
+
+        begin
+          balancer_ids(region, environment, balancer).each { |id| client.add_lb(id) }
+        rescue MissingKey => e
+          return e.message
+        end
+
+        response.reply(t('enable.starting_update', node: node, region: region, env: environment, balancer: balancer))
+        client.update_node(node, :enabled)
+        t('general.update_done', balancer: balancer)
+      end
+
+      # filter function to check if the message looks to be coming via DM
+      def is_dm?(response)
+        # both the :shell and :console adapters *always* appear to be DMs, so short-circuit those
+        return false if [:shell, :console].include?(Lita.config.robot.adapter)
+
+        # return whether it's a PM, or not, according to the adapter
+        response.message.source.private_message?
+      end
+
+      # take the response Object and parse out the match data
+      def split_params(response)
+        [
+          response.match_data['region'].downcase,
+          response.match_data['environment'].downcase,
+          response.match_data['balancer'].downcase,
+        ]
+      end
+
+      # take the response Object and parse out the match data
+      # for commands including a node to mutate
+      def split_long_params(response)
+        split_params(response) << response.match_data['node'].downcase
+      end
+
+      # get the load balancer IDs for the cluster we want to operate on
+      # this walks the configuration Hash to look for any missing keys
+      # we do the walking to provide a helpful error message to the consumer
+      def balancer_ids(region, env, balancer)
+        h = config.lb_hash
+
+        # if either the <region> or <region>.<environment> key is missing: bail out
+        raise MissingKey, t('general.missing_region', region: region) unless h.key?(region)
+        raise MissingKey, t('general.missing_env', region: region, env: env) unless h[region].key?(env)
+
+        # if the <region>.<environment>.<balancer> key is missing: bail out
+        unless h[region][env].key?(balancer)
+          raise MissingKey, t('general.missing_balancer', region: region, env: env, balancer: balancer)
+        end
+
+        # if the value for <region>.<environment>.<balancer> is not an Array: bail out
+        raise MissingKey, t('general.balancer_not_arr') unless h[region][env][balancer].kind_of?(Array)
+
+        # return the Array of IDs
+        h[region][env][balancer]
+      end
+
+      Lita.register_handler(self)
+    end
+  end
+end

data/lib/lita-lbcfg/loader.rb

@@ -0,0 +1,45 @@
+# Copyright 2016 DoubleDutch, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'dd_spacecadet/config'
+
+module LitaLBCfg
+  module Loader
+    # helper function to set up SpaceCadet
+    # meant to be used with the `on :loaded` event handler
+    # to use this, please add `include LitaLBCfg::Loader` to your handler
+    def set_up_spacecadet(_)
+      creds = _config.credentials
+
+      creds.each do |credentials|
+        _register_client(credentials)
+      end
+    end
+
+    # helper method for reliably pulling the right Lita config key
+    def _config
+      Lita.config.handlers.lbcfg
+    end
+
+    # helper method to register the client based on the credentials
+    def _register_client(credentials)
+      DoubleDutch::SpaceCadet::Config.register(
+        "#{credentials[:region]}-#{credentials[:env]}".downcase,
+        credentials[:username].downcase,
+        credentials[:key],
+        credentials[:region].upcase
+      )
+    end
+  end
+end

data/lib/lita-lbcfg/version.rb

@@ -0,0 +1,17 @@
+# Copyright 2016 DoubleDutch, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module LitaLBCfg
+  VERSION ||= '0.1.1'.freeze
+end

data/lib/lita-lbcfg.rb

@@ -0,0 +1,28 @@
+# Copyright 2016 DoubleDutch, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'lita-lbcfg/version'
+
+require 'lita'
+
+Lita.load_locales Dir[File.expand_path(
+  File.join("..", "..", "locales", "*.yml"), __FILE__
+)]
+
+require 'lita/handlers/lbcfg'
+
+Lita::Handlers::Lbcfg.template_root File.expand_path(
+  File.join("..", "..", "templates"),
+ __FILE__
+)

data/lita-lbcfg.gemspec

@@ -0,0 +1,44 @@
+# Copyright 2016 DoubleDutch, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __FILE__))
+
+require 'lita-lbcfg/version'
+
+Gem::Specification.new do |s|
+  s.name                  = 'lita-lbcfg'
+  s.summary               = 'Lita handler for manipulating Rackspace Cloud Load Balancers'
+  s.author                = 'DoubleDutch Engineering Operations'
+  s.email                 = 'engops@doubledutch.me'
+  s.license               = 'Apache 2.0'
+  s.version               = LitaLBCfg::VERSION
+  s.required_ruby_version = '~> 2.3'
+  s.date                  = Time.now.strftime('%Y-%m-%d')
+  s.homepage              = 'https://github.com/DoubleDutch/lita-lbcfg'
+  s.description           = 'Lita handler for manipulating Rackspace Cloud Load Balancers using the dd_spacecadet gem'
+
+  s.test_files            = `git ls-files spec/*`.split
+  s.files                 = `git ls-files`.split
+
+  # not sure we want this showing up in the Lita plugin listings online
+  # s.metadata              = { 'lita_plugin_type' => 'handler' }
+
+  s.add_development_dependency 'rake', '~> 11.2.2'
+  s.add_development_dependency 'rspec', '~> 3.5.0'
+  s.add_development_dependency 'rubocop', '~> 0.42.0'
+  s.add_development_dependency 'irbtools', '~> 2.0.1'
+
+  s.add_runtime_dependency 'lita', '~> 4.7.0'
+  s.add_runtime_dependency 'dd_spacecadet', '~> 0.2.0'
+end

data/locales/en.yml

@@ -0,0 +1,20 @@
+en:
+  lita:
+    handlers:
+      lbcfg:
+        general:
+          private_message: "I'm a huge fan of visibility around infrastructure changes. Let's do this in a public channel! :)"
+          missing_region: "Region '%{region}' does not exist in the config"
+          missing_env: "Environment '%{env}' does not exist in the config for %{region}"
+          missing_balancer: "Balancer '%{balancer}' does not exist in the config for %{region}.%{env}"
+          balancer_not_arr: "Balancer value in the config is not an Array"
+          update_done: "Finished updating the %{balancer} load balancer"
+        status:
+          no_details: "No details were returned for %{region}.%{env}.%{balancer} load balancer"
+        enable:
+          starting_update: "Enabling %{node} within the %{region}.%{env}.%{balancer} balancer..."
+        drain:
+          starting_update: "Draining %{node} within the %{region}.%{env}.%{balancer} balancer..."
+        router:
+          invalid_action: "%{action} is not a valid action, please use 'drain' or 'enable'"
+        not_found: "The command did not match any known routes, please try again. ('%{body}')"

data/spec/spec_helper.rb

@@ -0,0 +1,21 @@
+# Copyright 2016 DoubleDutch, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'lita-lbcfg'
+require 'dd_spacecadet'
+require 'lita/rspec'
+
+# A compatibility mode is provided for older plugins upgrading from Lita 3. Since this plugin
+# was generated with Lita 4, the compatibility mode should be left disabled.
+Lita.version_3_compatibility_mode = false

data/spec/unit/lita/handlers/lbcfg_spec.rb

@@ -0,0 +1,408 @@
+# Copyright 2016 DoubleDutch, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'spec_helper'
+
+def action_to_verb(action)
+  case action.downcase
+  when 'drain'
+    'Draining'
+  when 'enable'
+    'Enabling'
+  else
+    '???'
+  end
+end
+
+def action_to_sym(action)
+  case action.downcase
+  when 'drain'
+    :draining
+  when 'enable'
+    :enabled
+  else
+    :UNKNOWN_THINGY
+  end
+end
+
+
+describe Lita::Handlers::Lbcfg, lita_handler: true do
+  it { is_expected.to route_command('lbcfg status sf test lita').to(:status) }
+  it { is_expected.to route_command('lbcfg drain sf test lita us-lita-01').to(:lbcfg_router) }
+  it { is_expected.to route_command('lbcfg enable sf test lita us-lita-01').to(:lbcfg_router) }
+  it { is_expected.to route_command('lbcfg invalid sf test lita us-lita-01').to(:lbcfg_router) }
+
+  let(:happy_status) do
+    [
+      {
+        name: 'test-lb01',
+        id: 42,
+        nodes: [
+          { name: 'app01', condition: 'ENABLED', ip: '127.0.0.1', id: 142 },
+          { name: 'app02', condition: 'ENABLED', ip: '127.0.0.2', id: 184 }
+        ]
+      },
+      {
+        name: 'test-lb02',
+        id: 84,
+        nodes: [
+          { name: 'app01', condition: 'ENABLED', ip: '127.0.0.1', id: 242 },
+          { name: 'app02', condition: 'ENABLED', ip: '127.0.0.2', id: 284 }
+        ]
+      }
+    ]
+  end
+
+  let(:happy_cfg) do
+    {
+      'sf' => {
+        'test' => {
+          'lita' => [42, 84]
+        }
+      }
+    }
+  end
+
+  let(:sad_region_cfg) do
+    {
+      'sfx' => {
+        'test' => {
+          'lita' => [42, 84]
+        }
+      }
+    }
+  end
+
+  let(:sad_env_cfg) do
+    {
+      'sf' => {
+        'testx' => {
+          'lita' => [42, 84]
+        }
+      }
+    }
+  end
+
+  let(:sad_balancer_cfg) do
+    {
+      'sf' => {
+        'test' => {
+          'litax' => [42, 84]
+        }
+      }
+    }
+  end
+
+  describe '#config' do
+    it 'should set the lb_hash key to an empty Hash' do
+      expect(Lita.config.handlers.lbcfg.lb_hash).to be_a(Hash)
+      expect(Lita.config.handlers.lbcfg.lb_hash).to be_empty
+    end
+
+    it 'should set the credentials key to an empty Array' do
+      expect(Lita.config.handlers.lbcfg.credentials).to be_an(Array)
+      expect(Lita.config.handlers.lbcfg.credentials).to be_empty
+    end
+  end
+
+  ####
+  # Shared Tests
+  ####
+  shared_examples 'happy path' do |opts|
+    let(:action) { opts[:action] }
+    let(:verb) { action_to_verb(action) }
+    let(:symbol) { action_to_sym(action) }
+
+    before do
+      @lb_client = double('DoubleDutch::SpaceCadet::LB', status: happy_status, add_lb: nil, update_node: nil)
+      allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:new_client)
+        .with('sf-test')
+        .and_return(@lb_client)
+    end
+
+    after do
+      allow_any_instance_of(DoubleDutch::SpaceCadet::LB).to receive(:new_client).and_call_original
+    end
+
+    it 'should create a new DoubleDutch::SpaceCadet::LB config and add the IDs to it' do
+      expect(@lb_client).to receive(:add_lb).with(42)
+      expect(@lb_client).to receive(:add_lb).with(84)
+      send_command("lbcfg #{action} sf test lita app01")
+    end
+
+    it 'should call the update with the proper values' do
+      expect(@lb_client).to receive(:update_node).with('app01', symbol)
+      send_command("lbcfg #{action} sf test lita app01")
+    end
+
+    it 'should respond with the correct response' do
+      send_command("lbcfg #{action} sf test lita app01")
+      expect(replies.size).to eql(2)
+      expect(replies[0]).to eql("#{verb} app01 within the sf.test.lita balancer...")
+      expect(replies[1]).to eql('Finished updating the lita load balancer')
+    end
+  end
+
+  shared_examples 'unsafe or inconsistent lb' do |opts|
+    let(:action) { opts[:action] }
+    let(:verb) { action_to_verb(action) }
+    let(:symbol) { action_to_sym(action) }
+
+    context 'when the LB is unsafe' do
+      before do
+        @lb_client = double('DoubleDutch::SpaceCadet::LB', status: happy_status, add_lb: nil, update_node: nil)
+        allow(@lb_client).to receive(:update_node).and_raise(DoubleDutch::SpaceCadet::LBUnsafe, 'testBody')
+        allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:new_client)
+          .with('sf-test')
+          .and_return(@lb_client)
+      end
+
+      after do
+        allow_any_instance_of(DoubleDutch::SpaceCadet::LB).to receive(:new_client).and_call_original
+      end
+
+      it 'should create a new DoubleDutch::SpaceCadet::LB config and add the IDs to it' do
+        expect(@lb_client).to receive(:add_lb).with(42)
+        expect(@lb_client).to receive(:add_lb).with(84)
+        send_command("lbcfg #{action} sf test lita app01")
+      end
+
+      it 'should call the update with the proper values' do
+        expect(@lb_client).to receive(:update_node).with('app01', symbol)
+        send_command("lbcfg #{action} sf test lita app01")
+      end
+
+      it 'should respond with the correct response' do
+        send_command("lbcfg #{opts[:action]} sf test lita app01")
+        expect(replies.size).to eql(2)
+        expect(replies[0]).to eql("#{verb} app01 within the sf.test.lita balancer...")
+        expect(replies[1]).to eql(
+"An error has occured trying to #{action} the requested node:\n" +
+'DoubleDutch::SpaceCadet::LBUnsafe: testBody'
+        )
+      end
+    end
+
+    context 'when the LB is inconsistent' do
+      before do
+        @lb_client = double('DoubleDutch::SpaceCadet::LB', status: happy_status, add_lb: nil, update_node: nil)
+        allow(@lb_client).to receive(:update_node).and_raise(DoubleDutch::SpaceCadet::LBInconsistentState, 'testBody')
+        allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:new_client)
+          .with('sf-test')
+          .and_return(@lb_client)
+      end
+
+      after do
+        allow_any_instance_of(DoubleDutch::SpaceCadet::LB).to receive(:new_client).and_call_original
+      end
+
+      it 'should create a new DoubleDutch::SpaceCadet::LB config and add the IDs to it' do
+        expect(@lb_client).to receive(:add_lb).with(42)
+        expect(@lb_client).to receive(:add_lb).with(84)
+        send_command("lbcfg #{action} sf test lita app01")
+      end
+
+      it 'should call the update with the proper values' do
+        expect(@lb_client).to receive(:update_node).with('app01', symbol)
+        send_command("lbcfg #{action} sf test lita app01")
+      end
+
+      it 'should respond with the correct response' do
+        send_command("lbcfg #{opts[:action]} sf test lita app01")
+        expect(replies.size).to eql(2)
+        expect(replies[0]).to eql("#{verb} app01 within the sf.test.lita balancer...")
+        expect(replies[1]).to eql(
+"An error has occured trying to #{action} the requested node:\n" +
+'DoubleDutch::SpaceCadet::LBInconsistentState: testBody'
+        )
+      end
+    end
+  end
+
+  shared_examples 'action bad bot config' do |opts|
+    context "when the region isn't found in the bot config" do
+      before(:each) do
+        lbcfg = double('Lita::', lb_hash: sad_region_cfg, credentials: [])
+        allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:config).and_return(lbcfg)
+      end
+
+      it 'should return a proper error' do
+        send_command("lbcfg #{opts[:action]} sf test lita app01")
+        expect(replies.last).to eql("Region 'sf' does not exist in the config")
+      end
+    end
+
+    context "when the env isn't found in the bot config" do
+      before(:each) do
+        lbcfg = double('Lita::', lb_hash: sad_env_cfg, credentials: [])
+        allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:config).and_return(lbcfg)
+      end
+
+      it 'should return a proper error' do
+        send_command("lbcfg #{opts[:action]} sf test lita app01")
+        expect(replies.last).to eql("Environment 'test' does not exist in the config for sf")
+      end
+    end
+
+    context "when the balancer isn't found in the bot config" do
+      before(:each) do
+        lbcfg = double('Lita::', lb_hash: sad_balancer_cfg, credentials: [])
+        allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:config).and_return(lbcfg)
+      end
+
+      it 'should return a proper error' do
+        send_command("lbcfg #{opts[:action]} sf test lita app01")
+        expect(replies.last).to eql("Balancer 'lita' does not exist in the config for sf.test")
+      end
+    end
+  end
+
+  ####
+  # Handlers
+  ####
+
+  context 'invalid command' do
+    it 'should respond with an error' do
+      send_command('unknown bot command')
+      expect(replies.last).to eql(
+        "The command did not match any known routes, please try again. ('unknown bot command')"
+      )
+    end
+  end
+
+  # action router
+  context do
+    before(:each) do
+      lbcfg = double('Lita::', lb_hash: happy_cfg, credentials: [])
+      allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:config).and_return(lbcfg)
+    end
+
+    describe '.lbcfg_drain' do
+      it_behaves_like 'happy path', action: 'drain'
+      it_behaves_like 'action bad bot config', action: 'drain'
+      it_behaves_like 'unsafe or inconsistent lb', action: 'drain'
+    end
+
+    describe '.lbcfg_enable' do
+      it_behaves_like 'happy path', action: 'enable'
+      it_behaves_like 'action bad bot config', action: 'enable'
+      it_behaves_like 'unsafe or inconsistent lb', action: 'enable'
+    end
+
+    context 'invalid command' do
+      it 'returns an error message' do
+        send_command('lbcfg invalid sf test lita app01')
+        expect(replies.last).to eql("invalid is not a valid action, please use 'drain' or 'enable'")
+      end
+    end
+  end
+
+  describe '.status' do
+    let(:happy_data) do
+      [
+        {
+          name: 'test-lb01',
+          id: 42,
+          nodes: [
+            { name: 'app01', condition: 'ENABLED', ip: '127.0.0.1', id: 142 },
+            { name: 'app02', condition: 'DRAINING', ip: '127.0.0.2', id: 184 }
+          ]
+        },
+        {
+          name: 'test-lb02',
+          id: 84,
+          nodes: [
+            { name: 'app01', condition: 'ENABLED', ip: '127.0.0.1', id: 242 },
+            { name: 'app02', condition: 'DRAINING', ip: '127.0.0.2', id: 284 }
+          ]
+        },
+      ]
+    end
+
+    before(:each) do
+      lbcfg = double('Lita::', lb_hash: happy_cfg, credentials: [])
+      allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:config).and_return(lbcfg)
+    end
+
+    context 'happy-path' do
+      before do
+        @lb_client = double('DoubleDutch::SpaceCadet::LB', status: happy_data, add_lb: nil)
+        allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:new_client)
+          .with('sf-test')
+          .and_return(@lb_client)
+      end
+
+      after do
+        allow_any_instance_of(DoubleDutch::SpaceCadet::LB).to receive(:new_client).and_call_original
+      end
+
+      it 'should create a new DoubleDutch::SpaceCadet::LB config and add the IDs to it' do
+        expect(@lb_client).to receive(:add_lb).with(42)
+        expect(@lb_client).to receive(:add_lb).with(84)
+        send_command('lbcfg status sf test lita')
+      end
+
+      it 'should render the proper response' do
+        send_command('lbcfg status sf test lita')
+        expect(replies.last).to eql(
+'test-lb01 (42)
+  app01  ENABLED  127.0.0.1  142
+  app02  DRAINING  127.0.0.2  184
+---
+test-lb02 (84)
+  app01  ENABLED  127.0.0.1  242
+  app02  DRAINING  127.0.0.2  284
+---
+'
+        )
+      end
+    end
+
+    context "when the region isn't found in the bot config" do
+      before(:each) do
+        lbcfg = double('Lita::', lb_hash: sad_region_cfg, credentials: [])
+        allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:config).and_return(lbcfg)
+      end
+
+      it 'should return a proper error' do
+        send_command('lbcfg status sf test lita')
+        expect(replies.last).to eql("Region 'sf' does not exist in the config")
+      end
+    end
+
+    context "when the env isn't found in the bot config" do
+      before(:each) do
+        lbcfg = double('Lita::', lb_hash: sad_env_cfg, credentials: [])
+        allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:config).and_return(lbcfg)
+      end
+
+      it 'should return a proper error' do
+        send_command('lbcfg status sf test lita')
+        expect(replies.last).to eql("Environment 'test' does not exist in the config for sf")
+      end
+    end
+
+    context "when the balancer isn't found in the bot config" do
+      before(:each) do
+        lbcfg = double('Lita::', lb_hash: sad_balancer_cfg, credentials: [])
+        allow_any_instance_of(Lita::Handlers::Lbcfg).to receive(:config).and_return(lbcfg)
+      end
+
+      it 'should return a proper error' do
+        send_command('lbcfg status sf test lita')
+        expect(replies.last).to eql("Balancer 'lita' does not exist in the config for sf.test")
+      end
+    end
+  end
+end

data/templates/exception.erb

@@ -0,0 +1,3 @@
+<%= @title %>
+
+<%= @exception %>: <%= @message %>

data/templates/exception.slack.erb

@@ -0,0 +1,3 @@
+<%= @title %>
+
+`<%= @exception %>: <%= @message %>`

data/templates/status.erb

@@ -0,0 +1 @@
+<%= @output %>

data/templates/status.slack.erb

@@ -0,0 +1,3 @@
+```
+<%= @output %>
+```

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: lita-lbcfg
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- DoubleDutch Engineering Operations
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 11.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 11.2.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.42.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.42.0
+- !ruby/object:Gem::Dependency
+  name: irbtools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+- !ruby/object:Gem::Dependency
+  name: lita
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.0
+- !ruby/object:Gem::Dependency
+  name: dd_spacecadet
+  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
+description: Lita handler for manipulating Rackspace Cloud Load Balancers using the
+  dd_spacecadet gem
+email: engops@doubledutch.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/lita-lbcfg.rb
+- lib/lita-lbcfg/loader.rb
+- lib/lita-lbcfg/version.rb
+- lib/lita/handlers/lbcfg.rb
+- lita-lbcfg.gemspec
+- locales/en.yml
+- spec/spec_helper.rb
+- spec/unit/lita/handlers/lbcfg_spec.rb
+- templates/exception.erb
+- templates/exception.slack.erb
+- templates/status.erb
+- templates/status.slack.erb
+homepage: https://github.com/DoubleDutch/lita-lbcfg
+licenses:
+- Apache 2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Lita handler for manipulating Rackspace Cloud Load Balancers
+test_files:
+- spec/spec_helper.rb
+- spec/unit/lita/handlers/lbcfg_spec.rb