cab851c2f8
'--object-only' is an alias for '--format=%(objectname)'. It cannot be used together other format-altering options like '--name-only', '--long' or '--format', they are mutually exclusive. The "--name-only" option outputs <filepath> only. Likewise, <objectName> is another high frequency used field, so implement '--object-only' option will bring intuitive and clear semantics for this scenario. Using '--format=%(objectname)' we can achieve a similar effect, but the former is with a lower learning cost(without knowing the format requirement of '--format' option). Even so, if a user is prefer to use "--format=%(objectname)", this is entirely welcome because they are not only equivalent in function, but also have almost identical performance. The reason is this commit also add the specific of "--format=%(objectname)" to the current fast-pathes (builtin formats) to avoid running unnecessary parsing mechanisms. The following performance benchmarks are based on torvalds/linux.git: When hit the fast-path: Benchmark 1: /opt/git/ls-tree-oid-only/bin/git ls-tree -r --object-only HEAD Time (mean ± σ): 83.6 ms ± 2.0 ms [User: 59.4 ms, System: 24.1 ms] Range (min … max): 80.4 ms … 87.2 ms 35 runs Benchmark 1: /opt/git/ls-tree-oid-only/bin/git ls-tree -r --format='%(objectname)' HEAD Time (mean ± σ): 84.1 ms ± 1.8 ms [User: 61.7 ms, System: 22.3 ms] Range (min … max): 80.9 ms … 87.5 ms 35 runs But for a customized format, it will be slower: Benchmark 1: /opt/git/ls-tree-oid-only/bin/git ls-tree -r --format='oid: %(objectname)' HEAD Time (mean ± σ): 96.5 ms ± 2.5 ms [User: 72.9 ms, System: 23.5 ms] Range (min … max): 93.1 ms … 104.1 ms 31 runs Helped-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com> Signed-off-by: Teng Long <dyroneteng@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
375 lines
9.9 KiB
C
375 lines
9.9 KiB
C
/*
|
|
* GIT - The information manager from hell
|
|
*
|
|
* Copyright (C) Linus Torvalds, 2005
|
|
*/
|
|
#include "cache.h"
|
|
#include "config.h"
|
|
#include "object-store.h"
|
|
#include "blob.h"
|
|
#include "tree.h"
|
|
#include "commit.h"
|
|
#include "quote.h"
|
|
#include "builtin.h"
|
|
#include "parse-options.h"
|
|
#include "pathspec.h"
|
|
|
|
static int line_termination = '\n';
|
|
#define LS_RECURSIVE 1
|
|
#define LS_TREE_ONLY (1 << 1)
|
|
#define LS_SHOW_TREES (1 << 2)
|
|
static int abbrev;
|
|
static int ls_options;
|
|
static struct pathspec pathspec;
|
|
static int chomp_prefix;
|
|
static const char *ls_tree_prefix;
|
|
static const char *format;
|
|
struct show_tree_data {
|
|
unsigned mode;
|
|
enum object_type type;
|
|
const struct object_id *oid;
|
|
const char *pathname;
|
|
struct strbuf *base;
|
|
};
|
|
|
|
static const char * const ls_tree_usage[] = {
|
|
N_("git ls-tree [<options>] <tree-ish> [<path>...]"),
|
|
NULL
|
|
};
|
|
|
|
static enum ls_tree_cmdmode {
|
|
MODE_DEFAULT = 0,
|
|
MODE_LONG,
|
|
MODE_NAME_ONLY,
|
|
MODE_OBJECT_ONLY,
|
|
} cmdmode;
|
|
|
|
static void expand_objectsize(struct strbuf *line, const struct object_id *oid,
|
|
const enum object_type type, unsigned int padded)
|
|
{
|
|
if (type == OBJ_BLOB) {
|
|
unsigned long size;
|
|
if (oid_object_info(the_repository, oid, &size) < 0)
|
|
die(_("could not get object info about '%s'"),
|
|
oid_to_hex(oid));
|
|
if (padded)
|
|
strbuf_addf(line, "%7"PRIuMAX, (uintmax_t)size);
|
|
else
|
|
strbuf_addf(line, "%"PRIuMAX, (uintmax_t)size);
|
|
} else if (padded) {
|
|
strbuf_addf(line, "%7s", "-");
|
|
} else {
|
|
strbuf_addstr(line, "-");
|
|
}
|
|
}
|
|
|
|
static size_t expand_show_tree(struct strbuf *sb, const char *start,
|
|
void *context)
|
|
{
|
|
struct show_tree_data *data = context;
|
|
const char *end;
|
|
const char *p;
|
|
unsigned int errlen;
|
|
size_t len = strbuf_expand_literal_cb(sb, start, NULL);
|
|
|
|
if (len)
|
|
return len;
|
|
if (*start != '(')
|
|
die(_("bad ls-tree format: element '%s' does not start with '('"), start);
|
|
|
|
end = strchr(start + 1, ')');
|
|
if (!end)
|
|
die(_("bad ls-tree format: element '%s' does not end in ')'"), start);
|
|
|
|
len = end - start + 1;
|
|
if (skip_prefix(start, "(objectmode)", &p)) {
|
|
strbuf_addf(sb, "%06o", data->mode);
|
|
} else if (skip_prefix(start, "(objecttype)", &p)) {
|
|
strbuf_addstr(sb, type_name(data->type));
|
|
} else if (skip_prefix(start, "(objectsize:padded)", &p)) {
|
|
expand_objectsize(sb, data->oid, data->type, 1);
|
|
} else if (skip_prefix(start, "(objectsize)", &p)) {
|
|
expand_objectsize(sb, data->oid, data->type, 0);
|
|
} else if (skip_prefix(start, "(objectname)", &p)) {
|
|
strbuf_add_unique_abbrev(sb, data->oid, abbrev);
|
|
} else if (skip_prefix(start, "(path)", &p)) {
|
|
const char *name = data->base->buf;
|
|
const char *prefix = chomp_prefix ? ls_tree_prefix : NULL;
|
|
struct strbuf quoted = STRBUF_INIT;
|
|
struct strbuf sbuf = STRBUF_INIT;
|
|
strbuf_addstr(data->base, data->pathname);
|
|
name = relative_path(data->base->buf, prefix, &sbuf);
|
|
quote_c_style(name, "ed, NULL, 0);
|
|
strbuf_addbuf(sb, "ed);
|
|
strbuf_release(&sbuf);
|
|
strbuf_release("ed);
|
|
} else {
|
|
errlen = (unsigned long)len;
|
|
die(_("bad ls-tree format: %%%.*s"), errlen, start);
|
|
}
|
|
return len;
|
|
}
|
|
|
|
static int show_recursive(const char *base, size_t baselen, const char *pathname)
|
|
{
|
|
int i;
|
|
|
|
if (ls_options & LS_RECURSIVE)
|
|
return 1;
|
|
|
|
if (!pathspec.nr)
|
|
return 0;
|
|
|
|
for (i = 0; i < pathspec.nr; i++) {
|
|
const char *spec = pathspec.items[i].match;
|
|
size_t len, speclen;
|
|
|
|
if (strncmp(base, spec, baselen))
|
|
continue;
|
|
len = strlen(pathname);
|
|
spec += baselen;
|
|
speclen = strlen(spec);
|
|
if (speclen <= len)
|
|
continue;
|
|
if (spec[len] && spec[len] != '/')
|
|
continue;
|
|
if (memcmp(pathname, spec, len))
|
|
continue;
|
|
return 1;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
static int show_tree_fmt(const struct object_id *oid, struct strbuf *base,
|
|
const char *pathname, unsigned mode, void *context)
|
|
{
|
|
size_t baselen;
|
|
int recurse = 0;
|
|
struct strbuf sb = STRBUF_INIT;
|
|
enum object_type type = object_type(mode);
|
|
|
|
struct show_tree_data data = {
|
|
.mode = mode,
|
|
.type = type,
|
|
.oid = oid,
|
|
.pathname = pathname,
|
|
.base = base,
|
|
};
|
|
|
|
if (type == OBJ_TREE && show_recursive(base->buf, base->len, pathname))
|
|
recurse = READ_TREE_RECURSIVE;
|
|
if (type == OBJ_TREE && recurse && !(ls_options & LS_SHOW_TREES))
|
|
return recurse;
|
|
if (type == OBJ_BLOB && (ls_options & LS_TREE_ONLY))
|
|
return 0;
|
|
|
|
baselen = base->len;
|
|
strbuf_expand(&sb, format, expand_show_tree, &data);
|
|
strbuf_addch(&sb, line_termination);
|
|
fwrite(sb.buf, sb.len, 1, stdout);
|
|
strbuf_release(&sb);
|
|
strbuf_setlen(base, baselen);
|
|
return recurse;
|
|
}
|
|
|
|
static int show_default(struct show_tree_data *data)
|
|
{
|
|
size_t baselen = data->base->len;
|
|
|
|
if (cmdmode == MODE_LONG) {
|
|
char size_text[24];
|
|
if (data->type == OBJ_BLOB) {
|
|
unsigned long size;
|
|
if (oid_object_info(the_repository, data->oid, &size) == OBJ_BAD)
|
|
xsnprintf(size_text, sizeof(size_text), "BAD");
|
|
else
|
|
xsnprintf(size_text, sizeof(size_text),
|
|
"%" PRIuMAX, (uintmax_t)size);
|
|
} else {
|
|
xsnprintf(size_text, sizeof(size_text), "-");
|
|
}
|
|
printf("%06o %s %s %7s\t", data->mode, type_name(data->type),
|
|
find_unique_abbrev(data->oid, abbrev), size_text);
|
|
} else {
|
|
printf("%06o %s %s\t", data->mode, type_name(data->type),
|
|
find_unique_abbrev(data->oid, abbrev));
|
|
}
|
|
baselen = data->base->len;
|
|
strbuf_addstr(data->base, data->pathname);
|
|
write_name_quoted_relative(data->base->buf,
|
|
chomp_prefix ? ls_tree_prefix : NULL, stdout,
|
|
line_termination);
|
|
strbuf_setlen(data->base, baselen);
|
|
return 1;
|
|
}
|
|
|
|
static int show_tree(const struct object_id *oid, struct strbuf *base,
|
|
const char *pathname, unsigned mode, void *context)
|
|
{
|
|
int recurse = 0;
|
|
size_t baselen;
|
|
enum object_type type = object_type(mode);
|
|
struct show_tree_data data = {
|
|
.mode = mode,
|
|
.type = type,
|
|
.oid = oid,
|
|
.pathname = pathname,
|
|
.base = base,
|
|
};
|
|
|
|
if (type == OBJ_BLOB) {
|
|
if (ls_options & LS_TREE_ONLY)
|
|
return 0;
|
|
} else if (type == OBJ_TREE &&
|
|
show_recursive(base->buf, base->len, pathname)) {
|
|
recurse = READ_TREE_RECURSIVE;
|
|
if (!(ls_options & LS_SHOW_TREES))
|
|
return recurse;
|
|
}
|
|
|
|
if (cmdmode == MODE_OBJECT_ONLY) {
|
|
printf("%s%c", find_unique_abbrev(oid, abbrev), line_termination);
|
|
return recurse;
|
|
}
|
|
|
|
if (cmdmode == MODE_NAME_ONLY) {
|
|
baselen = base->len;
|
|
strbuf_addstr(base, pathname);
|
|
write_name_quoted_relative(base->buf,
|
|
chomp_prefix ? ls_tree_prefix : NULL,
|
|
stdout, line_termination);
|
|
strbuf_setlen(base, baselen);
|
|
return recurse;
|
|
}
|
|
|
|
if (cmdmode == MODE_LONG ||
|
|
(!ls_options || (ls_options & LS_RECURSIVE)
|
|
|| (ls_options & LS_SHOW_TREES)
|
|
|| (ls_options & LS_TREE_ONLY)))
|
|
show_default(&data);
|
|
|
|
return recurse;
|
|
}
|
|
|
|
struct ls_tree_cmdmode_to_fmt {
|
|
enum ls_tree_cmdmode mode;
|
|
const char *const fmt;
|
|
};
|
|
|
|
static struct ls_tree_cmdmode_to_fmt ls_tree_cmdmode_format[] = {
|
|
{
|
|
.mode = MODE_DEFAULT,
|
|
.fmt = "%(objectmode) %(objecttype) %(objectname)%x09%(path)",
|
|
},
|
|
{
|
|
.mode = MODE_LONG,
|
|
.fmt = "%(objectmode) %(objecttype) %(objectname) %(objectsize:padded)%x09%(path)",
|
|
},
|
|
{
|
|
.mode = MODE_NAME_ONLY, /* And MODE_NAME_STATUS */
|
|
.fmt = "%(path)",
|
|
},
|
|
{
|
|
.mode = MODE_OBJECT_ONLY,
|
|
.fmt = "%(objectname)",
|
|
},
|
|
{ 0 },
|
|
};
|
|
|
|
int cmd_ls_tree(int argc, const char **argv, const char *prefix)
|
|
{
|
|
struct object_id oid;
|
|
struct tree *tree;
|
|
int i, full_tree = 0;
|
|
read_tree_fn_t fn = show_tree;
|
|
const struct option ls_tree_options[] = {
|
|
OPT_BIT('d', NULL, &ls_options, N_("only show trees"),
|
|
LS_TREE_ONLY),
|
|
OPT_BIT('r', NULL, &ls_options, N_("recurse into subtrees"),
|
|
LS_RECURSIVE),
|
|
OPT_BIT('t', NULL, &ls_options, N_("show trees when recursing"),
|
|
LS_SHOW_TREES),
|
|
OPT_SET_INT('z', NULL, &line_termination,
|
|
N_("terminate entries with NUL byte"), 0),
|
|
OPT_CMDMODE('l', "long", &cmdmode, N_("include object size"),
|
|
MODE_LONG),
|
|
OPT_CMDMODE(0, "name-only", &cmdmode, N_("list only filenames"),
|
|
MODE_NAME_ONLY),
|
|
OPT_CMDMODE(0, "name-status", &cmdmode, N_("list only filenames"),
|
|
MODE_NAME_ONLY),
|
|
OPT_CMDMODE(0, "object-only", &cmdmode, N_("list only objects"),
|
|
MODE_OBJECT_ONLY),
|
|
OPT_SET_INT(0, "full-name", &chomp_prefix,
|
|
N_("use full path names"), 0),
|
|
OPT_BOOL(0, "full-tree", &full_tree,
|
|
N_("list entire tree; not just current directory "
|
|
"(implies --full-name)")),
|
|
OPT_STRING_F(0, "format", &format, N_("format"),
|
|
N_("format to use for the output"),
|
|
PARSE_OPT_NONEG),
|
|
OPT__ABBREV(&abbrev),
|
|
OPT_END()
|
|
};
|
|
|
|
git_config(git_default_config, NULL);
|
|
ls_tree_prefix = prefix;
|
|
if (prefix && *prefix)
|
|
chomp_prefix = strlen(prefix);
|
|
|
|
argc = parse_options(argc, argv, prefix, ls_tree_options,
|
|
ls_tree_usage, 0);
|
|
if (full_tree) {
|
|
ls_tree_prefix = prefix = NULL;
|
|
chomp_prefix = 0;
|
|
}
|
|
/* -d -r should imply -t, but -d by itself should not have to. */
|
|
if ( (LS_TREE_ONLY|LS_RECURSIVE) ==
|
|
((LS_TREE_ONLY|LS_RECURSIVE) & ls_options))
|
|
ls_options |= LS_SHOW_TREES;
|
|
|
|
if (format && cmdmode)
|
|
usage_msg_opt(
|
|
_("--format can't be combined with other format-altering options"),
|
|
ls_tree_usage, ls_tree_options);
|
|
if (argc < 1)
|
|
usage_with_options(ls_tree_usage, ls_tree_options);
|
|
if (get_oid(argv[0], &oid))
|
|
die("Not a valid object name %s", argv[0]);
|
|
|
|
/*
|
|
* show_recursive() rolls its own matching code and is
|
|
* generally ignorant of 'struct pathspec'. The magic mask
|
|
* cannot be lifted until it is converted to use
|
|
* match_pathspec() or tree_entry_interesting()
|
|
*/
|
|
parse_pathspec(&pathspec, PATHSPEC_ALL_MAGIC &
|
|
~(PATHSPEC_FROMTOP | PATHSPEC_LITERAL),
|
|
PATHSPEC_PREFER_CWD,
|
|
prefix, argv + 1);
|
|
for (i = 0; i < pathspec.nr; i++)
|
|
pathspec.items[i].nowildcard_len = pathspec.items[i].len;
|
|
pathspec.has_wildcard = 0;
|
|
tree = parse_tree_indirect(&oid);
|
|
if (!tree)
|
|
die("not a tree object");
|
|
/*
|
|
* The generic show_tree_fmt() is slower than show_tree(), so
|
|
* take the fast path if possible.
|
|
*/
|
|
if (format) {
|
|
struct ls_tree_cmdmode_to_fmt *m2f;
|
|
|
|
fn = show_tree_fmt;
|
|
for (m2f = ls_tree_cmdmode_format; m2f->fmt; m2f++) {
|
|
if (strcmp(format, m2f->fmt))
|
|
continue;
|
|
|
|
cmdmode = m2f->mode;
|
|
fn = show_tree;
|
|
break;
|
|
}
|
|
}
|
|
|
|
return !!read_tree(the_repository, tree, &pathspec, fn, NULL);
|
|
}
|