lita-retro 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5d0cc52a998a8a5c2e66c4ae2438803d5eeadc2b
+  data.tar.gz: 6d3431bf84f8edbefd250f93b2b703fe02bf57c9
+SHA512:
+  metadata.gz: 868dbd9d744be861ace2710a963c5041db5736a16f000bf111590a81e8cdcbd50cfbded5ed58da669aac062306a62e2c3e940b961e28ef7dc4689a8c439cd92a
+  data.tar.gz: 921ad61f7f7efdaefb06af4aedaea49dcd033c083c9ff2e3332afd7bcb9b9a47a6a36ec5396b65201fd30652efd8c1d9025dfc523903513c68265256d0cd04e8

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,8 @@
+language: ruby
+rvm:
+  - 2.0.0
+script: bundle exec rake
+before_install:
+  - gem update --system
+services:
+  - redis-server

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,50 @@
+# lita-retro
+
+[![Build Status](https://travis-ci.org/jimmycuadra/lita-retro.png?branch=master)](https://travis-ci.org/jimmycuadra/lita-retro)
+[![Code Climate](https://codeclimate.com/github/jimmycuadra/lita-retro.png)](https://codeclimate.com/github/jimmycuadra/lita-retro)
+[![Coverage Status](https://coveralls.io/repos/jimmycuadra/lita-retro/badge.png)](https://coveralls.io/r/jimmycuadra/lita-retro)
+
+**lita-retro** helps manage topics for regular team retrospective meetings.
+
+## Installation
+
+Add lita-retro to your Lita instance's Gemfile:
+
+``` ruby
+gem "lita-retro"
+```
+
+## Usage
+
+Throughout the week, team members may think of things they'd like to discuss at the next team retro. They can store their topic ideas with Lita and Lita will list all the topics when it comes time to meet and discuss them. Topics can be classified as good, bad, or neutral, signified by a happy face, a sad face, or a straight face, respectively.
+
+```
+Carl: Lita retro :) Our new documentation was super useful!
+Lita: Good topic added!
+Henry: Lita retro :( There were too many interruptions.
+Lita: Bad topic added!
+Sophie: Lita retro :| What are we supposed to do during downtime?
+Lita: Neutral topic added!
+```
+
+When it's time for the retro, ask Lita to list all the topics for you.
+
+```
+You: Lita retro list
+Lita: Good topic from Carl: Our new documentation was super useful!
+      Bad topic from Henry: There were too many interruptions.
+      Neutral topic from Sophie: What are we supposed to do during downtime?
+```
+
+After the meeting, clear the topics and begin collecting them for the following week. Only users in the `:retro_admins` authorization group can do this.
+
+```
+You: Lita retro clear
+Lita: Cleared all topics!
+You: Lita retro list
+Lita: There are no retrospective topics yet.
+```
+
+## 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-retro.rb

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

data/lib/lita/handlers/retro.rb

@@ -0,0 +1,89 @@
+module Lita
+  module Handlers
+    class Retro < Handler
+      route /retro\s+:\)\s+(.+)/i, :add_good, command: true, help: {
+        t("help.add_good_key") => t("help.add_good_value")
+      }
+
+      route /retro\s+:\(\s+(.+)/i, :add_bad, command: true, help: {
+        t("help.add_bad_key") => t("help.add_bad_value")
+      }
+
+      route /retro\s+:\|\s+(.+)/i, :add_neutral, command: true, help: {
+        t("help.add_neutral_key") => t("help.add_neutral_value")
+      }
+
+      route /retro\s+list/i, :list, command: true, help: {
+        "retro list" => t("help.list_value")
+      }
+
+      route /retro\s+clear/i, :clear, command: true, restrict_to: :retro_admins, help: {
+        "retro clear" => t("help.clear_value")
+      }
+
+      def add_bad(response)
+        add_type("bad", response)
+      end
+
+      def add_good(response)
+        add_type("good", response)
+      end
+
+      def add_neutral(response)
+        add_type("neutral", response)
+      end
+
+      def list(response)
+        topics = [
+          list_type("good"),
+          list_type("bad"),
+          list_type("neutral")
+        ].compact
+
+        if topics.empty?
+          response.reply(t("no_topics"))
+        else
+          response.reply(topics.join("\n"))
+        end
+      end
+
+      def clear(response)
+        %w(good bad neutral).map do |type|
+          redis.smembers(type).each { |id| redis.del("#{type}:#{id}") }
+          redis.del(type)
+        end
+
+        response.reply(t("clear"))
+      end
+
+      private
+
+      def add_type(type, response)
+        redis.sadd("#{type}:#{response.user.id}", response.matches[0][0])
+        redis.sadd("#{type}", response.user.id)
+        response.reply(t("added", type: type))
+      end
+
+      def list_type(type)
+        user_ids = redis.smembers(type)
+        return if user_ids.empty?
+
+        topics = []
+
+        user_ids.each do |user_id|
+          user = User.find_by_id(user_id)
+          next unless user
+
+          redis.smembers("#{type}:#{user.id}").each do |topic|
+            topics << t("topic", type: type.capitalize, name: user.name, topic: topic)
+          end
+        end
+
+        topics.join("\n")
+      end
+    end
+
+    Lita.register_handler(Retro)
+  end
+end
+

data/lita-retro.gemspec

@@ -0,0 +1,24 @@
+Gem::Specification.new do |spec|
+  spec.name          = "lita-retro"
+  spec.version       = "0.0.1"
+  spec.authors       = ["Jimmy Cuadra"]
+  spec.email         = ["jimmy@jimmycuadra.com"]
+  spec.description   = %q{A Lita handler to help manage topics for regular team retrospective meetings.}
+  spec.summary       = %q{A Lita handler to help manage topics for regular team retrospective meetings.}
+  spec.homepage      = "https://github.com/jimmycuadra/lita-retro"
+  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.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,17 @@
+en:
+  lita:
+    handlers:
+      retro:
+        help:
+          add_good_key: "retro :) TOPIC"
+          add_good_value: Add a positive topic for the next retrospective.
+          add_bad_key: "retro :( TOPIC"
+          add_bad_value: Add a negative topic for the next retrospective.
+          add_neutral_key: "retro :| TOPIC"
+          add_neutral_value: Add a neutral topic for the next retrospective.
+          list_value: List all topics for the next retrospective.
+          clear_value: Clear the retrospective topics.
+        added: "Added %{type} topic!"
+        topic: "%{type} topic from %{name}: %{topic}"
+        no_topics: There are no retrospective topics yet.
+        clear: Cleared all topics!

data/spec/lita/handlers/retro_spec.rb

@@ -0,0 +1,52 @@
+require "spec_helper"
+
+describe Lita::Handlers::Retro, lita_handler: true do
+  let(:bad_user) { Lita::User.create(2, name: "Bad User") }
+  let(:neutral_user) { Lita::User.create(3, name: "Neutral User") }
+
+  it { routes_command("retro :) topic").to(:add_good) }
+  it { routes_command("retro :( topic").to(:add_bad) }
+  it { routes_command("retro :| topic").to(:add_neutral) }
+  it { routes_command("retro list").to(:list) }
+  it { routes_command("retro clear").to(:clear) }
+
+  it "adds good topics" do
+    send_command("retro :) foo bar")
+    send_command("retro list")
+    expect(replies.last).to eq("Good topic from Test User: foo bar")
+  end
+
+  it "adds bad topics" do
+    send_command("retro :( foo bar")
+    send_command("retro list")
+    expect(replies.last).to eq("Bad topic from Test User: foo bar")
+  end
+
+  it "adds neutral topics" do
+    send_command("retro :| foo bar")
+    send_command("retro list")
+    expect(replies.last).to eq("Neutral topic from Test User: foo bar")
+  end
+
+  it "lists all topics" do
+    send_command("retro :) something good!")
+    send_command("retro :( something bad!", as: bad_user)
+    send_command("retro :| something neutral!", as: neutral_user)
+    send_command("retro list")
+    expect(replies.last).to include("Good topic from Test User: something good!")
+    expect(replies.last).to include("Bad topic from Bad User: something bad!")
+    expect(replies.last).to include("Neutral topic from Neutral User: something neutral!")
+  end
+
+  it "clears all topics" do
+    allow(Lita::Authorization).to receive(:user_in_group?).with(user, :retro_admins).and_return(
+      true
+    )
+    send_command("retro :) something good!")
+    send_command("retro :( something bad!", as: bad_user)
+    send_command("retro :| something neutral!", as: neutral_user)
+    send_command("retro clear")
+    send_command("retro list")
+    expect(replies.last).to eq("There are no retrospective topics yet.")
+  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-retro"
+require "lita/rspec"

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: lita-retro
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jimmy Cuadra
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lita
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '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 to help manage topics for regular team retrospective meetings.
+email:
+- jimmy@jimmycuadra.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/lita-retro.rb
+- lib/lita/handlers/retro.rb
+- lita-retro.gemspec
+- locales/en.yml
+- spec/lita/handlers/retro_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/jimmycuadra/lita-retro
+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 to help manage topics for regular team retrospective meetings.
+test_files:
+- spec/lita/handlers/retro_spec.rb
+- spec/spec_helper.rb