X-Git-Url: http://git.maemo.org/git/?p=python-purple;a=blobdiff_plain;f=account_cbs.pxd;h=4f2e4be0742d192848fc0fe03d602b9bb95b5678;hp=54183feffd394c22e385d56a53383408ff453fce;hb=60e2bde48e3f6f4f451f1fae7fc0122b6d1e9f72;hpb=5fe506a5d23d5f7ba01599247a58bd03ca9eb7da;ds=inline

diff --git a/account_cbs.pxd b/account_cbs.pxd
index 54183fe..4f2e4be 100644
--- a/account_cbs.pxd
+++ b/account_cbs.pxd
@@ -24,49 +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_info("account", "%s", "notify-added\n")
-    try:
-        (<object>account_cbs["notify-added"])("notify-added: TODO")
-    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_info("account", "%s", "status-changed\n")
-    try:
-        (<object>account_cbs["status-changed"])("status-changed: TODO")
-    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_info("account", "%s", "request-add\n")
-    try:
-        (<object>account_cbs["request-add"])("request-add: TODO")
-    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_info("account", "%s", "request-authorize\n")
-    try:
-        (<object>account_cbs["request-authorize"])("request-authorize: TODO")
-        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_info("account", "%s", "close-account-request\n")
-    try:
-        (<object>account_cbs["close-account-request"])("close-account-request: TODO")
-    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")