X-Git-Url: http://git.maemo.org/git/?p=python-purple;a=blobdiff_plain;f=purple.pyx;h=17411e78233f6ae7c2035846ba327b5f242f1219;hp=0ca9b87a6d95d4802d187d7c6f1affc637b4c047;hb=39c1c26cdc38fe7dc79122c45bba7731b08ed1cd;hpb=4dd540b8a4896ede6e99f7c7869fddf417d90f1a diff --git a/purple.pyx b/purple.pyx index 0ca9b87..17411e7 100644 --- a/purple.pyx +++ b/purple.pyx @@ -17,209 +17,433 @@ # along with this program. If not, see . # -include "glib.pxd" - -cdef extern from *: - ctypedef char* const_char_ptr "const char *" - -cdef extern from "time.h": - ctypedef long int time_t - -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": - void c_purple_plugins_add_search_path "purple_plugins_add_search_path" (const_char_ptr path) - -cdef extern from "libpurple/prefs.h": - 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) +cimport purple cdef extern from "c_purple.h": - void set_uiops() - guint glib_input_add(gint fd, PurpleInputCondition condition, PurpleInputFunction function, gpointer data) - -__DEFAULT_PATH__ = "/home/user/MyDocs/Carman" -__APP_NAME__ = "carman-purple-python" -__APP_VERSION__ = "0.1" - -global __DEFAULT_PATH__ -global __APP_NAME__ - -def debug_misc(category, format): - if category == None: - c_purple_debug(PURPLE_DEBUG_MISC, NULL, format) - else: - c_purple_debug(PURPLE_DEBUG_MISC, category, format) -# debug_misc - -def debug_info(category, format): - if category == None: - c_purple_debug(PURPLE_DEBUG_INFO, NULL, format) - else: - c_purple_debug(PURPLE_DEBUG_INFO, category, format) -# debug_info - -def debug_warning(category, format): - if category == None: - c_purple_debug(PURPLE_DEBUG_WARNING, NULL, format) - else: - c_purple_debug(PURPLE_DEBUG_WARNING, category, format) -# debug_warning - -def debug_error(category, format): - if category == None: - c_purple_debug(PURPLE_DEBUG_ERROR, NULL, format) - else: - c_purple_debug(PURPLE_DEBUG_ERROR, category, format) -# debug_error - -def debug_fatal(category, format): - if category == None: - c_purple_debug(PURPLE_DEBUG_FATAL, NULL, format) - else: - c_purple_debug(PURPLE_DEBUG_FATAL, category, format) -# debug_fatal - -cdef void core_ui_ops_ui_prefs_init(): - debug_info("core_ui_ops", "ui_prefs_init") -# core_ui_ops_ui_prefs_init - -cdef void core_ui_ops_debug_ui_init(): - debug_info("core_ui_ops", "debug_ui_init") -# core_ui_ops_debug_ui_init - -cdef void core_ui_ops_ui_init(): - debug_info("core_ui_ops", "ui_init") -# core_ui_ops_ui_init - -cdef void core_ui_ops_quit(): - debug_info("core_ui_ops", "quit") -# core_ui_ops_quit + 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 class Purple: - def __cinit__(self): - cdef PurpleCoreUiOps c_core_ui_ops - c_core_ui_ops.ui_prefs_init = core_ui_ops_ui_prefs_init - c_core_ui_ops.debug_ui_init = core_ui_ops_debug_ui_init - c_core_ui_ops.ui_init = core_ui_ops_ui_init - c_core_ui_ops.quit = core_ui_ops_quit - c_core_ui_ops.get_ui_info = NULL # FIXME - - cdef PurpleEventLoopUiOps c_eventloop_ui_ops - c_eventloop_ui_ops.timeout_add = g_timeout_add - c_eventloop_ui_ops.timeout_remove = g_source_remove + '''Purple class. + + @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 + ''' + + + 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 + + c_ui_name = ui_name + c_ui_version = ui_version + c_ui_website = ui_website + c_ui_dev_website = ui_dev_website + + if debug_enabled: + debug.purple_debug_set_enabled(debug_enabled) + + if default_path: + util.purple_util_set_user_dir(default_path) + + # adds glib iteration inside ecore main loop + 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 __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.purple_debug_info("core_ui_ops", "%s", "ui_prefs_init\n") + prefs.purple_prefs_load() + + prefs.purple_prefs_add_none("/carman") + + cdef void __core_ui_ops_debug_init(self): + debug.purple_debug_info("core_ui_ops", "%s", "debug_ui_init\n") + pass + + cdef void __core_ui_ops_ui_init(self): + 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.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): + glib.g_main_context_iteration(NULL, False) + return True + + def purple_init(self): + '''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 = g_source_remove + 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 = g_timeout_add_seconds + c_eventloop_ui_ops.timeout_add_seconds = NULL - self.debug_set_enabled(True) - self.util_set_user_dir(__DEFAULT_PATH__) - self.plugin_add_search_path(__DEFAULT_PATH__) + core.purple_core_set_ui_ops(&c_core_ui_ops) + eventloop.purple_eventloop_set_ui_ops(&c_eventloop_ui_ops) - c_purple_core_set_ui_ops(&c_core_ui_ops) - c_purple_eventloop_set_ui_ops(&c_eventloop_ui_ops) - - ret = self.core_init(__APP_NAME__) + # initialize purple core + ret = core.purple_core_init(c_ui_name) if ret is False: - debug_info("main", "Exiting because libpurple initialization failed.") - return + debug.purple_debug_fatal("main", "%s", "libpurple " \ + "initialization failed.\n") + return False # check if there is another instance of libpurple running - if self.core_ensure_single_instance() == False: - debug_info("main", "Exiting because another instance of libpurple is already running.") - self.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.purple_set_blist(blist.purple_blist_new()) + blist.purple_blist_load() + + # load pounces + pounce.purple_pounces_load() + + return ret + + 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 - # __init__ - - def __del__(self): - self.core_quit() - # __del__ - - def core_ensure_single_instance(self): - return c_purple_core_ensure_single_instance() - # core_ensure_single_instance - - def core_init(self, ui_name): - return c_purple_core_init(ui_name) - # core_init - - def core_quit(self): - c_purple_core_quit() - # core_quit - - def debug_set_enabled(self, debug_enabled): - c_purple_debug_set_enabled(debug_enabled) - # debug_set_enabled - - def plugin_add_search_path(self, path): - c_purple_plugins_add_search_path(path) - # plugin_add_search_path - - def prefs_rename(self, old_name, new_name): - c_purple_prefs_rename(old_name, new_name) - # prefs_rename - - def prefs_get_string(self, name): - return c_purple_prefs_get_string(name) - # prefs_get_string - - def prefs_load(self): - return c_purple_prefs_load() - # prefs_load - - def util_set_user_dir(self, dir): - c_purple_util_set_user_dir(dir) - # util_set_user_dir - -include "core/account.pxd" -include "core/buddy.pxd" -#include "core/blist.pxd" -#include "core/connection.pxd" -#include "core/core.pxd" -#include "core/idle.pxd" -#include "core/pounce.pxd" + + 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 + + iter = plugin.purple_plugins_get_protocols() + protocol_list = [] + while iter: + pp = iter.data + if pp.info and pp.info.name: + protocol_list.append(Protocol(pp.info.id)) + iter = iter.next + 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"