]> gitweb.ps.run Git - ps-cgit/blobdiff - cgit.c
projects / ps-cgit / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
Don't show the the branch selector button if javascript is enabled
[ps-cgit] / cgit.c
diff --git a/cgit.c b/cgit.c
index 110facec5867ad0912da6b41c24758a6c3f798cf..142e4164562c3a9f8f9a8d395598fb458af9b6ae 100644 (file)
--- a/cgit.c
+++ b/cgit.c
@@ -8,476 +8,172 @@
 
 #include "cgit.h"
 
 
 #include "cgit.h"
 
-const char cgit_version[] = CGIT_VERSION;
-
-const char cgit_doctype[] =
-"<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\"\n"
-"  \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n";
-
-const char cgit_error[] =
-"<div class='error'>%s</div>";
-
-const char cgit_lib_error[] =
-"<div class='error'>%s: %s</div>";
-
-int htmlfd = 0;
-
-char *cgit_root         = "/usr/src/git";
-char *cgit_root_title   = "Git repository browser";
-char *cgit_css          = "/cgit.css";
-char *cgit_logo         = "/git-logo.png";
-char *cgit_logo_link    = "http://www.kernel.org/pub/software/scm/git/docs/";
-char *cgit_virtual_root = NULL;
-
-char *cgit_cache_root   = "/var/cache/cgit";
-
-int cgit_cache_root_ttl        =  5;
-int cgit_cache_repo_ttl        =  5;
-int cgit_cache_dynamic_ttl     =  5;
-int cgit_cache_static_ttl      = -1;
-int cgit_cache_max_create_time =  5;
-
-char *cgit_repo_name    = NULL;
-char *cgit_repo_desc    = NULL;
-char *cgit_repo_owner   = NULL;
-
-int cgit_query_has_symref = 0;
-int cgit_query_has_sha1   = 0;
-
-char *cgit_querystring  = NULL;
-char *cgit_query_repo   = NULL;
-char *cgit_query_page   = NULL;
-char *cgit_query_head   = NULL;
-char *cgit_query_sha1   = NULL;
-
-struct cacheitem cacheitem;
-
-int cgit_parse_query(char *txt, configfn fn)
+static int cgit_prepare_cache(struct cacheitem *item)
 {
 {
-       char *t, *value = NULL, c;
-
-       if (!txt)
+       if (!cgit_repo && cgit_query_repo) {
+               char *title = fmt("%s - %s", cgit_root_title, "Bad request");
+               cgit_print_docstart(title, item);
+               cgit_print_pageheader(title, 0);
+               cgit_print_error(fmt("Unknown repo: %s", cgit_query_repo));
+               cgit_print_docend();
                return 0;
                return 0;
-
-       t = txt = xstrdup(txt);
- 
-       while((c=*t) != '\0') {
-               if (c=='=') {
-                       *t = '\0';
-                       value = t+1;
-               } else if (c=='&') {
-                       *t = '\0';
-                       (*fn)(txt, value);
-                       txt = t+1;
-                       value = NULL;
-               }
-               t++;
        }
        }
-       if (t!=txt)
-               (*fn)(txt, value);
-       return 0;
-}
-
-void cgit_global_config_cb(const char *name, const char *value)
-{
-       if (!strcmp(name, "root"))
-               cgit_root = xstrdup(value);
-       else if (!strcmp(name, "root-title"))
-               cgit_root_title = xstrdup(value);
-       else if (!strcmp(name, "css"))
-               cgit_css = xstrdup(value);
-       else if (!strcmp(name, "logo"))
-               cgit_logo = xstrdup(value);
-       else if (!strcmp(name, "logo-link"))
-               cgit_logo_link = xstrdup(value);
-       else if (!strcmp(name, "virtual-root"))
-               cgit_virtual_root = xstrdup(value);
-}
 
 
-void cgit_repo_config_cb(const char *name, const char *value)
-{
-       if (!strcmp(name, "name"))
-               cgit_repo_name = xstrdup(value);
-       else if (!strcmp(name, "desc"))
-               cgit_repo_desc = xstrdup(value);
-       else if (!strcmp(name, "owner"))
-               cgit_repo_owner = xstrdup(value);
-}
-
-void cgit_querystring_cb(const char *name, const char *value)
-{
-       if (!strcmp(name,"r"))
-               cgit_query_repo = xstrdup(value);
-       else if (!strcmp(name, "p"))
-               cgit_query_page = xstrdup(value);
-       else if (!strcmp(name, "h")) {
-               cgit_query_head = xstrdup(value);
-               cgit_query_has_symref = 1;
-       } else if (!strcmp(name, "id")) {
-               cgit_query_sha1 = xstrdup(value);
-               cgit_query_has_sha1 = 1;
+       if (!cgit_repo) {
+               item->name = xstrdup(fmt("%s/index.html", cgit_cache_root));
+               item->ttl = cgit_cache_root_ttl;
+               return 1;
        }
        }
-}
 
 
-char *cgit_repourl(const char *reponame)
-{
-       if (cgit_virtual_root) {
-               return fmt("%s/%s/", cgit_virtual_root, reponame);
+       if (!cgit_cmd) {
+               item->name = xstrdup(fmt("%s/%s/index.%s.html", cgit_cache_root,
+                                        cache_safe_filename(cgit_repo->url),
+                                        cache_safe_filename(cgit_querystring)));
+               item->ttl = cgit_cache_repo_ttl;
        } else {
        } else {
-               return fmt("?r=%s", reponame);
+               item->name = xstrdup(fmt("%s/%s/%s/%s.html", cgit_cache_root,
+                                        cache_safe_filename(cgit_repo->url),
+                                        cgit_query_page,
+                                        cache_safe_filename(cgit_querystring)));
+               if (cgit_query_has_symref)
+                       item->ttl = cgit_cache_dynamic_ttl;
+               else if (cgit_query_has_sha1)
+                       item->ttl = cgit_cache_static_ttl;
+               else
+                       item->ttl = cgit_cache_repo_ttl;
        }
        }
+       return 1;
 }
 
 }
 
-char *cgit_pageurl(const char *reponame, const char *pagename, 
-                  const char *query)
+static void cgit_print_repo_page(struct cacheitem *item)
 {
 {
-       if (cgit_virtual_root) {
-               return fmt("%s/%s/%s/?%s", cgit_virtual_root, reponame, 
-                          pagename, query);
-       } else {
-               return fmt("?r=%s&p=%s&%s", reponame, pagename, query);
+       char *title;
+       int show_search;
+
+       if (!cgit_query_head)
+               cgit_query_head = cgit_repo->defbranch;
+
+       if (chdir(cgit_repo->path)) {
+               title = fmt("%s - %s", cgit_root_title, "Bad request");
+               cgit_print_docstart(title, item);
+               cgit_print_pageheader(title, 0);
+               cgit_print_error(fmt("Unable to scan repository: %s",
+                                    strerror(errno)));
+               cgit_print_docend();
+               return;
        }
        }
-}
 
 
-static int cgit_print_branch_cb(const char *refname, const unsigned char *sha1,
-                               int flags, void *cb_data)
-{
-       struct commit *commit;
-       char buf[256], *url;
+       title = fmt("%s - %s", cgit_repo->name, cgit_repo->desc);
+       show_search = 0;
+       setenv("GIT_DIR", cgit_repo->path, 1);
 
 
-       commit = lookup_commit(sha1);
-       if (commit && !parse_commit(commit)){
-               html("<tr><td>");
-               url = cgit_pageurl(cgit_query_repo, "log", 
-                                  fmt("h=%s", refname));
-               html_link_open(url, NULL, NULL);
-               strncpy(buf, refname, sizeof(buf));
-               html_txt(buf);
-               html_link_close();
-               html("</td><td>");
-               pretty_print_commit(CMIT_FMT_ONELINE, commit, ~0, buf,
-                                   sizeof(buf), 0, NULL, NULL, 0);
-               html_txt(buf);
-               html("</td></tr>\n");
-       } else {
-               html("<tr><td>");
-               html_txt(buf);
-               html("</td><td>");
-               htmlf("*** bad ref %s", sha1_to_hex(sha1));
-               html("</td></tr>\n");
+       if ((cgit_cmd == CMD_SNAPSHOT) && cgit_repo->snapshots) {
+               cgit_print_snapshot(item, cgit_query_head, cgit_query_sha1,
+                                   cgit_repobasename(cgit_repo->url),
+                                   cgit_query_path,
+                                   cgit_repo->snapshots );
+               return;
        }
        }
-       return 0;
-}
-
-/* Sun, 06 Nov 1994 08:49:37 GMT */
-static char *http_date(time_t t)
-{
-       static char day[][4] = {"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"};
-       static char month[][4] = {"Jan", "Feb", "Mar", "Apr", "May", "Jun",
-                                 "Jul", "Aug", "Sep", "Oct", "Now", "Dec"};
-       struct tm *tm = gmtime(&t);
-       return fmt("%s, %02d %s %04d %02d:%02d:%02d GMT", day[tm->tm_wday],
-                  tm->tm_mday, month[tm->tm_mon], 1900+tm->tm_year,
-                  tm->tm_hour, tm->tm_min, tm->tm_sec);
-}
-
-static int ttl_seconds(int ttl)
-{
-       if (ttl<0)
-               return 60 * 60 * 24 * 365;
-       else 
-               return ttl * 60;
-}
-
-static void cgit_print_docstart(char *title)
-{
-       html("Content-Type: text/html; charset=utf-8\n");
-       htmlf("Last-Modified: %s\n", http_date(cacheitem.st.st_mtime));
-       htmlf("Expires: %s\n", http_date(cacheitem.st.st_mtime + 
-                                        ttl_seconds(cacheitem.ttl)));
-       html("\n");
-       html(cgit_doctype);
-       html("<html>\n");
-       html("<head>\n");
-       html("<title>");
-       html_txt(title);
-       html("</title>\n");
-       htmlf("<meta name='generator' content='cgit v%s'/>\n", cgit_version);
-       html("<link rel='stylesheet' type='text/css' href='");
-       html_attr(cgit_css);
-       html("'/>\n");
-       html("</head>\n");
-       html("<body>\n");
-}
 
 
-static void cgit_print_docend()
-{
-       html("</body>\n</html>\n");
-}
-
-static void cgit_print_pageheader(char *title)
-{
-       html("<div id='header'>");
-       htmlf("<a href='%s'>", cgit_logo_link);
-       htmlf("<img id='logo' src='%s'/>\n", cgit_logo);
-       htmlf("</a>");
-       html_txt(title);
-       html("</div>");
-}
-
-static void cgit_print_repolist()
-{
-       DIR *d;
-       struct dirent *de;
-       struct stat st;
-       char *name;
-
-       chdir(cgit_root);
-       cgit_print_docstart(cgit_root_title);
-       cgit_print_pageheader(cgit_root_title);
+       if (cgit_cmd == CMD_BLOB) {
+               cgit_print_blob(item, cgit_query_sha1, cgit_query_path);
+               return;
+       }
 
 
-       if (!(d = opendir("."))) {
-               htmlf(cgit_lib_error, "Unable to scan repository directory",
-                     strerror(errno));
+       show_search = (cgit_cmd == CMD_LOG);
+       cgit_print_docstart(title, item);
+       if (!cgit_cmd) {
+               cgit_print_pageheader("summary", show_search);
+               cgit_print_summary();
                cgit_print_docend();
                return;
        }
 
                cgit_print_docend();
                return;
        }
 
-       html("<h2>Repositories</h2>\n");
-       html("<table class='list'>");
-       html("<tr><th>Name</th><th>Description</th><th>Owner</th></tr>\n");
-       while ((de = readdir(d)) != NULL) {
-               if (de->d_name[0] == '.')
-                       continue;
-               if (stat(de->d_name, &st) < 0)
-                       continue;
-               if (!S_ISDIR(st.st_mode))
-                       continue;
-
-               cgit_repo_name = cgit_repo_desc = cgit_repo_owner = NULL;
-               name = fmt("%s/info/cgit", de->d_name);
-               if (cgit_read_config(name, cgit_repo_config_cb))
-                       continue;
-
-               html("<tr><td>");
-               html_link_open(cgit_repourl(de->d_name), NULL, NULL);
-               html_txt(cgit_repo_name);
-               html_link_close();
-               html("</td><td>");
-               html_txt(cgit_repo_desc);
-               html("</td><td>");
-               html_txt(cgit_repo_owner);
-               html("</td></tr>\n");
+       cgit_print_pageheader(cgit_query_page, show_search);
+
+       switch(cgit_cmd) {
+       case CMD_LOG:
+               cgit_print_log(cgit_query_sha1, cgit_query_ofs,
+                              cgit_max_commit_count, cgit_query_grep, cgit_query_search,
+                              cgit_query_path, 1);
+               break;
+       case CMD_TREE:
+               cgit_print_tree(cgit_query_sha1, cgit_query_path);
+               break;
+       case CMD_COMMIT:
+               cgit_print_commit(cgit_query_sha1);
+               break;
+       case CMD_REFS:
+               cgit_print_refs();
+               break;
+       case CMD_TAG:
+               cgit_print_tag(cgit_query_sha1);
+               break;
+       case CMD_DIFF:
+               cgit_print_diff(cgit_query_sha1, cgit_query_sha2, cgit_query_path);
+               break;
+       default:
+               cgit_print_error("Invalid request");
        }
        }
-       closedir(d);
-       html("</table>");
        cgit_print_docend();
 }
 
        cgit_print_docend();
 }
 
-static void cgit_print_branches()
-{
-       html("<table class='list'>");
-       html("<tr><th>Branch name</th><th>Head commit</th></tr>\n");
-       for_each_branch_ref(cgit_print_branch_cb, NULL);
-       html("</table>");
-}
-
-static int get_one_line(char *txt)
+static void cgit_fill_cache(struct cacheitem *item, int use_cache)
 {
 {
-       char *t;
+       static char buf[PATH_MAX];
+       int stdout2;
 
 
-       for(t=txt; *t != '\n' && t != '\0'; t++)
-               ;
-       *t = '\0';
-       return t-txt-1;
-}
-
-static void cgit_print_commit_shortlog(struct commit *commit)
-{
-       char *h, *t, *p; 
-       char *tree = NULL, *author = NULL, *subject = NULL;
-       int len;
-       time_t sec;
-       struct tm *time;
-       char buf[32];
-
-       h = t = commit->buffer;
-       
-       if (strncmp(h, "tree ", 5))
-               die("Bad commit format: %s", 
-                   sha1_to_hex(commit->object.sha1));
-       
-       len = get_one_line(h);
-       tree = h+5;
-       h += len + 2;
-
-       while (!strncmp(h, "parent ", 7))
-               h += get_one_line(h) + 2;
-       
-       if (!strncmp(h, "author ", 7)) {
-               author = h+7;
-               h += get_one_line(h) + 2;
-               t = author;
-               while(t!=h && *t!='<') 
-                       t++;
-               *t='\0';
-               p = t;
-               while(--t!=author && *t==' ')
-                       *t='\0';
-               while(++p!=h && *p!='>')
-                       ;
-               while(++p!=h && !isdigit(*p))
-                       ;
+       getcwd(buf, sizeof(buf));
+       item->st.st_mtime = time(NULL);
 
 
-               t = p;
-               while(++p && isdigit(*p))
-                       ;
-               *p = '\0';
-               sec = atoi(t);
-               time = gmtime(&sec);
+       if (use_cache) {
+               stdout2 = chk_positive(dup(STDOUT_FILENO),
+                                      "Preserving STDOUT");
+               chk_zero(close(STDOUT_FILENO), "Closing STDOUT");
+               chk_positive(dup2(item->fd, STDOUT_FILENO), "Dup2(cachefile)");
        }
 
        }
 
-       while((len = get_one_line(h)) > 0)
-               h += len+2;
-
-       h++;
-       len = get_one_line(h);
-
-       subject = h;
-
-       html("<tr><td>");
-       strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", time);
-       html_txt(buf);
-       html("</td><td>");
-       char *qry = fmt("id=%s", sha1_to_hex(commit->object.sha1));
-       char *url = cgit_pageurl(cgit_query_repo, "view", qry);
-       html_link_open(url, NULL, NULL);
-       html_txt(subject);
-       html_link_close();
-       html("</td><td>");
-       html_txt(author);
-       html("</td></tr>\n");
-}
-
-static void cgit_print_log(const char *tip, int ofs, int cnt)
-{
-       struct rev_info rev;
-       struct commit *commit;
-       const char *argv[2] = {NULL, tip};
-       int n = 0;
-       
-       init_revisions(&rev, NULL);
-       rev.abbrev = DEFAULT_ABBREV;
-       rev.commit_format = CMIT_FMT_DEFAULT;
-       rev.verbose_header = 1;
-       rev.show_root_diff = 0;
-       setup_revisions(2, argv, &rev, NULL);
-       prepare_revision_walk(&rev);
+       if (cgit_repo)
+               cgit_print_repo_page(item);
+       else
+               cgit_print_repolist(item);
 
 
-       html("<h2>Log</h2>");
-       html("<table class='list'>");
-       html("<tr><th>Date</th><th>Message</th><th>Author</th></tr>\n");
-       while ((commit = get_revision(&rev)) != NULL && n++ < 100) {
-               cgit_print_commit_shortlog(commit);
-               free(commit->buffer);
-               commit->buffer = NULL;
-               free_commit_list(commit->parents);
-               commit->parents = NULL;
+       if (use_cache) {
+               chk_zero(close(STDOUT_FILENO), "Close redirected STDOUT");
+               chk_positive(dup2(stdout2, STDOUT_FILENO),
+                            "Restoring original STDOUT");
+               chk_zero(close(stdout2), "Closing temporary STDOUT");
        }
        }
-       html("</table>\n");
-}
 
 
-static void cgit_print_repo_summary()
-{
-       html("<h2>");
-       html_txt("Repo summary page");
-       html("</h2>");
-       cgit_print_branches();
+       chdir(buf);
 }
 
 }
 
-static void cgit_print_object(char *hex)
+static void cgit_check_cache(struct cacheitem *item)
 {
 {
-       unsigned char sha1[20];
-       //struct object *object;
-       char type[20];
-       unsigned char *buf;
-       unsigned long size;
+       int i = 0;
 
 
-       if (get_sha1_hex(hex, sha1)){
-               htmlf(cgit_error, "Bad hex value");
-               return;
-       }
-
-       if (sha1_object_info(sha1, type, NULL)){
-               htmlf(cgit_error, "Bad object name");
-               return;
-       }
-
-       buf = read_sha1_file(sha1, type, &size);
-       if (!buf) {
-               htmlf(cgit_error, "Error reading object");
-               return;
-       }
-
-       buf[size] = '\0';
-       html("<h2>Object view</h2>");
-       htmlf("sha1=%s<br/>type=%s<br/>size=%i<br/>", hex, type, size);
-       html("<pre>");
-       html_txt(buf);
-       html("</pre>");
-}
-
-static void cgit_print_repo_page()
-{
-       if (chdir(fmt("%s/%s", cgit_root, cgit_query_repo)) || 
-           cgit_read_config("info/cgit", cgit_repo_config_cb)) {
-               char *title = fmt("%s - %s", cgit_root_title, "Bad request");
-               cgit_print_docstart(title);
-               cgit_print_pageheader(title);
-               htmlf(cgit_lib_error, "Unable to scan repository",
-                     strerror(errno));
-               cgit_print_docend();
-               return;
-       }
-       setenv("GIT_DIR", fmt("%s/%s", cgit_root, cgit_query_repo), 1);
-       char *title = fmt("%s - %s", cgit_repo_name, cgit_repo_desc);
-       cgit_print_docstart(title);
-       cgit_print_pageheader(title);
-       if (!cgit_query_page)
-               cgit_print_repo_summary();
-       else if (!strcmp(cgit_query_page, "log")) {
-               cgit_print_log(cgit_query_head, 0, 100);
-       } else if (!strcmp(cgit_query_page, "view")) {
-               cgit_print_object(cgit_query_sha1);
-       }
-       cgit_print_docend();
-}
-
-static void cgit_fill_cache(struct cacheitem *item)
-{
-       htmlfd = item->fd;
-       item->st.st_mtime = time(NULL);
-       if (cgit_query_repo)
-               cgit_print_repo_page();
-       else
-               cgit_print_repolist();
-}
-
-static void cgit_refresh_cache(struct cacheitem *item)
-{
  top:
  top:
-       if (!cache_lookup(item)) {
-               if (cache_lock(item)) {
-                       cgit_fill_cache(item);
+       if (++i > cgit_max_lock_attempts) {
+               die("cgit_refresh_cache: unable to lock %s: %s",
+                   item->name, strerror(errno));
+       }
+       if (!cache_exist(item)) {
+               if (!cache_lock(item)) {
+                       sleep(1);
+                       goto top;
+               }
+               if (!cache_exist(item)) {
+                       cgit_fill_cache(item, 1);
                        cache_unlock(item);
                } else {
                        cache_unlock(item);
                } else {
-                       sched_yield();
-                       goto top;
+                       cache_cancel_lock(item);
                }
                }
-       } else if (cache_expired(item)) {
-               if (cache_lock(item)) {
-                       cgit_fill_cache(item);
+       } else if (cache_expired(item) && cache_lock(item)) {
+               if (cache_expired(item)) {
+                       cgit_fill_cache(item, 1);
                        cache_unlock(item);
                        cache_unlock(item);
+               } else {
+                       cache_cancel_lock(item);
                }
        }
 }
                }
        }
 }
@@ -497,12 +193,67 @@ static void cgit_print_cache(struct cacheitem *item)
        close(fd);
 }
 
        close(fd);
 }
 
+static void cgit_parse_args(int argc, const char **argv)
+{
+       int i;
+
+       for (i = 1; i < argc; i++) {
+               if (!strncmp(argv[i], "--cache=", 8)) {
+                       cgit_cache_root = xstrdup(argv[i]+8);
+               }
+               if (!strcmp(argv[i], "--nocache")) {
+                       cgit_nocache = 1;
+               }
+               if (!strncmp(argv[i], "--query=", 8)) {
+                       cgit_querystring = xstrdup(argv[i]+8);
+               }
+               if (!strncmp(argv[i], "--repo=", 7)) {
+                       cgit_query_repo = xstrdup(argv[i]+7);
+               }
+               if (!strncmp(argv[i], "--page=", 7)) {
+                       cgit_query_page = xstrdup(argv[i]+7);
+               }
+               if (!strncmp(argv[i], "--head=", 7)) {
+                       cgit_query_head = xstrdup(argv[i]+7);
+                       cgit_query_has_symref = 1;
+               }
+               if (!strncmp(argv[i], "--sha1=", 7)) {
+                       cgit_query_sha1 = xstrdup(argv[i]+7);
+                       cgit_query_has_sha1 = 1;
+               }
+               if (!strncmp(argv[i], "--ofs=", 6)) {
+                       cgit_query_ofs = atoi(argv[i]+6);
+               }
+       }
+}
+
 int main(int argc, const char **argv)
 {
 int main(int argc, const char **argv)
 {
-       cgit_read_config("/etc/cgitrc", cgit_global_config_cb);
-       cgit_querystring = xstrdup(getenv("QUERY_STRING"));
+       struct cacheitem item;
+       const char *cgit_config_env = getenv("CGIT_CONFIG");
+
+       htmlfd = STDOUT_FILENO;
+       item.st.st_mtime = time(NULL);
+       cgit_repolist.length = 0;
+       cgit_repolist.count = 0;
+       cgit_repolist.repos = NULL;
+
+       cgit_read_config(cgit_config_env ? cgit_config_env : CGIT_CONFIG,
+                        cgit_global_config_cb);
+       cgit_repo = NULL;
+       if (getenv("SCRIPT_NAME"))
+               cgit_script_name = xstrdup(getenv("SCRIPT_NAME"));
+       if (getenv("QUERY_STRING"))
+               cgit_querystring = xstrdup(getenv("QUERY_STRING"));
+       cgit_parse_args(argc, argv);
        cgit_parse_query(cgit_querystring, cgit_querystring_cb);
        cgit_parse_query(cgit_querystring, cgit_querystring_cb);
-       cgit_refresh_cache(&cacheitem);
-       cgit_print_cache(&cacheitem);
+       if (!cgit_prepare_cache(&item))
+               return 0;
+       if (cgit_nocache) {
+               cgit_fill_cache(&item, 0);
+       } else {
+               cgit_check_cache(&item);
+               cgit_print_cache(&item);
+       }
        return 0;
 }
        return 0;
 }
Unnamed repository; edit this file 'description' to name the repository.