Fixed protocol append typo on purple.pyx.
[python-purple] / account_cbs.pxd
index e0f767a..4f2e4be 100644 (file)
@@ -24,43 +24,57 @@ cdef extern from *:
 
 account_cbs = {}
 
-cdef void notify_added (account.PurpleAccount *account, const_char *remote_user, const_char *id, const_char *alias, const_char *message):
-    debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "account", "notify_added\n")
-    global account_cbs
-    try:
-        (<object>account_cbs["notify_added"])("notify_added")
-    except KeyError:
-        pass
+cdef void notify_added(account.PurpleAccount *account, \
+        const_char *remote_user, const_char *id, const_char *alias, \
+        const_char *message):
+    """
+    A buddy who is already on this account's buddy list added this account to
+    their buddy list.
+    """
+    debug.purple_debug_info("account", "%s", "notify-added\n")
+    if account_cbs.has_key("notify-added"):
+        (<object> account_cbs["notify-added"])("notify-added: TODO")
 
-cdef void status_changed (account.PurpleAccount *account, status.PurpleStatus *status):
-    debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "account", "status_changed\n")
-    global account_cbs
-    try:
-        (<object>account_cbs["status_changed"])("status_changed")
-    except KeyError:
-        pass
+cdef void status_changed(account.PurpleAccount *account, \
+        status.PurpleStatus *status):
+    """
+    This account's status changed.
+    """
+    debug.purple_debug_info("account", "%s", "status-changed\n")
+    if account_cbs.has_key("status-changed"):
+        (<object> account_cbs["status-changed"])("status-changed: TODO")
 
-cdef void request_add (account.PurpleAccount *account, const_char *remote_user, const_char *id, const_char *alias, const_char *message):
-    debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "account", "request_add\n")
-    global account_cbs
-    try:
-        (<object>account_cbs["request_add"])("request_add")
-    except KeyError:
-        pass
+cdef void request_add(account.PurpleAccount *account, \
+        const_char *remote_user, const_char *id, const_char *alias, \
+        const_char *message):
+    """
+    Someone we don't have on our list added us; prompt to add them.
+    """
+    debug.purple_debug_info("account", "%s", "request-add\n")
+    if account_cbs.has_key("request-add"):
+        (<object> account_cbs["request-add"])("request-add: TODO")
 
-cdef void *request_authorize (account.PurpleAccount *account, const_char *remote_user, const_char *id, const_char *alias, const_char *message, glib.gboolean on_list, account.PurpleAccountRequestAuthorizationCb authorize_cb, account.PurpleAccountRequestAuthorizationCb deny_cb, void *user_data):
-    debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "account", "request_authorize\n")
-    global account_cbs
-    try:
-        (<object>account_cbs["request_authorize"])("request_authorize")
-        return NULL
-    except KeyError:
-        pass
+cdef void *request_authorize(account.PurpleAccount *account, \
+        const_char *remote_user, const_char *id, const_char *alias, \
+        const_char *message, glib.gboolean on_list, \
+        account.PurpleAccountRequestAuthorizationCb authorize_cb, \
+        account.PurpleAccountRequestAuthorizationCb deny_cb, \
+        void *user_data):
+    """
+    Prompt for authorization when someone adds this account to their buddy
+    list. To authorize them to see this account's presence, call
+    authorize_cb(user_data) otherwise call deny_cb(user_data).
+    @return a UI-specific handle, as passed to #close_account_request.
+    """
+    debug.purple_debug_info("account", "%s", "request-authorize\n")
+    if account_cbs.has_key("request-authorize"):
+        (<object> account_cbs["request-authorize"])("request-authorize: TODO")
 
 cdef void close_account_request (void *ui_handle):
-    debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "account", "close_account_request\n")
-    global account_cbs
-    try:
-        (<object>account_cbs["close_account_request"])("close_account_request")
-    except KeyError:
-        pass
+    """
+    Close a pending request for authorization. ui_handle is a handle as
+    returned by request_authorize.
+    """
+    debug.purple_debug_info("account", "%s", "close-account-request\n")
+    if account_cbs.has_key("close-account-request"):
+        (<object> account_cbs["close-account-request"])("close-account-request: TODO")