]> git.cameronkatri.com Git - cgit.git/blob - cgit.h
Merge branch 'stable'
[cgit.git] / cgit.h
1 #ifndef CGIT_H
2 #define CGIT_H
3
4
5 #include <git-compat-util.h>
6 #include <cache.h>
7 #include <grep.h>
8 #include <object.h>
9 #include <tree.h>
10 #include <commit.h>
11 #include <tag.h>
12 #include <diff.h>
13 #include <diffcore.h>
14 #include <refs.h>
15 #include <revision.h>
16 #include <log-tree.h>
17 #include <archive.h>
18 #include <xdiff/xdiff.h>
19 #include <utf8.h>
20
21
22 /*
23 * The valid cgit repo-commands
24 */
25 #define CMD_LOG 1
26 #define CMD_COMMIT 2
27 #define CMD_DIFF 3
28 #define CMD_TREE 4
29 #define CMD_BLOB 5
30 #define CMD_SNAPSHOT 6
31 #define CMD_TAG 7
32 #define CMD_REFS 8
33
34 /*
35 * Dateformats used on misc. pages
36 */
37 #define FMT_LONGDATE "%Y-%m-%d %H:%M:%S"
38 #define FMT_SHORTDATE "%Y-%m-%d"
39
40
41 /*
42 * Limits used for relative dates
43 */
44 #define TM_MIN 60
45 #define TM_HOUR (TM_MIN * 60)
46 #define TM_DAY (TM_HOUR * 24)
47 #define TM_WEEK (TM_DAY * 7)
48 #define TM_YEAR (TM_DAY * 365)
49 #define TM_MONTH (TM_YEAR / 12.0)
50
51
52 /*
53 * Default encoding
54 */
55 #define PAGE_ENCODING "UTF-8"
56
57 typedef void (*configfn)(const char *name, const char *value);
58 typedef void (*filepair_fn)(struct diff_filepair *pair);
59 typedef void (*linediff_fn)(char *line, int len);
60
61 struct cacheitem {
62 char *name;
63 struct stat st;
64 int ttl;
65 int fd;
66 };
67
68 struct repoinfo {
69 char *url;
70 char *name;
71 char *path;
72 char *desc;
73 char *owner;
74 char *defbranch;
75 char *group;
76 char *module_link;
77 char *readme;
78 int snapshots;
79 int enable_log_filecount;
80 int enable_log_linecount;
81 };
82
83 struct repolist {
84 int length;
85 int count;
86 struct repoinfo *repos;
87 };
88
89 struct commitinfo {
90 struct commit *commit;
91 char *author;
92 char *author_email;
93 unsigned long author_date;
94 char *committer;
95 char *committer_email;
96 unsigned long committer_date;
97 char *subject;
98 char *msg;
99 char *msg_encoding;
100 };
101
102 struct taginfo {
103 char *tagger;
104 char *tagger_email;
105 int tagger_date;
106 char *msg;
107 };
108
109 struct refinfo {
110 const char *refname;
111 struct object *object;
112 union {
113 struct taginfo *tag;
114 struct commitinfo *commit;
115 };
116 };
117
118 struct reflist {
119 struct refinfo **refs;
120 int alloc;
121 int count;
122 };
123
124 extern const char *cgit_version;
125
126 extern struct repolist cgit_repolist;
127 extern struct repoinfo *cgit_repo;
128 extern int cgit_cmd;
129
130 extern char *cgit_root_title;
131 extern char *cgit_css;
132 extern char *cgit_logo;
133 extern char *cgit_index_header;
134 extern char *cgit_index_info;
135 extern char *cgit_logo_link;
136 extern char *cgit_module_link;
137 extern char *cgit_agefile;
138 extern char *cgit_virtual_root;
139 extern char *cgit_script_name;
140 extern char *cgit_cache_root;
141 extern char *cgit_repo_group;
142
143 extern int cgit_nocache;
144 extern int cgit_snapshots;
145 extern int cgit_enable_index_links;
146 extern int cgit_enable_log_filecount;
147 extern int cgit_enable_log_linecount;
148 extern int cgit_max_lock_attempts;
149 extern int cgit_cache_root_ttl;
150 extern int cgit_cache_repo_ttl;
151 extern int cgit_cache_dynamic_ttl;
152 extern int cgit_cache_static_ttl;
153 extern int cgit_cache_max_create_time;
154 extern int cgit_summary_log;
155 extern int cgit_summary_tags;
156 extern int cgit_summary_branches;
157
158 extern int cgit_max_msg_len;
159 extern int cgit_max_repodesc_len;
160 extern int cgit_max_commit_count;
161
162 extern int cgit_query_has_symref;
163 extern int cgit_query_has_sha1;
164
165 extern char *cgit_querystring;
166 extern char *cgit_query_repo;
167 extern char *cgit_query_page;
168 extern char *cgit_query_search;
169 extern char *cgit_query_grep;
170 extern char *cgit_query_head;
171 extern char *cgit_query_sha1;
172 extern char *cgit_query_sha2;
173 extern char *cgit_query_path;
174 extern char *cgit_query_name;
175 extern int cgit_query_ofs;
176
177 extern int htmlfd;
178
179 extern int cgit_get_cmd_index(const char *cmd);
180 extern struct repoinfo *cgit_get_repoinfo(const char *url);
181 extern void cgit_global_config_cb(const char *name, const char *value);
182 extern void cgit_repo_config_cb(const char *name, const char *value);
183 extern void cgit_querystring_cb(const char *name, const char *value);
184
185 extern int chk_zero(int result, char *msg);
186 extern int chk_positive(int result, char *msg);
187 extern int chk_non_negative(int result, char *msg);
188
189 extern int hextoint(char c);
190 extern char *trim_end(const char *str, char c);
191 extern char *strlpart(char *txt, int maxlen);
192 extern char *strrpart(char *txt, int maxlen);
193
194 extern void cgit_add_ref(struct reflist *list, struct refinfo *ref);
195 extern int cgit_refs_cb(const char *refname, const unsigned char *sha1,
196 int flags, void *cb_data);
197
198 extern void *cgit_free_commitinfo(struct commitinfo *info);
199
200 extern int cgit_diff_files(const unsigned char *old_sha1,
201 const unsigned char *new_sha1,
202 linediff_fn fn);
203
204 extern void cgit_diff_tree(const unsigned char *old_sha1,
205 const unsigned char *new_sha1,
206 filepair_fn fn, const char *prefix);
207
208 extern void cgit_diff_commit(struct commit *commit, filepair_fn fn);
209
210 extern char *fmt(const char *format,...);
211
212 extern void html(const char *txt);
213 extern void htmlf(const char *format,...);
214 extern void html_txt(char *txt);
215 extern void html_ntxt(int len, char *txt);
216 extern void html_attr(char *txt);
217 extern void html_hidden(char *name, char *value);
218 extern void html_option(char *value, char *text, char *selected_value);
219 extern void html_link_open(char *url, char *title, char *class);
220 extern void html_link_close(void);
221 extern void html_filemode(unsigned short mode);
222 extern int html_include(const char *filename);
223
224 extern int cgit_read_config(const char *filename, configfn fn);
225 extern int cgit_parse_query(char *txt, configfn fn);
226 extern struct commitinfo *cgit_parse_commit(struct commit *commit);
227 extern struct taginfo *cgit_parse_tag(struct tag *tag);
228 extern void cgit_parse_url(const char *url);
229
230 extern char *cache_safe_filename(const char *unsafe);
231 extern int cache_lock(struct cacheitem *item);
232 extern int cache_unlock(struct cacheitem *item);
233 extern int cache_cancel_lock(struct cacheitem *item);
234 extern int cache_exist(struct cacheitem *item);
235 extern int cache_expired(struct cacheitem *item);
236
237 extern char *cgit_repourl(const char *reponame);
238 extern char *cgit_fileurl(const char *reponame, const char *pagename,
239 const char *filename, const char *query);
240 extern char *cgit_pageurl(const char *reponame, const char *pagename,
241 const char *query);
242
243 extern const char *cgit_repobasename(const char *reponame);
244
245 extern void cgit_tree_link(char *name, char *title, char *class, char *head,
246 char *rev, char *path);
247 extern void cgit_log_link(char *name, char *title, char *class, char *head,
248 char *rev, char *path, int ofs, char *grep,
249 char *pattern);
250 extern void cgit_commit_link(char *name, char *title, char *class, char *head,
251 char *rev);
252 extern void cgit_refs_link(char *name, char *title, char *class, char *head,
253 char *rev, char *path);
254 extern void cgit_snapshot_link(char *name, char *title, char *class,
255 char *head, char *rev, char *archivename);
256 extern void cgit_diff_link(char *name, char *title, char *class, char *head,
257 char *new_rev, char *old_rev, char *path);
258
259 extern void cgit_object_link(struct object *obj);
260
261 extern void cgit_print_error(char *msg);
262 extern void cgit_print_date(time_t secs, char *format);
263 extern void cgit_print_age(time_t t, time_t max_relative, char *format);
264 extern void cgit_print_docstart(char *title, struct cacheitem *item);
265 extern void cgit_print_docend();
266 extern void cgit_print_pageheader(char *title, int show_search);
267 extern void cgit_print_snapshot_start(const char *mimetype,
268 const char *filename,
269 struct cacheitem *item);
270 extern void cgit_print_branches(int maxcount);
271 extern void cgit_print_tags(int maxcount);
272
273 extern void cgit_print_repolist(struct cacheitem *item);
274 extern void cgit_print_summary();
275 extern void cgit_print_log(const char *tip, int ofs, int cnt, char *grep,
276 char *pattern, char *path, int pager);
277 extern void cgit_print_blob(struct cacheitem *item, const char *hex, char *path);
278 extern void cgit_print_tree(const char *rev, char *path);
279 extern void cgit_print_commit(char *hex);
280 extern void cgit_print_refs();
281 extern void cgit_print_tag(char *revname);
282 extern void cgit_print_diff(const char *new_hex, const char *old_hex, const char *prefix);
283 extern void cgit_print_snapshot(struct cacheitem *item, const char *head,
284 const char *hex, const char *prefix,
285 const char *filename, int snapshot);
286 extern void cgit_print_snapshot_links(const char *repo, const char *head,
287 const char *hex, int snapshots);
288 extern int cgit_parse_snapshots_mask(const char *str);
289
290 #endif /* CGIT_H */