Added majority of libpurple functions used by pidgin-carman.
[python-purple] / purple.pyx
1 #
2 #  Copyright (c) 2008 INdT - Instituto Nokia de Tecnologia
3 #
4 #  This file is part of python-purple.
5 #
6 #  python-purple is free software: you can redistribute it and/or modify
7 #  it under the terms of the GNU General Public License as published by
8 #  the Free Software Foundation, either version 3 of the License, or
9 #  (at your option) any later version.
10 #
11 #  python-purple is distributed in the hope that it will be useful,
12 #  but WITHOUT ANY WARRANTY; without even the implied warranty of
13 #  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 #  GNU General Public License for more details.
15 #
16 #  You should have received a copy of the GNU General Public License
17 #  along with this program.  If not, see <http://www.gnu.org/licenses/>.
18 #
19
20 include "glib.pxd"
21
22 cdef extern from *:
23     ctypedef char* const_char_ptr "const char *"
24     ctypedef char* const_guchar_ptr "const guchar *"
25
26 cdef extern from "time.h":
27     ctypedef long int time_t
28
29 include "libpurple/account.pxd"
30 include "libpurple/buddyicon.pxd"
31 include "libpurple/blist.pxd"
32 include "libpurple/connection.pxd"
33 include "libpurple/conversation.pxd"
34 include "libpurple/core.pxd"
35 include "libpurple/debug.pxd"
36 include "libpurple/eventloop.pxd"
37 include "libpurple/idle.pxd"
38 include "libpurple/plugin.pxd"
39 include "libpurple/pounce.pxd"
40 include "libpurple/prefs.pxd"
41 include "libpurple/proxy.pxd"
42 include "libpurple/signals.pxd"
43 include "libpurple/status.pxd"
44 include "libpurple/savedstatuses.pxd"
45 include "libpurple/util.pxd"
46
47 cdef extern from "c_purple.h":
48     void connect_to_signals_for_demonstration_purposes_only ()
49     guint glib_input_add(gint fd, PurpleInputCondition condition, PurpleInputFunction function, gpointer data)
50
51 import ecore
52
53 __DEFAULT_PATH__ = "/tmp"
54 __APP_NAME__ = "carman-purple-python"
55 __APP_VERSION__ = "0.1"
56
57 global __DEFAULT_PATH__
58 global __APP_NAME__
59 global __APP_VERSION__
60
61 cdef class Purple:
62     """ Purple class """
63     cdef PurpleCoreUiOps c_core_ui_ops
64     cdef PurpleEventLoopUiOps c_eventloop_ui_ops
65     cdef GHashTable *c_ui_info
66
67     def __cinit__(self, debug_enabled=True, app_name=__APP_NAME__, default_path=__DEFAULT_PATH__):
68         self.c_ui_info = NULL
69
70         if app_name is not __APP_NAME__:
71             __APP_NAME__ = app_name
72
73         if default_path is not __DEFAULT_PATH__:
74             __DEFAULT_PATH__ = default_path
75
76         c_purple_debug_set_enabled(debug_enabled)
77         c_purple_util_set_user_dir(default_path)
78         c_purple_plugins_add_search_path(default_path)
79
80         # adds glib iteration inside ecore main loop
81         ecore.idler_add(self.__glib_iteration_when_idle)
82      # __cinit__
83
84     def __del__(self):
85         c_purple_core_quit()
86     # __del__
87
88     cdef void __core_ui_ops_ui_prefs_init(self):
89         c_purple_debug(PURPLE_DEBUG_INFO, "core_ui_ops", "ui_prefs_init\n")
90         c_purple_prefs_load()
91
92         c_purple_prefs_add_none("/carman")
93         c_purple_prefs_add_none("/carman/plugins")
94     # __core_ui_ops_ui_prefs_init
95
96     cdef void __core_ui_ops_debug_init(self):
97         c_purple_debug(PURPLE_DEBUG_INFO, "core_ui_ops", "debug_ui_init\n")
98     # __core_ui_ops_debug_init
99
100     cdef void __core_ui_ops_ui_init(self):
101         c_purple_debug(PURPLE_DEBUG_INFO, "core_ui_ops", "ui_init\n")
102     # __core_ui_ops_ui_init
103
104     cdef void __core_ui_ops_quit(self):
105         c_purple_debug(PURPLE_DEBUG_INFO, "core_ui_ops", "quit\n")
106     # __core_ui_ops_quit
107
108     cdef GHashTable *__core_ui_ops_get_ui_info(self):
109         if self.c_ui_info == NULL:
110             self.c_ui_info = g_hash_table_new(g_str_hash, g_str_equal)
111
112             g_hash_table_insert(self.c_ui_info, "name", <gpointer> __APP_NAME__)
113             g_hash_table_insert(self.c_ui_info, "version", <gpointer> __APP_VERSION__)
114         return self.c_ui_info
115     # __core_ui_ops_get_ui_info
116
117     def __glib_iteration_when_idle(self):
118         g_main_context_iteration(NULL, False)
119         return True
120     # __glib_iteration_when_idle
121
122     def purple_init(self):
123         """ Initializes libpurple """
124         # initialize c_core_ui_ops structure
125         self.c_core_ui_ops.ui_prefs_init = <void (*)()> self.__core_ui_ops_ui_prefs_init
126         self.c_core_ui_ops.debug_ui_init = <void (*)()> self.__core_ui_ops_debug_init
127         self.c_core_ui_ops.ui_init = <void (*)()> self.__core_ui_ops_ui_init
128         self.c_core_ui_ops.quit = <void (*)()> self.__core_ui_ops_quit
129         self.c_core_ui_ops.get_ui_info = <GHashTable* (*)()> self.__core_ui_ops_get_ui_info
130
131         c_purple_core_set_ui_ops(&self.c_core_ui_ops)
132
133         # initialize c_eventloop_ui_ops structure
134         self.c_eventloop_ui_ops.timeout_add = g_timeout_add
135         self.c_eventloop_ui_ops.timeout_remove = g_source_remove
136         self.c_eventloop_ui_ops.input_add = glib_input_add
137         self.c_eventloop_ui_ops.input_remove = g_source_remove
138         self.c_eventloop_ui_ops.input_get_error = NULL
139         self.c_eventloop_ui_ops.timeout_add_seconds = g_timeout_add_seconds
140
141         c_purple_eventloop_set_ui_ops(&self.c_eventloop_ui_ops)
142
143         # initialize purple core
144         ret = c_purple_core_init(__APP_NAME__)
145         if ret is False:
146             c_purple_debug(PURPLE_DEBUG_INFO, "main", "Exiting because libpurple initialization failed.\n")
147             return False
148
149         # check if there is another instance of libpurple running
150         if c_purple_core_ensure_single_instance() == False:
151             c_purple_debug(PURPLE_DEBUG_INFO, "main", "Exiting because another instance of libpurple is already running.\n")
152             c_purple_core_quit()
153             return False
154
155         # create and load the buddy list
156         c_purple_set_blist(c_purple_blist_new())
157         c_purple_blist_load()
158
159         # load pounces
160         c_purple_pounces_load()
161
162         return ret
163     # purple_init
164
165     def get_protocols(self):
166         cdef GList *iter
167         cdef PurplePlugin *plugin
168         protocols = []
169         iter = c_purple_plugins_get_protocols()
170         while iter:
171             plugin = <PurplePlugin*> iter.data
172             if plugin.info and plugin.info.name:
173                 protocols += [(plugin.info.id, plugin.info.name)]
174             iter = iter.next
175         return protocols
176     # get_protocols
177
178     def connect(self):
179         conn = Connection()
180         conn.connect()
181     # connect
182 # Purple
183
184 include "account.pxd"
185 include "buddy.pxd"
186 include "connection.pxd"
187 include "conversation.pxd"