Home | Trees | Index | Help |
---|
Package twisted :: Package protocols :: Module irc :: Class IRCClient |
|
BaseProtocol
--+ |Protocol
--+ |LineReceiver
--+ | IRCClient
TendrilIRC
,
IRCProto
,
IRCClientWithoutLogin
Internet Relay Chat client protocol, with sprinkles.
In addition to providing an interface for an IRC client protocol, this class also contains reasonable implementations of many common CTCP methods.Method Summary | |
---|---|
__getstate__(self)
| |
Called when I see a user perform an ACTION on a channel. | |
away(self,
message)
| |
When I get a message that's so broken I can't use it. | |
(Deprecated) (inherited from Protocol )
| |
Called when the connection is shut down. (inherited from Protocol )
| |
Called when a connection is made. | |
Send one or more extended messagesas a CTCP query. | |
Send one or more extended messagesas a CTCP reply. | |
Dispatch method for any CTCP queries received. | |
ctcpQuery_ACTION(self,
user,
channel,
data)
| |
A master index of what CTCP tags this client knows. | |
Initiate a Direct Client Connection | |
ctcpQuery_ERRMSG(self,
user,
channel,
data)
| |
ctcpQuery_FINGER(self,
user,
channel,
data)
| |
ctcpQuery_PING(self,
user,
channel,
data)
| |
ctcpQuery_SOURCE(self,
user,
channel,
data)
| |
ctcpQuery_TIME(self,
user,
channel,
data)
| |
ctcpQuery_USERINFO(self,
user,
channel,
data)
| |
ctcpQuery_VERSION(self,
user,
channel,
data)
| |
Dispatch method for any CTCP replies received. | |
ctcpReply_PING(self,
user,
channel,
data)
| |
ctcpUnknownQuery(self,
user,
channel,
tag,
data)
| |
Called when a fitting ctcpReply_ method is not found. | |
Protocol.dataReceived. | |
dcc_ACCEPT(self,
user,
channel,
data)
| |
dcc_CHAT(self,
user,
channel,
data)
| |
dcc_RESUME(self,
user,
channel,
data)
| |
dcc_SEND(self,
user,
channel,
data)
| |
Send a DCC ACCEPT response to clients who have requested a resume. | |
Called when a client has verified and accepted a DCC resume request made by us. | |
dccDoChat(self,
user,
channel,
address,
port,
data)
| |
Called when a client is trying to resume an offered file via DCC send. | |
Called when I receive a DCC SEND offer from a client. | |
Send a DCC RESUME request to another user. | |
dccSend(self,
user,
file)
| |
Determine the function to call for the given command and call it with the given arguments. | |
irc_ERR_NICKNAMEINUSE(self,
prefix,
params)
| |
irc_ERR_PASSWDMISMATCH(self,
prefix,
params)
| |
irc_JOIN(self,
prefix,
params)
| |
Kicked? Who? Not me, I hope. | |
irc_MODE(self,
prefix,
params)
| |
irc_NICK(self,
prefix,
params)
| |
irc_NOTICE(self,
prefix,
params)
| |
irc_PART(self,
prefix,
params)
| |
irc_PING(self,
prefix,
params)
| |
irc_PRIVMSG(self,
prefix,
params)
| |
irc_RPL_ENDOFMOTD(self,
prefix,
params)
| |
irc_RPL_MOTD(self,
prefix,
params)
| |
irc_RPL_MOTDSTART(self,
prefix,
params)
| |
irc_RPL_NOTOPIC(self,
prefix,
params)
| |
I just joined the channel, and the server is telling me the current topic. | |
irc_RPL_WELCOME(self,
prefix,
params)
| |
Someone in the channel set the topic. | |
irc_unknown(self,
prefix,
command,
params)
| |
join(self,
channel,
key)
| |
Called when I finish joining a channel. | |
Called when I am kicked from a channel. | |
leave(self,
channel,
reason)
| |
Called when I have left a channel. | |
Called when the maximum line length has been reached. (inherited from LineReceiver )
| |
Override this for when each line is received. | |
Strike a pose. | |
Change the modes on a user or channel. | |
Called when a channel's modes are changed | |
msg(self,
user,
message,
length)
| |
Called when my nick has been changed. | |
notice(self,
user,
message)
| |
Called when I have a notice from a user to me or a channel. | |
part(self,
channel,
reason)
| |
Measure round-trip delay to another IRC client. | |
Called with the results of a CTCP PING query. | |
Called when I have a message from a user to me or a channel. | |
This is called when I receive a message which is peculiar, but not wholly indecipherable. | |
quit(self,
message)
| |
Override this for when raw data is received. (inherited from LineReceiver )
| |
I received a message-of-the-day banner from the server. | |
register(self,
nickname,
hostname,
servername)
| |
say(self,
channel,
message,
length)
| |
Sends a line to the other end of the connection. | |
Sets the line-mode of this receiver. (inherited from LineReceiver )
| |
setNick(self,
nickname)
| |
Sets the raw mode of this receiver. (inherited from LineReceiver )
| |
Called after sucessfully signing on to the server. | |
Attempt to set the topic of the given channel, or ask what it is. | |
In channel, user changed the topic to newTopic. | |
Called when I see another user joining a channel. | |
Called when I observe someone else being kicked from a channel. | |
Called when I see another user leaving a channel. | |
A user changed their name from oldname to newname. |
Instance Variable Summary | |
---|---|
fingerReply
- Sent in reply to a FINGERCTCP query. | |
lineRate
- Minimum delay between lines sent to the server. | |
nickname
- Nickname the client will use. | |
password
- Password used to log on to the server. | |
realname
- Supplied to the server during login as the "Real name" or
"ircname". | |
sourceURL
- CTCP SOURCE reply, a URL where the source code of this client may be
found. | |
userinfo
- Sent in reply to a USERINFOCTCP query. | |
versionEnv
- CTCP VERSION reply, environment the client is running in. | |
versionName
- CTCP VERSION reply, client name. | |
versionNum
- CTCP VERSION reply, client version, |
Class Variable Summary | |
---|---|
str |
__pychecker__
|
str |
dcc_destdir
|
NoneType |
dcc_sessions
|
str |
delimiter
|
Callable or String | fingerReply
|
Number of Seconds. | lineRate
|
str |
motd
|
str |
nickname
|
NoneType |
password
|
int |
performLogin
|
NoneType |
realname
|
str |
sourceURL
|
NoneType |
userinfo
|
NoneType |
versionEnv
|
NoneType |
versionName
|
NoneType |
versionNum
|
Method Details |
---|
action(self, user, channel, data)Called when I see a user perform an ACTION on a channel. |
badMessage(self, line, excType, excValue, tb)When I get a message that's so broken I can't use it. |
connectionMade(self)Called when a connection is made. This may be considered the initializer of the protocol, because it is called when the connection is completed. For clients, this is called once the connection to the server has been established; for servers, this is called after an accept() call stops blocking and a socket has been received. If you need to send any greeting or initial message, do it here.
|
ctcpQuery(self, user, channel, messages)Dispatch method for any CTCP queries received. |
ctcpQuery_CLIENTINFO(self, user, channel, data)A master index of what CTCP tags this client knows. If no arguments are provided, respond with a list of known tags. If an argument is provided, provide human-readable help on the usage of that tag. |
ctcpQuery_DCC(self, user, channel, data)Initiate a Direct Client Connection |
ctcpReply(self, user, channel, messages)Dispatch method for any CTCP replies received. |
ctcpUnknownReply(self, user, channel, tag, data)Called when a fitting ctcpReply_ method is not found. XXX: If the client makes arbitrary CTCP queries, this method should probably show the responses to them instead of treating them as anomolies. |
dataReceived(self, data)Protocol.dataReceived. Translates bytes into lines, and calls lineReceived (or rawDataReceived, depending on mode.)
|
dccAcceptResume(self, user, fileName, port, resumePos)Send a DCC ACCEPT response to clients who have requested a resume. |
dccDoAcceptResume(self, user, file, port, resumePos)Called when a client has verified and accepted a DCC resume request made by us. By default it will do nothing. |
dccDoResume(self, user, file, port, resumePos)Called when a client is trying to resume an offered file via DCC send. It should be either replied to with a DCC ACCEPT or ignored (default). |
dccDoSend(self, user, address, port, fileName, size, data)Called when I receive a DCC SEND offer from a client. By default, I do nothing here. |
dccResume(self, user, fileName, port, resumePos)Send a DCC RESUME request to another user. |
handleCommand(self, command, prefix, params)Determine the function to call for the given command and call it with the given arguments. |
irc_KICK(self, prefix, params)Kicked? Who? Not me, I hope. |
irc_RPL_TOPIC(self, prefix, params)I just joined the channel, and the server is telling me the current topic. |
irc_TOPIC(self, prefix, params)Someone in the channel set the topic. |
joined(self, channel)Called when I finish joining a channel. channel has the starting character (# or &) intact. |
kickedFrom(self, channel, kicker, message)Called when I am kicked from a channel. |
left(self, channel)Called when I have left a channel. channel has the starting character (# or &) intact. |
lineReceived(self, line)Override this for when each line is received.
|
me(self, channel, action)Strike a pose. |
mode(self, chan, set, modes, limit=None, user=None, mask=None)Change the modes on a user or channel. |
modeChanged(self, user, channel, set, modes, args)Called when a channel's modes are changed
|
nickChanged(self, nick)Called when my nick has been changed. |
noticed(self, user, channel, message)Called when I have a notice from a user to me or a channel. By default, this is equivalent to IRCClient.privmsg, but if your client makes any automated replies, you must override this! From the RFC:The difference between NOTICE and PRIVMSG is that automatic replies MUST NEVER be sent in response to a NOTICE message. [...] The object of this rule is to avoid loops between clients automatically sending something in response to something it received. |
ping(self, user)Measure round-trip delay to another IRC client. |
pong(self, user, secs)Called with the results of a CTCP PING query. |
privmsg(self, user, channel, message)Called when I have a message from a user to me or a channel. |
quirkyMessage(self, s)This is called when I receive a message which is peculiar, but not wholly indecipherable. |
receivedMOTD(self, motd)I received a message-of-the-day banner from the server. motd is a list of strings, where each string was sent as a seperate message from the server. To display, you might want to use:string.join(motd, '\n')to get a nicely formatted string. |
sendLine(self, line)Sends a line to the other end of the connection.
|
signedOn(self)Called after sucessfully signing on to the server. |
topic(self, channel, topic=None)Attempt to set the topic of the given channel, or ask what it is. If topic is None, then I sent a topic query instead of trying to set the topic. The server should respond with a TOPIC message containing the current topic of the given channel. |
topicUpdated(self, user, channel, newTopic)In channel, user changed the topic to newTopic. Also called when first joining a channel. |
userJoined(self, user, channel)Called when I see another user joining a channel. |
userKicked(self, kickee, channel, kicker, message)Called when I observe someone else being kicked from a channel. |
userLeft(self, user, channel)Called when I see another user leaving a channel. |
userRenamed(self, oldname, newname)A user changed their name from oldname to newname. |
Instance Variable Details |
---|
fingerReplySent in reply to a FINGER CTCP query. IfNone , no FINGER
reply will be sent.
|
lineRateMinimum delay between lines sent to the server. IfNone ,
no delay will be imposed.
|
nicknameNickname the client will use. |
passwordPassword used to log on to the server. May beNone .
|
realnameSupplied to the server during login as the "Real name" or "ircname". |
sourceURLCTCP SOURCE reply, a URL where the source code of this client may be found. IfNone , no SOURCE reply will be sent.
|
userinfoSent in reply to a USERINFO CTCP query. IfNone , no
USERINFO reply will be sent. "This is used to transmit a string
which is settable by the user (and never should be set by the
client)."
|
versionEnvCTCP VERSION reply, environment the client is running in. |
versionNameCTCP VERSION reply, client name. IfNone , no VERSION
reply will be sent.
|
versionNumCTCP VERSION reply, client version, |
Class Variable Details |
---|
__pychecker__
|
dcc_destdir
|
dcc_sessions
|
delimiter
|
fingerReply
|
lineRate
|
motd
|
nickname
|
password
|
performLogin
|
realname
|
sourceURL
|
userinfo
|
versionEnv
|
versionName
|
versionNum
|
Home | Trees | Index | Help |
---|
Generated by Epydoc 1.2 prerelease on Wed Jan 29 06:25:53 2003 | http://epydoc.sf.net |