tldr/pages/common/test.md

# test

> Check file types and compare values.
> Returns 0 if the condition evaluates to true, 1 if it evaluates to false.
> More information: <https://www.gnu.org/software/coreutils/test>.

- Test if a given variable is equal to a given string:

`test "{{$MY_VAR}}" = "{{/bin/zsh}}"`

- Test if a given variable is empty:

`test -z "{{$GIT_BRANCH}}"`

- Test if a file exists:

`test -f "{{path/to/file_or_directory}}"`

- Test if a directory does not exist:

`test ! -d "{{path/to/directory}}"`

- If A is true, then do B, or C in the case of an error (notice that C may run even if A fails):

`test {{condition}} && {{echo "true"}} || {{echo "false"}}`
test: add page 2015-12-12 22:08:54 +00:00			`# test`

[, test: add Polish translation (#7354) 2021-11-07 00:57:43 +00:00			`> Check file types and compare values.`
test, [: add page, improve examples (#5205) 2021-03-10 19:24:11 +00:00			`> Returns 0 if the condition evaluates to true, 1 if it evaluates to false.`
coreutils*: use short more info links (#5658) 2021-04-01 16:54:26 +01:00			`> More information: <https://www.gnu.org/software/coreutils/test>.`
test: add page 2015-12-12 22:08:54 +00:00
test, [: add page, improve examples (#5205) 2021-03-10 19:24:11 +00:00			`- Test if a given variable is equal to a given string:`
test: add page 2015-12-12 22:08:54 +00:00
`test`: Use POSIX-compliant example for equals comparison (#11728) * [: use posix-compliant example for equals comparison the previous example worked fine for bash, but some other shells (zsh, in my case) will not work when using "==" for comparison. the posix spec only requires "=", so I think it makes a little more sense to use that in the example. * test: use posix-compliant example for equals comparison the previous example worked fine for bash, but some other shells (zsh, in my case) will not work when using "==" for comparison. the posix spec only requires "=", so I think it makes a little more sense to use that in the example. 2023-12-14 15:01:13 +00:00			`test "{{$MY_VAR}}" = "{{/bin/zsh}}"`
test: add page 2015-12-12 22:08:54 +00:00
test, [: add page, improve examples (#5205) 2021-03-10 19:24:11 +00:00			`- Test if a given variable is empty:`
test: add page 2015-12-12 22:08:54 +00:00
test, [: add page, improve examples (#5205) 2021-03-10 19:24:11 +00:00			`test -z "{{$GIT_BRANCH}}"`
test: add page 2015-12-12 22:08:54 +00:00
test, [: add page, improve examples (#5205) 2021-03-10 19:24:11 +00:00			`- Test if a file exists:`
test: add page 2015-12-12 22:08:54 +00:00
test, [: add page, improve examples (#5205) 2021-03-10 19:24:11 +00:00			`test -f "{{path/to/file_or_directory}}"`
test: add page 2015-12-12 22:08:54 +00:00
test, [: add page, improve examples (#5205) 2021-03-10 19:24:11 +00:00			`- Test if a directory does not exist:`
test: add page 2015-12-12 22:08:54 +00:00
test, [: add page, improve examples (#5205) 2021-03-10 19:24:11 +00:00			`test ! -d "{{path/to/directory}}"`
test: add page 2015-12-12 22:08:54 +00:00
test: update condition example description (#8594) 2022-10-04 10:49:21 +01:00			`- If A is true, then do B, or C in the case of an error (notice that C may run even if A fails):`
test: add page 2015-12-12 22:08:54 +00:00
test, [: add page, improve examples (#5205) 2021-03-10 19:24:11 +00:00			`test {{condition}} && {{echo "true"}} \|\| {{echo "false"}}`