X-Git-Url: http://git.maemo.org/git/?p=python-purple;a=blobdiff_plain;f=purple.pyx;h=17411e78233f6ae7c2035846ba327b5f242f1219;hp=f5b7aa1539abfde7ee6b4aabea35ae12dd076ecb;hb=39c1c26cdc38fe7dc79122c45bba7731b08ed1cd;hpb=a29730a9b6c00cfeaacc64311349df4da9ce1c8b;ds=sidebyside diff --git a/purple.pyx b/purple.pyx index f5b7aa1..17411e7 100644 --- a/purple.pyx +++ b/purple.pyx @@ -17,234 +17,433 @@ # along with this program. If not, see . # -include "glib.pxd" +cimport purple + +cdef extern from "c_purple.h": + glib.guint glib_input_add(glib.gint fd, eventloop.PurpleInputCondition condition, eventloop.PurpleInputFunction function, glib.gpointer data) import ecore +import signal + +cdef glib.GHashTable *c_ui_info + +c_ui_info = NULL + +cdef char *c_ui_name +cdef char *c_ui_version +cdef char *c_ui_website +cdef char *c_ui_dev_website + +cdef account.PurpleAccountUiOps c_account_ui_ops +cdef blist.PurpleBlistUiOps c_blist_ui_ops +cdef connection.PurpleConnectionUiOps c_conn_ui_ops +cdef conversation.PurpleConversationUiOps c_conv_ui_ops +cdef core.PurpleCoreUiOps c_core_ui_ops +cdef eventloop.PurpleEventLoopUiOps c_eventloop_ui_ops +#cdef ft.PurpleXferUiOps c_ft_ui_ops +cdef notify.PurpleNotifyUiOps c_notify_ui_ops +#cdef privacy.PurplePrivacyUiOps c_privacy_ui_ops +cdef request.PurpleRequestUiOps c_request_ui_ops +#cdef roomlist.PurpleRoomlistUiOps c_rlist_ui_ops + +include "account_cbs.pxd" +include "blist_cbs.pxd" +include "connection_cbs.pxd" +include "conversation_cbs.pxd" +#include "xfer_cbs.pxd" +include "notify_cbs.pxd" +#include "privacy_cbs.pxd" +include "request_cbs.pxd" +#include "roomlist_cbs.pxd" +include "signal_cbs.pxd" + +include "util.pxd" -cdef extern from *: - ctypedef char* const_char_ptr "const char *" - ctypedef char* const_guchar_ptr "const guchar *" +cdef class Purple: + '''Purple class. -cdef extern from "time.h": - ctypedef long int time_t + @param ui_name ID of the UI using the purple. + This should be a unique ID, registered with the purple team. + @param ui_version UI version. + @param ui_website UI website. + @param ui_dev_website UI development website. + @param debug_enabled True to enable debug messages. + @param default_path Custom settings directory + ''' -cdef extern from "libpurple/blist.h": - ctypedef struct PurpleBuddyList: - pass - void c_purple_set_blist "purple_set_blist" (PurpleBuddyList *list) - void c_purple_blist_load "purple_blist_load" () - PurpleBuddyList* c_purple_blist_new "purple_blist_new" () - -cdef extern from "libpurple/core.h": - ctypedef struct PurpleCoreUiOps: - void (*ui_prefs_init) () - void (*debug_ui_init) () - void (*ui_init) () - void (*quit) () - GHashTable* (*get_ui_info) () - - gboolean c_purple_core_init "purple_core_init" (const_char_ptr ui_name) - void c_purple_core_quit "purple_core_quit" () - void c_purple_core_set_ui_ops "purple_core_set_ui_ops" (PurpleCoreUiOps *ops) - gboolean c_purple_core_ensure_single_instance "purple_core_ensure_single_instance" () - -cdef extern from "libpurple/debug.h": - ctypedef enum PurpleDebugLevel: - PURPLE_DEBUG_ALL - PURPLE_DEBUG_MISC - PURPLE_DEBUG_INFO - PURPLE_DEBUG_WARNING - PURPLE_DEBUG_ERROR - PURPLE_DEBUG_FATAL - - void c_purple_debug "purple_debug" (PurpleDebugLevel level, const_char_ptr category, const_char_ptr format) - void c_purple_debug_set_enabled "purple_debug_set_enabled" (gboolean debug_enabled) - -cdef extern from "libpurple/eventloop.h": - ctypedef enum PurpleInputCondition: - PURPLE_INPUT_READ - PURPLE_INPUT_WRITE - - ctypedef void (*PurpleInputFunction) (gpointer , gint, PurpleInputCondition) - - ctypedef struct PurpleEventLoopUiOps: - guint (*timeout_add) (guint interval, GSourceFunc function, gpointer data) - gboolean (*timeout_remove) (guint handle) - guint (*input_add) (int fd, PurpleInputCondition cond, PurpleInputFunction func, gpointer user_data) - gboolean (*input_remove) (guint handle) - int (*input_get_error) (int fd, int *error) - guint (*timeout_add_seconds)(guint interval, GSourceFunc function, gpointer data) - - void c_purple_eventloop_set_ui_ops "purple_eventloop_set_ui_ops" (PurpleEventLoopUiOps *ops) - -cdef extern from "libpurple/plugin.h": - ctypedef struct PurplePlugin - - cdef struct _PurplePluginInfo: - char *id - char *name - ctypedef _PurplePluginInfo PurplePluginInfo - - cdef struct _PurplePlugin: - PurplePluginInfo *info # The plugin information. - ctypedef _PurplePlugin PurplePlugin - - void c_purple_plugins_add_search_path "purple_plugins_add_search_path" (const_char_ptr path) - GList *c_purple_plugins_get_protocols "purple_plugins_get_protocols" () - -cdef extern from "libpurple/pounce.h": - gboolean c_purple_pounces_load "purple_pounces_load" () - -cdef extern from "libpurple/prefs.h": - void c_purple_prefs_add_none "purple_prefs_add_none" (const_char_ptr name) - void c_purple_prefs_rename "purple_prefs_rename" (const_char_ptr oldname, const_char_ptr newname) - const_char_ptr c_purple_prefs_get_string "purple_prefs_get_string" (const_char_ptr name) - gboolean c_purple_prefs_load "purple_prefs_load" () - -cdef extern from "libpurple/util.h": - void c_purple_util_set_user_dir "purple_util_set_user_dir" (char *dir) + def __init__(self, ui_name, ui_version, ui_website, ui_dev_website, \ + debug_enabled=None, default_path=None): -cdef extern from "c_purple.h": - guint glib_input_add(gint fd, PurpleInputCondition condition, PurpleInputFunction function, gpointer data) - void glib_main_loop() + global c_ui_name + global c_ui_version + global c_ui_website + global c_ui_dev_website -__DEFAULT_PATH__ = "/tmp" -__APP_NAME__ = "carman-purple-python" -__APP_VERSION__ = "0.1" + c_ui_name = ui_name + c_ui_version = ui_version + c_ui_website = ui_website + c_ui_dev_website = ui_dev_website -global __DEFAULT_PATH__ -global __APP_NAME__ -global __APP_VERSION__ + if debug_enabled: + debug.purple_debug_set_enabled(debug_enabled) -cdef class Purple: - """ Purple class """ - cdef PurpleCoreUiOps c_core_ui_ops - cdef PurpleEventLoopUiOps c_eventloop_ui_ops - cdef GHashTable *c_ui_info + if default_path: + util.purple_util_set_user_dir(default_path) - def __cinit__(self, debug_enabled=True, app_name=__APP_NAME__, default_path=__DEFAULT_PATH__): - self.c_ui_info = NULL + # adds glib iteration inside ecore main loop + ecore.timer_add(0.001, self.__glib_iteration_when_idle) - if app_name is not __APP_NAME__: - __APP_NAME__ = app_name + # libpurple's built-in DNS resolution forks processes to perform + # blocking lookups without blocking the main process. It does not + # handle SIGCHLD itself, so if the UI does not you quickly get an army + # of zombie subprocesses marching around. + signal.signal(signal.SIGCHLD, signal.SIG_IGN) - if default_path is not __DEFAULT_PATH__: - __DEFAULT_PATH__ = default_path + def destroy(self): + core.purple_core_quit() - c_purple_debug_set_enabled(debug_enabled) - c_purple_util_set_user_dir(default_path) - c_purple_plugins_add_search_path(default_path) + def __get_ui_name(self): + '''Returns the UI name. - # adds glib iteration inside ecore main loop - ecore.idler_add(self.__glib_iteration_when_idle) - # __cinit__ + @return UI name. + ''' - def __del__(self): - c_purple_core_quit() - # __del__ + global c_ui_name + return str(c_ui_name) + ui_name = property(__get_ui_name) cdef void __core_ui_ops_ui_prefs_init(self): - c_purple_debug(PURPLE_DEBUG_INFO, "core_ui_ops", "ui_prefs_init\n") - c_purple_prefs_load() + debug.purple_debug_info("core_ui_ops", "%s", "ui_prefs_init\n") + prefs.purple_prefs_load() - c_purple_prefs_add_none("/carman") - c_purple_prefs_add_none("/carman/plugins") - # __core_ui_ops_ui_prefs_init + prefs.purple_prefs_add_none("/carman") cdef void __core_ui_ops_debug_init(self): - c_purple_debug(PURPLE_DEBUG_INFO, "core_ui_ops", "debug_ui_init\n") - # __core_ui_ops_debug_init + debug.purple_debug_info("core_ui_ops", "%s", "debug_ui_init\n") + pass cdef void __core_ui_ops_ui_init(self): - c_purple_debug(PURPLE_DEBUG_INFO, "core_ui_ops", "ui_init\n") - # __core_ui_ops_ui_init + debug.purple_debug_info("core_ui_ops", "%s", "ui_init\n") + + account.purple_accounts_set_ui_ops(&c_account_ui_ops) + connection.purple_connections_set_ui_ops(&c_conn_ui_ops) + blist.purple_blist_set_ui_ops(&c_blist_ui_ops) + conversation.purple_conversations_set_ui_ops(&c_conv_ui_ops) + notify.purple_notify_set_ui_ops(&c_notify_ui_ops) + #privacy.purple_privacy_set_ui_ops(&c_privacy_ui_ops) + request.purple_request_set_ui_ops(&c_request_ui_ops) + #ft.purple_xfers_set_ui_ops(&c_ft_ui_ops) + #roomlist.purple_roomlist_set_ui_ops(&c_rlist_ui_ops) cdef void __core_ui_ops_quit(self): - c_purple_debug(PURPLE_DEBUG_INFO, "core_ui_ops", "quit\n") - # __core_ui_ops_quit - - cdef GHashTable *__core_ui_ops_get_ui_info(self): - if self.c_ui_info == NULL: - self.c_ui_info = g_hash_table_new(g_str_hash, g_str_equal) - - g_hash_table_insert(self.c_ui_info, "name", __APP_NAME__) - g_hash_table_insert(self.c_ui_info, "version", __APP_VERSION__) - return self.c_ui_info - # __core_ui_ops_get_ui_info + debug.purple_debug_info("core_ui_ops", "%s", "quit\n") + + account.purple_accounts_set_ui_ops(NULL) + connection.purple_connections_set_ui_ops(NULL) + blist.purple_blist_set_ui_ops(NULL) + conversation.purple_conversations_set_ui_ops(NULL) + notify.purple_notify_set_ui_ops(NULL) + #privacy.purple_privacy_set_ui_ops(NULL) + request.purple_request_set_ui_ops(NULL) + #ft.purple_xfers_set_ui_ops(NULL) + #roomlist.purple_roomlist_set_ui_ops(NULL) + + if self.c_ui_info: + glib.g_hash_table_destroy( self.c_ui_info) + + cdef glib.GHashTable *__core_ui_ops_get_ui_info(self): + global c_ui_info + global c_ui_name + global c_ui_version + global c_ui_website + global c_ui_dev_website + + if c_ui_info == NULL: + c_ui_info = glib.g_hash_table_new(glib.g_str_hash, \ + glib.g_str_equal) + + glib.g_hash_table_insert(c_ui_info, "name", c_ui_name) + glib.g_hash_table_insert(c_ui_info, "version", c_ui_version) + glib.g_hash_table_insert(c_ui_info, "website", c_ui_website) + glib.g_hash_table_insert(c_ui_info, "dev_website", c_ui_dev_website) + return c_ui_info def __glib_iteration_when_idle(self): - g_main_context_iteration(NULL, False) + glib.g_main_context_iteration(NULL, False) return True - # __glib_iteration_when_idle def purple_init(self): - """ Initializes libpurple """ - # initialize c_core_ui_ops structure - self.c_core_ui_ops.ui_prefs_init = self.__core_ui_ops_ui_prefs_init - self.c_core_ui_ops.debug_ui_init = self.__core_ui_ops_debug_init - self.c_core_ui_ops.ui_init = self.__core_ui_ops_ui_init - self.c_core_ui_ops.quit = self.__core_ui_ops_quit - self.c_core_ui_ops.get_ui_info = self.__core_ui_ops_get_ui_info - - c_purple_core_set_ui_ops(&self.c_core_ui_ops) - - # initialize c_eventloop_ui_ops structure - self.c_eventloop_ui_ops.timeout_add = g_timeout_add - self.c_eventloop_ui_ops.timeout_remove = g_source_remove - self.c_eventloop_ui_ops.input_add = glib_input_add - self.c_eventloop_ui_ops.input_remove = g_source_remove - self.c_eventloop_ui_ops.input_get_error = NULL - self.c_eventloop_ui_ops.timeout_add_seconds = g_timeout_add_seconds - - c_purple_eventloop_set_ui_ops(&self.c_eventloop_ui_ops) + '''Initializes the purple. + + This will setup preferences for all the core subsystems. + ''' + + global c_ui_name + + c_account_ui_ops.notify_added = notify_added + c_account_ui_ops.status_changed = status_changed + c_account_ui_ops.request_add = request_add + c_account_ui_ops.request_authorize = request_authorize + c_account_ui_ops.close_account_request = close_account_request + + c_blist_ui_ops.new_list = new_list + c_blist_ui_ops.new_node = new_node + c_blist_ui_ops.show = show + c_blist_ui_ops.update = update + c_blist_ui_ops.remove = remove + c_blist_ui_ops.destroy = destroy + c_blist_ui_ops.set_visible = set_visible + c_blist_ui_ops.request_add_buddy = request_add_buddy + c_blist_ui_ops.request_add_chat = request_add_chat + c_blist_ui_ops.request_add_group = request_add_group + + c_conn_ui_ops.connect_progress = connect_progress + c_conn_ui_ops.connected = connected + c_conn_ui_ops.disconnected = disconnected + c_conn_ui_ops.notice = notice + c_conn_ui_ops.report_disconnect = report_disconnect + c_conn_ui_ops.network_connected = network_connected + c_conn_ui_ops.network_disconnected = network_disconnected + c_conn_ui_ops.report_disconnect_reason = report_disconnect_reason + + c_conv_ui_ops.create_conversation = create_conversation + c_conv_ui_ops.destroy_conversation = destroy_conversation + c_conv_ui_ops.write_chat = write_chat + c_conv_ui_ops.write_im = write_im + c_conv_ui_ops.write_conv = write_conv + c_conv_ui_ops.chat_add_users = chat_add_users + c_conv_ui_ops.chat_rename_user = chat_rename_user + c_conv_ui_ops.chat_remove_users = chat_remove_users + c_conv_ui_ops.chat_update_user = chat_update_user + c_conv_ui_ops.present = present + c_conv_ui_ops.has_focus = has_focus + c_conv_ui_ops.custom_smiley_add = custom_smiley_add + c_conv_ui_ops.custom_smiley_write = custom_smiley_write + c_conv_ui_ops.custom_smiley_close = custom_smiley_close + c_conv_ui_ops.send_confirm = send_confirm + + c_notify_ui_ops.notify_message = notify_message + c_notify_ui_ops.notify_email = notify_email + c_notify_ui_ops.notify_emails = notify_emails + c_notify_ui_ops.notify_formatted = notify_formatted + c_notify_ui_ops.notify_searchresults = notify_searchresults + c_notify_ui_ops.notify_searchresults_new_rows = notify_searchresults_new_rows + c_notify_ui_ops.notify_userinfo = notify_userinfo + c_notify_ui_ops.notify_uri = notify_uri + c_notify_ui_ops.close_notify = close_notify + + c_request_ui_ops.request_input = request_input + c_request_ui_ops.request_choice = request_choice + c_request_ui_ops.request_action = request_action + c_request_ui_ops.request_fields = request_fields + c_request_ui_ops.request_file = request_file + c_request_ui_ops.close_request = close_request + c_request_ui_ops.request_folder = request_folder + + c_core_ui_ops.ui_prefs_init = self.__core_ui_ops_ui_prefs_init + c_core_ui_ops.debug_ui_init = self.__core_ui_ops_debug_init + c_core_ui_ops.ui_init = self.__core_ui_ops_ui_init + c_core_ui_ops.quit = self.__core_ui_ops_quit + c_core_ui_ops.get_ui_info = self.__core_ui_ops_get_ui_info + + c_eventloop_ui_ops.timeout_add = glib.g_timeout_add + c_eventloop_ui_ops.timeout_remove = glib.g_source_remove + c_eventloop_ui_ops.input_add = glib_input_add + c_eventloop_ui_ops.input_remove = glib.g_source_remove + c_eventloop_ui_ops.input_get_error = NULL + c_eventloop_ui_ops.timeout_add_seconds = NULL + + core.purple_core_set_ui_ops(&c_core_ui_ops) + eventloop.purple_eventloop_set_ui_ops(&c_eventloop_ui_ops) # initialize purple core - ret = c_purple_core_init(__APP_NAME__) + ret = core.purple_core_init(c_ui_name) if ret is False: - c_purple_debug(PURPLE_DEBUG_INFO, "main", "Exiting because libpurple initialization failed.\n") + debug.purple_debug_fatal("main", "%s", "libpurple " \ + "initialization failed.\n") return False # check if there is another instance of libpurple running - if c_purple_core_ensure_single_instance() == False: - c_purple_debug(PURPLE_DEBUG_INFO, "main", "Exiting because another instance of libpurple is already running.\n") - c_purple_core_quit() + if core.purple_core_ensure_single_instance() == False: + debug.purple_debug_fatal("main", "%s", "Another instance of " \ + "libpurple is already running.\n") + core.purple_core_quit() return False # create and load the buddy list - c_purple_set_blist(c_purple_blist_new()) - c_purple_blist_load() + blist.purple_set_blist(blist.purple_blist_new()) + blist.purple_blist_load() # load pounces - c_purple_pounces_load() + pounce.purple_pounces_load() return ret - # core_init -# Purple + def add_callback(self, type, name, callback): + '''Adds a callback with given name inside callback's type. + + @param type Callback type (e.g. "account") + @param name Callback name (e.g. "notify-added") + @param callback Callback to be called + ''' + + global account_cbs + global blist_cbs + global connection_cbs + global conversation_cbs + global notify_cbs + global request_cbs + + { "account": account_cbs, + "blist": blist_cbs, + "connection": connection_cbs, + "conversation": conversation_cbs, + "notify": notify_cbs, + "request": request_cbs }[type][name] = callback + + def signal_connect(self, name=None, cb=None): + '''Connects a signal handler to a signal for a particular object. + Take care not to register a handler function twice. Purple will + not correct any mistakes for you in this area. + + @param name Name of the signal to connect. + @param cb Callback function. + ''' + + cdef int handle + cdef plugin.PurplePlugin *jabber + + if name is None: + return + + jabber = prpl.purple_find_prpl("prpl-jabber") + if jabber == NULL: + return + + global signal_cbs + signal_cbs[name] = cb + + if name == "signed-on": + signals.purple_signal_connect( + connection.purple_connections_get_handle(), + "signed-on", &handle, + signal_signed_on_cb, NULL) + elif name == "signed-off": + signals.purple_signal_connect( + connection.purple_connections_get_handle(), + "signed-off", &handle, + signal_signed_off_cb, NULL) + elif name == "connection-error": + signals.purple_signal_connect( + connection.purple_connections_get_handle(), + "connection-error", &handle, + signal_connection_error_cb, NULL) + elif name == "buddy-signed-on": + signals.purple_signal_connect( + blist.purple_blist_get_handle(), + "buddy-signed-on", &handle, + signal_buddy_signed_on_cb, NULL) + elif name == "buddy-signed-off": + signals.purple_signal_connect( + blist.purple_blist_get_handle(), + "buddy-signed-off", &handle, + signal_buddy_signed_off_cb, NULL) + elif name == "receiving-im-msg": + signals.purple_signal_connect( + conversation.purple_conversations_get_handle(), + "receiving-im-msg", &handle, + signal_receiving_im_msg_cb, NULL) + elif name == "jabber-receiving-xmlnode": + signals.purple_signal_connect( + jabber, "jabber-receiving-xmlnode", &handle, + jabber_receiving_xmlnode_cb, NULL) + + def accounts_get_all(self): + '''Returns a list of all accounts. + + @return A list of all accounts. + ''' + + cdef glib.GList *iter + cdef account.PurpleAccount *acc + cdef char *username + cdef char *protocol_id + + iter = account.purple_accounts_get_all() + account_list = [] + + while iter: + acc = iter.data + + if acc: + username = account.purple_account_get_username(acc) + protocol_id = account.purple_account_get_protocol_id(acc) + + if username != NULL and protocol_id != NULL: + account_list.append(Account(username, \ + Protocol(protocol_id), self)) + iter = iter.next + + return account_list + + def accounts_get_all_active(self): + '''Returns a list of all enabled accounts. + + @return A list of all enabled accounts. + ''' + + cdef glib.GList *iter + cdef account.PurpleAccount *acc + cdef char *username + cdef char *protocol_id + + #FIXME: The list is owned by the caller, and must be g_list_free()d + # to avoid leaking the nodes. + + iter = account.purple_accounts_get_all_active() + account_list = [] + + while iter: + acc = iter.data + + if acc: + username = account.purple_account_get_username(acc) + protocol_id = account.purple_account_get_protocol_id(acc) + + if username != NULL and protocol_id != NULL: + account_list.append(Account(username, \ + Protocol(protocol_id), self)) + iter = iter.next + + return account_list + + def protocols_get_all(self): + '''Returns a list of all protocols. + + @return A list of all protocols. + ''' + + cdef glib.GList *iter + cdef plugin.PurplePlugin *pp - def get_protocols(self): - cdef GList *iter - cdef PurplePlugin *plugin - protocols = [] - iter = c_purple_plugins_get_protocols() + iter = plugin.purple_plugins_get_protocols() + protocol_list = [] while iter: - plugin = iter.data - if plugin.info and plugin.info.name: - protocols += [(plugin.info.id, plugin.info.name)] + pp = iter.data + if pp.info and pp.info.name: + protocol_list.append(Protocol(pp.info.id)) iter = iter.next - return protocols - - def connect(self): - conn = Connection() - conn.connect() - -include "core/account.pxd" -include "core/buddy.pxd" -include "glib.pxd" -#include "core/blist.pxd" -include "core/connection.pxd" -#include "core/core.pxd" -#include "core/idle.pxd" -#include "core/pounce.pxd" -include "core/conversation.pxd" + return protocol_list + + def call_action(self, i): + __call_action(i) + +include "protocol.pyx" +#include "plugin.pyx" +include "proxy.pyx" +#include "protocol.pyx" +include "account.pyx" +include "buddy.pyx" +#include "connection.pyx" +include "conversation.pyx"