2 # Copyright (c) 2008 INdT - Instituto Nokia de Tecnologia
4 # This file is part of python-purple.
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.
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.
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/>.
25 @param core Purple class instance
27 @param protocol Protocol class instance
30 def __init__(self, username, protocol, core):
31 self.__username = username
32 self.__protocol = protocol
35 if protocol.exists and self._get_structure() != NULL:
40 cdef account.PurpleAccount *_get_structure(self):
41 return account.purple_accounts_find(self.username, \
42 self.protocol.protocol_id)
44 def __is_connected(self):
46 return account.purple_account_is_connected(self._get_structure())
49 is_connected = property(__is_connected)
51 def __is_connecting(self):
53 return account.purple_account_is_connecting(self._get_structure())
56 is_connecting = property(__is_connecting)
58 def __is_disconnected(self):
60 return account.purple_account_is_disconnected( \
61 self._get_structure())
64 is_disconnected = property(__is_disconnected)
68 core = property(__get_core)
70 def __get_exists(self):
72 exists = property(__get_exists)
74 def __get_username(self):
75 cdef char *username = NULL
77 username = <char *> account.purple_account_get_username( \
78 self._get_structure())
84 return self.__username
85 username = property(__get_username)
87 def __get_protocol(self):
89 protocol = property(__get_protocol)
91 def __get_password(self):
92 cdef char *password = NULL
94 password = <char *> account.purple_account_get_password( \
95 self._get_structure())
102 password = property(__get_password)
104 def __get_alias(self):
105 cdef char *alias = NULL
107 alias = <char *> account.purple_account_get_alias(self._get_structure())
114 alias = property(__get_alias)
116 def __get_user_info(self):
117 cdef char *user_info = NULL
119 user_info = <char *> account.purple_account_get_user_info(self._get_structure())
126 user_info = property(__get_user_info)
128 def __get_remember_password(self):
130 return account.purple_account_get_remember_password( \
131 self._get_structure())
134 remember_password = property(__get_remember_password)
136 def __get_enabled(self):
138 return account.purple_account_get_enabled(self._get_structure(), \
142 enabled = property(__get_enabled)
144 def set_username(self, username):
146 Sets the account's username.
148 @param username The username
149 @return True if successful, False if account doesn't exists
152 account.purple_account_set_username(self._get_structure(), \
158 def set_protocol(self, protocol):
160 Sets the account's protocol.
162 @param protocol A Protocol class instance
163 @return True if successful, False if account doesn't exists
165 if protocol.exists and self.__exists:
166 account.purple_account_set_protocol_id(self._get_structure(), \
167 protocol.protocol_id)
168 self.__protocol = protocol
173 def set_password(self, password):
175 Sets the account's password.
177 @param password The password
178 @return True if successful, False if account doesn't exists
181 account.purple_account_set_password(self._get_structure(), \
187 def set_alias(self, alias):
189 Sets the account's alias
191 @param alias The alias
192 @return True if successful, False if account doesn't exists
195 account.purple_account_set_alias(self._get_structure(), \
201 def set_user_info(self, user_info):
203 Sets the account's user information
205 @param user_info The user information
206 @return True if successful, False if account doesn't exists
209 account.purple_account_set_user_info(self._get_structure(), \
215 def set_remember_password(self, remember_password):
217 Sets whether or not this account should save its password.
219 @param remember_password True if should remember the password,
221 @return True if successful, False if account doesn't exists
224 account.purple_account_set_remember_password( \
225 self._get_structure(), remember_password)
230 def set_enabled(self, value):
232 Sets wheter or not this account is enabled.
234 @param value True if it is enabled, or False otherwise
235 @return True if successful, False if account doesn't exists
238 account.purple_account_set_enabled(self._get_structure(), \
239 self.core.ui_name, bool(value))
246 Creates a new account.
248 @return True if successful, False if account already exists
253 account.purple_account_new(self.username, self.protocol_id)
259 Connects to an account.
261 @return True if successful, False if account doesn't exists
264 account.purple_account_connect(self._get_structure())
269 def disconnect(self):
271 Disconnects from an account.
273 @return True if successful, False if account doesn't exists
276 account.purple_account_disconnect(self._get_structure())