cgitrc.5.txt: describe where/how cgit will locate cgitrc

[cgit.git] / cgit.h

diff --git a/cgit.h b/cgit.h
index f06a941d7ac1e01f6252ef29482ab1c5f3b24241..4c854eaa8320771466460f18ff0839c73cc2dafc 100644 (file)
--- a/cgit.h
+++ b/cgit.h
@@ -1,18 +1,88 @@
 #ifndef CGIT_H
 #define CGIT_H
 
 #ifndef CGIT_H
 #define CGIT_H
 

-#include "git.h"
-#include <openssl/sha.h>
-#include <ctype.h>
-#include <sched.h>
+
+#include <git-compat-util.h>
+#include <cache.h>
+#include <grep.h>
+#include <object.h>
+#include <tree.h>
+#include <commit.h>
+#include <tag.h>
+#include <diff.h>
+#include <diffcore.h>
+#include <refs.h>
+#include <revision.h>
+#include <log-tree.h>
+#include <archive.h>
+#include <string-list.h>
+#include <xdiff-interface.h>
+#include <xdiff/xdiff.h>
+#include <utf8.h>
+
+
+/*
+ * Dateformats used on misc. pages
+ */
+#define FMT_LONGDATE "%Y-%m-%d %H:%M:%S (%Z)"
+#define FMT_SHORTDATE "%Y-%m-%d"
+#define FMT_ATOMDATE "%Y-%m-%dT%H:%M:%SZ"
+
+
+/*
+ * Limits used for relative dates
+ */
+#define TM_MIN    60
+#define TM_HOUR  (TM_MIN * 60)
+#define TM_DAY   (TM_HOUR * 24)
+#define TM_WEEK  (TM_DAY * 7)
+#define TM_YEAR  (TM_DAY * 365)
+#define TM_MONTH (TM_YEAR / 12.0)
+
+
+/*
+ * Default encoding
+ */
+#define PAGE_ENCODING "UTF-8"

 
 typedef void (*configfn)(const char *name, const char *value);
 
 typedef void (*configfn)(const char *name, const char *value);

+typedef void (*filepair_fn)(struct diff_filepair *pair);
+typedef void (*linediff_fn)(char *line, int len);
+
+struct cgit_filter {
+       char *cmd;
+       char **argv;
+       int old_stdout;
+       int pipe_fh[2];
+       int pid;
+       int exitstatus;
+};

 
 

-struct cacheitem {
+struct cgit_repo {
+       char *url;

        char *name;
        char *name;

-       struct stat st;
-       int ttl;
-       int fd;
+       char *path;
+       char *desc;
+       char *owner;
+       char *defbranch;
+       char *group;
+       char *module_link;
+       char *readme;
+       char *clone_url;
+       int snapshots;
+       int enable_log_filecount;
+       int enable_log_linecount;
+       int max_stats;
+       time_t mtime;
+       struct cgit_filter *about_filter;
+       struct cgit_filter *commit_filter;
+       struct cgit_filter *source_filter;
+};
+
+struct cgit_repolist {
+       int length;
+       int count;
+       struct cgit_repo *repos;

 };
 
 struct commitinfo {
 };
 
 struct commitinfo {


@@ -25,81 +95,179 @@ struct commitinfo {
        unsigned long committer_date;
        char *subject;
        char *msg;
        unsigned long committer_date;
        char *subject;
        char *msg;

+       char *msg_encoding;
+};
+
+struct taginfo {
+       char *tagger;
+       char *tagger_email;
+       unsigned long tagger_date;
+       char *msg;
+};
+
+struct refinfo {
+       const char *refname;
+       struct object *object;
+       union {
+               struct taginfo *tag;
+               struct commitinfo *commit;
+       };
+};
+
+struct reflist {
+       struct refinfo **refs;
+       int alloc;
+       int count;
+};
+
+struct cgit_query {
+       int has_symref;
+       int has_sha1;
+       char *raw;
+       char *repo;
+       char *page;
+       char *search;
+       char *grep;
+       char *head;
+       char *sha1;
+       char *sha2;
+       char *path;
+       char *name;
+       char *mimetype;
+       char *url;
+       char *period;
+       int   ofs;
+       int nohead;
+       char *sort;
+       int showmsg;

 };
 
 };
 

-extern const char cgit_version[];
-
-extern char *cgit_root;
-extern char *cgit_root_title;
-extern char *cgit_css;
-extern char *cgit_logo;
-extern char *cgit_logo_link;
-extern char *cgit_virtual_root;
-extern char *cgit_cache_root;
-
-extern int cgit_nocache;
-extern int cgit_max_lock_attempts;
-extern int cgit_cache_root_ttl;
-extern int cgit_cache_repo_ttl;
-extern int cgit_cache_dynamic_ttl;
-extern int cgit_cache_static_ttl;
-extern int cgit_cache_max_create_time;
-
-extern char *cgit_repo_name;
-extern char *cgit_repo_desc;
-extern char *cgit_repo_owner;
-
-extern int cgit_query_has_symref;
-extern int cgit_query_has_sha1;
-
-extern char *cgit_querystring;
-extern char *cgit_query_repo;
-extern char *cgit_query_page;
-extern char *cgit_query_head;
-extern char *cgit_query_sha1;
-extern int   cgit_query_ofs;
-
-extern int htmlfd;
-
-extern void cgit_global_config_cb(const char *name, const char *value);
+struct cgit_config {
+       char *agefile;
+       char *cache_root;
+       char *clone_prefix;
+       char *css;
+       char *favicon;
+       char *footer;
+       char *head_include;
+       char *header;
+       char *index_header;
+       char *index_info;
+       char *logo;
+       char *logo_link;
+       char *module_link;
+       char *repo_group;
+       char *robots;
+       char *root_title;
+       char *root_desc;
+       char *root_readme;
+       char *script_name;
+       char *virtual_root;
+       int cache_size;
+       int cache_dynamic_ttl;
+       int cache_max_create_time;
+       int cache_repo_ttl;
+       int cache_root_ttl;
+       int cache_static_ttl;
+       int embedded;
+       int enable_index_links;
+       int enable_log_filecount;
+       int enable_log_linecount;
+       int local_time;
+       int max_repo_count;
+       int max_commit_count;
+       int max_lock_attempts;
+       int max_msg_len;
+       int max_repodesc_len;
+       int max_stats;
+       int nocache;
+       int noplainemail;
+       int noheader;
+       int renamelimit;
+       int snapshots;
+       int summary_branches;
+       int summary_log;
+       int summary_tags;
+       struct string_list mimetypes;
+       struct cgit_filter *about_filter;
+       struct cgit_filter *commit_filter;
+       struct cgit_filter *source_filter;
+};
+
+struct cgit_page {
+       time_t modified;
+       time_t expires;
+       size_t size;
+       char *mimetype;
+       char *charset;
+       char *filename;
+       char *etag;
+       char *title;
+       int status;
+       char *statusmsg;
+};
+
+struct cgit_context {
+       struct cgit_query qry;
+       struct cgit_config cfg;
+       struct cgit_repo *repo;
+       struct cgit_page page;
+};
+
+struct cgit_snapshot_format {
+       const char *suffix;
+       const char *mimetype;
+       write_archive_fn_t write_func;
+       int bit;
+};
+
+extern const char *cgit_version;
+
+extern struct cgit_repolist cgit_repolist;
+extern struct cgit_context ctx;
+extern const struct cgit_snapshot_format cgit_snapshot_formats[];
+
+extern struct cgit_repo *cgit_add_repo(const char *url);
+extern struct cgit_repo *cgit_get_repoinfo(const char *url);

 extern void cgit_repo_config_cb(const char *name, const char *value);
 extern void cgit_repo_config_cb(const char *name, const char *value);

-extern void cgit_querystring_cb(const char *name, const char *value);

 
 

-extern char *fmt(const char *format,...);
+extern int chk_zero(int result, char *msg);
+extern int chk_positive(int result, char *msg);
+extern int chk_non_negative(int result, char *msg);

 
 

-extern void html(const char *txt);
-extern void htmlf(const char *format,...);
-extern void html_txt(char *txt);
-extern void html_attr(char *txt);
-extern void html_link_open(char *url, char *title, char *class);
-extern void html_link_close(void);
+extern char *trim_end(const char *str, char c);
+extern char *strlpart(char *txt, int maxlen);
+extern char *strrpart(char *txt, int maxlen);
+
+extern void cgit_add_ref(struct reflist *list, struct refinfo *ref);
+extern int cgit_refs_cb(const char *refname, const unsigned char *sha1,
+                       int flags, void *cb_data);
+
+extern void *cgit_free_commitinfo(struct commitinfo *info);
+
+extern int cgit_diff_files(const unsigned char *old_sha1,
+                          const unsigned char *new_sha1,
+                          unsigned long *old_size, unsigned long *new_size,
+                          int *binary, linediff_fn fn);
+
+extern void cgit_diff_tree(const unsigned char *old_sha1,
+                          const unsigned char *new_sha1,
+                          filepair_fn fn, const char *prefix);
+
+extern void cgit_diff_commit(struct commit *commit, filepair_fn fn);
+
+extern char *fmt(const char *format,...);

 
 

-extern int cgit_read_config(const char *filename, configfn fn);
-extern int cgit_parse_query(char *txt, configfn fn);

 extern struct commitinfo *cgit_parse_commit(struct commit *commit);
 extern struct commitinfo *cgit_parse_commit(struct commit *commit);

+extern struct taginfo *cgit_parse_tag(struct tag *tag);
+extern void cgit_parse_url(const char *url);
+
+extern const char *cgit_repobasename(const char *reponame);
+
+extern int cgit_parse_snapshots_mask(const char *str);
+
+extern int cgit_open_filter(struct cgit_filter *filter);
+extern int cgit_close_filter(struct cgit_filter *filter);

 
 

-extern void cache_prepare(struct cacheitem *item);
-extern int cache_lock(struct cacheitem *item);
-extern int cache_unlock(struct cacheitem *item);
-extern int cache_cancel_lock(struct cacheitem *item);
-extern int cache_exist(struct cacheitem *item);
-extern int cache_expired(struct cacheitem *item);
-
-extern char *cgit_repourl(const char *reponame);
-extern char *cgit_pageurl(const char *reponame, const char *pagename, 
-                         const char *query);
-
-extern void cgit_print_error(char *msg);
-extern void cgit_print_date(unsigned long secs);
-extern void cgit_print_docstart(char *title, struct cacheitem *item);
-extern void cgit_print_docend();
-extern void cgit_print_pageheader(char *title);
-
-extern void cgit_print_repolist(struct cacheitem *item);
-extern void cgit_print_summary();
-extern void cgit_print_log(const char *tip, int ofs, int cnt);
-extern void cgit_print_view(const char *hex);
-extern void cgit_print_tree(const char *hex);
-extern void cgit_print_commit(const char *hex);

 
 #endif /* CGIT_H */
 
 #endif /* CGIT_H */