slack-ruby-bot 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c8b86a027a9c17bbb4d3e69212493162aacfffca
-  data.tar.gz: 94ec098315fd7611325f567da9c5964d4847d47b
+  metadata.gz: f872fa7b4cc7c405bc25e0802e243826672c098f
+  data.tar.gz: ed6a6038cf90aea81894759e73b2991a484f0d09
 SHA512:
-  metadata.gz: c97a004bbcfadbbd318158cc8ffe1d59637c7b0026139e771f655393cb362acd02adff508cff69a961781b5da25efa199756c326ca18f098fefc8f6ee85c4b6b
-  data.tar.gz: 15014981779338072114308822e4018d9bfc21b067f58689489ec2fffaec88b7fbf46a05a40a09d963c302da70d9312f9f0d08c42fe25a080ecfab2e78a171cc
+  metadata.gz: 2823b93a71bd803ebdbd3d753785e457250275dc2a0bb9eee72a4b7e9986f9060fa42487676d7ca6ed32513173c5ee51cc33274f69fc6c1e43d5c7311fce1386
+  data.tar.gz: 6d08cab72ee6db777d275550654154d9186b35643107529ee25c59e449fb19b52f6a7dde58bcef583dba4c19fb201bfe140cfe832daff91f07321e6cec0483c2

data/.gitignore

@@ -1,3 +1,4 @@
 .env
 pkg
 Gemfile.lock
+.bundle

data/.rubocop.yml

@@ -1,6 +1,7 @@
 AllCops:
   Exclude:
     - vendor/**/*
+    - examples/**/vendor/**/*
     - bin/**/*
 
 inherit_from: .rubocop_todo.yml

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+### 0.8.1 (6/10/2016)
+
+* [#69](https://github.com/dblock/slack-ruby-bot/pull/69): Ability to add help info to bot and commands - [@accessd](https://github.com/accessd).
+* [#75](https://github.com/dblock/slack-ruby-bot/issues/75): Guarantee order of command evaluation - [@dblock](https://github.com/dblock).
+* [#76](https://github.com/dblock/slack-ruby-bot/issues/76): Infinity error when app disabled - [@slayershadow](https://github.com/SlayerShadow).
+* [#81](https://github.com/dblock/slack-ruby-bot/pull/81): Removed dependency on Bundler - [@derekddecker](https://github.com/derekddecker).
+* [#84](https://github.com/dblock/slack-ruby-bot/pull/84): Removed dependency on ActiveSupport - [@rmulligan](https://github.com/rmulligan).
+
 ### 0.8.0 (5/5/2016)
 
 * [#32](https://github.com/dblock/slack-ruby-bot/issues/32): Don't include `faye-websocket` by default, support `celluloid-io` - [@dblock](https://github.com/dblock).

data/README.md

@@ -7,17 +7,19 @@ Slack-Ruby-Bot
 
 A generic Slack bot framework written in Ruby on top of [slack-ruby-client](https://github.com/dblock/slack-ruby-client). This library does all the heavy lifting, such as message parsing, so you can focus on implementing slack bot commands. It also attempts to introduce the bare minimum number of requirements or any sorts of limitations. It's a Slack bot boilerplate.
 
+If you are not familiar with Slack bots or Slack API concepts, you might want to watch [this video](http://code.dblock.org/2016/03/11/your-first-slack-bot-service-video.html).
+
 ![](slack.png)
 
 ## Useful to Me?
 
 * If you are just trying to send messages to Slack, use [slack-ruby-client](https://github.com/dblock/slack-ruby-client), which this library is built on top of.
-* If you're trying to roll out a full service with Slack button integration, check out [slack-bot-server](https://github.com/dblock/slack-bot-server), which uses this library.
+* If you're trying to roll out a full service with Slack button integration, check out [slack-ruby-bot-server](https://github.com/dblock/slack-ruby-bot-server), which uses this library.
 * Otherwise, this piece of the puzzle will help you create a single bot instance for one team.
 
 ## Stable Release
 
-You're reading the documentation for the **stable** release of slack-ruby-bot 0.8.0. See [CHANGELOG](CHANGELOG.md) for a history of changes and [UPGRADING](UPGRADING.md) for how to upgrade to more recent versions.
+You're reading the documentation for the **stable** release of slack-ruby-bot, 0.8.1. See [CHANGELOG](CHANGELOG.md) for a history of changes and [UPGRADING](UPGRADING.md) for how to upgrade to more recent versions.
 
 ## Usage
 
@@ -140,6 +142,47 @@ end
 
 See [examples/market](examples/market/marketbot.rb) for a working example.
 
+### Providing description for your bot and commands
+
+You can specify help information for bot or commands with `help` block, for example:
+
+in case of bot:
+
+```ruby
+class WeatherBot < SlackRubyBot::Bot
+  help do
+    title 'Weather Bot'
+    desc 'This bot tells you the weather.'
+
+    command 'clouds' do
+      desc 'Tells you how many clouds there\'re above you.'
+    end
+
+    command 'What\'s the weather in <city>?' do
+      desc 'Tells you the weather in a <city>.'
+      long_desc "Accurate 10 Day Weather Forecasts for thousands of places around the World.\n" \
+        'Bot provides detailed Weather Forecasts over a 10 day period updated four times a day.'
+    end
+  end
+
+  # commands implementation
+end
+```
+
+![](screenshots/help.png)
+
+in case of your own command:
+
+```ruby
+class Deploy < SlackRubyBot::Commands::Base
+  help do
+    title 'deploy'
+    desc 'deploys your app'
+    long_desc 'command format: *deploy <branch> to <env>* where <env> is production or staging'
+  end
+end
+```
+
 ### SlackRubyBot::Commands::Base
 
 The `SlackRubyBot::Bot` class is DSL sugar deriving from `SlackRubyBot::Commands::Base`. For more involved bots you can organize the bot implementation into subclasses of `SlackRubyBot::Commands::Base` manually. By default a command class responds, case-insensitively, to its name. A class called `Phone` that inherits from `SlackRubyBot::Commands::Base` responds to `phone` and `Phone` and calls the `call` method when implemented.
@@ -221,8 +264,6 @@ For example, the following hook handles [user_change](https://api.slack.com/even
 module MyBot
   module Hooks
     class UserChange
-      extend SlackRubyBot::Hooks::Base
-
       def call(client, data)
         # data['user']['id'] contains the user ID
         # data['user']['name'] contains the new user name

data/examples/weather/weatherbot.rb

@@ -3,6 +3,21 @@ require 'slack-ruby-bot'
 SlackRubyBot::Client.logger.level = Logger::WARN
 
 class WeatherBot < SlackRubyBot::Bot
+  help do
+    title 'Weather Bot'
+    desc 'This bot tells you the weather.'
+
+    command 'clouds' do
+      desc 'Tells you how many clouds there\'re above you.'
+    end
+
+    command 'What\'s the weather in <city>?' do
+      desc 'Tells you the weather in a <city>.'
+      long_desc "Accurate 10 Day Weather Forecasts for thousands of places around the World.\n" \
+        'We provide detailed Weather Forecasts over a 10 day period updated four times a day.'
+    end
+  end
+
   match(/^How is the weather in (?<location>\w*)\?$/i) do |client, data, match|
     client.say(channel: data.channel, text: "The weather in #{match[:location]} is nice.")
   end

data/lib/config/application.rb

@@ -3,8 +3,6 @@ $LOAD_PATH.unshift(File.dirname(__FILE__))
 
 require 'boot'
 
-Bundler.require :default, ENV['RACK_ENV']
-
 Dir[File.expand_path('../../initializers', __FILE__) + '/**/*.rb'].each do |file|
   require file
 end

data/lib/config/boot.rb

@@ -1,5 +1,4 @@
 require 'rubygems'
-require 'bundler/setup'
 require 'logger'
 require 'active_support'
 require 'active_support/core_ext'

data/lib/slack-ruby-bot.rb

@@ -19,6 +19,7 @@ module SlackRubyBot
 end
 
 require 'slack-ruby-client'
+require 'slack-ruby-bot/support/commands_helper'
 require 'slack-ruby-bot/commands'
 require 'slack-ruby-bot/client'
 require 'slack-ruby-bot/server'

data/lib/slack-ruby-bot/commands/base.rb

@@ -24,6 +24,10 @@ module SlackRubyBot
           client.say(options.merge(channel: channel, text: '', gif: keywords))
         end
 
+        def help(&block)
+          CommandsHelper.instance.capture_help(name, &block)
+        end
+
         def default_command_name
           name && name.split(':').last.downcase
         end
@@ -69,12 +73,12 @@ module SlackRubyBot
         end
 
         def match(match, &block)
-          self.routes ||= {}
+          self.routes ||= ActiveSupport::OrderedHash.new
           self.routes[match] = { match_method: :match, call: block }
         end
 
         def scan(match, &block)
-          self.routes ||= {}
+          self.routes ||= ActiveSupport::OrderedHash.new
           self.routes[match] = { match_method: :scan, call: block }
         end
 

data/lib/slack-ruby-bot/commands/help.rb

@@ -1,8 +1,40 @@
 module SlackRubyBot
   module Commands
-    class Help < Base
-      def self.call(client, data, _match)
-        client.say(channel: data.channel, text: 'See https://github.com/dblock/slack-ruby-bot, please.', gif: 'help')
+    class HelpCommand < Base
+      help do
+        title 'help'
+        desc 'Shows help information.'
+      end
+
+      command 'help' do |client, data, match|
+        command = match[:expression]
+
+        text = if command.present?
+                 CommandsHelper.instance.command_full_desc(command)
+               else
+                 general_text
+               end
+
+        client.say(channel: data.channel, text: text, gif: 'help')
+      end
+
+      class << self
+        private
+
+        def general_text
+          bot_desc = CommandsHelper.instance.bot_desc_and_commands
+          other_commands_descs = CommandsHelper.instance.other_commands_descs
+          <<TEXT
+#{bot_desc.join("\n")}
+
+*Other commands:*
+#{other_commands_descs.join("\n")}
+
+For getting description of the command use: *help <command>*
+
+For more information see https://github.com/dblock/slack-ruby-bot, please.
+TEXT
+        end
       end
     end
   end

data/lib/slack-ruby-bot/commands/help/attrs.rb

@@ -0,0 +1,34 @@
+module SlackRubyBot
+  module Commands
+    module Help
+      class Attrs
+        attr_accessor :command_name, :command_desc, :command_long_desc
+        attr_reader :class_name, :commands
+
+        def initialize(class_name)
+          @class_name = class_name
+          @commands = []
+        end
+
+        def title(title)
+          self.command_name = title
+        end
+
+        def desc(desc)
+          self.command_desc = desc
+        end
+
+        def long_desc(long_desc)
+          self.command_long_desc = long_desc
+        end
+
+        def command(title, &block)
+          @commands << self.class.new(class_name).tap do |k|
+            k.title(title)
+            k.instance_eval(&block)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack-ruby-bot/commands/hi.rb

@@ -1,6 +1,11 @@
 module SlackRubyBot
   module Commands
     class Hi < Base
+      help do
+        title 'hi'
+        desc 'Says hello.'
+      end
+
       def self.call(client, data, _match)
         client.say(channel: data.channel, text: "Hi <@#{data.user}>!", gif: 'hi')
       end

data/lib/slack-ruby-bot/rspec/support/bots_for_tests.rb

@@ -0,0 +1,33 @@
+module Testing
+  class WeatherBot < SlackRubyBot::Bot
+    help do
+      title 'Weather Bot'
+      desc 'This bot tells you the weather.'
+
+      command 'clouds' do
+        desc 'Tells you how many clouds there\'re above you.'
+      end
+
+      command '' do
+        desc 'empty description'
+      end
+
+      command 'command_without_description' do
+      end
+
+      command 'What\'s the weather in <city>?' do
+        desc 'Tells you the weather in a <city>.'
+        long_desc "Accurate 10 Day Weather Forecasts for thousands of places around the World.\n" \
+          'We provide detailed Weather Forecasts over a 10 day period updated four times a day.'
+      end
+    end
+  end
+
+  class HelloCommand < SlackRubyBot::Commands::Base
+    help do
+      title 'hello'
+      desc 'Says hello.'
+      long_desc 'The long description'
+    end
+  end
+end

data/lib/slack-ruby-bot/server.rb

@@ -51,10 +51,16 @@ module SlackRubyBot
     def restart!(wait = 1)
       @async ? start_async : start!
     rescue StandardError => e
-      sleep wait
-      logger.error "#{e.message}, reconnecting in #{wait} second(s)."
-      logger.debug e
-      restart! [wait * 2, 60].min
+      case e.message
+      when 'account_inactive', 'invalid_auth'
+        logger.error "#{token}: #{e.message}, team will be deactivated."
+        @stopping = true
+      else
+        sleep wait
+        logger.error "#{e.message}, reconnecting in #{wait} second(s)."
+        logger.debug e
+        restart! [wait * 2, 60].min
+      end
     end
 
     private

data/lib/slack-ruby-bot/support/commands_helper.rb

@@ -0,0 +1,76 @@
+require 'singleton'
+require_relative '../commands/help/attrs'
+
+module SlackRubyBot
+  class CommandsHelper
+    include Singleton
+    attr_reader :commands_help_attrs
+
+    def initialize
+      @commands_help_attrs = []
+    end
+
+    def capture_help(class_name, &block)
+      k = Commands::Help::Attrs.new(class_name)
+      k.instance_eval(&block)
+      @commands_help_attrs << k
+    end
+
+    def bot_desc_and_commands
+      collect_help_attrs(bot_help_attrs) do |help_attrs|
+        bot_commands_descs = collect_name_and_desc(help_attrs.commands)
+        "#{command_name_and_desc(help_attrs)}\n\n*Commands:*\n#{bot_commands_descs.join("\n")}"
+      end
+    end
+
+    def other_commands_descs
+      collect_name_and_desc(other_commands_help_attrs)
+    end
+
+    def command_full_desc(name)
+      unescaped_name = Slack::Messages::Formatting.unescape(name)
+      help_attrs = find_command_help_attrs(unescaped_name)
+      return "There's no command *#{unescaped_name}*" unless help_attrs
+      return "There's no description for command *#{unescaped_name}*" if help_attrs.command_long_desc.blank?
+      "#{command_name_and_desc(help_attrs)}\n\n#{help_attrs.command_long_desc}"
+    end
+
+    private
+
+    def find_command_help_attrs(name)
+      help_attrs = commands_help_attrs.find { |k| k.command_name == name }
+      return help_attrs if help_attrs
+      commands_help_attrs.each { |k| k.commands.each { |c| return c if c.command_name == name } }
+      nil
+    end
+
+    def collect_help_attrs(help_attrs)
+      help_attrs_with_present_names(help_attrs).map do |ha|
+        yield(ha)
+      end
+    end
+
+    def collect_name_and_desc(help_attrs)
+      collect_help_attrs(help_attrs) do |ha|
+        command_name_and_desc(ha)
+      end
+    end
+
+    def command_name_and_desc(help_attrs)
+      desc = help_attrs.command_desc.present? ? " - #{help_attrs.command_desc}" : ''
+      "*#{help_attrs.command_name}*#{desc}"
+    end
+
+    def help_attrs_with_present_names(help_attrs)
+      help_attrs.select { |k| k.command_name.present? }
+    end
+
+    def bot_help_attrs
+      commands_help_attrs.select { |k| k.class_name.constantize.superclass == SlackRubyBot::Bot }
+    end
+
+    def other_commands_help_attrs
+      commands_help_attrs.select { |k| k.class_name.constantize.superclass == SlackRubyBot::Commands::Base }
+    end
+  end
+end

data/lib/slack-ruby-bot/support/loggable.rb

@@ -1,20 +1,21 @@
 module SlackRubyBot
   module Loggable
-    extend ActiveSupport::Concern
-
-    class_methods do
-      def logger
-        @logger ||= begin
-          $stdout.sync = true
-          Logger.new(STDOUT)
-        end
-      end
+    def self.included(base)
+      base.send :include, LoggingMethods
+      base.extend(LoggingMethods)
     end
 
-    private
+    def self.logger
+      @logger ||= begin
+                    $stdout.sync = true
+                    Logger.new(STDOUT)
+                  end
+    end
+  end
 
+  module LoggingMethods
     def logger
-      self.class.logger
+      Loggable.logger
     end
   end
 end

data/lib/slack-ruby-bot/version.rb

@@ -1,3 +1,3 @@
 module SlackRubyBot
-  VERSION = '0.8.0'.freeze
+  VERSION = '0.8.1'.freeze
 end

data/slack-ruby-bot.gemspec

@@ -16,7 +16,6 @@ Gem::Specification.new do |s|
   s.summary = 'The easiest way to write a Slack bot in Ruby.'
   s.add_dependency 'hashie'
   s.add_dependency 'slack-ruby-client', '>= 0.6.0'
-  s.add_dependency 'activesupport'
   s.add_dependency 'giphy', '~> 2.0.2'
   s.add_development_dependency 'rake'
   s.add_development_dependency 'rspec'

data/spec/slack-ruby-bot/app_spec.rb

@@ -12,4 +12,11 @@ describe SlackRubyBot::App do
       expect(klass.instance.class).to be klass
     end
   end
+
+  describe 'executable' do
+    it 'can be required as a dependency' do
+      response = system("ruby -e \"Bundler = nil ; require 'slack-ruby-bot'\"")
+      expect(response).to be true
+    end
+  end
 end

data/spec/slack-ruby-bot/commands/help/attrs_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe SlackRubyBot::Commands::Help::Attrs do
+  let(:help_attrs) { described_class.new('WeatherBot') }
+
+  it 'captures commands help attributes' do
+    expect(help_attrs.commands).to be_empty
+
+    sample_title = 'how\'s the weather?'
+    sample_desc = 'Tells you the weather in a <city>.'
+    sample_long_desc = "Accurate 10 Day Weather Forecasts for thousands of places around the World.\n" \
+      'We provide detailed Weather Forecasts over a 10 day period updated four times a day.'
+
+    help_attrs.command(sample_title) do
+      desc sample_desc
+      long_desc sample_long_desc
+    end
+
+    expect(help_attrs.commands.count).to eq(1)
+    command = help_attrs.commands.first
+    expect(command.command_name).to eq(sample_title)
+    expect(command.command_desc).to eq(sample_desc)
+    expect(command.command_long_desc).to eq(sample_long_desc)
+  end
+end

data/spec/slack-ruby-bot/commands/help_spec.rb

@@ -5,6 +5,24 @@ describe SlackRubyBot::Commands::Help do
     SlackRubyBot::App.new
   end
   it 'help' do
-    expect(message: "#{SlackRubyBot.config.user} help").to respond_with_slack_message('See https://github.com/dblock/slack-ruby-bot, please.')
+    message = <<MSG
+*Weather Bot* - This bot tells you the weather.
+
+*Commands:*
+*clouds* - Tells you how many clouds there're above you.
+*command_without_description*
+*What's the weather in <city>?* - Tells you the weather in a <city>.
+
+*Other commands:*
+*help* - Shows help information.
+*hi* - Says hello.
+*hello* - Says hello.
+
+For getting description of the command use: *help <command>*
+
+For more information see https://github.com/dblock/slack-ruby-bot, please.
+MSG
+
+    expect(message: "#{SlackRubyBot.config.user} help").to respond_with_slack_message(message)
   end
 end

data/spec/slack-ruby-bot/hooks/message_spec.rb

@@ -16,7 +16,7 @@ describe SlackRubyBot::Hooks::Message do
     it 'returns only built in command classes' do
       expect(built_in_command_classes).to include SlackRubyBot::Commands::Hi
       expect(built_in_command_classes).to include SlackRubyBot::Commands::Default
-      expect(built_in_command_classes).to include SlackRubyBot::Commands::Help
+      expect(built_in_command_classes).to include SlackRubyBot::Commands::HelpCommand
       expect(built_in_command_classes).to_not include SlackRubyBot::Bot
     end
     it 'does not return unknown command class' do

data/spec/slack-ruby-bot/server_spec.rb

@@ -88,4 +88,21 @@ describe SlackRubyBot::Server do
       end
     end
   end
+  context '#restart!' do
+    subject do
+      SlackRubyBot::Server.new(token: 'token')
+    end
+    it 'reloads server after disconnection' do
+      expect(subject).to receive(:restart!)
+      subject.send(:client).send(:callbacks)['close'].first.call
+      expect(subject.instance_variable_get(:@stopping)).to be_falsy
+    end
+    it 'does not reload server for inactive account' do
+      stopping = -> { subject.instance_variable_get :@stopping }
+      allow(subject).to receive(:start!) { raise StandardError, 'account_inactive' }
+      expect(stopping.call).to be_falsy
+      subject.restart!
+      expect(stopping.call).to be true
+    end
+  end
 end

data/spec/slack-ruby-bot/support/commands_helper_spec.rb

@@ -0,0 +1,121 @@
+require 'spec_helper'
+
+describe SlackRubyBot::CommandsHelper do
+  let(:bot_class_name) { 'Testing::WeatherBot' }
+  let(:command_class_name) { 'Testing::HelloCommand' }
+  let(:commands_helper) { described_class.instance }
+
+  describe '#capture_help' do
+    let(:help_attrs) { commands_helper.commands_help_attrs }
+    let(:bot_help_attrs) { help_attrs.find { |k| k.class_name == bot_class_name } }
+    let(:command_help_attrs) { help_attrs.find { |k| k.class_name == command_class_name } }
+
+    it 'should save bot class name' do
+      expect(bot_help_attrs).to be
+    end
+
+    describe 'captures help attributes correctly' do
+      context 'for command' do
+        it 'command name' do
+          expect(command_help_attrs.command_name).to eq('hello')
+        end
+
+        it 'command description' do
+          expect(command_help_attrs.command_desc).to eq('Says hello.')
+        end
+
+        it 'command long description' do
+          expect(command_help_attrs.command_long_desc).to eq('The long description')
+        end
+      end
+
+      context 'for bot' do
+        it 'name' do
+          expect(bot_help_attrs.command_name).to eq('Weather Bot')
+        end
+
+        it 'description' do
+          expect(bot_help_attrs.command_desc).to eq('This bot tells you the weather.')
+        end
+
+        describe 'commands' do
+          let(:clouds_command) { bot_help_attrs.commands.find { |k| k.command_name == 'clouds' } }
+          let(:weather_command) { bot_help_attrs.commands.find { |k| k.command_name == "What's the weather in <city>?" } }
+
+          it 'command name' do
+            expect(clouds_command).to be
+            expect(weather_command).to be
+          end
+
+          it 'command description' do
+            expect(clouds_command.command_desc).to eq("Tells you how many clouds there're above you.")
+            expect(weather_command.command_desc).to eq('Tells you the weather in a <city>.')
+          end
+
+          it 'command long description' do
+            expect(weather_command.command_long_desc).to eq("Accurate 10 Day Weather Forecasts for thousands of places around the World.\n" \
+                                                            'We provide detailed Weather Forecasts over a 10 day period updated four times a day.')
+          end
+        end
+      end
+    end
+  end
+
+  describe '#bot_desc_and_commands' do
+    let(:bot_desc) { commands_helper.bot_desc_and_commands.first }
+
+    it 'returns bot name and description' do
+      expect(bot_desc).to include('*Weather Bot* - This bot tells you the weather.')
+    end
+
+    it 'returns possible commands for bot' do
+      expect(bot_desc).to include("\n\n*Commands:*\n")
+      expect(bot_desc).to include("*clouds* - Tells you how many clouds there're above you.\n")
+      expect(bot_desc).to include("*What's the weather in <city>?* - Tells you the weather in a <city>.")
+    end
+
+    it 'do not return command with empty name' do
+      expect(bot_desc).to_not include('**')
+    end
+
+    it 'do not show description for command without description' do
+      expect(bot_desc).to include("*command_without_description*\n")
+    end
+  end
+
+  describe '#other_commands_descs' do
+    let(:commands_desc) { commands_helper.other_commands_descs }
+    let(:hello_command_desc) { commands_desc.find { |desc| desc =~ /\*hello\*/ } }
+
+    it 'returns command name and description' do
+      expect(hello_command_desc).to eq('*hello* - Says hello.')
+    end
+  end
+
+  describe '#command_full_desc' do
+    context 'for bot commands' do
+      it 'returns long description' do
+        full_desc = commands_helper.command_full_desc("What's the weather in &lt;city&gt;?")
+        expect(full_desc).to include "Accurate 10 Day Weather Forecasts for thousands of places around the World.\n" \
+          'We provide detailed Weather Forecasts over a 10 day period updated four times a day.'
+      end
+    end
+
+    context 'for other commands' do
+      it 'returns long description' do
+        full_desc = commands_helper.command_full_desc('hello')
+        expect(full_desc).to include 'The long description'
+      end
+    end
+
+    it 'returns correct message if there is no such command' do
+      full_desc = commands_helper.command_full_desc('deploy')
+      expect(full_desc).to eq "There's no command *deploy*"
+    end
+
+    it 'returns correct message if there is no long description for the command' do
+      full_desc = commands_helper.command_full_desc('clouds')
+      expect(full_desc).to eq "There's no description for command *clouds*"
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: slack-ruby-bot
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Daniel Doubrovkine
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-05 00:00:00.000000000 Z
+date: 2016-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie
@@ -38,20 +38,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.6.0
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: giphy
   requirement: !ruby/object:Gem::Requirement
@@ -193,6 +179,7 @@ files:
 - lib/slack-ruby-bot/commands/about.rb
 - lib/slack-ruby-bot/commands/base.rb
 - lib/slack-ruby-bot/commands/help.rb
+- lib/slack-ruby-bot/commands/help/attrs.rb
 - lib/slack-ruby-bot/commands/hi.rb
 - lib/slack-ruby-bot/commands/unknown.rb
 - lib/slack-ruby-bot/config.rb
@@ -202,6 +189,7 @@ files:
 - lib/slack-ruby-bot/hooks/message.rb
 - lib/slack-ruby-bot/hooks/set.rb
 - lib/slack-ruby-bot/rspec.rb
+- lib/slack-ruby-bot/rspec/support/bots_for_tests.rb
 - lib/slack-ruby-bot/rspec/support/fixtures/slack/migration_in_progress.yml
 - lib/slack-ruby-bot/rspec/support/slack-ruby-bot/it_behaves_like_a_slack_bot.rb
 - lib/slack-ruby-bot/rspec/support/slack-ruby-bot/respond_with_error.rb
@@ -210,12 +198,14 @@ files:
 - lib/slack-ruby-bot/rspec/support/slack_ruby_bot_configure.rb
 - lib/slack-ruby-bot/rspec/support/vcr.rb
 - lib/slack-ruby-bot/server.rb
+- lib/slack-ruby-bot/support/commands_helper.rb
 - lib/slack-ruby-bot/support/loggable.rb
 - lib/slack-ruby-bot/version.rb
 - lib/slack_ruby_bot.rb
 - screenshots/aliases.gif
 - screenshots/demo.gif
 - screenshots/dms.gif
+- screenshots/help.png
 - screenshots/market.gif
 - screenshots/register-bot.png
 - screenshots/weather.gif
@@ -234,6 +224,7 @@ files:
 - spec/slack-ruby-bot/commands/commands_with_expression_spec.rb
 - spec/slack-ruby-bot/commands/direct_messages_spec.rb
 - spec/slack-ruby-bot/commands/empty_text_spec.rb
+- spec/slack-ruby-bot/commands/help/attrs_spec.rb
 - spec/slack-ruby-bot/commands/help_spec.rb
 - spec/slack-ruby-bot/commands/hi_spec.rb
 - spec/slack-ruby-bot/commands/match_spec.rb
@@ -253,6 +244,7 @@ files:
 - spec/slack-ruby-bot/hooks/set_spec.rb
 - spec/slack-ruby-bot/rspec/respond_with_error_spec.rb
 - spec/slack-ruby-bot/server_spec.rb
+- spec/slack-ruby-bot/support/commands_helper_spec.rb
 - spec/slack-ruby-bot/support/loggable_spec.rb
 - spec/slack-ruby-bot/version_spec.rb
 - spec/spec_helper.rb
@@ -276,7 +268,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.6
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: The easiest way to write a Slack bot in Ruby.
@@ -294,6 +286,7 @@ test_files:
 - spec/slack-ruby-bot/commands/commands_with_expression_spec.rb
 - spec/slack-ruby-bot/commands/direct_messages_spec.rb
 - spec/slack-ruby-bot/commands/empty_text_spec.rb
+- spec/slack-ruby-bot/commands/help/attrs_spec.rb
 - spec/slack-ruby-bot/commands/help_spec.rb
 - spec/slack-ruby-bot/commands/hi_spec.rb
 - spec/slack-ruby-bot/commands/match_spec.rb
@@ -313,6 +306,7 @@ test_files:
 - spec/slack-ruby-bot/hooks/set_spec.rb
 - spec/slack-ruby-bot/rspec/respond_with_error_spec.rb
 - spec/slack-ruby-bot/server_spec.rb
+- spec/slack-ruby-bot/support/commands_helper_spec.rb
 - spec/slack-ruby-bot/support/loggable_spec.rb
 - spec/slack-ruby-bot/version_spec.rb
 - spec/spec_helper.rb