lita-trello-lists 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b5589affaa09d28ead829b122e3a4acef7ee1b31
+  data.tar.gz: daa551cfd3916ab97f3c766fee20e939e9f5db2a
+SHA512:
+  metadata.gz: e44ab14419499e9a1a48dd279f88e8575d6b2c08953b058c4e2bc09e62dfdd882b2ad16de119371d42076c80d938e8624febbe6fe0afe791982f833f6d0b2c60
+  data.tar.gz: f042a9f7f9b94d2154c0c2d3c588b727b7a8bd2cae89ad07879bdc7c91199d99f0176691dc7da4097b618a92f42f1fa6fb0abbdda91b3f19d4bd04d7168089ef

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,3 @@
+source "https://rubygems.org"
+
+gemspec

data/README.md

@@ -0,0 +1,38 @@
+# lita-trello-lists
+
+This is a Lita handler for displaying your Trello lists through Lita.
+
+## Installation
+
+Add lita-trello-lists to your Lita instance's Gemfile:
+
+``` ruby
+gem "lita-trello-lists"
+```
+
+## Configuration
+
+You will need to set at least one configuration variable:
+
+``` ruby
+lita.handlers.trello_lists.boards = ['123456', 'abcsfgf']
+```
+
+You can find the ID of one of your boards through its URL.
+
+Additionally, if your boards are private, you will need to supply your Trello API key and a token. You can find out how to get these things through the [Trello API documentation](https://trello.com/docs/).
+
+``` ruby
+lita.handlers.trello_lists.key = "2345n32b42oijkn3b24j34jn34"
+lita.handlers.trello_lists.token = "sahfiu23kjriuejknr239r0ofiwjben023ork2inw"
+```
+
+## Usage
+
+Say you have a board names "Engineering" and a list in it called "In Progress". The following are all equivalent:
+
+```
+> @robot trello list in progress
+> @robot trello list progress in engineering
+> @robot trello list in progress in eng
+```

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-trello-lists.rb

@@ -0,0 +1,12 @@
+require "lita"
+
+Lita.load_locales Dir[File.expand_path(
+  File.join("..", "..", "locales", "*.yml"), __FILE__
+)]
+
+require "lita/handlers/trello_lists"
+
+Lita::Handlers::TrelloLists.template_root File.expand_path(
+  File.join("..", "..", "templates"),
+ __FILE__
+)

data/lib/lita/handlers/trello_lists.rb

@@ -0,0 +1,139 @@
+module Lita
+  module Handlers
+    class TrelloLists < Handler
+      config :key, type: String, required: false
+      config :token, type: String, required: false
+      config :boards, type: Array, required: true
+
+      TRELLO_API_URL = "https://api.trello.com/1"
+
+      route(/^trello list (.*)$/, :list_summary, command: true, help: {
+        "trello list LIST NAME" => "Show a summary of the cards in a certain list on Trello."
+      })
+
+      route(/^trello list (.+) in (.+)?$/, :list_summary, command: true, help: {
+        "trello list LIST NAME in BOARD NAME" => "Show a summary of the cards in a list on a specific board on Trello."
+      })
+
+      def list_summary(message)
+        list_name_fragment  = message.matches[0][0]
+        board_name_fragment = message.matches[0][1]
+
+        board_name = find_board_from_fragment(board_name_fragment)
+        list_name  = find_list_from_fragment(list_name_fragment, board_name)
+
+        if board_name_fragment && board_name.nil?
+          message.reply("We couldn't find a board from the name \"#{board_name}\".")
+          return
+        end
+
+        if list_name.nil?
+          message.reply("We couldn't find a list from the name \"#{list_name}\".")
+          return
+        end
+
+        if board_name.nil? && list_exists_in_multiple_boards?(list_name)
+          response =  "The list \"#{list_name}\" appears in multiple Trello boards. Try this:\n"
+          response += "> everbot trello list #{list_name_fragment} in BOARD NAME"
+          message.reply(response)
+          return
+        end
+
+        response = "**Cards in #{list_name}:** \n"
+        response += get_cards_for(list_name, board_name).map do |card|
+          members = card[:members].map { |m| "      #{m}\n" }
+          [
+            "-  _#{card[:name]}_",
+            "    Assigned To:",
+            card[:members].map { |m| "      #{m}" }
+          ].flatten.join("\n")
+        end.join("\n\n")
+        message.reply(response)
+      end
+
+      def get_cards_for(list, board)
+        possible_lists = board ? lists_in_board(board) : lists_in_all_boards
+        list_id = possible_lists.select { |l| l["name"] == list }.first["id"]
+
+        cards = trello_get("/lists/#{list_id}", cards: "open")["cards"]
+        cards.map do |card|
+          {
+            members: card["idMembers"].map { |id| trello_get("/members/#{id}")["fullName"] },
+            name: card["name"],
+            url: card["shortUrl"]
+          }
+        end
+      end
+
+      def list_exists_in_multiple_boards?(fragment)
+        list_name = best_match_in_array(fragment, all_list_names)
+        all_list_names.select { |name| name == list_name }.count > 1
+      end
+
+      def find_list_from_fragment(fragment, board)
+        list_names = if board
+          lists_in_board(board).map  { |list| list["name"] }
+        else
+          all_list_names
+        end
+
+        best_match_in_array(fragment, list_names)
+      end
+
+      def find_board_from_fragment(fragment)
+        best_match_in_array(fragment, all_board_names)
+      end
+
+      def best_match_in_array(fragment, collection)
+        findings = collection.map do |thing|
+          match = thing[/#{fragment}/i]
+
+          length_of_match = match ? match.length : 0
+
+          [length_of_match, thing]
+        end.to_h
+
+        findings[findings.keys.sort.last] unless findings.keys.all?(&:zero?)
+      end
+
+      def lists_in_all_boards
+        boards.map { |board| board["lists"] }.flatten
+      end
+
+      def lists_in_board(board_name)
+        boards.select { |board| board["name"] == board_name }.first["lists"]
+      end
+
+      def all_board_names
+        boards.map { |board| board["name"] }
+      end
+
+      def all_list_names
+        boards.map do |board|
+          board["lists"].map { |list| list["name"] }
+        end.flatten
+      end
+
+      def boards
+        if @cached_data.nil? || (Time.now.sec - @last_access.sec) >= 5
+          @cached_data = config.boards.map do |board_id|
+            trello_get("/boards/#{board_id}", lists: "open")
+          end
+          @last_access = Time.now
+        end
+        @cached_data
+      end
+
+      def trello_get(url, params={})
+        params.merge!({
+          key: config.key,
+          token: config.token
+        })
+
+        MultiJson.load(http.get(TRELLO_API_URL + url, params).body)
+      end
+    end
+
+    Lita.register_handler(TrelloLists)
+  end
+end

data/lita-trello-lists.gemspec

@@ -0,0 +1,24 @@
+Gem::Specification.new do |spec|
+  spec.name          = "lita-trello-lists"
+  spec.version       = "0.1.0"
+  spec.authors       = ["Taylor Lapeyre"]
+  spec.email         = ["taylorlapeyre@gmail.com"]
+  spec.description   = "Display your Trello lists through Lita."
+  spec.summary       = "Display your Trello lists through Lita."
+  spec.homepage      = "https://github.com/taylorlapeyre/lita-trello-lists"
+  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", ">= 4.3"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "pry-byebug"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rack-test"
+  spec.add_development_dependency "rspec", ">= 3.0.0"
+end

data/locales/en.yml

@@ -0,0 +1,4 @@
+en:
+  lita:
+    handlers:
+      trello_lists:

data/spec/lita/handlers/trello_lists_spec.rb

@@ -0,0 +1,48 @@
+require "spec_helper"
+
+describe Lita::Handlers::TrelloLists, lita_handler: true do
+  before do
+    # Trello's "welcome" boards
+    Lita.config.handlers.trello_lists.boards  = ["bKbdmCKB", "9dnaRkNt", "VVPQBpZE"]
+  end
+
+  it { is_expected.to route_command("trello list Basics").to(:list_summary) }
+  it { is_expected.to route_command("trello list Basics Things").to(:list_summary) }
+  it { is_expected.to route_command("trello list Basics in Welcome Board").to(:list_summary) }
+
+  it "responds with a summary when given a list name" do
+    send_command "trello list Basics"
+    expect(replies).to_not be_empty
+    expect(replies.last).to match /Welcome to Trello/
+  end
+
+  it "can list the cards of a list in a specific board" do
+    send_command "trello list Getting Started in How to Use Trello for Android"
+    expect(replies).to_not be_empty
+    expect(replies.last).to match /Tap on a card/
+  end
+
+  it "can find a list with a partial string match" do
+    send_command "trello list interm"
+    expect(replies).to_not be_empty
+    expect(replies.last).to match /Intermediate/
+  end
+
+  it "responds with a helpful message when the list is in multiple boards" do
+    send_command "trello list Getting Started"
+    expect(replies).to_not be_empty
+    expect(replies.last).to match /appears in multiple Trello boards/
+  end
+
+  it "responds with a helpful message when the list isn't found" do
+    send_command "trello list foobar"
+    expect(replies).to_not be_empty
+    expect(replies.last).to match /We couldn't find a list/
+  end
+
+  it "responds with a helpful message when the board isn't found" do
+    send_command "trello list Basics in Foobar"
+    expect(replies).to_not be_empty
+    expect(replies.last).to match /We couldn't find a board/
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require "lita-trello-lists"
+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

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification
+name: lita-trello-lists
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Taylor Lapeyre
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lita
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.3'
+- !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: pry-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: 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: rack-test
+  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
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+description: Display your Trello lists through Lita.
+email:
+- taylorlapeyre@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- Rakefile
+- lib/lita-trello-lists.rb
+- lib/lita/handlers/trello_lists.rb
+- lita-trello-lists.gemspec
+- locales/en.yml
+- spec/lita/handlers/trello_lists_spec.rb
+- spec/spec_helper.rb
+- templates/.gitkeep
+homepage: https://github.com/taylorlapeyre/lita-trello-lists
+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.4.5
+signing_key: 
+specification_version: 4
+summary: Display your Trello lists through Lita.
+test_files:
+- spec/lita/handlers/trello_lists_spec.rb
+- spec/spec_helper.rb