2007-06-07 Murray Cumming <murrayc@murrayc.com>
[modest] / src / modest-tny-folder.c
1 /* Copyright (c) 2006, Nokia Corporation
2  * All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *
8  * * Redistributions of source code must retain the above copyright
9  *   notice, this list of conditions and the following disclaimer.
10  * * Redistributions in binary form must reproduce the above copyright
11  *   notice, this list of conditions and the following disclaimer in the
12  *   documentation and/or other materials provided with the distribution.
13  * * Neither the name of the Nokia Corporation nor the names of its
14  *   contributors may be used to endorse or promote products derived from
15  *   this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
18  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
19  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
20  * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
21  * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
22  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
23  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
24  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
25  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
26  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29
30 #include <glib.h>
31 #include <glib/gi18n.h>
32 #include <string.h>
33 #include <modest-tny-folder.h>
34 #include <modest-tny-outbox-account.h>
35 #include <tny-camel-folder.h>
36 #include <tny-merge-folder.h>
37 #include <camel/camel-folder.h>
38 #include <modest-protocol-info.h>
39 #include <modest-runtime.h>
40 #include <modest-tny-account-store.h>
41
42 TnyFolderType
43 modest_tny_folder_guess_folder_type_from_name (const gchar* name)
44 {
45         gint  type;
46         gchar *folder;
47
48         g_return_val_if_fail (name, TNY_FOLDER_TYPE_UNKNOWN);
49         
50         type = TNY_FOLDER_TYPE_UNKNOWN;
51         folder = g_utf8_strdown (name, strlen(name));
52
53         if (strcmp (folder, "inbox") == 0 ||
54             strcmp (folder, _("inbox")) == 0 ||
55             strcmp (folder, _("mcen_me_folder_inbox")) == 0)
56                 type = TNY_FOLDER_TYPE_INBOX;
57         else if (strcmp (folder, "outbox") == 0 ||
58                  strcmp (folder, _("outbox")) == 0 ||
59                  strcmp (folder, _("mcen_me_folder_outbox")) == 0)
60                 type = TNY_FOLDER_TYPE_OUTBOX;
61         else if (g_str_has_prefix(folder, "junk") ||
62                  g_str_has_prefix(folder, _("junk")))
63                 type = TNY_FOLDER_TYPE_JUNK;
64         else if (g_str_has_prefix(folder, "trash") ||
65                  g_str_has_prefix(folder, _("trash")))
66                 type = TNY_FOLDER_TYPE_TRASH;
67         else if (g_str_has_prefix(folder, "sent") ||
68                  g_str_has_prefix(folder, _("sent")) ||
69                  strcmp (folder, _("mcen_me_folder_sent")) == 0)
70                 type = TNY_FOLDER_TYPE_SENT;
71         else if (g_str_has_prefix(folder, "draft") ||
72                  g_str_has_prefix(folder, _("draft")) ||
73                  strcmp (folder, _("mcen_me_folder_drafts")) == 0)
74                 type = TNY_FOLDER_TYPE_DRAFTS;
75         else if (g_str_has_prefix(folder, "notes") ||
76                  g_str_has_prefix(folder, _("notes")))
77                 type = TNY_FOLDER_TYPE_NOTES;
78         else if (g_str_has_prefix(folder, "contacts") ||
79                  g_str_has_prefix(folder, _("contacts")))
80                 type = TNY_FOLDER_TYPE_CONTACTS;
81         else if (g_str_has_prefix(folder, "calendar") ||
82                  g_str_has_prefix(folder, _("calendar")))
83                 type = TNY_FOLDER_TYPE_CALENDAR;
84         
85         g_free (folder);
86         return type;
87 }
88
89
90
91 TnyFolderType
92 modest_tny_folder_guess_folder_type (const TnyFolder *folder)
93 {
94         TnyFolderType type;
95
96         g_return_val_if_fail (folder, TNY_FOLDER_TYPE_UNKNOWN);
97
98         type = tny_folder_get_folder_type (TNY_FOLDER (folder));
99         
100         if (type == TNY_FOLDER_TYPE_UNKNOWN) {
101                 const gchar *folder_name;
102
103                 folder_name = tny_folder_get_name (TNY_FOLDER (folder));
104                 type =  modest_tny_folder_guess_folder_type_from_name (folder_name);
105         }
106
107         return type;
108 }
109
110
111 /* FIXME: encode all folder rules here */
112 ModestTnyFolderRules
113 modest_tny_folder_get_rules   (TnyFolder *folder)
114 {
115         ModestTnyFolderRules rules = 0;
116         TnyFolderType type;
117
118         g_return_val_if_fail (TNY_IS_FOLDER(folder), -1);
119
120         if (modest_tny_folder_is_local_folder (folder)) {
121         
122                 type = modest_tny_folder_get_local_folder_type (folder);
123                 
124                 switch (type) {
125                 case TNY_FOLDER_TYPE_OUTBOX:
126                 case TNY_FOLDER_TYPE_SENT:
127                         rules |= MODEST_FOLDER_RULES_FOLDER_NON_WRITEABLE;
128                 case TNY_FOLDER_TYPE_DRAFTS:
129                 case TNY_FOLDER_TYPE_INBOX:
130                 case TNY_FOLDER_TYPE_JUNK:
131                 case TNY_FOLDER_TYPE_TRASH:
132                 case TNY_FOLDER_TYPE_ROOT:
133                 case TNY_FOLDER_TYPE_NOTES:
134                 case TNY_FOLDER_TYPE_CONTACTS:
135                 case TNY_FOLDER_TYPE_CALENDAR:
136                 case TNY_FOLDER_TYPE_ARCHIVE:
137                 case TNY_FOLDER_TYPE_MERGE:
138                 case TNY_FOLDER_TYPE_NUM:
139                         rules |= MODEST_FOLDER_RULES_FOLDER_NON_DELETABLE;
140                         rules |= MODEST_FOLDER_RULES_FOLDER_NON_MOVEABLE;
141                         rules |= MODEST_FOLDER_RULES_FOLDER_NON_RENAMEABLE;
142                 default:
143                         break;
144                 }
145         } else {
146                 ModestTransportStoreProtocol proto;
147                 TnyAccount *account =
148                         modest_tny_folder_get_account ((TnyFolder*)folder);
149                 if (!account)
150                         return -1; /* no account: nothing is allowed */
151                 
152                 proto = modest_protocol_info_get_transport_store_protocol (tny_account_get_proto (account));
153
154                 if (proto == MODEST_PROTOCOL_STORE_IMAP) {
155                         rules = 0;
156                 } else {
157                         /* pop, nntp, ... */
158                         rules =
159                                 MODEST_FOLDER_RULES_FOLDER_NON_WRITEABLE |
160                                 MODEST_FOLDER_RULES_FOLDER_NON_DELETABLE |
161                                 MODEST_FOLDER_RULES_FOLDER_NON_MOVEABLE  |
162                                 MODEST_FOLDER_RULES_FOLDER_NON_RENAMEABLE;
163
164                 }
165                 g_object_unref (G_OBJECT(account));
166         }
167         return rules;
168 }
169
170
171 gboolean
172 modest_tny_folder_is_local_folder   (TnyFolder *folder)
173 {
174         g_return_val_if_fail (folder, FALSE);
175         
176         /* The merge folder is a special case, 
177          * used to merge the per-account local outbox folders. 
178          * and can have no get_account() implementation.
179          * We should do something more sophisticated if we 
180          * ever use TnyMergeFolder for anything else.
181          */
182         if (TNY_IS_MERGE_FOLDER (folder))
183                 return TRUE;
184
185         TnyAccount* account = tny_folder_get_account ((TnyFolder*)folder);
186         if (!account)
187                 return FALSE;
188
189         /* Outbox is a special case, using a derived TnyAccount: */
190         if (MODEST_IS_TNY_OUTBOX_ACCOUNT (account)) {
191                 g_object_unref (account);
192                 return TRUE;  
193         }
194
195         const gchar* account_id = tny_account_get_id (account);
196         if (!account_id)
197                 return FALSE;
198
199         g_object_unref (G_OBJECT(account));
200         
201         return (strcmp (account_id, MODEST_ACTUAL_LOCAL_FOLDERS_ACCOUNT_ID) == 0);
202 }       
203
204
205 TnyFolderType
206 modest_tny_folder_get_local_folder_type  (TnyFolder *folder)
207 {
208         g_return_val_if_fail (folder, TNY_FOLDER_TYPE_UNKNOWN);
209
210         /* The merge folder is a special case, 
211          * used to merge the per-account local outbox folders. 
212          * and can have no get_account() implementation.
213          * We should do something more sophisticated if we 
214          * ever use TnyMergeFolder for anything else.
215          */
216         if (TNY_IS_MERGE_FOLDER (folder))
217                 return TNY_FOLDER_TYPE_OUTBOX;
218                 
219         /* Outbox is a special case, using a derived TnyAccount: */
220         TnyAccount* parent_account = tny_folder_get_account (folder);
221         if (parent_account && MODEST_IS_TNY_OUTBOX_ACCOUNT (parent_account)) {
222                 g_object_unref (parent_account);
223                 return TNY_FOLDER_TYPE_OUTBOX;  
224         }
225
226         if (parent_account) {
227                 g_object_unref (parent_account);
228                 parent_account = NULL;
229         }
230
231
232         g_return_val_if_fail (modest_tny_folder_is_local_folder(folder),
233                               TNY_FOLDER_TYPE_UNKNOWN);
234
235         /* we need to use the camel functions, because we want the
236          * _full name_, that is, the full path name of the folder,
237          * to distinguish between 'Outbox' and 'myfunkyfolder/Outbox'
238          */
239         CamelFolder *camel_folder = tny_camel_folder_get_folder (TNY_CAMEL_FOLDER(folder));
240         if (!camel_folder)
241                 return TNY_FOLDER_TYPE_UNKNOWN;
242
243         const gchar *full_name = camel_folder_get_full_name (camel_folder);
244         /* printf ("DEBUG: %s: full_name=%s\n", __FUNCTION__, full_name); */
245         camel_object_unref (CAMEL_OBJECT(camel_folder));
246         
247         if (!full_name) 
248                 return TNY_FOLDER_TYPE_UNKNOWN;
249         else 
250                 return modest_local_folder_info_get_type (full_name);
251 }
252
253 gboolean
254 modest_tny_folder_is_outbox_for_account (TnyFolder *folder, TnyAccount *account)
255 {
256         g_return_val_if_fail(folder, FALSE);
257         g_return_val_if_fail(account, FALSE);
258         
259         if (modest_tny_folder_get_local_folder_type (folder) != TNY_FOLDER_TYPE_OUTBOX)
260                 return FALSE;
261                 
262         return TRUE;
263 #if 0   
264         /* we need to use the camel functions, because we want the
265          * _full name_, that is, the full path name of the folder,
266          * to distinguis between 'Outbox' and 'myfunkyfolder/Outbox'
267          */
268         CamelFolder *camel_folder = tny_camel_folder_get_folder (TNY_CAMEL_FOLDER(folder));
269         if (!camel_folder)
270                 return FALSE;
271
272         const gchar *full_name = camel_folder_get_full_name (camel_folder);
273         camel_object_unref (CAMEL_OBJECT(camel_folder));
274         
275         if (!full_name) 
276                 return TNY_FOLDER_TYPE_UNKNOWN;
277         else 
278                 return modest_local_folder_info_get_type (full_name);
279                 
280         return FALSE;
281 #endif
282 }
283
284 gchar* 
285 modest_tny_folder_get_header_unique_id (TnyHeader *header)
286 {
287         TnyFolder *folder;
288         gchar *url, *retval;
289         const gchar *uid;
290
291         g_return_val_if_fail (TNY_IS_HEADER (header), NULL);
292
293         folder = tny_header_get_folder (header);
294         if (!folder)
295                 return NULL;
296
297         url = tny_folder_get_url_string (folder);
298         uid = tny_header_get_uid (header);
299
300         retval = g_strjoin ("/", url, uid, NULL);
301
302         g_free (url);
303         g_object_unref (folder);
304
305         return retval;
306 }
307
308 TnyAccount *modest_tny_folder_get_account (TnyFolder *folder)
309 {
310         TnyAccount *account = NULL;
311         
312         if (TNY_IS_MERGE_FOLDER (folder)) {
313                 /* TnyMergeFolder does not support get_account(), 
314                  * because it could be merging folders from multiple accounts.
315                  * So we assume that this is the local folders account: */
316                  
317                 account = modest_tny_account_store_get_local_folders_account (
318                         TNY_ACCOUNT_STORE (modest_runtime_get_account_store()));
319         } else {
320                 account = tny_folder_get_account (folder);
321         }
322         
323         return account;
324 }
325