aboutsummaryrefslogtreecommitdiffstats
path: root/lib/AdminPanel/rpmdragora.pm
blob: a2a3c2cf96caf7763202e4ec6a7d432ebb073926 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159/*
 * Guillaume Cottenceau (gc@mandrakesoft.com)
 *
 * Copyright 2000 Mandrakesoft
 *
 * This software may be freely redistributed under the terms of the GNU
 * public license.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 */

/*
 * Using high-level UI.
 *
 * These functions are frontend-independant: your program won't know each
 * `frontend' (e.g. each way to grab user input) will be used.
 *
 * Then you may link your binary against any `frontend' that implement all
 * these functions (and possibly necessary libraries).
 */


#ifndef _FRONTEND_H_
#define _FRONTEND_H_

/* this must be called before anything else */
void init_frontend(void);

/* this must be called before exit of program */
void finish_frontend(void);


void info_message(char *msg, ...) __attribute__ ((format (printf, 1, 2))); /* (blocks program) */

void error_message(char *msg, ...) __attribute__ ((format (printf, 1, 2))); /* (blocks program) */

/* (doesn't block program) 
 * (this is not necessarily stackable, e.g. only one wait_message at a time) */
void wait_message(char *msg, ...) __attribute__ ((format (printf, 1, 2)));

/* call this to finish the wait on wait_message */
void remove_wait_message(void);

/* monitor progression of something (downloading a file, etc)
 * if size of progression is unknown, use `0' */
void init_progression(char *msg, int size);
void update_progression(int current_size);
void end_progression(void);

enum frontend_return { RETURN_OK, RETURN_BACK, RETURN_ERROR };

/* Yes == RETURN_OK    No == RETURN_ERROR    Back == RETURN_BACK */
enum frontend_return ask_yes_no(char *msg);

/* [elems] NULL terminated array of char*
 * [choice] address of a (unitialized) char* */
enum frontend_return ask_from_list(char *msg, char ** elems, char ** choice);

enum frontend_return ask_from_list_comments(char *msg, char ** elems, char ** elems_comments, char ** choice);

/* [questions] NULL terminated array of char*
 * [answers] address of a (unitialized) char**, will contain a non-NULL terminated array of char*
 * [callback_func] function called at most when the answers change; it can examine the array of char* and assign some new char* */
enum frontend_return ask_from_entries(char *msg, char ** questions, char *** answers, int entry_size, void (*callback_func)(char ** strings));

#endif