X-Git-Url: http://git.maemo.org/git/?p=python-purple;a=blobdiff_plain;f=purple.pyx;h=17411e78233f6ae7c2035846ba327b5f242f1219;hp=fcce7fffdfd33ae64e9ec1cd1b96cefe47b8c2a2;hb=39c1c26cdc38fe7dc79122c45bba7731b08ed1cd;hpb=e7e4e8ff4937aed9c1b732719bc310c3e8a88f5e diff --git a/purple.pyx b/purple.pyx index fcce7ff..17411e7 100644 --- a/purple.pyx +++ b/purple.pyx @@ -17,184 +17,433 @@ # along with this program. If not, see . # -cdef extern from "libpurple/purple.h": - pass - -cimport glib - -cimport account -cimport buddyicon -cimport blist -cimport connection -cimport conversation -cimport core -cimport debug -cimport eventloop -cimport ft -cimport idle -cimport notify -cimport plugin -cimport pounce -cimport prefs -cimport proxy -cimport request -cimport roomlist -cimport signals -cimport status -cimport savedstatuses -cimport util +cimport purple cdef extern from "c_purple.h": - void connect_to_signals_for_demonstration_purposes_only () 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" -__DEFAULT_PATH__ = "/tmp" -__APP_NAME__ = "carman-purple-python" -__APP_VERSION__ = "0.1" +cdef class Purple: + '''Purple class. -global __DEFAULT_PATH__ -global __APP_NAME__ -global __APP_VERSION__ + @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 class Purple: - """ Purple class """ - cdef core.PurpleCoreUiOps c_core_ui_ops - cdef eventloop.PurpleEventLoopUiOps c_eventloop_ui_ops - cdef glib.GHashTable *c_ui_info - def __cinit__(self, debug_enabled=True, app_name=__APP_NAME__, default_path=__DEFAULT_PATH__): - self.c_ui_info = NULL + def __init__(self, ui_name, ui_version, ui_website, ui_dev_website, \ + debug_enabled=None, default_path=None): + + global c_ui_name + global c_ui_version + global c_ui_website + global c_ui_dev_website - if app_name is not __APP_NAME__: - __APP_NAME__ = app_name + c_ui_name = ui_name + c_ui_version = ui_version + c_ui_website = ui_website + c_ui_dev_website = ui_dev_website - if default_path is not __DEFAULT_PATH__: - __DEFAULT_PATH__ = default_path + if debug_enabled: + debug.purple_debug_set_enabled(debug_enabled) - debug.c_purple_debug_set_enabled(debug_enabled) - util.c_purple_util_set_user_dir(default_path) - plugin.c_purple_plugins_add_search_path(default_path) + if default_path: + util.purple_util_set_user_dir(default_path) # adds glib iteration inside ecore main loop - ecore.idler_add(self.__glib_iteration_when_idle) - # __cinit__ + ecore.timer_add(0.001, self.__glib_iteration_when_idle) + + # 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) + + def destroy(self): + core.purple_core_quit() - def __del__(self): - core.c_purple_core_quit() - # __del__ + def __get_ui_name(self): + '''Returns the UI name. + + @return UI name. + ''' + + global c_ui_name + return str(c_ui_name) + ui_name = property(__get_ui_name) cdef void __core_ui_ops_ui_prefs_init(self): - debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "core_ui_ops", "ui_prefs_init\n") - prefs.c_purple_prefs_load() + debug.purple_debug_info("core_ui_ops", "%s", "ui_prefs_init\n") + prefs.purple_prefs_load() - prefs.c_purple_prefs_add_none("/carman") - # __core_ui_ops_ui_prefs_init + prefs.purple_prefs_add_none("/carman") cdef void __core_ui_ops_debug_init(self): - debug.c_purple_debug(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): - debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "core_ui_ops", "ui_init\n") - - # FIXME: Add core ui initialization here - # __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): - debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "core_ui_ops", "quit\n") - - account.c_purple_accounts_set_ui_ops(NULL) - connection.c_purple_connections_set_ui_ops(NULL) - blist.c_purple_blist_set_ui_ops(NULL) - conversation.c_purple_conversations_set_ui_ops(NULL) - notify.c_purple_notify_set_ui_ops(NULL) - request.c_purple_request_set_ui_ops(NULL) - ft.c_purple_xfers_set_ui_ops(NULL) - roomlist.c_purple_roomlist_set_ui_ops(NULL) + 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) - # __core_ui_ops_quit + glib.g_hash_table_destroy( self.c_ui_info) cdef glib.GHashTable *__core_ui_ops_get_ui_info(self): - if self.c_ui_info == NULL: - self.c_ui_info = glib.g_hash_table_new(glib.g_str_hash, glib.g_str_equal) - - glib.g_hash_table_insert(self.c_ui_info, "name", __APP_NAME__) - glib.g_hash_table_insert(self.c_ui_info, "version", __APP_VERSION__) - return self.c_ui_info - # __core_ui_ops_get_ui_info + 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): 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 - - core.c_purple_core_set_ui_ops(&self.c_core_ui_ops) - - # initialize c_eventloop_ui_ops structure - self.c_eventloop_ui_ops.timeout_add = glib.g_timeout_add - self.c_eventloop_ui_ops.timeout_remove = glib.g_source_remove - self.c_eventloop_ui_ops.input_add = glib_input_add - self.c_eventloop_ui_ops.input_remove = glib.g_source_remove - self.c_eventloop_ui_ops.input_get_error = NULL - self.c_eventloop_ui_ops.timeout_add_seconds = glib.g_timeout_add_seconds - - eventloop.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 = core.c_purple_core_init(__APP_NAME__) + ret = core.purple_core_init(c_ui_name) if ret is False: - debug.c_purple_debug(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 core.c_purple_core_ensure_single_instance() == False: - debug.c_purple_debug(debug.PURPLE_DEBUG_INFO, "main", "Exiting because another instance of libpurple is already running.\n") - core.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 - blist.c_purple_set_blist(blist.c_purple_blist_new()) - blist.c_purple_blist_load() + blist.purple_set_blist(blist.purple_blist_new()) + blist.purple_blist_load() # load pounces - pounce.c_purple_pounces_load() + pounce.purple_pounces_load() return ret - # purple_init - def get_protocols(self): + 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 plugin.PurplePlugin *__plugin - protocols = [] - iter = plugin.c_purple_plugins_get_protocols() + 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 + + 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 - # get_protocols + return protocol_list - def connect(self): - conn = Connection() - conn.connect() - # connect -# Purple + 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 "connection.pyx" include "conversation.pyx"