@attr_reader [String] authname @attr_reader [String, nil] away The user’s away message, or
`nil` if not away.
@attr_reader [Array<Channel>] channels All channels the user is
in.
@attr_reader [String] host @attr_reader [Integer] idle How long this user has been idle, in seconds.
This is a snapshot of the last WHOIS.
@attr_reader [String] nick The user’s nickname @attr_reader [Boolean] online True if the user is online. @attr_reader [Boolean] oper True if the user is an IRC operator. @attr_reader [String] realname @attr_reader [Boolean] secure True if the user is using a secure
connection, i.e. SSL.
@attr_reader [Time] signed_on_at @attr_reader [Boolean] unknown True if the instance references an user who
cannot be found on the server.
@attr_reader [String] user
@version 2.0.0
By default, you can use methods like {user}, {host} and alike – If you however fear that another thread might change data while you’re using it and if this means a critical issue to your code, you can store a clone of the result of this method and work with that instead.
@example
on :channel do |m| data = m.user.data.dup do_something_with(data.user) do_something_with(data.host) end
@return [Hash]
# File lib/cinch/user.rb, line 184 def initialize(*args) @data = { :user => nil, :host => nil, :realname => nil, :authname => nil, :idle => 0, :signed_on_at => nil, :unknown? => false, :online? => false, :channels => [], :secure? => false, :away => nil, :oper? => false, } case args.size when 2 @name, @bot = args when 4 @data[:user], @name, @data[:host], @bot = args else raise ArgumentError end @synced_attributes = Set.new @when_requesting_synced_attribute = lambda {|attr| unless attribute_synced?(attr) @data[:unknown?] = false unsync :unknown? whois end } @monitored = false end
@see Syncable#attr
# File lib/cinch/user.rb, line 232 def attr(attribute, data = true, unsync = false) super end
Checks if the user is identified. Currently officially supports Quakenet and Freenode.
@return [Boolean] true if the user is identified @version 1.1.0
# File lib/cinch/user.rb, line 227 def authed? !attr(:authname).nil? end
# File lib/cinch/user.rb, line 57 def authname attr(:authname, true, false) end
@private
# File lib/cinch/user.rb, line 113 def authname_unynced attr(:authname, true, true) end
# File lib/cinch/user.rb, line 82 def channels attr(:channels, true, false) end
@private
# File lib/cinch/user.rb, line 140 def channels_unsynced attr(:channels, true, true) end
Send data via DCC SEND to a user.
@param [DCC::DCCableObject] io @param [String] filename @since 2.0.0 @return [void] @note This method blocks.
# File lib/cinch/user.rb, line 405 def dcc_send(io, filename = File.basename(io.path)) own_ip = bot.config.dcc.own_ip || @bot.irc.socket.addr[2] dcc = DCC::Outgoing::Send.new(receiver: self, filename: filename, io: io, own_ip: own_ip ) dcc.start_server handler = Handler.new(@bot, :message, Pattern.new(/^/, /\0001DCC RESUME #{filename} #{dcc.port} (\d+)\0001/, /$/)) do |m, position| next unless m.user == self dcc.seek(position.to_i) m.user.send "\0001DCC ACCEPT #{filename} #{dcc.port} #{position}\0001" handler.unregister end @bot.handlers.register(handler) @bot.loggers.info "DCC: Outgoing DCC SEND: File name: %s - Size: %dB - IP: %s - Port: %d - Status: waiting" % [filename, io.size, own_ip, dcc.port] dcc.send_handshake begin dcc.listen @bot.loggers.info "DCC: Outgoing DCC SEND: File name: %s - Size: %dB - IP: %s - Port: %d - Status: done" % [filename, io.size, own_ip, dcc.port] rescue Timeout::Error @bot.loggers.info "DCC: Outgoing DCC SEND: File name: %s - Size: %dB - IP: %s - Port: %d - Status: failed (timeout)" % [filename, io.size, own_ip, dcc.port] ensure handler.unregister end end
@param [Hash, nil] values A hash of values gathered from WHOIS,
or `nil` if no data was returned
@param [Boolean] not_found Has to be true if WHOIS resulted in
an unknown user
@return [void] @api private @since 1.0.1
# File lib/cinch/user.rb, line 263 def end_of_whois(values, not_found = false) @in_whois = false if not_found sync(:unknown?, true, true) self.online = false sync(:idle, 0, true) sync(:channels, [], true) fields = @data.keys fields.delete(:unknown?) fields.delete(:idle) fields.delete(:channels) fields.each do |field| sync(field, nil, true) end return end if values.nil? # for some reason, we did not receive user information. one # reason is freenode throttling WHOIS Thread.new do sleep 2 whois end return end { :authname => nil, :idle => 0, :secure? => false, :oper? => false, :channels => [], }.merge(values).each do |attr, value| sync(attr, value, true) end sync(:unknown?, false, true) self.online = true end
# File lib/cinch/user.rb, line 49 def host attr(:host, true, false) end
@private
# File lib/cinch/user.rb, line 103 def host_unsynced attr(:host, true, true) end
# File lib/cinch/user.rb, line 61 def idle attr(:idle, true, false) end
@private
# File lib/cinch/user.rb, line 118 def idle_unsynced attr(:idle, true, true) end
@return [String]
# File lib/cinch/user.rb, line 320 def inspect "#<User nick=#{@name.inspect}>" end
Generates a mask for the user.
@param [String] s a pattern for generating the mask.
- %n = nickname - %u = username - %h = host - %r = realname - %a = authname
@return [Mask]
# File lib/cinch/user.rb, line 335 def mask(s = "%n!%u@%h") s = s.gsub(/%(.)/) { case $1 when "n" @name when "u" self.user when "h" self.host when "r" self.realname when "a" self.authname end } Mask.new(s) end
Check if the user matches a mask.
@param [Ban, Mask, User, String] other The user or mask to match against @return [Boolean]
# File lib/cinch/user.rb, line 358 def match(other) Mask.from(other) =~ Mask.from(self) end
Starts monitoring a user’s online state by either using MONITOR or periodically running WHOIS.
@since 2.0.0 @return [void] @see unmonitor
# File lib/cinch/user.rb, line 369 def monitor if @bot.irc.isupport["MONITOR"] > 0 @bot.irc.send "MONITOR + #@name" else refresh @monitored_timer = Timer.new(@bot, interval: 30) { refresh } @monitored_timer.start end @monitored = true end
@note This attribute will be updated by various events, but unless {monitor} is being used, this information cannot be ensured to be always correct.
# File lib/cinch/user.rb, line 77 def online attr(:online?, true, false) end
Updates the user’s online state and dispatch the correct event.
@since 2.0.0 @return [void] @api private
# File lib/cinch/user.rb, line 444 def online=(bool) notify = self.__send__("online?_unsynced") != bool && @monitored sync(:online?, bool, true) return unless notify if bool @bot.handlers.dispatch(:online, nil, self) else @bot.handlers.dispatch(:offline, nil, self) end end
@private
# File lib/cinch/user.rb, line 134 def online_unsynced attr(:online?, true, true) end
@since 2.1.0
# File lib/cinch/user.rb, line 92 def oper attr(:oper?, true, false) end
@private @since 2.1.0
# File lib/cinch/user.rb, line 152 def oper_unsynced attr(:oper?, true, true) end
# File lib/cinch/user.rb, line 53 def realname attr(:realname, true, false) end
@private
# File lib/cinch/user.rb, line 108 def realname_unsynced attr(:realname, true, true) end
# File lib/cinch/user.rb, line 86 def secure attr(:secure?, true, false) end
@private
# File lib/cinch/user.rb, line 145 def secure_unsynced attr(:secure?, true, true) end
# File lib/cinch/user.rb, line 65 def signed_on_at attr(:signed_on_at, true, false) end
@private
# File lib/cinch/user.rb, line 123 def signed_on_at_unsynced attr(:signed_on_at, true, true) end
@return [String]
# File lib/cinch/user.rb, line 315 def to_s @name end
# File lib/cinch/user.rb, line 69 def unknown attr(:unknown?, true, false) end
@private
# File lib/cinch/user.rb, line 128 def unknown_unsynced attr(:unknown?, true, true) end
Stops monitoring a user’s online state.
@since 2.0.0 @return [void] @see monitor
# File lib/cinch/user.rb, line 388 def unmonitor if @bot.irc.isupport["MONITOR"] > 0 @bot.irc.send "MONITOR - #@name" else @monitored_timer.stop if @monitored_timer end @monitored = false end
@return [void] @since 1.0.1 @api private @see Syncable#unsync_all
# File lib/cinch/user.rb, line 310 def unsync_all super end
Used to update the user’s nick on nickchange events.
@param [String] new_nick The user’s new nick @api private @return [void]
# File lib/cinch/user.rb, line 461 def update_nick(new_nick) @last_nick, @name = @name, new_nick # Unsync authname because some networks tie authentication to # the nick, so the user might not be authenticated anymore after # changing his nick unsync(:authname) @bot.user_list.update_nick(self) end
# File lib/cinch/user.rb, line 45 def user attr(:user, true, false) end
@private
# File lib/cinch/user.rb, line 98 def user_unsynced attr(:user, true, true) end
Queries the IRC server for information on the user. This will set the User’s state to not synced. After all information are received, the object will be set back to synced.
@return [void]
# File lib/cinch/user.rb, line 241 def whois return if @in_whois @data.keys.each do |attr| unsync attr end @in_whois = true if @bot.irc.network.whois_only_one_argument? @bot.irc.send "WHOIS #@name" else @bot.irc.send "WHOIS #@name #@name" end end
Generated with the Darkfish Rdoc Generator 2.