Class: Cinch::Target

Inherits:
Object
  • Object
show all
Includes:
Comparable
Defined in:
lib/cinch/target.rb

Overview

Since:

  • 2.0.0

Direct Known Subclasses

Channel, User

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, bot) ⇒ Target

Returns a new instance of Target.

Since:

  • 2.0.0



12
13
14
15
 
# File 'lib/cinch/target.rb', line 12

def initialize(name, bot)
  @name = name
  @bot = bot
end

Instance Attribute Details

#bot ⇒ Bot (readonly)

Returns:

Since:

  • 2.0.0



11
12
13
 
# File 'lib/cinch/target.rb', line 11

def bot
  @bot
end

#name ⇒ String (readonly)

Returns:

Since:

  • 2.0.0



9
10
11
 
# File 'lib/cinch/target.rb', line 9

def name
  @name
end

Instance Method Details

#<=>(other) ⇒ -1, ...

Parameters:

Returns:

Since:

  • 2.0.0



151
152
153
154
155
156
157
158
159
160
 
# File 'lib/cinch/target.rb', line 151

def <=>(other)
  casemapping = @bot.irc.isupport["CASEMAPPING"]
  left = @name.irc_downcase(casemapping)

  if other.is_a?(Target)
    left <=> other.name.irc_downcase(casemapping)
  elsif other.is_a?(String)
    left <=> other.irc_downcase(casemapping)
  end
end

#action(text) ⇒ void

This method returns an undefined value.

Invoke an action (/me) in/to the target.

Parameters:

  • the message to send

See Also:

Since:

  • 2.0.0



107
108
109
110
 
# File 'lib/cinch/target.rb', line 107

def action(text)
  line = text.to_s.each_line.first.chomp
  @bot.irc.send("PRIVMSG #{@name} :\001ACTION #{line}\001")
end

#concretize ⇒ Object

Since:

  • 2.0.0



136
137
138
139
140
141
142
 
# File 'lib/cinch/target.rb', line 136

def concretize
  if @bot.isupport["CHANTYPES"].include?(@name[0])
    @bot.channel_list.find_ensured(@name)
  else
    @bot.user_list.find_ensured(@name)
  end
end

#ctcp(message) ⇒ void

This method returns an undefined value.

Send a CTCP to the target.

Parameters:

  • the ctcp message

Since:

  • 2.0.0



132
133
134
 
# File 'lib/cinch/target.rb', line 132

def ctcp(message)
  send :"\001#{message}\001"
end

#eql?(other) ⇒ Boolean

Returns:

Since:

  • 2.0.0



145
146
147
 
# File 'lib/cinch/target.rb', line 145

def eql?(other)
  self == other
end

#msg(*args) ⇒ Object

Deprecated.

Since:

  • 2.0.0



53
54
55
56
 
# File 'lib/cinch/target.rb', line 53

def msg(*args)
  Cinch::Utilities::Deprecation.print_deprecation("2.2.0", "Target#msg", "Target#send")
  send(*args)
end

#notice(text) ⇒ void

This method returns an undefined value.

Sends a NOTICE to the target.

Parameters:

  • the message to send

See Also:

Since:

  • 2.0.0



22
23
24
 
# File 'lib/cinch/target.rb', line 22

def notice(text)
  send(text, true)
end

#privmsg(*args) ⇒ Object

Deprecated.

Since:

  • 2.0.0



59
60
61
62
 
# File 'lib/cinch/target.rb', line 59

def privmsg(*args)
  Cinch::Utilities::Deprecation.print_deprecation("2.2.0", "Target#privmsg", "Target#send")
  send(*args)
end

#safe_action(text) ⇒ void

This method returns an undefined value.

Like #action, but remove any non-printable characters from ‘text`. The purpose of this method is to send text from untrusted sources, like other users or feeds.

Note: this will break any mIRC color codes embedded in the string. For more fine-grained control, use Helpers#Sanitize and Formatting.unformat directly.

Parameters:

  • the message to send

See Also:

Since:

  • 2.0.0



124
125
126
 
# File 'lib/cinch/target.rb', line 124

def safe_action(text)
  action(Cinch::Helpers.sanitize(text))
end

#safe_msg(*args) ⇒ Object

Deprecated.

Since:

  • 2.0.0



81
82
83
84
 
# File 'lib/cinch/target.rb', line 81

def safe_msg(*args)
  Cinch::Utilities::Deprecation.print_deprecation("2.2.0", "Target#safe_msg", "Target#safe_send")
  safe_send(*args)
end

#safe_notice(text) ⇒ Object

Like #safe_msg but for notices.

See Also:

Since:

  • 2.0.0



98
99
100
 
# File 'lib/cinch/target.rb', line 98

def safe_notice(text)
  safe_send(text, true)
end

#safe_privmsg(*args) ⇒ Object

Deprecated.

Since:

  • 2.0.0



87
88
89
90
 
# File 'lib/cinch/target.rb', line 87

def safe_privmsg(*args)
  Cinch::Utilities::Deprecation.print_deprecation("2.2.0", "Target#safe_privmsg", "Target#safe_send")
  safe_send(*args)
end

#safe_send(text, notice = false) ⇒ void

This method returns an undefined value.

Like #send, but remove any non-printable characters from ‘text`. The purpose of this method is to send text of untrusted sources, like other users or feeds.

Note: this will break any mIRC color codes embedded in the string. For more fine-grained control, use Helpers#Sanitize and Formatting.unformat directly.

Parameters:

  • the message to send

  • (defaults to: false)

    Use NOTICE instead of PRIVMSG?

See Also:

Since:

  • 2.0.0



76
77
78
 
# File 'lib/cinch/target.rb', line 76

def safe_send(text, notice = false)
  send(Cinch::Helpers.sanitize(text), notice)
end

#send(text, notice = false) ⇒ void

Note:

The aliases ‘msg` and `privmsg` are deprecated and will be removed in a future version.

This method returns an undefined value.

Sends a PRIVMSG to the target.

Parameters:

  • the message to send

  • (defaults to: false)

    Use NOTICE instead of PRIVMSG?

See Also:

Since:

  • 2.0.0



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/cinch/target.rb', line 34

def send(text, notice = false)
  # TODO deprecate `notice` argument, put splitting into own
  # method
  text = text.to_s
  split_start = @bot.config.message_split_start || ""
  split_end = @bot.config.message_split_end || ""
  command = notice ? "NOTICE" : "PRIVMSG"
  prefix = ":#{@bot.mask} #{command} #{@name} :"

  text.lines.map(&:chomp).each do |line|
    splitted = split_message(line, prefix, split_start, split_end)

    splitted[0, (@bot.config.max_messages || splitted.size)].each do |string|
      @bot.irc.send("#{command} #{@name} :#{string}")
    end
  end
end