Skip to content

quote_path() clean-ups

Junio C Hamano git 2 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v2 Latest7 patches 6 repliesIn review
  2. v16 patches 8 repliesSuperseded

Patches in v2 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/7quote_path: rename quote_path_relative() to quote_path()builtin/clean.c builtin/grep.c quote.c +2 more+14 -180 replies
2/7quote_path: give flags parameter to quote_path()builtin/clean.c builtin/grep.c quote.c +2 more+26 -260 replies
3/7quote_path: optionally allow quoting a path with SP in itquote.c quote.h wt-status.c+11 -120 replies
4/7quote_path: code clarificationquote.c+12 -73 replies
5/7wt-status: consistently quote paths in "status --short" outputt/t7508-status.sh wt-status.c+29 -22 replies
6/7quote: rename misnamed sq_lookup[] to cq_lookup[]quote.c+7 -70 replies
7/7quote: turn 'nodq' parameter into a set of flagsdiff.c quote.c quote.h+20 -130 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v2 yet.

Read the v2 thread

Cover letter [PATCH v2 0/7] quote_path() clean-ups

Here is an update, after seeing Peff's review.

The overall structure of the series stays the same.

* The second patch lost an incorrect use of 'flags' parameter down to quote_c_style_counted() from quote_path(). In the function declaration of quote_path(), the flags parameter is now named.

* The third patch that moves the "optionally quote path with SP in it" logic to quote_path() is essentialy unchanged.

* But the fourth patch rewrites the implementation to avoid shifting the output bytes with insertstr().

* The fifth patch (formerly the fourth) that teachs "status --short" to consistently quote hasn't changed, except that we test also for the ignored paths.

* The last two patches are unchanged. They are optional clean-ups that are not required.

We might want to add a bit more tests for:

- how conflicted "funny" paths are shown.

- how doubly funny paths (those that quote_c_style_counted() needs to use backslash quoting *and* that contain SP) are shown.

but I'd say that is outside the scope of this round. Seeing what is done in t3300, the latter test cannot be written portably as far as I can tell.

Junio C Hamano (7):
quote_path: rename quote_path_relative() to quote_path()
quote_path: give flags parameter to quote_path()
quote_path: optionally allow quoting a path with SP in it
quote_path: code clarification
wt-status: consistently quote paths in "status --short" output
quote: rename misnamed sq_lookup[] to cq_lookup[]
quote: turn 'nodq' parameter into a set of flags

 builtin/clean.c   | 22 +++++++++++-----------
 builtin/grep.c    |  2 +-
 diff.c            |  8 ++++----
 quote.c           | 47 +++++++++++++++++++++++++++++++----------------
 quote.h           | 11 +++++++----
 t/t7508-status.sh | 27 +++++++++++++++++++++++++++
 wt-status.c       | 37 +++++++++++++------------------------
 7 files changed, 94 insertions(+), 60 deletions(-)

Range-diff against v1:

1:  a9306429f4 = 1:  a9306429f4 quote_path: rename quote_path_relative() to quote_path()
2:  c2784628a4 ! 2:  179d12d16f quote_path: give flags parameter to quote_path()
    @@ quote.c: void write_name_quoted_relative(const char *name, const char *prefix,
      {
      	struct strbuf sb = STRBUF_INIT;
      	const char *rel = relative_path(in, prefix, &sb);
    - 	strbuf_reset(out);
    --	quote_c_style_counted(rel, strlen(rel), out, NULL, 0);
    -+	quote_c_style_counted(rel, strlen(rel), out, NULL, flags);
    - 	strbuf_release(&sb);
    - 
    - 	return out->buf;
     
      ## quote.h ##
     @@ quote.h: void write_name_quoted_relative(const char *name, const char *prefix,
    @@ quote.h: void write_name_quoted_relative(const char *name, const char *prefix,
      
      /* quote path as relative to the given prefix */
     -char *quote_path(const char *in, const char *prefix, struct strbuf *out);
    -+char *quote_path(const char *in, const char *prefix, struct strbuf *out, unsigned);
    ++char *quote_path(const char *in, const char *prefix, struct strbuf *out, unsigned flags);
      
      /* quoting as a string literal for other languages */
      void perl_quote_buf(struct strbuf *sb, const char *src);

3: 640673148e ! 3: d566c38d2f quote_path: optionally allow quoting a path with SP in it
@@ Commit message

## quote.c ##
@@ quote.c: char *quote_path(const char *in, const char *prefix, struct strbuf *out, unsigne
- struct strbuf sb = STRBUF_INIT;
- const char *rel = relative_path(in, prefix, &sb);
- strbuf_reset(out);
-- quote_c_style_counted(rel, strlen(rel), out, NULL, flags);
-+ quote_c_style_counted(rel, strlen(rel), out, NULL, 0);
+ quote_c_style_counted(rel, strlen(rel), out, NULL, 0);
strbuf_release(&sb);

+ if ((flags & QUOTE_PATH_QUOTE_SP) &&
@@ quote.h
@@ quote.h: void write_name_quoted_relative(const char *name, const char *prefix,

/* quote path as relative to the given prefix */
- char *quote_path(const char *in, const char *prefix, struct strbuf *out, unsigned);
+ char *quote_path(const char *in, const char *prefix, struct strbuf *out, unsigned flags); +#define QUOTE_PATH_QUOTE_SP 01

/* quoting as a string literal for other languages */

-:  ---------- > 4:  f3769b7cf4 quote_path: code clarification
4:  ac9a0c4a33 ! 5:  498bed71e4 wt-status: consistently quote paths in "status --short" output
    @@ Commit message
         output, but untracked, ignored, and unmerged paths weren't.
     
         The test was stolen from a patch to fix output for the 'untracked'
    -    paths by brian m. carlson.
    +    paths by brian m. carlson, with similar tests added for 'ignored'
    +    ones.
     
         Signed-off-by: Junio C Hamano <[email protected]>
     
    @@ t/t7508-status.sh: test_expect_success 'status -s without relative paths' '
     +	test_when_finished "git rm --cached \"file with spaces\"; rm -f file*" &&
     +	>"file with spaces" &&
     +	>"file with spaces 2" &&
    ++	>"expect with spaces" &&
     +	git add "file with spaces" &&
    ++
     +	git status -s >output &&
    -+	test_cmp expect output
    ++	test_cmp expect output &&
     +
    ++	git status -s --ignored >output &&
    ++	grep "^!! \"expect with spaces\"$" output &&
    ++	grep -v "^!! " output >output-wo-ignored &&
    ++	test_cmp expect output-wo-ignored
     +'
     +
      test_expect_success 'dry-run of partial commit excluding new file in index' '
5:  57c6294695 = 6:  e74186bbd7 quote: rename misnamed sq_lookup[] to cq_lookup[]
6:  480152cfe4 ! 7:  d87d7dd561 quote: turn 'nodq' parameter into a set of flags

@@ quote.c: static size_t quote_c_style_counted(const char *name, ssize_t maxlen,
if (!nodq)
strbuf_addch(sb, '"');
} else {
+@@ quote.c: char *quote_path(const char *in, const char *prefix, struct strbuf *out, unsigne
+ */
+ if (force_dq)
+ strbuf_addch(out, '"');
+- quote_c_style_counted(rel, strlen(rel), out, NULL, !!force_dq);
++ quote_c_style_counted(rel, strlen(rel), out, NULL,
++ force_dq ? CQUOTE_NODQ : 0);
+ if (force_dq)
+ strbuf_addch(out, '"');
+ strbuf_release(&sb);

## quote.h ##
@@ quote.h: struct strvec;

Signature · 1 line
2.28.0-603-ga98dad7d4d