X-Git-Url: http://git.maemo.org/git/?p=python-purple;a=blobdiff_plain;f=signal_cbs.pxd;h=ed1ab7173b36bb9ba7d054076f1673ea079547b9;hp=8155b745634759f90cadc8490035ed3e1eedb51d;hb=3453e9755aca10e51bb7ce6b7a665ee461aad1de;hpb=445c387d8067391f329186a13ce482dbb3c64c80 diff --git a/signal_cbs.pxd b/signal_cbs.pxd index 8155b74..ed1ab71 100644 --- a/signal_cbs.pxd +++ b/signal_cbs.pxd @@ -21,52 +21,192 @@ cimport purple signal_cbs = {} -cdef void signal_buddy_signed_off_cb (blist.PurpleBuddy *buddy): +cdef extern from *: + ctypedef char const_gchar "const gchar" + +cdef void signal_signed_on_cb(connection.PurpleConnection *gc, \ + glib.gpointer null): + """ + Emitted when a connection has signed on. + @params gc The connection that has signed on. + """ + cdef account.PurpleAccount *acc = connection.purple_connection_get_account(gc) + cdef char *c_username = NULL + cdef char *c_protocol_id = NULL + + c_username = account.purple_account_get_username(acc) + if c_username == NULL: + username = None + else: + username = c_username + + c_protocol_id = account.purple_account_get_protocol_id(acc) + if c_protocol_id == NULL: + protocol_id = None + else: + protocol_id = c_protocol_id + + if signal_cbs.has_key("signed-on"): + ( signal_cbs["signed-on"])(username, protocol_id) + +cdef void signal_signed_off_cb(connection.PurpleConnection *gc, \ + glib.gpointer null): + """ + Emitted when a connection has signed off. + @params gc The connection that has signed off. + """ + cdef account.PurpleAccount *acc = connection.purple_connection_get_account(gc) + cdef char *c_username = NULL + cdef char *c_protocol_id = NULL + + c_username = account.purple_account_get_username(acc) + if c_username == NULL: + username = None + else: + username = c_username + + c_protocol_id = account.purple_account_get_protocol_id(acc) + if c_protocol_id == NULL: + protocol_id = None + else: + protocol_id = c_protocol_id + + if signal_cbs.has_key("signed-off"): + ( signal_cbs["signed-off"])(username, protocol_id) + +cdef void signal_connection_error_cb(connection.PurpleConnection *gc, \ + connection.PurpleConnectionError err, const_gchar *c_desc): + """ + Emitted when a connection error occurs, before signed-off. + @params gc The connection on which the error has occured + @params err The error that occured + @params desc A description of the error, giving more information + """ + cdef account.PurpleAccount *acc = connection.purple_connection_get_account(gc) + cdef char *c_username = NULL + cdef char *c_protocol_id = NULL + + c_username = account.purple_account_get_username(acc) + if c_username: + username = c_username + else: + username = None + + c_protocol_id = account.purple_account_get_protocol_id(acc) + if c_protocol_id: + protocol_id = c_protocol_id + else: + protocol_id = None + + short_desc = { + 0: "Network error", + 1: "Invalid username", + 2: "Authentication failed", + 3: "Authentication impossible", + 4: "No SSL support", + 5: "Encryption error", + 6: "Name in use", + 7: "Invalid settings", + 8: "SSL certificate not provided", + 9: "SSL certificate untrusted", + 10: "SSL certificate expired", + 11: "SSL certificate not activated", + 12: "SSL certificate hostname mismatch", + 13: "SSL certificate fingerprint mismatch", + 14: "SSL certificate self signed", + 15: "SSL certificate other error", + 16: "Other error" }[ err] + + if c_desc: + desc = str( c_desc) + else: + desc = None + + if signal_cbs.has_key("connection-error"): + ( signal_cbs["connection-error"])(username, protocol_id, \ + short_desc, desc) + +cdef void signal_buddy_signed_on_cb(blist.PurpleBuddy *buddy): + """ + Emitted when a buddy on your buddy list signs on. + @params buddy The buddy that signed on. + """ + cdef char *c_name = NULL + cdef char *c_alias = NULL + + c_name = blist.purple_buddy_get_name(buddy) + if c_name == NULL: + name = None + else: + name = c_name + + c_alias = blist.purple_buddy_get_alias_only(buddy) + if c_alias == NULL: + alias = None + else: + alias = c_alias + + if signal_cbs.has_key("buddy-signed-on"): + ( signal_cbs["buddy-signed-on"])(name, alias) + +cdef void signal_buddy_signed_off_cb(blist.PurpleBuddy *buddy): + """ + Emitted when a buddy on your buddy list signs off. + @params buddy The buddy that signed off. + """ cdef char *c_name = NULL cdef char *c_alias = NULL - c_name = blist.c_purple_buddy_get_name(buddy) + c_name = blist.purple_buddy_get_name(buddy) if c_name == NULL: name = None else: name = c_name - c_alias = blist.c_purple_buddy_get_alias_only(buddy) + c_alias = blist.purple_buddy_get_alias_only(buddy) if c_alias == NULL: alias = None else: alias = c_alias - try: + if signal_cbs.has_key("buddy-signed-off"): ( signal_cbs["buddy-signed-off"])(name, alias) - except KeyError: - pass -cdef glib.gboolean signal_receiving_im_msg_cb (account.PurpleAccount *account, - char **sender, char **message, conversation.PurpleConversation *conv, +cdef glib.gboolean signal_receiving_im_msg_cb(account.PurpleAccount *account, \ + char **sender, char **message, conversation.PurpleConversation *conv, \ conversation.PurpleMessageFlags *flags): - cdef blist.PurpleBuddy *buddy = blist.c_purple_find_buddy(account, sender[0]) + """ + Emitted when an IM is received. The callback can replace the name of the + sender, the message, or the flags by modifying the pointer to the strings + and integer. This can also be used to cancel a message by returning TRUE. + @note Make sure to free *sender and *message before you replace them! + @returns TRUE if the message should be canceled, or FALSE otherwise. + @params account The account the message was received on. + @params sender A pointer to the username of the sender. + @params message A pointer to the message that was sent. + @params conv The IM conversation. + @params flags A pointer to the IM message flags. + """ + cdef blist.PurpleBuddy *buddy = blist.purple_find_buddy(account, sender[0]) cdef char *c_alias = NULL - c_alias = blist.c_purple_buddy_get_alias_only(buddy) + c_alias = blist.purple_buddy_get_alias_only(buddy) if c_alias == NULL: alias = None else: alias = c_alias - stripped = util.c_purple_markup_strip_html(message[0]) + stripped = util.purple_markup_strip_html(message[0]) - try: + if signal_cbs.has_key("receiving-im-msg"): return ( signal_cbs["receiving-im-msg"])(sender[0], alias, stripped) - except KeyError: - return False -cdef void jabber_receiving_xmlnode_cb (connection.PurpleConnection *gc, +cdef void jabber_receiving_xmlnode_cb(connection.PurpleConnection *gc, \ xmlnode.xmlnode **packet, glib.gpointer null): - + """ + Emitted when jabber receives a XML node. + """ message = xmlnode.xmlnode_to_str(packet[0], NULL) - try: + if signal_cbs.has_key("jabber-receiving-xmlnode"): ( signal_cbs["jabber-receiving-xmlnode"])(message) - except KeyError: - pass