update copyright year
[claws.git] / src / jpilot.h
1 /*
2  * Claws Mail -- a GTK based, lightweight, and fast e-mail client
3  * Copyright (C) 2001-2012 Match Grun and the Claws Mail team
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 3 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program. If not, see <http://www.gnu.org/licenses/>.
17  * 
18  */
19
20 /*
21  * Definitions for accessing JPilot database files.
22  * JPilot is Copyright(c) by Judd Montgomery.
23  * Visit http://www.jpilot.org for more details.
24  */
25
26 #ifndef __JPILOT_H__
27 #define __JPILOT_H__
28
29 #ifdef HAVE_CONFIG_H
30 #include "claws-features.h"
31 #endif
32
33 #ifdef USE_JPILOT
34
35 #include <glib.h>
36 #include <stdio.h>
37
38 #ifdef HAVE_LIBPISOCK_PI_ADDRESS_H
39 #  include <libpisock/pi-address.h>
40 #else
41 #  include <pi-address.h>
42 #endif
43
44 #include "addritem.h"
45 #include "addrcache.h"
46 #include "adbookbase.h"
47
48 typedef struct _JPilotFile JPilotFile;
49
50 struct _JPilotFile {
51         AddressBookType type;
52         AddressCache *addressCache;
53         gint     retVal;
54         FILE     *file;
55         gchar    *path;
56         struct AddressAppInfo addrInfo;
57         gboolean readMetadata;
58         GList    *customLabels;
59         GList    *labelInd;
60         gboolean havePC3;
61         time_t   pc3ModifyTime;
62 };
63
64 /* Limits */
65 #define JPILOT_NUM_LABELS       22      /* Number of labels */
66 #define JPILOT_NUM_PHONELABELS  8       /* Number of phone number labels */
67 #define JPILOT_NUM_CATEG        16      /* Number of categories */
68 #define JPILOT_LEN_LABEL        15      /* Max length of label */
69 #define JPILOT_LEN_CATEG        15      /* Max length of category */
70 #define JPILOT_NUM_ADDR_PHONE   5       /* Number of phone entries a person */
71                                         /* can have */
72
73 /* Function prototypes */
74 JPilotFile *jpilot_create               ( void );
75 JPilotFile *jpilot_create_path          ( const gchar *path );
76 void jpilot_set_name                    ( JPilotFile* pilotFile, const gchar *value );
77 void jpilot_set_file                    ( JPilotFile* pilotFile, const gchar *value );
78 void jpilot_free                        ( JPilotFile *pilotFile );
79 gint jpilot_get_status                  ( JPilotFile *pilotFile );
80 gboolean jpilot_get_modified            ( JPilotFile *pilotFile );
81 gboolean jpilot_get_accessed            ( JPilotFile *pilotFile );
82 void jpilot_set_accessed                ( JPilotFile *pilotFile, const gboolean value );
83 gboolean jpilot_get_read_flag           ( JPilotFile *pilotFile );
84 ItemFolder *jpilot_get_root_folder      ( JPilotFile *pilotFile );
85 gchar *jpilot_get_name                  ( JPilotFile *pilotFile );
86
87 gint jpilot_read_data                   ( JPilotFile *pilotFile );
88 GList *jpilot_get_list_person           ( JPilotFile *pilotFile );
89 GList *jpilot_get_list_folder           ( JPilotFile *pilotFile );
90 GList *jpilot_get_all_persons           ( JPilotFile *pilotFile );
91
92 GList *jpilot_load_custom_label         ( JPilotFile *pilotFile, GList *labelList );
93
94 gchar *jpilot_find_pilotdb              ( void );
95
96
97 void jpilot_clear_custom_labels         ( JPilotFile *pilotFile );
98 void jpilot_add_custom_label            ( JPilotFile *pilotFile, const gchar *labelName );
99 GList *jpilot_get_custom_labels         ( JPilotFile *pilotFile );
100 gboolean jpilot_test_custom_label       ( JPilotFile *pilotFile, const gchar *labelName );
101 gboolean jpilot_test_pilot_lib          ( void );
102
103 gint jpilot_read_modified               ( JPilotFile *pilotFile );
104
105 #endif /* USE_JPILOT */
106
107 #endif /* __JPILOT_H__ */