Updated report_disconnect_reason callback.
[python-purple] / signal_cbs.pxd
index 00369e8..5cc1075 100644 (file)
@@ -21,22 +21,173 @@ cimport purple
 
 signal_cbs = {}
 
-cdef void signal_buddy_signed_off_cb (blist.PurpleBuddy *buddy):
-    debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "signal",
-                         "buddy_signed_off\n")
-    try:
-        (<object>signal_cbs["buddy_signed_off"])(buddy.name)
-    except KeyError:
-        pass
-
-cdef glib.gboolean signal_receiving_im_msg_cb (account.PurpleAccount *account,
-                                        char **sender,
-                                        char **message,
-                                        conversation.PurpleConversation *conv,
-                                        conversation.PurpleMessageFlags *flags):
-    debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "signal",
-                         "receivinv_im_msg_cb\n")
-    try:
-        (<object>signal_cbs["receiving_im_msg"])(sender[0], message[0])
-    except KeyError:
-        pass
+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 = <char *> account.purple_account_get_username(acc)
+    if c_username == NULL:
+        username = None
+    else:
+        username = c_username
+
+    c_protocol_id = <char *> 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"):
+        (<object> 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 = <char *> account.purple_account_get_username(acc)
+    if c_username == NULL:
+        username = None
+    else:
+        username = c_username
+
+    c_protocol_id = <char *> 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"):
+        (<object> signal_cbs["signed-off"])(username, protocol_id)
+
+cdef void signal_connection_error_cb(connection.PurpleConnection *gc, \
+        connection.PurpleConnectionError err, char *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
+    """
+
+    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" }[<int>err]
+
+    if c_desc == NULL:
+        desc = None
+    else:
+        desc = c_desc
+
+    if signal_cbs.has_key("connection-error"):
+        (<object> signal_cbs["connection-error"])(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 = <char *> blist.purple_buddy_get_name(buddy)
+    if c_name == NULL:
+        name = None
+    else:
+        name = c_name
+
+    c_alias = <char *> 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"):
+        (<object> 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 = <char *> blist.purple_buddy_get_name(buddy)
+    if c_name == NULL:
+        name = None
+    else:
+        name = c_name
+
+    c_alias = <char *> blist.purple_buddy_get_alias_only(buddy)
+    if c_alias == NULL:
+        alias = None
+    else:
+        alias = c_alias
+
+    if signal_cbs.has_key("buddy-signed-off"):
+        (<object> signal_cbs["buddy-signed-off"])(name, alias)
+
+cdef glib.gboolean signal_receiving_im_msg_cb(account.PurpleAccount *account, \
+        char **sender, char **message, conversation.PurpleConversation *conv, \
+        conversation.PurpleMessageFlags *flags):
+    """
+    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 = <char *> blist.purple_buddy_get_alias_only(buddy)
+    if c_alias == NULL:
+        alias = None
+    else:
+        alias = c_alias
+
+    stripped = util.purple_markup_strip_html(message[0])
+
+    if signal_cbs.has_key("receiving-im-msg"):
+        return (<object> signal_cbs["receiving-im-msg"])(sender[0], alias, stripped)
+
+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)
+
+    if signal_cbs.has_key("jabber-receiving-xmlnode"):
+        (<object> signal_cbs["jabber-receiving-xmlnode"])(message)