X-Git-Url: http://git.maemo.org/git/?a=blobdiff_plain;ds=sidebyside;f=purple.pyx;h=17411e78233f6ae7c2035846ba327b5f242f1219;hb=7752e0f4a14a32ede02b8b86c83d9510338a59ed;hp=fcce7fffdfd33ae64e9ec1cd1b96cefe47b8c2a2;hpb=e7e4e8ff4937aed9c1b732719bc310c3e8a88f5e;p=python-purple
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"