2ca1414f5b42bb8e1feb622834a64d95478b3c38
[python-purple] / account_cbs.pxd
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 cimport purple
21
22 cdef extern from *:
23     ctypedef char const_char "const char"
24
25 account_cbs = {}
26
27 cdef account.PurpleAccountRequestAuthorizationCb c_request_authorize_authorize_cb = NULL
28 cdef account.PurpleAccountRequestAuthorizationCb c_request_authorize_deny_cb = NULL
29 cdef void *c_request_authorize_user_data = NULL
30
31 def call_authorize_cb():
32     global c_request_authorize_authorize_cb
33     global c_request_authorize_deny_cb
34     global c_request_authorize_user_data
35
36     if c_request_authorize_authorize_cb:
37         c_request_authorize_authorize_cb(c_request_authorize_user_data)
38     c_request_authorize_authorize_cb = NULL
39     c_request_authorize_deny_cb = NULL
40     c_request_authorize_user_data = NULL
41
42 def call_deny_cb():
43     global c_request_authorize_authorize_cb
44     global c_request_authorize_deny_cb
45     global c_request_authorize_user_data
46
47     if c_request_authorize_deny_cb:
48         c_request_authorize_deny_cb(c_request_authorize_user_data)
49     c_request_authorize_authorize_cb = NULL
50     c_request_authorize_deny_cb = NULL
51     c_request_authorize_user_data = NULL
52
53 cdef void notify_added(account.PurpleAccount *account, \
54         const_char *remote_user, const_char *id, const_char *alias, \
55         const_char *message):
56     """
57     A buddy who is already on this account's buddy list added this account to
58     their buddy list.
59     """
60     debug.purple_debug_info("account", "%s", "notify-added\n")
61     if account_cbs.has_key("notify-added"):
62         (<object> account_cbs["notify-added"])("notify-added: TODO")
63
64 cdef void status_changed(account.PurpleAccount *account, \
65         status.PurpleStatus *status):
66     """
67     This account's status changed.
68     """
69     debug.purple_debug_info("account", "%s", "status-changed\n")
70     if account_cbs.has_key("status-changed"):
71         (<object> account_cbs["status-changed"])("status-changed: TODO")
72
73 cdef void request_add(account.PurpleAccount *account, \
74         const_char *remote_user, const_char *id, const_char *alias, \
75         const_char *message):
76     """
77     Someone we don't have on our list added us; prompt to add them.
78     """
79     debug.purple_debug_info("account", "%s", "request-add\n")
80     if account_cbs.has_key("request-add"):
81         (<object> account_cbs["request-add"])("request-add: TODO")
82
83 cdef void *request_authorize(account.PurpleAccount *c_account, \
84         const_char *remote_user, const_char *id, const_char *alias, \
85         const_char *c_message, glib.gboolean on_list, \
86         account.PurpleAccountRequestAuthorizationCb authorize_cb, \
87         account.PurpleAccountRequestAuthorizationCb deny_cb, \
88         void *user_data):
89     """
90     Prompt for authorization when someone adds this account to their buddy
91     list. To authorize them to see this account's presence, call
92     authorize_cb(user_data) otherwise call deny_cb(user_data).
93     @return a UI-specific handle, as passed to #close_account_request.
94     """
95     cdef connection.PurpleConnection *gc = \
96             account.purple_account_get_connection(c_account)
97
98     debug.purple_debug_info("account", "%s", "request-authorize\n")
99
100     global c_request_authorize_authorize_cb
101     global c_request_authorize_deny_cb
102     global c_request_authorize_user_data
103
104     c_request_authorize_authorize_cb = authorize_cb
105     c_request_authorize_deny_cb = deny_cb
106     c_request_authorize_user_data = user_data
107
108     if alias:
109         remote_alias = <char *> alias
110     else:
111         remote_alias = None
112
113     if id:
114         username = <char *> id
115     elif connection.purple_connection_get_display_name(gc) != NULL:
116         username = connection.purple_connection_get_display_name(gc)
117     else:
118         username = account.purple_account_get_username(c_account)
119
120     protocol_id = account.purple_account_get_protocol_id(c_account)
121
122     if c_message:
123         message = <char *> c_message
124     else:
125         message = None
126
127     if account_cbs.has_key("request-authorize"):
128         (<object> account_cbs["request-authorize"])( \
129                 (<char *> remote_user, remote_alias), \
130                 (username, protocol_id), \
131                 message, on_list, \
132                 call_authorize_cb, call_deny_cb)
133
134 cdef void close_account_request (void *ui_handle):
135     """
136     Close a pending request for authorization. ui_handle is a handle as
137     returned by request_authorize.
138     """
139     debug.purple_debug_info("account", "%s", "close-account-request\n")
140
141     request.purple_request_close(request.PURPLE_REQUEST_ACTION, ui_handle)
142
143     if account_cbs.has_key("close-account-request"):
144         (<object> account_cbs["close-account-request"])()