builtin / clean.con commit Merge branch 'tk/doc-filter-branch' into maint-1.8.1 (a12816b)
   1/*
   2 * "git clean" builtin command
   3 *
   4 * Copyright (C) 2007 Shawn Bohrer
   5 *
   6 * Based on git-clean.sh by Pavel Roskin
   7 */
   8
   9#include "builtin.h"
  10#include "cache.h"
  11#include "dir.h"
  12#include "parse-options.h"
  13#include "refs.h"
  14#include "string-list.h"
  15#include "quote.h"
  16
  17static int force = -1; /* unset */
  18
  19static const char *const builtin_clean_usage[] = {
  20        N_("git clean [-d] [-f] [-n] [-q] [-e <pattern>] [-x | -X] [--] <paths>..."),
  21        NULL
  22};
  23
  24static const char *msg_remove = N_("Removing %s\n");
  25static const char *msg_would_remove = N_("Would remove %s\n");
  26static const char *msg_skip_git_dir = N_("Skipping repository %s\n");
  27static const char *msg_would_skip_git_dir = N_("Would skip repository %s\n");
  28static const char *msg_warn_remove_failed = N_("failed to remove %s");
  29
  30static int git_clean_config(const char *var, const char *value, void *cb)
  31{
  32        if (!strcmp(var, "clean.requireforce"))
  33                force = !git_config_bool(var, value);
  34        return git_default_config(var, value, cb);
  35}
  36
  37static int exclude_cb(const struct option *opt, const char *arg, int unset)
  38{
  39        struct string_list *exclude_list = opt->value;
  40        string_list_append(exclude_list, arg);
  41        return 0;
  42}
  43
  44static int remove_dirs(struct strbuf *path, const char *prefix, int force_flag,
  45                int dry_run, int quiet, int *dir_gone)
  46{
  47        DIR *dir;
  48        struct strbuf quoted = STRBUF_INIT;
  49        struct dirent *e;
  50        int res = 0, ret = 0, gone = 1, original_len = path->len, len, i;
  51        unsigned char submodule_head[20];
  52        struct string_list dels = STRING_LIST_INIT_DUP;
  53
  54        *dir_gone = 1;
  55
  56        if ((force_flag & REMOVE_DIR_KEEP_NESTED_GIT) &&
  57                        !resolve_gitlink_ref(path->buf, "HEAD", submodule_head)) {
  58                if (!quiet) {
  59                        quote_path_relative(path->buf, strlen(path->buf), &quoted, prefix);
  60                        printf(dry_run ?  _(msg_would_skip_git_dir) : _(msg_skip_git_dir),
  61                                        quoted.buf);
  62                }
  63
  64                *dir_gone = 0;
  65                return 0;
  66        }
  67
  68        dir = opendir(path->buf);
  69        if (!dir) {
  70                /* an empty dir could be removed even if it is unreadble */
  71                res = dry_run ? 0 : rmdir(path->buf);
  72                if (res) {
  73                        quote_path_relative(path->buf, strlen(path->buf), &quoted, prefix);
  74                        warning(_(msg_warn_remove_failed), quoted.buf);
  75                        *dir_gone = 0;
  76                }
  77                return res;
  78        }
  79
  80        if (path->buf[original_len - 1] != '/')
  81                strbuf_addch(path, '/');
  82
  83        len = path->len;
  84        while ((e = readdir(dir)) != NULL) {
  85                struct stat st;
  86                if (is_dot_or_dotdot(e->d_name))
  87                        continue;
  88
  89                strbuf_setlen(path, len);
  90                strbuf_addstr(path, e->d_name);
  91                if (lstat(path->buf, &st))
  92                        ; /* fall thru */
  93                else if (S_ISDIR(st.st_mode)) {
  94                        if (remove_dirs(path, prefix, force_flag, dry_run, quiet, &gone))
  95                                ret = 1;
  96                        if (gone) {
  97                                quote_path_relative(path->buf, strlen(path->buf), &quoted, prefix);
  98                                string_list_append(&dels, quoted.buf);
  99                        } else
 100                                *dir_gone = 0;
 101                        continue;
 102                } else {
 103                        res = dry_run ? 0 : unlink(path->buf);
 104                        if (!res) {
 105                                quote_path_relative(path->buf, strlen(path->buf), &quoted, prefix);
 106                                string_list_append(&dels, quoted.buf);
 107                        } else {
 108                                quote_path_relative(path->buf, strlen(path->buf), &quoted, prefix);
 109                                warning(_(msg_warn_remove_failed), quoted.buf);
 110                                *dir_gone = 0;
 111                                ret = 1;
 112                        }
 113                        continue;
 114                }
 115
 116                /* path too long, stat fails, or non-directory still exists */
 117                *dir_gone = 0;
 118                ret = 1;
 119                break;
 120        }
 121        closedir(dir);
 122
 123        strbuf_setlen(path, original_len);
 124
 125        if (*dir_gone) {
 126                res = dry_run ? 0 : rmdir(path->buf);
 127                if (!res)
 128                        *dir_gone = 1;
 129                else {
 130                        quote_path_relative(path->buf, strlen(path->buf), &quoted, prefix);
 131                        warning(_(msg_warn_remove_failed), quoted.buf);
 132                        *dir_gone = 0;
 133                        ret = 1;
 134                }
 135        }
 136
 137        if (!*dir_gone && !quiet) {
 138                for (i = 0; i < dels.nr; i++)
 139                        printf(dry_run ?  _(msg_would_remove) : _(msg_remove), dels.items[i].string);
 140        }
 141        string_list_clear(&dels, 0);
 142        return ret;
 143}
 144
 145int cmd_clean(int argc, const char **argv, const char *prefix)
 146{
 147        int i, res;
 148        int dry_run = 0, remove_directories = 0, quiet = 0, ignored = 0;
 149        int ignored_only = 0, config_set = 0, errors = 0, gone = 1;
 150        int rm_flags = REMOVE_DIR_KEEP_NESTED_GIT;
 151        struct strbuf directory = STRBUF_INIT;
 152        struct dir_struct dir;
 153        static const char **pathspec;
 154        struct strbuf buf = STRBUF_INIT;
 155        struct string_list exclude_list = STRING_LIST_INIT_NODUP;
 156        const char *qname;
 157        char *seen = NULL;
 158        struct option options[] = {
 159                OPT__QUIET(&quiet, N_("do not print names of files removed")),
 160                OPT__DRY_RUN(&dry_run, N_("dry run")),
 161                OPT__FORCE(&force, N_("force")),
 162                OPT_BOOLEAN('d', NULL, &remove_directories,
 163                                N_("remove whole directories")),
 164                { OPTION_CALLBACK, 'e', "exclude", &exclude_list, N_("pattern"),
 165                  N_("add <pattern> to ignore rules"), PARSE_OPT_NONEG, exclude_cb },
 166                OPT_BOOLEAN('x', NULL, &ignored, N_("remove ignored files, too")),
 167                OPT_BOOLEAN('X', NULL, &ignored_only,
 168                                N_("remove only ignored files")),
 169                OPT_END()
 170        };
 171
 172        git_config(git_clean_config, NULL);
 173        if (force < 0)
 174                force = 0;
 175        else
 176                config_set = 1;
 177
 178        argc = parse_options(argc, argv, prefix, options, builtin_clean_usage,
 179                             0);
 180
 181        memset(&dir, 0, sizeof(dir));
 182        if (ignored_only)
 183                dir.flags |= DIR_SHOW_IGNORED;
 184
 185        if (ignored && ignored_only)
 186                die(_("-x and -X cannot be used together"));
 187
 188        if (!dry_run && !force) {
 189                if (config_set)
 190                        die(_("clean.requireForce set to true and neither -n nor -f given; "
 191                                  "refusing to clean"));
 192                else
 193                        die(_("clean.requireForce defaults to true and neither -n nor -f given; "
 194                                  "refusing to clean"));
 195        }
 196
 197        if (force > 1)
 198                rm_flags = 0;
 199
 200        dir.flags |= DIR_SHOW_OTHER_DIRECTORIES;
 201
 202        if (read_cache() < 0)
 203                die(_("index file corrupt"));
 204
 205        if (!ignored)
 206                setup_standard_excludes(&dir);
 207
 208        for (i = 0; i < exclude_list.nr; i++)
 209                add_exclude(exclude_list.items[i].string, "", 0,
 210                            &dir.exclude_list[EXC_CMDL]);
 211
 212        pathspec = get_pathspec(prefix, argv);
 213
 214        fill_directory(&dir, pathspec);
 215
 216        if (pathspec)
 217                seen = xmalloc(argc > 0 ? argc : 1);
 218
 219        for (i = 0; i < dir.nr; i++) {
 220                struct dir_entry *ent = dir.entries[i];
 221                int len, pos;
 222                int matches = 0;
 223                struct cache_entry *ce;
 224                struct stat st;
 225
 226                /*
 227                 * Remove the '/' at the end that directory
 228                 * walking adds for directory entries.
 229                 */
 230                len = ent->len;
 231                if (len && ent->name[len-1] == '/')
 232                        len--;
 233                pos = cache_name_pos(ent->name, len);
 234                if (0 <= pos)
 235                        continue;       /* exact match */
 236                pos = -pos - 1;
 237                if (pos < active_nr) {
 238                        ce = active_cache[pos];
 239                        if (ce_namelen(ce) == len &&
 240                            !memcmp(ce->name, ent->name, len))
 241                                continue; /* Yup, this one exists unmerged */
 242                }
 243
 244                /*
 245                 * we might have removed this as part of earlier
 246                 * recursive directory removal, so lstat() here could
 247                 * fail with ENOENT.
 248                 */
 249                if (lstat(ent->name, &st))
 250                        continue;
 251
 252                if (pathspec) {
 253                        memset(seen, 0, argc > 0 ? argc : 1);
 254                        matches = match_pathspec(pathspec, ent->name, len,
 255                                                 0, seen);
 256                }
 257
 258                if (S_ISDIR(st.st_mode)) {
 259                        strbuf_addstr(&directory, ent->name);
 260                        if (remove_directories || (matches == MATCHED_EXACTLY)) {
 261                                if (remove_dirs(&directory, prefix, rm_flags, dry_run, quiet, &gone))
 262                                        errors++;
 263                                if (gone && !quiet) {
 264                                        qname = quote_path_relative(directory.buf, directory.len, &buf, prefix);
 265                                        printf(dry_run ? _(msg_would_remove) : _(msg_remove), qname);
 266                                }
 267                        }
 268                        strbuf_reset(&directory);
 269                } else {
 270                        if (pathspec && !matches)
 271                                continue;
 272                        res = dry_run ? 0 : unlink(ent->name);
 273                        if (res) {
 274                                qname = quote_path_relative(ent->name, -1, &buf, prefix);
 275                                warning(_(msg_warn_remove_failed), qname);
 276                                errors++;
 277                        } else if (!quiet) {
 278                                qname = quote_path_relative(ent->name, -1, &buf, prefix);
 279                                printf(dry_run ? _(msg_would_remove) : _(msg_remove), qname);
 280                        }
 281                }
 282        }
 283        free(seen);
 284
 285        strbuf_release(&directory);
 286        string_list_clear(&exclude_list, 0);
 287        return (errors != 0);
 288}