lita-digitalocean 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5444464dba3faf90e5b413c215bda59c1a797fdf
+  data.tar.gz: 9397be0387a7e3be5f012ee09dc3d0479e573003
+SHA512:
+  metadata.gz: 3d8e15cb823eefde8069e2a908eefbeb365be41b3df69eedbb39d2af2ace2f79dac6242f2f2b62b7d1ea97fff09ee1af98763384f3048daca2d1dfd8e2b0e7e3
+  data.tar.gz: 769db7c17a2f6e3f05b4e64d0cb515b7a6093a505f695739a97b140553a040ffbfcfa603b5de79165601ad231fd87ba13948903e136a755a9ae777dbb028dcd5

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+rvm:
+  - 2.0.0
+script: bundle exec rake
+before_install:
+  - gem update --system
+services:
+  - redis-server
+notifications:
+  webhooks:
+    urls:
+      - https://lita-freenode.herokuapp.com/travis

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2014 Jimmy Cuadra
+
+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,91 @@
+# lita-digitalocean
+
+[![Build Status](https://travis-ci.org/jimmycuadra/lita-digitalocean.png?branch=master)](https://travis-ci.org/jimmycuadra/lita-digitalocean)
+[![Code Climate](https://codeclimate.com/github/jimmycuadra/lita-digitalocean.png)](https://codeclimate.com/github/jimmycuadra/lita-digitalocean)
+[![Coverage Status](https://coveralls.io/repos/jimmycuadra/lita-digitalocean/badge.png)](https://coveralls.io/r/jimmycuadra/lita-digitalocean)
+
+**lita-digitalocean** is a handler plugin for [Lita](https://www.lita.io/) that manages [DigitalOcean](https://www.digitalocean.com/) services.
+
+## Installation
+
+Add lita-digitalocean to your Lita instance's Gemfile:
+
+``` ruby
+gem "lita-digitalocean"
+```
+
+## Configuration
+
+### Required attributes
+
+* `client_id` (String) - The client ID for the account to manage.
+* `api_key` (String) - The API key for the account to manage.
+
+### Example
+
+``` ruby
+Lita.configure do |config|
+  config.handlers.digitalocean.client_id = "BdCsMEJYPv2tu7xQtLRB3"
+  config.handlers.digitalocean.api_key = "3df020a0441731e5ca47243b5515cbb7"
+end
+```
+
+## Usage
+
+To use any of the DigitalOcean commands, the user sending the message must be in the `:digitalocean_admins` authorization group.
+
+### Domain commands
+
+Not yet implemented. Coming soon!
+
+### Droplet commands
+
+Not yet implemented. Coming soon!
+
+### Image commands
+
+Not yet implemented. Coming soon!
+
+### Region commands
+
+Not yet implemented. Coming soon!
+
+### SSH key commands
+
+To add a new SSH key and get back its ID:
+
+```
+Lita: do ssh keys add NAME PUBLIC_KEY
+```
+
+To delete an SSH key by its ID:
+
+```
+Lita: do ssh keys delete ID
+```
+
+To edit the name and/or public key of an existing SSH key:
+
+```
+Lita: do ssh keys edit ID [name=NAME] [public_key=PUBLIC_KEY]
+```
+
+To list the names and IDs of all SSH keys:
+
+```
+Lita: do ssh keys list
+```
+
+To show the name and public key of an SSH key by ID:
+
+```
+Lita: do ssh keys show ID
+```
+
+### Size commands
+
+Not yet implemented. Coming soon!
+
+## License
+
+[MIT](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/lib/lita/handlers/digitalocean.rb

@@ -0,0 +1,159 @@
+require "digital_ocean"
+
+module Lita
+  module Handlers
+    class Digitalocean < Handler
+      def self.default_config(config)
+        config.client_id = nil
+        config.api_key = nil
+      end
+
+      private
+
+      def self.do_route(regexp, route_name, help)
+        route(regexp, route_name, command: true, restrict_to: :digitalocean_admins, help: help)
+      end
+
+      public
+
+      do_route /^do\s+ssh\s+keys?\s+add\s+.+$/i, :ssh_keys_add, {
+        t("help.ssh_keys.add_key") => t("help.ssh_keys.add_value")
+      }
+
+      do_route /^do\s+ssh\s+keys?\s+delete\s+(\d+)$/i, :ssh_keys_delete, {
+        t("help.ssh_keys.delete_key") => t("help.ssh_keys.delete_value")
+      }
+
+      do_route /^do\s+ssh\s+keys?\s+edit\s+(\d+)\s+.+$/i, :ssh_keys_edit, {
+        t("help.ssh_keys.edit_key") => t("help.ssh_keys.edit_value")
+      }
+
+      do_route /^do\s+ssh\s+keys?\s+list$/i, :ssh_keys_list, {
+        t("help.ssh_keys.list_key") => t("help.ssh_keys.list_value")
+      }
+
+      do_route /^do\s+ssh\s+keys?\s+show\s+(\d+)$/i, :ssh_keys_show, {
+        t("help.ssh_keys.show_key") => t("help.ssh_keys.show_value"),
+      }
+
+      def ssh_keys_add(response)
+        name, public_key = response.args[3..4]
+
+        unless name && public_key
+          return response.reply("#{t('format')}: #{t('help.ssh_keys.add_key')}")
+        end
+
+        do_response = do_call(response) do |client|
+          client.ssh_keys.add(name: name, ssh_pub_key: public_key)
+        end or return
+
+        key = do_response.ssh_key
+        response.reply(
+          t("ssh_keys.add.created", message: "#{key.id} (#{key.name}): #{key.ssh_pub_key}")
+        )
+      end
+
+      def ssh_keys_delete(response)
+        key_id = response.matches[0][0]
+
+        do_call(response) do |client|
+          client.ssh_keys.delete(key_id)
+        end or return
+
+        response.reply(t("ssh_keys.delete.deleted", key_id: key_id))
+      end
+
+      def ssh_keys_edit(response)
+        args = extract_named_args(response.args, :name, :public_key)
+
+        if args[:public_key]
+          args[:ssh_pub_key] = args.delete(:public_key)
+        end
+
+        do_response = do_call(response) do |client|
+          client.ssh_keys.edit(response.matches[0][0], args)
+        end or return
+
+        key = do_response.ssh_key
+        response.reply(
+          t("ssh_keys.edit.updated", message: "#{key.id} (#{key.name}): #{key.ssh_pub_key}")
+        )
+      end
+
+      def ssh_keys_list(response)
+        do_response = do_call(response) do |client|
+          client.ssh_keys.list
+        end or return
+
+        if do_response.ssh_keys.empty?
+          response.reply(t("ssh_keys.list.empty"))
+        else
+          do_response.ssh_keys.each do |key|
+            response.reply("#{key.id} (#{key.name})")
+          end
+        end
+      end
+
+      def ssh_keys_show(response)
+        do_response = do_call(response) do |client|
+          client.ssh_keys.show(response.matches[0][0])
+        end or return
+
+        key = do_response.ssh_key
+        response.reply("#{key.id} (#{key.name}): #{key.ssh_pub_key}")
+      end
+
+      private
+
+      def api_key
+        config.api_key
+      end
+
+      def client
+        @client ||= ::DigitalOcean::API.new(client_id: client_id, api_key: api_key)
+      end
+
+      def client_id
+        config.client_id
+      end
+
+      def config
+        Lita.config.handlers.digitalocean
+      end
+
+      def do_call(response)
+        unless api_key && client_id
+          response.reply(t("credentials_missing"))
+          return
+        end
+
+        do_response = yield client
+
+        if do_response.status != "OK"
+          response.reply(t("error", message: do_response.message))
+          return
+        end
+
+        do_response
+      end
+
+      def extract_named_args(args, *keys)
+        args.inject({}) do |hash, arg|
+          key, value = arg.split("=", 2)
+
+          if value
+            normalized_key = key.downcase.to_sym
+
+            if keys.include?(normalized_key)
+              hash[normalized_key] = value.gsub(/\A["']|["']\Z/, "")
+            end
+          end
+
+          hash
+        end
+      end
+    end
+
+    Lita.register_handler(Digitalocean)
+  end
+end

data/lib/lita-digitalocean.rb

@@ -0,0 +1,7 @@
+require "lita"
+
+Lita.load_locales Dir[File.expand_path(
+  File.join("..", "..", "locales", "*.yml"), __FILE__
+)]
+
+require "lita/handlers/digitalocean"

data/lita-digitalocean.gemspec

@@ -0,0 +1,25 @@
+Gem::Specification.new do |spec|
+  spec.name          = "lita-digitalocean"
+  spec.version       = "0.0.1"
+  spec.authors       = ["Jimmy Cuadra"]
+  spec.email         = ["jimmy@jimmycuadra.com"]
+  spec.description   = %q{A Lita handler for managing DigitalOcean services.}
+  spec.summary       = %q{A Lita handler for managing DigitalOcean services.}
+  spec.homepage      = "https://github.com/jimmycuadra/lita-digitalocean"
+  spec.license       = "MIT"
+  spec.metadata      = { "lita_plugin_type" => "handler" }
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "lita", ">= 3.1"
+  spec.add_runtime_dependency "digital_ocean", ">= 1.3.0"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", ">= 3.0.0.beta2"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "coveralls"
+end

data/locales/en.yml

@@ -0,0 +1,30 @@
+en:
+  lita:
+    handlers:
+      digitalocean:
+        credentials_missing: >-
+          client_id and api_key must be set in Lita's configuration to
+          use the DigitalOcean commands.
+        error: "DigitalOcean API error: %{message}"
+        format: Format
+        help:
+          ssh_keys:
+            add_key: do ssh keys add NAME PUBLIC_KEY
+            add_value: Adds a new SSH key.
+            delete_key: do ssh keys delete ID
+            delete_value: Delete the SSH key with the given ID.
+            edit_key: "do ssh keys edit ID [name=NAME] [public_key=PUBLIC_KEY]"
+            edit_value: Change the NAME and/or PUBLIC_KEY of the SSH key with the given ID.
+            list_key: do ssh keys list
+            list_value: Lists all SSH keys.
+            show_key: do ssh keys show ID
+            show_value: Shows the public key for SSH key with the given ID.
+        ssh_keys:
+          add:
+            created: "Created new SSH key: %{message}"
+          delete:
+            deleted: "Deleted SSH key: %{key_id}"
+          edit:
+            updated: "Updated SSH key: %{message}"
+          list:
+            empty: No SSH keys have been added yet.

data/spec/lita/handlers/digitalocean_spec.rb

@@ -0,0 +1,130 @@
+require "spec_helper"
+
+describe Lita::Handlers::Digitalocean, lita_handler: true do
+  it { routes_command("do ssh keys add 'foo bar' 'ssh-rsa abcdefg'").to(:ssh_keys_add) }
+  it { routes_command("do ssh keys delete 123").to(:ssh_keys_delete) }
+  it do
+    routes_command(
+      "do ssh keys edit 123 name=foo public_key='ssh-rsa changed'"
+    ).to(:ssh_keys_edit)
+  end
+  it { routes_command("do ssh keys list").to(:ssh_keys_list) }
+  it { routes_command("do ssh keys show 123").to(:ssh_keys_show) }
+
+  let(:client) do
+    instance_double(
+      "::DigitalOcean::API",
+      ssh_keys: client_ssh_keys
+    )
+  end
+
+  let(:client_ssh_keys) { instance_double("::DigitalOcean::Resource::SSHKey") }
+
+  before do
+    Lita.config.handlers.digitalocean.tap do |config|
+      config.client_id = "CLIENT_ID"
+      config.api_key = "API_KEY"
+    end
+
+    allow(Lita::Authorization).to receive(:user_in_group?).with(
+      user,
+      :digitalocean_admins
+    ).and_return(true)
+
+    allow(::DigitalOcean::API).to receive(:new).and_return(client)
+  end
+
+  describe "ssh key commands" do
+    let(:do_list) do
+      instance_double(
+        "Hashie::Rash",
+        status: "OK",
+        ssh_keys: [
+          instance_double("Hashie::Rash", id: 123, name: "My Key"),
+          instance_double("Hashie::Rash", id: 456, name: "Your Key"),
+        ]
+      )
+    end
+
+    let(:do_list_empty) do
+      instance_double(
+        "Hashie::Rash",
+        status: "OK",
+        ssh_keys: []
+      )
+    end
+
+    let(:do_key) do
+      instance_double(
+        "Hashie::Rash",
+        status: "OK",
+        ssh_key: instance_double(
+          "Hashie::Rash",
+          id: 123,
+          name: "My Key",
+          ssh_pub_key: "ssh-rsa abcdefg"
+        )
+      )
+    end
+
+    let(:do_delete) { instance_double("Hashie::Rash", status: "OK") }
+
+    describe "#ssh_keys_add" do
+      it "responds with the details of the new key" do
+        allow(client_ssh_keys).to receive(:add).with(
+          name: "My Key",
+          ssh_pub_key: "ssh-rsa abcdefg"
+        ).and_return(do_key)
+        send_command("do ssh keys add 'My Key' 'ssh-rsa abcdefg'")
+        expect(replies.last).to eq("Created new SSH key: 123 (My Key): ssh-rsa abcdefg")
+      end
+
+      it "responds with an error message if name or public key is missing" do
+        send_command("do ssh keys add foo")
+        expect(replies.last).to eq("Format: do ssh keys add NAME PUBLIC_KEY")
+      end
+    end
+
+    describe "#ssh_keys_delete" do
+      it "responds with a success message" do
+        allow(client_ssh_keys).to receive(:delete).with("123").and_return(do_delete)
+        send_command("do ssh keys delete 123")
+        expect(replies.last).to eq("Deleted SSH key: 123")
+      end
+    end
+
+    describe "#ssh_keys_edit" do
+      it "responds with the edited key's values" do
+        allow(client_ssh_keys).to receive(:edit).with(
+          "123",
+          name: "My Key",
+          ssh_pub_key: "ssh-rsa abcdefg"
+        ).and_return(do_key)
+        send_command(%{do ssh keys edit 123 name='My Key' public_key="ssh-rsa abcdefg"})
+        expect(replies.last).to eq("Updated SSH key: 123 (My Key): ssh-rsa abcdefg")
+      end
+    end
+
+    describe "#ssh_keys_list" do
+      it "returns a list of key IDs and names" do
+        allow(client_ssh_keys).to receive(:list).and_return(do_list)
+        send_command("do ssh keys list")
+        expect(replies).to eq(["123 (My Key)", "456 (Your Key)"])
+      end
+
+      it "returns an empty state message if there are no SSH keys" do
+        allow(client_ssh_keys).to receive(:list).and_return(do_list_empty)
+        send_command("do ssh keys list")
+        expect(replies.last).to eq("No SSH keys have been added yet.")
+      end
+    end
+
+    describe "#ssh_keys_show" do
+      it "responds with the public key" do
+        allow(client_ssh_keys).to receive(:show).with("123").and_return(do_key)
+        send_command("do ssh keys show 123")
+        expect(replies.last).to eq("123 (My Key): ssh-rsa abcdefg")
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+require "simplecov"
+require "coveralls"
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start { add_filter "/spec/" }
+
+require "lita-digitalocean"
+require "lita/rspec"

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: lita-digitalocean
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jimmy Cuadra
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lita
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: digital_ocean
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0.beta2
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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: coveralls
+  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'
+description: A Lita handler for managing DigitalOcean services.
+email:
+- jimmy@jimmycuadra.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/lita-digitalocean.rb
+- lib/lita/handlers/digitalocean.rb
+- lita-digitalocean.gemspec
+- locales/en.yml
+- spec/lita/handlers/digitalocean_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/jimmycuadra/lita-digitalocean
+licenses:
+- MIT
+metadata:
+  lita_plugin_type: handler
+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.2.2
+signing_key: 
+specification_version: 4
+summary: A Lita handler for managing DigitalOcean services.
+test_files:
+- spec/lita/handlers/digitalocean_spec.rb
+- spec/spec_helper.rb