git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v2 02/11] GIT-VERSION-GEN: allow running without input and output files

From
Toon Claes <toon@iotcl.com>
Date
Jan 21, 2025, 13:16 UTC
Message-ID
<87jzaoi9yc.fsf@iotcl.com>
In-Reply-To
<20250114-b4-pks-meson-additions-v2-2-8d7ec676cfd9@pks.im>
Patrick Steinhardt <ps@pks.im> writes:
Show 101 quoted lines
> The GIT-VERSION-GEN script requires an input file containing formatting
> directives to be replaced as well as an output file that will get
> overwritten in case the file contents have changed. When computing the
> project version for Meson we don't want to have either though:
>
>   - We only want to compute the version without anything else, but don't
>     have an input file that would match that exact format. While we
>     could of course introduce a new file just for that usecase, it feels
>     suboptimal to add another file every time we want to have a slightly
>     different format for versioned data.
>
>   - The computed version needs to be read from stdout so that Meson can
>     wire it up for the project.
>
> Extend the script to handle both usecases by recognizing `--format=` as
> alternative to providing an input path and by writing to stdout in case
> no output file was given.
>
> Signed-off-by: Patrick Steinhardt <ps@pks.im>
> ---
>  GIT-VERSION-GEN | 44 +++++++++++++++++++++++++++++---------------
>  1 file changed, 29 insertions(+), 15 deletions(-)
>
> diff --git a/GIT-VERSION-GEN b/GIT-VERSION-GEN
> index b8b683b9337e5771e14a2cfb84022a11489bb432..9d201a98fd2766911544225c62159cbfe8dff5fe 100755
> --- a/GIT-VERSION-GEN
> +++ b/GIT-VERSION-GEN
> @@ -5,21 +5,29 @@ DEF_VER=v2.48.0
>  LF='
>  '
>  
> -if test "$#" -ne 3
> +if test "$#" -lt 2 || test "$#" -gt 3
>  then
> -    echo >&2 "USAGE: $0 <SOURCE_DIR> <INPUT> <OUTPUT>"
> +    echo >&2 "USAGE: $0 <SOURCE_DIR> (--format=<STRING>|<INPUT>) [<OUTPUT>]"
>      exit 1
>  fi
>  
>  SOURCE_DIR="$1"
> -INPUT="$2"
> -OUTPUT="$3"
>  
> -if ! test -f "$INPUT"
> -then
> -	echo >&2 "Input is not a file: $INPUT"
> -	exit 1
> -fi
> +case "$2" in
> +--format=*)
> +	INPUT="${2#--format=}"
> +	;;
> +*)
> +	if ! test -f "$2"
> +	then
> +		echo >&2 "Input is not a file: $2"
> +		exit 1
> +	fi
> +	INPUT=$(cat "$2")
> +	;;
> +esac
> +
> +OUTPUT="$3"
>  
>  # Protect us from reading Git version information outside of the Git directory
>  # in case it is not a repository itself, but embedded in an unrelated
> @@ -74,19 +82,25 @@ read GIT_MAJOR_VERSION GIT_MINOR_VERSION GIT_MICRO_VERSION GIT_PATCH_LEVEL trail
>  $(echo "$GIT_VERSION" 0 0 0 0 | tr '.a-zA-Z-' ' ')
>  EOF
>  
> -sed -e "s|@GIT_VERSION@|$GIT_VERSION|" \
> +REPLACED=$(printf "%s" "$INPUT" | sed -e "s|@GIT_VERSION@|$GIT_VERSION|" \
>  	-e "s|@GIT_MAJOR_VERSION@|$GIT_MAJOR_VERSION|" \
>  	-e "s|@GIT_MINOR_VERSION@|$GIT_MINOR_VERSION|" \
>  	-e "s|@GIT_MICRO_VERSION@|$GIT_MICRO_VERSION|" \
>  	-e "s|@GIT_PATCH_LEVEL@|$GIT_PATCH_LEVEL|" \
>  	-e "s|@GIT_BUILT_FROM_COMMIT@|$GIT_BUILT_FROM_COMMIT|" \
>  	-e "s|@GIT_USER_AGENT@|$GIT_USER_AGENT|" \
> -	-e "s|@GIT_DATE@|$GIT_DATE|" \
> -	"$INPUT" >"$OUTPUT".$$+
> +	-e "s|@GIT_DATE@|$GIT_DATE|"
> +)
>  
> -if ! test -f "$OUTPUT" || ! cmp "$OUTPUT".$$+ "$OUTPUT" >/dev/null
> +if test -z "$OUTPUT"
>  then
> -	mv "$OUTPUT".$$+ "$OUTPUT"
> +	printf "%s\n" "$REPLACED"
>  else
> -	rm "$OUTPUT".$$+
> +	printf "%s\n" "$REPLACED" >"$OUTPUT".$$+
> +	if ! test -f "$OUTPUT" || ! cmp "$OUTPUT".$$+ "$OUTPUT" >/dev/null
> +	then
> +		mv "$OUTPUT".$$+ "$OUTPUT"
> +	else
> +		rm "$OUTPUT".$$+
> +	fi
>  fi
>
> -- 
> 2.48.0.257.gd3603152ad.dirty

I was considering to suggest to have GIT-VERSION-GEN accept --stdin for $INPUT and have it read from stdin instead of passing the format as an argument, but looking at the following commits I agree with your approach.

-- Toon

Previous: Patrick SteinhardtNext: Patrick Steinhardt
Message 4 of 18 in “meson: a couple of additions”
  1. 00/11 meson: a couple of additionsPatrick Steinhardt, Jan 14, 2025
  2. 01/11 GIT-VERSION-GEN: simplify computing the dirty markerPatrick Steinhardt, Jan 14, 2025
  3. 02/11 GIT-VERSION-GEN: allow running without input and output filesPatrick Steinhardt, Jan 14, 2025
  4. Toon ClaesJan 21, 2025
  5. 03/11 meson: populate project version via GIT-VERSION-GENPatrick Steinhardt, Jan 14, 2025
  6. Toon ClaesJan 21, 2025
  7. 04/11 meson: fix dependencies for generated headersPatrick Steinhardt, Jan 14, 2025
  8. 05/11 meson: wire up development environmentsPatrick Steinhardt, Jan 14, 2025
  9. 06/11 meson: wire up generation of distribution archivePatrick Steinhardt, Jan 14, 2025
  10. Toon ClaesJan 21, 2025
  11. Patrick SteinhardtJan 22, 2025
  12. 07/11 meson: wire up fuzzersPatrick Steinhardt, Jan 14, 2025
  13. 08/11 meson: make the CSPRNG backend configurablePatrick Steinhardt, Jan 14, 2025
  14. 09/11 meson: fix compilation with Visual StudioPatrick Steinhardt, Jan 14, 2025
  15. 10/11 ci: raise error when Meson generates warningsPatrick Steinhardt, Jan 14, 2025
  16. Toon ClaesJan 21, 2025
  17. 11/11 ci: wire up Visual Studio build with MesonPatrick Steinhardt, Jan 14, 2025
  18. Junio C HamanoJan 14, 2025

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.