xref: /src/usr.bin/make/unit-tests/varmod-gmtime.mk

# $NetBSD: varmod-gmtime.mk,v 1.6 2020/10/31 20:30:06 rillig Exp $
#
# Tests for the :gmtime variable modifier, which formats a timestamp
# using strftime(3) in UTC.

all:	mod-gmtime
all:	mod-gmtime-indirect
all:	parse-errors

# Test for the default time format, %c.  Since the time always varies, it's
# only possible to check for the general format here.  The names of the
# month and weekday are always in English, independent from the locale.
# Example: Thu Oct 29 18:56:41 2020
.if ${:U:gmtime:tW:M??? ??? ?? ??\:??\:?? ????} == ""
.  error
.endif

mod-gmtime:
	@echo $@:

	# modifier name too short
	@echo ${%Y:L:gmtim=1593536400}

	# 2020-07-01T00:00:00Z
	@echo ${%Y:L:gmtime=1593536400}

	# modifier name too long
	@echo ${%Y:L:gmtimer=1593536400}

	# If the modifier name is not matched exactly, fall back to the
	# :from=to modifier.
	@echo ${gmtime:L:gm%=local%} == localtime

mod-gmtime-indirect:
	@echo $@:

	# As of 2020-08-16, it is not possible to pass the seconds via a
	# variable expression.  This is because parsing of the :gmtime
	# modifier stops at the '$' and returns to ApplyModifiers.
	#
	# There, a colon would be skipped but not a dollar.
	# Parsing therefore continues at the '$' of the ${:U159...}, looking
	# for an ordinary variable modifier.
	#
	# At this point, the ${:U} is expanded and interpreted as a variable
	# modifier, which results in the error message "Unknown modifier '1'".
	#
	# If ApplyModifier_Gmtime were to pass its argument through
	# ParseModifierPart, this would work.
	@echo ${%Y:L:gmtime=${:U1593536400}}

parse-errors:
	@echo $@:

	# As of 2020-10-31, it is possible to pass negative time stamps
	# to the :gmtime modifier, resulting in dates before 1970.
	# Going back 50 years in the past is not a practical use case for
	# make.
	: -1 becomes ${:L:gmtime=-1}.

	# Spaces are allowed, not because it would make sense but just as
	# a side-effect from using strtoul.
	: space 1 becomes ${:L:gmtime= 1}.

	# 0 means now; to get consistent test results, the actual value has
	# to be normalized.
	: 0 becomes ${:L:gmtime=0:C,^... ... .. ..:..:.. 20..$,ok,W}.

	: 1 becomes ${:L:gmtime=1}.

	: INT32_MAX becomes ${:L:gmtime=2147483647}.

	# This may be different if time_t is still a 32-bit signed integer.
	: INT32_MAX + 1 becomes ${:L:gmtime=2147483648}.

	# Integer overflow.
	# Because this modifier is implemented using strtoul, the parsed
	# time is ULONG_MAX, which gets converted to -1.  This results
	# in a time stamp of the second before 1970.
	: overflow becomes ${:L:gmtime=10000000000000000000000000000000}.

	# As of 2020-10-31, there is no error handling while parsing the
	# :gmtime modifier, thus no error message is printed.  Parsing
	# stops after the '=', and the remaining string is parsed for
	# more variable modifiers.  Because of the unknown modifier 'e',
	# the whole variable value is discarded and thus not printed.
	: letter becomes ${:L:gmtime=error}.