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.

TODO

Limit the length of messages sent (because the IRC server probably does).
Add flood protection/rate limiting for my CTCP replies.
NickServ cooperation. (a mix-in?)
Heartbeat. The transport may die in such a way that it does not realize it is dead until it is written to. Sending something (like "PING this.irc-host.net") during idle peroids would alleviate that. If you're concerned with the stability of the host as well as that of the transport, you might care to watch for the corresponding PONG.

Instance Variables	nickname	Nickname the client will use.
	password	Password used to log on to the server. May be `None`.
	realname	Supplied to the server during login as the "Real name" or "ircname". May be `None`.
	username	Supplied to the server during login as the "User name". May be `None`
	userinfo	Sent in reply to a USERINFO CTCP query. If `None`, 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)."
	fingerReply	Sent in reply to a FINGER CTCP query. If `None`, no FINGER reply will be sent. (type: Callable or String )
	versionName	CTCP VERSION reply, client name. If `None`, no VERSION reply will be sent.
	versionNum	CTCP VERSION reply, client version,
	versionEnv	CTCP VERSION reply, environment the client is running in.
	sourceURL	CTCP SOURCE reply, a URL where the source code of this client may be found. If `None`, no SOURCE reply will be sent.
	lineRate	Minimum delay between lines sent to the server. If `None`, no delay will be imposed. (type: Number of Seconds. )

Method	sendLine	Sends a line to the other end of the connection.
Method	created	Called with creation date information about the server, usually at logon.
Method	yourHost	Called with daemon information about the server, usually at logon.
Method	myInfo	Called with information about the server, usually at logon.
Method	luserClient	Called with information about the number of connections, usually at logon.
Method	bounce	Called with information about where the client should reconnect.
Method	isupport	Called with various information about what the server supports.
Method	luserChannels	Called with the number of channels existant on the server.
Method	luserOp	Called with the number of ops logged on to the server.
Method	luserMe	Called with information about the server connected to.
Method	privmsg	Called when I have a message from a user to me or a channel.
Method	joined	Called when I finish joining a channel.
Method	left	Called when I have left a channel.
Method	noticed	Called when I have a notice from a user to me or a channel.
Method	modeChanged	Called when a channel's modes are changed
Method	pong	Called with the results of a CTCP PING query.
Method	signedOn	Called after sucessfully signing on to the server.
Method	kickedFrom	Called when I am kicked from a channel.
Method	nickChanged	Called when my nick has been changed.
Method	userJoined	Called when I see another user joining a channel.
Method	userLeft	Called when I see another user leaving a channel.
Method	userQuit	Called when I see another user disconnect from the network.
Method	userKicked	Called when I observe someone else being kicked from a channel.
Method	action	Called when I see a user perform an ACTION on a channel.
Method	topicUpdated	In channel, user changed the topic to newTopic.
Method	userRenamed	A user changed their name from oldname to newname.
Method	receivedMOTD	I received a message-of-the-day banner from the server.
Method	join	Undocumented
Method	leave	Undocumented
Method	kick	Undocumented
Method	topic	Attempt to set the topic of the given channel, or ask what it is.
Method	mode	Change the modes on a user or channel.
Method	say	Undocumented
Method	msg	Send a message to a user or channel.
Method	notice	Undocumented
Method	away	Undocumented
Method	register	Undocumented
Method	setNick	Undocumented
Method	quit	Undocumented
Method	me	Strike a pose.
Method	ping	Measure round-trip delay to another IRC client.
Method	dccSend	Undocumented
Method	dccResume	Send a DCC RESUME request to another user.
Method	dccAcceptResume	Send a DCC ACCEPT response to clients who have requested a resume.
Method	irc_ERR_NICKNAMEINUSE	Undocumented
Method	irc_ERR_PASSWDMISMATCH	Undocumented
Method	irc_RPL_WELCOME	Undocumented
Method	irc_JOIN	Undocumented
Method	irc_PART	Undocumented
Method	irc_QUIT	Undocumented
Method	irc_MODE	Undocumented
Method	irc_PING	Undocumented
Method	irc_PRIVMSG	Undocumented
Method	irc_NOTICE	Undocumented
Method	irc_NICK	Undocumented
Method	irc_KICK	Kicked? Who? Not me, I hope.
Method	irc_TOPIC	Someone in the channel set the topic.
Method	irc_RPL_TOPIC	I just joined the channel, and the server is telling me the current topic.
Method	irc_RPL_NOTOPIC	Undocumented
Method	irc_RPL_MOTDSTART	Undocumented
Method	irc_RPL_MOTD	Undocumented
Method	irc_RPL_ENDOFMOTD	Undocumented
Method	irc_RPL_CREATED	Undocumented
Method	irc_RPL_YOURHOST	Undocumented
Method	irc_RPL_MYINFO	Undocumented
Method	irc_RPL_BOUNCE	Undocumented
Method	irc_RPL_LUSERCLIENT	Undocumented
Method	irc_RPL_LUSEROP	Undocumented
Method	irc_RPL_LUSERCHANNELS	Undocumented
Method	irc_RPL_LUSERME	Undocumented
Method	irc_unknown	Undocumented
Method	ctcpQuery	Dispatch method for any CTCP queries received.
Method	ctcpQuery_ACTION	Undocumented
Method	ctcpQuery_PING	Undocumented
Method	ctcpQuery_FINGER	Undocumented
Method	ctcpQuery_VERSION	Undocumented
Method	ctcpQuery_SOURCE	Undocumented
Method	ctcpQuery_USERINFO	Undocumented
Method	ctcpQuery_CLIENTINFO	A master index of what CTCP tags this client knows.
Method	ctcpQuery_ERRMSG	Undocumented
Method	ctcpQuery_TIME	Undocumented
Method	ctcpQuery_DCC	Initiate a Direct Client Connection
Method	dcc_SEND	Undocumented
Method	dcc_ACCEPT	Undocumented
Method	dcc_RESUME	Undocumented
Method	dcc_CHAT	Undocumented
Method	dccDoSend	Called when I receive a DCC SEND offer from a client.
Method	dccDoResume	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).
Method	dccDoAcceptResume	Called when a client has verified and accepted a DCC resume request made by us. By default it will do nothing.
Method	dccDoChat	Undocumented
Method	ctcpUnknownQuery	Undocumented
Method	ctcpMakeReply	Send one or more extended messages as a CTCP reply.
Method	ctcpMakeQuery	Send one or more extended messages as a CTCP query.
Method	ctcpReply	Dispatch method for any CTCP replies received.
Method	ctcpReply_PING	Undocumented
Method	ctcpUnknownReply	Called when a fitting ctcpReply_ method is not found.
Method	badMessage	When I get a message that's so broken I can't use it.
Method	quirkyMessage	This is called when I receive a message which is peculiar, but not wholly indecipherable.
Method	connectionMade	Called when a connection is made.
Method	dataReceived	Protocol.dataReceived. Translates bytes into lines, and calls lineReceived (or rawDataReceived, depending on mode.)
Method	lineReceived	Override this for when each line is received.
Method	handleCommand	Determine the function to call for the given command and call it with the given arguments.
Method	__getstate__	Undocumented
Method	_reallySendLine	Undocumented
Method	_sendLine	Undocumented

Inherited from LineReceiver:

Method	clearLineBuffer	Clear buffered data.
Method	setLineMode	Sets the line-mode of this receiver.
Method	setRawMode	Sets the raw mode of this receiver. Further data received will be sent to rawDataReceived rather than lineReceived.
Method	rawDataReceived	Override this for when raw data is received.
Method	lineLengthExceeded	Called when the maximum line length has been reached. Override if it needs to be dealt with in some special way.

Inherited from Protocol (via LineReceiver):

Method

connectionLost

Called when the connection is shut down.

Inherited from BaseProtocol (via LineReceiver, Protocol):

Method

makeConnection

Make a connection to a transport and a server.

Inherited from _PauseableMixin (via LineReceiver):

Method	pauseProducing	Undocumented
Method	resumeProducing	Undocumented
Method	stopProducing	Undocumented

Sends a line to the other end of the connection.

Called with creation date information about the server, usually at logon.

Parameters when A string describing when the server was created, probably. (type: str )

Called with daemon information about the server, usually at logon.

Parameters	info	(type: `str` )
	when	A string describing what software the server is running, probably.

Called with information about the server, usually at logon.

Parameters	servername	The hostname of this server. (type: `str` )
	version	A description of what software this server runs. (type: `str` )
	umodes	All the available user modes. (type: `str` )
	cmodes	All the available channel modes. (type: `str` )

Called with information about the number of connections, usually at logon.

Parameters info A description of the number of clients and servers connected to the network, probably. (type: str )

Called with information about where the client should reconnect.

Parameters info A plaintext description of the address that should be connected to. (type: str )

Called with various information about what the server supports.

Parameters options Descriptions of features or limits of the server, possibly in the form "NAME=VALUE". (type: list of str )

Called with the number of channels existant on the server.

Parameters channels (type: int )

Called with the number of ops logged on to the server.

Parameters ops (type: int )

Called with information about the server connected to.

Parameters info A plaintext string describing the number of users and servers connected to this server. (type: str )

Called when I have a message from a user to me or a channel.

Called when I finish joining a channel.

channel has the starting character (# or &) intact.

Called when I have left a channel.

channel has the starting character (# or &) intact.

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.

Called when a channel's modes are changed

Parameters	user	The user and hostmask which instigated this change. (type: `str` )
	channel	The channel for which the modes are changing. (type: `str` )
	set	true if the mode is being added, false if it is being removed. (type: `bool` or `int` )
	modes	The mode or modes which are being changed. (type: `str` )
	args	Any additional information required for the mode change. (type: `tuple` )

Called with the results of a CTCP PING query.

Called after sucessfully signing on to the server.

Called when I am kicked from a channel.

Called when my nick has been changed.

Called when I see another user joining a channel.

Called when I see another user leaving a channel.

Called when I see another user disconnect from the network.

Called when I observe someone else being kicked from a channel.

Called when I see a user perform an ACTION on a channel.

In channel, user changed the topic to newTopic.

Also called when first joining a channel.

A user changed their name from oldname to newname.

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.

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.

Change the modes on a user or channel.

Send a message to a user or channel.

Parameters	user	The username or channel name to which to direct the message. (type: `str` )
	message	The text to send (type: `str` )
	length	The maximum number of octets to send at a time. This has the effect of turning a single call to msg() into multiple commands to the server. This is useful when long messages may be sent that would otherwise cause the server to kick us off or silently truncate the text we are sending. If None is passed, the entire message is always send in one command. (type: `int` )

Measure round-trip delay to another IRC client.

Send a DCC RESUME request to another user.

Send a DCC ACCEPT response to clients who have requested a resume.

Kicked? Who? Not me, I hope.

Someone in the channel set the topic.

I just joined the channel, and the server is telling me the current topic.

Dispatch method for any CTCP queries received.

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.

Initiate a Direct Client Connection

Called when I receive a DCC SEND offer from a client.

By default, I do nothing here.

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).

Called when a client has verified and accepted a DCC resume request made by us. By default it will do nothing.

Send one or more extended messages as a CTCP reply.

Parameters messages (type: a list of extended messages. An extended message is a (tag, data) tuple, where 'data' may be None. )

Send one or more extended messages as a CTCP query.

Parameters messages (type: a list of extended messages. An extended message is a (tag, data) tuple, where 'data' may be None. )

Dispatch method for any CTCP replies received.

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.

When I get a message that's so broken I can't use it.

This is called when I receive a message which is peculiar, but not wholly indecipherable.

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.

Protocol.dataReceived. Translates bytes into lines, and calls lineReceived (or rawDataReceived, depending on mode.)

Override this for when each line is received.

Determine the function to call for the given command and call it with the given arguments.

t.w.p.i.IRCClient(basic.LineReceiver) : class documentation

TODO