Class: Irc::UserMessage

Inherits:

BasicUserMessage

• Object
• BasicUserMessage
• Irc::UserMessage

show all

Defined in:

/home/apoc/projects/ruby/rbot/lib/rbot/message.rb

Overview

Instance Attribute Summary (collapse)

• - (Object) action readonly

  for PRIVMSGs, true if the message was a CTCP ACTION (CTCP stuff will be stripped from the message).

• - (Object) channel readonly

  channel the message was in, nil for privately addressed messages.

• - (Object) ctcp readonly

  for PRIVMSGs, false unless the message was a CTCP command, in which case it evaluates to the CTCP command itself (TIME, PING, VERSION, etc).

• - (Object) params readonly

  for plugin messages, the rest of the message, with the plugin name removed.

• - (Object) plugin readonly

  for plugin messages, the name of the plugin invoked by the message.

• - (Object) replyto readonly

  convenience member.

Attributes inherited from BasicUserMessage

#bot, #ignored, #in_thread, #logmessage, #message, #plainmessage, #replied, #server, #source, #target, #time

Instance Method Summary (collapse)

• - (Object) act(string, options = {})

  convenience method to reply to a message with an action.

• - (Boolean) action?
• - (Object) ctcp_reply(string, options = {})

  send a CTCP response, i.e.

• - (UserMessage) initialize(bot, server, source, target, message) constructor

  instantiate a new UserMessage bot

  associated bot class source

  hostmask of the message source target

  nick/channel message is destined for message

  message part.

• - (Object) inspect
• - (Object) nickokay

  Like the above, but append the username.

• - (Object) nickreply(string, options = {})

  Same as reply, but when replying in public it adds the nick of the user the bot is replying to.

• - (Object) nickreply!(string, options = {})

  Same as nickreply, but always prepend the target's nick.

• - (Object) notify(msg, opts = {})

  send a NOTICE to the message source.

• - (Object) okay

  the default okay style is the same as the default reply style.

• - (Object) plainokay

  convenience method to reply “okay” in the current language to the message.

• - (Object) plainreply(string, options = {})

  convenience method to reply to a message, useful in plugins.

• - (Boolean) private?

  returns true for private messages, e.g.

• - (Boolean) public?

  returns true if the message was in a channel.

• - (Object) reply(string, options = {})

  The general way to reply to a command.

Methods inherited from BasicUserMessage

#address?, #botuser, #identified?, #parse_channel_list, #prefixed?, #recurse_depth, #recurse_depth=, #sourceaddress, #sourcenick, strip_formatting, strip_initial_formatting, stripcolour

333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 333

def initialize(bot, server, source, target, message)
  super(bot, server, source, target, message)
  @target = target
  @private = false
  @plugin = nil
  @ctcp = false
  @action = false

  if target == @bot.myself
    @private = true
    @address = true
    @channel = nil
    @replyto = source
  else
    @replyto = @target
    @channel = @target
  end

  # check for option extra addressing prefixes, e.g "|search foo", or
  # "!version" - first match wins
  bot.config['core.address_prefix'].each {|mprefix|
    if @message.gsub!(/^#{Regexp.escape(mprefix)}\s*/, "")
      @address = true
      @prefixed = true
      break
    end
  }

  # even if they used above prefixes, we allow for silly people who
  # combine all possible types, e.g. "|rbot: hello", or
  # "/msg rbot rbot: hello", etc
  if @message.gsub!(/^\s*#{Regexp.escape(bot.nick)}\s*([:;,>]|\s)\s*/i, "")
    @address = true
  end

  if(@message =~ /^\001(\S+)(\s(.+))?\001/)
    @ctcp = $1
	# FIXME need to support quoting of NULL and CR/LF, see
	# http://www.irchelp.org/irchelp/rfc/ctcpspec.html
    @message = $3 || String.new
    @action = @ctcp == 'ACTION'
    debug "Received CTCP command #{@ctcp} with options #{@message} (action? #{@action})"
    @logmessage = @message.dup
    @plainmessage = BasicUserMessage.strip_formatting(@message)
    @message = BasicUserMessage.strip_initial_formatting(@message)
  end

  # free splitting for plugins
  @params = @message.dup
  # Created messges (such as by fake_message) can contain multiple lines
  if @params.gsub!(/\A\s*(\S+)[\s$]*/m, "")
    @plugin = $1.downcase
    @params = nil unless @params.length > 0
  end
end

326
327
328

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 326

def action
  @action
end

316
317
318

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 316

def channel
  @channel
end

322
323
324

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 322

def ctcp
  @ctcp
end

308
309
310

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 308

def params
  @params
end

304
305
306

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 304

def plugin
  @plugin
end

313
314
315

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 313

def replyto
  @replyto
end

466
467
468
469

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 466

def act(string, options={})
  @bot.action @replyto, string, options
  @replied = true
end

399
400
401

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 399

def action?
  return @action
end

473
474
475

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 473

def ctcp_reply(string, options={})
  @bot.ctcp_notice @source, @ctcp, string, options
end

285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 285

def inspect
  fields = ' plugin=' << plugin.inspect
  fields << ' params=' << params.inspect
  fields << ' channel=' << channel.to_s if channel
  fields << ' (reply to ' << replyto.to_s << ')'
  if self.private?
    fields << ' (private)'
  else
    fields << ' (public)'
  end
  if self.action?
    fields << ' (action)'
  elsif ctcp
    fields << ' (CTCP ' << ctcp << ')'
  end
  super(fields)
end

484
485
486
487
488
489
490
491
492

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 484

def nickokay
  str = @bot.lang.get("okay").dup
  if self.public?
    # remove final punctuation
    str.gsub!(/[!,.]$/,"")
    str += ", #{@source}"
  end
  self.reply str, :nick => false
end

414
415
416

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 414

def nickreply(string, options={})
  reply string, {:nick => true}.merge(options)
end

419
420
421

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 419

def nickreply!(string, options={})
  reply string, {:nick => true, :forcenick => true}.merge(options)
end

502
503
504

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 502

def notify(msg,opts={})
  @bot.notice(sourcenick, msg, opts)
end

496
497
498

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 496

def okay
  @bot.config['core.reply_with_nick'] ? nickokay : plainokay
end

479
480
481

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 479

def plainokay
  self.reply @bot.lang.get("okay"), :nick => false
end

408
409
410

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 408

def plainreply(string, options={})
  reply string, {:nick => false}.merge(options)
end

390
391
392

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 390

def private?
  return @private
end

395
396
397

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 395

def public?
  return !@private
end

state if the nick of the user calling the command should be prepended
:auto uses core.reply_with_nick

if :nick is true, always prepend the target's nick, even if the nick
already appears in the reply. Defaults to false.

where should the bot reply?
:private always reply to the nick
:public reply to the channel (if available)
:auto uses core.private_replies

437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459

# File '/home/apoc/projects/ruby/rbot/lib/rbot/message.rb', line 437

def reply(string, options={})
  opts = {:nick => :auto, :forcenick => false, :to => :auto}.merge options

  if opts[:nick] == :auto
    opts[:nick] = @bot.config['core.reply_with_nick']
  end

  if !self.public?
    opts[:to] = :private
  elsif opts[:to] == :auto
    opts[:to] = @bot.config['core.private_replies'] ? :private : :public
  end

  if (opts[:nick] &&
      opts[:to] != :private &&
      (string !~ /(?:^|\W)#{Regexp.escape(@source.to_s)}(?:$|\W)/ ||
        opts[:forcenick]))
    string = "#{@source}#{@bot.config['core.nick_postfix']} #{string}"
  end
  to = (opts[:to] == :private) ? source : @channel
  @bot.say to, string, options
  @replied = true
end