t.w.p.t.TOCClient(protocol.Protocol) : class documentation

tests to see if a flap is actually on the buffer

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.

Called when the connection is shut down.

Clear any circular references here, and any external references to this Protocol. The connection has been closed.

Parameters

reason

(type: twisted.python.failure.Failure )

Called whenever data is received.

Use this method to translate to a higher-level message. Usually, some callback will be made upon the receipt of each complete protocol message.

Parameters

data

a string of indeterminate length. Please keep in mind that you will probably need to buffer some data, as partial (or multiple) protocol messages may be received! I recommend that unit tests for protocols call through to this method with differing chunk sizes, down to one byte at a time.

Handle a message that looks like:

   NICK:<format of nickname>

Handle a message that looks like:

   CONFIG:<config>

Format of config data:

• g: group. all users until next g or end of config are in this group
• b: buddy
• p: person on the permit list
• d: person on the deny list
• m: permit/deny mode (1: permit all, 2: deny all, 3: permit some, 4: deny some)

Handle a message that looks like:

   IM_IN:<user>:<autoreply T|F>:message

Handle a message that looks like:

   UPDATE_BUDDY:<username>:<online T|F>:<warning level>:<signon time>:<idle time (minutes)>:<user class>

Handle a message that looks like:

   ERROR:<error code>:<misc. data>

Handle a message that looks like:

   EVILED:<current warning level>:<user who warned us>

Handle a message that looks like:

   CHAT_JOIN:<room id>:<room name>

Handle a message that looks like:

   CHAT_UPDATE_BUDDY:<room id>:<in room? T/F>:<user 1>:<user 2>...

Handle a message that looks like:

   CHAT_IN:<room id>:<username>:<whisper T/F>:<message>

whisper isn't used

Handle a message that looks like:

   CHAT_INVITE:<room name>:<room id>:<username>:<message>

Handle a message that looks like:

   CHAT_LEFT:<room id>

Handle a message that looks like:

   RVOUS_PROPOSE:<user>:<uuid>:<cookie>:<seq>:<rip>:<pip>:<vip>:<port>
         [:tlv tag1:tlv value1[:tlv tag2:tlv value2[:...]]]

called when we are first online

called when we get a configuration from the server mode := permit/deny mode buddylist := current buddylist permit := permit list deny := deny list

called when an error is received code := error code args := misc. arguments (username, etc.)

called when we get warned newamount := the current warning level username := the user who warned us, or '' if it's anonymous

called when you receive an IM username := the user who the IM is from message := the message autoreply := true if the message is an autoreply from an away message

called when a buddy changes state username := the user whos state changed online := true if the user is online evilness := the users current warning level signontime := the time the user signed on (UNIX epoch) idletime := the time the user has been idle (minutes) away := true if the user is away userclass := the class of the user (generally " O")

we just joined a chat room roomid := the AIM id for the room roomname := the name for the room users := a list of the users already in the room

a user has joined the room roomid := the AIM id for the room username := the username inroom := true if the user is in the room

a message was sent to the room roomid := the AIM id for the room username := the user who sent the message message := the message

someone whispered to us in a chatroom roomid := the AIM for the room username := the user who whispered to us message := the message

we were invited to a chat room roomid := the AIM id for the room roomname := the name of the room username := the user who invited us message := the invite message

we left the room roomid := the AIM id for the room

we were asked for a rondevouz type := the type of rondevous. currently, one of ["send"] cookie := the cookie. pass this to rvous_accept() user := the user who asked us vip := their verified_ip port := the port they want us to conenct to kw := misc. args

we received part of a file from a file transfer file := the name of the file chunk := the chunk of data sofar := how much data we've gotten so far total := the total amount of data

return our away status

set the server configuration mode := permit mode buddylist := buddy list permit := permit list deny := deny list

called to finish the setup, and signon to the network

send a message user := the user to send to message := the message autoreply := true if the message is an autoreply (good for away messages)

change idle state idletime := the seconds that the user has been away, or 0 if they're back

warn a user user := the user to warn anon := if true, an anonymous warning

change away state message := the message, or '' to come back from awayness

join a chat room exchange := should almost always be 4 roomname := room name

send a message to a chatroom roomid := the AIM id for the room message := the message to send

whisper to another user in a chatroom roomid := the AIM id for the room user := the user to whisper to message := the message to send

leave a chat room. roomid := the AIM id for the room

invite a user[s] to the chat room roomid := the AIM id for the room usernames := either a string (one username) or a list (more than one) message := the message to invite them with

accept an invite to a chat room roomid := the AIM id for the room