On Fri, 2014-07-11 at 13:51 -0700, Jacob Keller wrote:
> Add support for configuring default sort ordering for git tags. Command
> line option will override this configured value, using the exact same
> syntax.
>
> Cc: Jeff King <p...@peff.net>
> Signed-off-by: Jacob Keller <jacob.e.kel...@intel.com>
> ---
> Updated based on Junio's suggestions, as well as making sure that we don't
> bail
> if we can't understand config's option. We still print error message followed
> by a warning about using default order. In addition, added a few more tests to
> ensure that these work as expected.
>
> Documentation/config.txt | 5 ++++
> Documentation/git-tag.txt | 5 +++-
> builtin/tag.c | 61
> ++++++++++++++++++++++++++++++++++-------------
> t/t7004-tag.sh | 36 ++++++++++++++++++++++++++++
> 4 files changed, 90 insertions(+), 17 deletions(-)
>
> diff --git a/Documentation/config.txt b/Documentation/config.txt
> index 1d718bdb9662..c55c22ab7be9 100644
> --- a/Documentation/config.txt
> +++ b/Documentation/config.txt
> @@ -2354,6 +2354,11 @@ submodule.<name>.ignore::
> "--ignore-submodules" option. The 'git submodule' commands are not
> affected by this setting.
>
> +tag.sort::
> + This variable controls the sort ordering of tags when displayed by
> + linkgit:git-tag[1]. Without the "--sort=<value>" option provided, the
> + value of this variable will be used as the default.
> +
> tar.umask::
> This variable can be used to restrict the permission bits of
> tar archive entries. The default is 0002, which turns off the
> diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
> index b424a1bc48bb..320908369f06 100644
> --- a/Documentation/git-tag.txt
> +++ b/Documentation/git-tag.txt
> @@ -99,7 +99,9 @@ OPTIONS
> Sort in a specific order. Supported type is "refname"
> (lexicographic order), "version:refname" or "v:refname" (tag
> names are treated as versions). Prepend "-" to reverse sort
> - order.
> + order. When this option is not given, the sort order defaults to the
> + value configured for the 'tag.sort' variable if it exists, or
> + lexicographic order otherwise. See linkgit:git-config[1].
>
> --column[=<options>]::
> --no-column::
> @@ -317,6 +319,7 @@ include::date-formats.txt[]
> SEE ALSO
> --------
> linkgit:git-check-ref-format[1].
> +linkgit:git-config[1].
>
> GIT
> ---
> diff --git a/builtin/tag.c b/builtin/tag.c
> index 7ccb6f3c581b..cb37b26159a6 100644
> --- a/builtin/tag.c
> +++ b/builtin/tag.c
> @@ -32,6 +32,8 @@ static const char * const git_tag_usage[] = {
> #define SORT_MASK 0x7fff
> #define REVERSE_SORT 0x8000
>
> +static int tag_sort;
> +
> struct tag_filter {
> const char **patterns;
> int lines;
> @@ -346,9 +348,46 @@ static const char tag_template_nocleanup[] =
> "Lines starting with '%c' will be kept; you may remove them"
> " yourself if you want to.\n");
>
> +/*
> + * Parse a sort string, and return 0 if parsed successfully. Will return
> + * non-zero when the sort string does not parse into a known type.
> + */
> +static int parse_sort_string(const char *arg, int *sort)
> +{
> + int type = 0, flags = 0;
> +
> + if (skip_prefix(arg, "-", &arg))
> + flags |= REVERSE_SORT;
> +
> + if (skip_prefix(arg, "version:", &arg) || skip_prefix(arg, "v:", &arg))
> + type = VERCMP_SORT;
> + else
> + type = STRCMP_SORT;
> +
> + if (strcmp(arg, "refname"))
> + return error(_("unsupported sort specification %s"), arg);
> +
> + *sort = (type | flags);
> +
> + return 0;
> +}
> +
> static int git_tag_config(const char *var, const char *value, void *cb)
> {
> - int status = git_gpg_config(var, value, cb);
> + int status;
> +
> + if (!strcmp(var, "tag.sort")) {
> + if (!value)
> + return config_error_nonbool(var);
> + status = parse_sort_string(value, &tag_sort);
> + if (status) {
> + warning("using default lexicographic sort order");
Oops, I should also use warning(_("")) here as well I believe...
Sorry for thrash.
Thanks,
Jake
> + tag_sort = STRCMP_SORT;
> + }
> + return 0;
> + }
> +
> + status = git_gpg_config(var, value, cb);
> if (status)
> return status;
> if (starts_with(var, "column."))
> @@ -522,18 +561,8 @@ static int parse_opt_points_at(const struct option *opt
> __attribute__((unused)),
> static int parse_opt_sort(const struct option *opt, const char *arg, int
> unset)
> {
> int *sort = opt->value;
> - int flags = 0;
>
> - if (skip_prefix(arg, "-", &arg))
> - flags |= REVERSE_SORT;
> -
> - if (skip_prefix(arg, "version:", &arg) || skip_prefix(arg, "v:", &arg))
> - *sort = VERCMP_SORT;
> -
> - if (strcmp(arg, "refname"))
> - die(_("unsupported sort specification %s"), arg);
> - *sort |= flags;
> - return 0;
> + return parse_sort_string(arg, sort);
> }
>
> int cmd_tag(int argc, const char **argv, const char *prefix)
> @@ -546,7 +575,7 @@ int cmd_tag(int argc, const char **argv, const char
> *prefix)
> struct create_tag_options opt;
> char *cleanup_arg = NULL;
> int annotate = 0, force = 0, lines = -1;
> - int cmdmode = 0, sort = 0;
> + int cmdmode = 0;
> const char *msgfile = NULL, *keyid = NULL;
> struct msg_arg msg = { 0, STRBUF_INIT };
> struct commit_list *with_commit = NULL;
> @@ -572,7 +601,7 @@ int cmd_tag(int argc, const char **argv, const char
> *prefix)
> OPT__FORCE(&force, N_("replace the tag if exists")),
> OPT_COLUMN(0, "column", &colopts, N_("show tag list in
> columns")),
> {
> - OPTION_CALLBACK, 0, "sort", &sort, N_("type"), N_("sort
> tags"),
> + OPTION_CALLBACK, 0, "sort", &tag_sort, N_("type"),
> N_("sort tags"),
> PARSE_OPT_NONEG, parse_opt_sort
> },
>
> @@ -628,9 +657,9 @@ int cmd_tag(int argc, const char **argv, const char
> *prefix)
> copts.padding = 2;
> run_column_filter(colopts, &copts);
> }
> - if (lines != -1 && sort)
> + if (lines != -1 && tag_sort)
> die(_("--sort and -n are incompatible"));
> - ret = list_tags(argv, lines == -1 ? 0 : lines, with_commit,
> sort);
> + ret = list_tags(argv, lines == -1 ? 0 : lines, with_commit,
> tag_sort);
> if (column_active(colopts))
> stop_column_filter();
> return ret;
> diff --git a/t/t7004-tag.sh b/t/t7004-tag.sh
> index 66010b0e7066..036665308841 100755
> --- a/t/t7004-tag.sh
> +++ b/t/t7004-tag.sh
> @@ -1423,6 +1423,42 @@ test_expect_success 'reverse lexical sort' '
> test_cmp expect actual
> '
>
> +test_expect_success 'configured lexical sort' '
> + git config tag.sort "v:refname" &&
> + git tag -l "foo*" >actual &&
> + cat >expect <<-\EOF &&
> + foo1.3
> + foo1.6
> + foo1.10
> + EOF
> + test_cmp expect actual
> +'
> +
> +test_expect_success 'option override configured sort' '
> + git tag -l --sort=-refname "foo*" >actual &&
> + cat >expect <<-\EOF &&
> + foo1.6
> + foo1.3
> + foo1.10
> + EOF
> + test_cmp expect actual
> +'
> +
> +test_expect_success 'invalid sort parameter on command line' '
> + test_must_fail git tag -l --sort=notvalid "foo*" >actual
> +'
> +
> +test_expect_success 'invalid sort parameter in configuratoin' '
> + git config tag.sort "v:notvalid" &&
> + git tag -l "foo*" >actual &&
> + cat >expect <<-\EOF &&
> + foo1.10
> + foo1.3
> + foo1.6
> + EOF
> + test_cmp expect actual
> +'
> +
> run_with_limited_stack () {
> (ulimit -s 64 && "$@")
> }
