Class: SlackRubyBot::Commands::Base

Inherits:
Object
  • Object
show all
Includes:
Loggable
Defined in:
lib/slack-ruby-bot/commands/base.rb

Direct Known Subclasses

Bot, Default, Help, Hi, Unknown, Testing::HelloCommand

Class Attribute Summary collapse

Class Method Summary collapse

Methods included from Loggable

included

Class Attribute Details

.command_classesObject

Returns the value of attribute command_classes.



12
13
14
# File 'lib/slack-ruby-bot/commands/base.rb', line 12

def command_classes
  @command_classes
end

Class Method Details

.attachment(match, fields_to_scan = nil, &block) ⇒ Object



81
82
83
84
85
86
87
88
# File 'lib/slack-ruby-bot/commands/base.rb', line 81

def attachment(match, fields_to_scan = nil, &block)
  fields_to_scan = [fields_to_scan] unless fields_to_scan.nil? || fields_to_scan.is_a?(Array)
  routes[match] = {
    match_method: :attachment,
    block: block,
    fields_to_scan: fields_to_scan
  }
end

.bot_matcherObject



90
91
92
# File 'lib/slack-ruby-bot/commands/base.rb', line 90

def bot_matcher
  '(?<bot>\S*)'
end

.command(*values, &block) ⇒ Object



32
33
34
35
# File 'lib/slack-ruby-bot/commands/base.rb', line 32

def command(*values, &block)
  values = values.map { |value| value.is_a?(Regexp) ? value.source : Regexp.escape(value) }.join('|')
  match Regexp.new("^#{bot_matcher}[[:space:]]+(?<command>#{values})([[:space:]]+(?<expression>.*)|)$", Regexp::IGNORECASE | Regexp::MULTILINE), &block
end

.command_name_from_classObject



23
24
25
# File 'lib/slack-ruby-bot/commands/base.rb', line 23

def command_name_from_class
  name ? name.split(':').last.downcase : object_id.to_s
end

.help(&block) ⇒ Object



19
20
21
# File 'lib/slack-ruby-bot/commands/base.rb', line 19

def help(&block)
  Support::Help.instance.capture_help(self, &block)
end

.inherited(subclass) ⇒ Object



14
15
16
17
# File 'lib/slack-ruby-bot/commands/base.rb', line 14

def inherited(subclass)
  SlackRubyBot::Commands::Base.command_classes ||= []
  SlackRubyBot::Commands::Base.command_classes << subclass
end

.invoke(client, data) ⇒ Object



37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# File 'lib/slack-ruby-bot/commands/base.rb', line 37

def invoke(client, data)
  finalize_routes!
  expression, text = parse(client, data)
  return false unless expression || data.attachments

  routes.each_pair do |route, options|
    match_method = options[:match_method]
    case match_method
    when :match
      next unless expression

      match = route.match(expression)
      match ||= route.match(text) if text
      next unless match
      next if match.names.include?('bot') && !client.name?(match['bot'])

      match = Support::Match.new(match)
    when :scan
      next unless expression

      match = expression.scan(route)
      next unless match.any?
    when :attachment
      next unless data.attachments && !data.attachments.empty?

      match, attachment, field = match_attachments(data, route, options[:fields_to_scan])
      next unless match

      match = Support::Match.new(match, attachment, field)
    end
    call_command(client, data, match, options[:block])
    return true
  end
  false
end

.match(match, &block) ⇒ Object



73
74
75
# File 'lib/slack-ruby-bot/commands/base.rb', line 73

def match(match, &block)
  routes[match] = { match_method: :match, block: block }
end

.operator(*values, &block) ⇒ Object



27
28
29
30
# File 'lib/slack-ruby-bot/commands/base.rb', line 27

def operator(*values, &block)
  values = values.map { |value| Regexp.escape(value) }.join('|')
  match Regexp.new("^(?<operator>#{values})(?<expression>.*)$", Regexp::IGNORECASE), &block
end

.routesObject



94
95
96
# File 'lib/slack-ruby-bot/commands/base.rb', line 94

def routes
  @routes ||= ActiveSupport::OrderedHash.new
end

.scan(match, &block) ⇒ Object



77
78
79
# File 'lib/slack-ruby-bot/commands/base.rb', line 77

def scan(match, &block)
  routes[match] = { match_method: :scan, block: block }
end