jack/42-archive
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge branch 'master' of github.com:jzck/42sh

Browse source
This commit is contained in:
wescande 2017-03-18 04:16:27 +01:00
commit 2acb7ee167
284 changed files with 7631 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
42sh/42shelltest-tmp/.gitignore vendored Normal file
View file

@ -0,0 +1,4 @@
.idea
tmp/
.mshell_hist
.DS_Store

122
42sh/42shelltest-tmp/42ShellTester.sh Normal file
View file

@ -0,0 +1,122 @@
#!/bin/bash
# /*
# Launcher
# */
get_install_directory()
{
local SOURCE="${BASH_SOURCE[0]}"
local DIR
while [ -h "${SOURCE}" ]
do
DIR="$(cd -P "$(dirname "${SOURCE}")" && pwd)"
SOURCE="$(readlink "${SOURCE}")"
[[ "${SOURCE}" != /* ]] && SOURCE="${DIR}/${SOURCE}"
done
printf "%s" "$(cd -P "$(dirname "${SOURCE}")" && pwd)"
}
# global variables
GLOBAL_PROG=""
GLOBAL_PROG_REFERENCE=""
GLOBAL_SPECS_FILTER=""
GLOBAL_ENTRYPATH=$(pwd)
GLOBAL_INSTALLDIR="$(get_install_directory)"
GLOBAL_TMP_DIRECTORY="${GLOBAL_INSTALLDIR}/tmp"
GLOBAL_LOCALBRANCH=$(git branch | awk '$0 ~ /^\*/ {print $2; exit}')
GLOBAL_TOKEN="TOKEN$(date +%Y%m%d%H%M)"
GLOBAL_TOTAL_TESTS=0
GLOBAL_TOTAL_FAILED_TESTS=0
GLOBAL_TOTAL_PENDING_TESTS=0
GLOBAL_LOG=""
GLOBAL_SHOW_SUCCESS=0
GLOBAL_RUN_POSIX_ONLY=0
GLOBAL_RUN_PENDING_TESTS=0
GLOBAL_RUN_HARD_TESTS=0
GLOBAL_RUN_ALL_TESTS=0
GLOBAL_INVALID_OPTION=0
C_BOLD="\033[37;1m"
C_RED="\033[31m\033[38;5;160m"
C_GREEN="\033[31m\033[38;5;34m"
C_YELLOW="\033[31m\033[1;33m"
C_GREY="\033[38;5;239m"
C_CLEAR="\033[0m"
# retrieve options
while [ ! -z "${1}" ]; do
if [[ "${1}" =~ ^-- ]]
then
case "${1}" in
"--reference")
shift 1
GLOBAL_PROG_REFERENCE="$(which ${1})"
;;
"--filter")
shift 1
GLOBAL_SPECS_FILTER="${1}"
;;
"--show-success")
GLOBAL_SHOW_SUCCESS=1
;;
"--pending")
GLOBAL_RUN_PENDING_TESTS=1
;;
"--posix")
GLOBAL_RUN_POSIX_ONLY=1
;;
"--hard")
GLOBAL_RUN_HARD_TESTS=1
;;
"--all")
GLOBAL_RUN_ALL_TESTS=1
;;
*)
printf "%s\n" "Invalid option: ${1}"
exit 1
;;
esac
else
if [ "${GLOBAL_PROG}" == "" ]
then
[[ "${1}" =~ ^[\.][\.]\/ ]] && GLOBAL_PROG="../${1}" || GLOBAL_PROG="$(which ${1})"
fi
fi
shift 1
done
# go to install directory
cd "${GLOBAL_INSTALLDIR}"
# load application sources
for FILE in ./lib/* ./lib/verbs/*
do
if [ -f "${FILE}" ]
then
source "${FILE}"
fi
done
# create and go to temporary directory
mkdir -p "${GLOBAL_TMP_DIRECTORY}"
cd "${GLOBAL_TMP_DIRECTORY}"
# compile support binaries
make re -C "${GLOBAL_INSTALLDIR}/support/" TARGET_DIR=${GLOBAL_TMP_DIRECTORY} 1>- 2>-
# run main function
run_main
# display log
printf "%s\n\nTotal tests: %s\nTotal failed tests: %s\nTotal pending tests: %s\n" "${GLOBAL_LOG}" "${GLOBAL_TOTAL_TESTS}" "${GLOBAL_TOTAL_FAILED_TESTS}" "${GLOBAL_TOTAL_PENDING_TESTS}"
# go back to entry directory
cd "${GLOBAL_ENTRYPATH}"
# exit with success or error status
if [ "${GLOBAL_TOTAL_FAILED_TESTS}" == "0" ]
then
exit 0
else
exit 1
fi

596
42sh/42shelltest-tmp/README.md Normal file
View file

@ -0,0 +1,596 @@
# 42ShellTester
<img align="right" src="./lib/assets/42ShellTester_cropped.png" width="45%" />42ShellTester is an **integration testing framework** wrote in Bash and designed for the pedagogical projects of the Shell branch at School 42 (Paris) listed bellow:
* **minishell**
* **21sh**
* **42sh**
It brings you an easy way to **add**, **maintain** and **run** integration tests, helping you to work step by step on your Shell implementation.
<!--START_TOTAL_TESTS-->
42ShellTester is currently packaged with **304 tests**.
<!--END_TOTAL_TESTS-->
## Install
```bash
git clone https://github.com/we-sh/42ShellTester ~/42ShellTester
```
## Run tests
Add the path to your Shell as argument:
```bash
bash ~/42ShellTester/42ShellTester.sh "/ABSOLUTE/PATH/TO/YOUR/SHELL"
```
## Options
##### `--filter` + `$regex`
Run tests that matches with the specified regular expression (e.g. `--filter "builtins"`).
##### `--reference` + `$binary`
Run tests that does not fail with the specified Shell binary (e.g. `--reference "bash"`).
##### `--posix`
Run tests that are POSIX compliant only (run all by default).
##### `--hard`
Run tests that are marked as « hard » (omitted by default).
##### `--pending`
Also run pending tests.
##### `--all`
Equivalent to use the two options `--pending` and `--hard` together.
##### `--show-success`
Also display tests that succeed (hidden by default).
## List of tests
<!--START_LIST_TESTS-->
* **[21sh/](spec/21sh)**
* **[misc/](spec/21sh/misc)**
* [001-no-prompt-in-non-interactive-mode](spec/21sh/misc/001-no-prompt-in-non-interactive-mode)
* [002-simple-command-line](spec/21sh/misc/002-simple-command-line)
* **[pipe/](spec/21sh/pipe)**
* [001-single-pipe](spec/21sh/pipe/001-single-pipe)
* [002-chained-pipes](spec/21sh/pipe/002-chained-pipes)
* [003-many-chained-pipes](spec/21sh/pipe/003-many-chained-pipes)
* [004-without-surrounding-whitespaces](spec/21sh/pipe/004-without-surrounding-whitespaces)
* [005-asynchronous](spec/21sh/pipe/005-asynchronous)
* [006-exit-status](spec/21sh/pipe/006-exit-status)
* **[mixed/](spec/21sh/pipe/mixed)**
* [001-exit-or-not-exit <img src='./lib/assets/hard.png' width='38' height='12' />](spec/21sh/pipe/mixed/001-exit-or-not-exit)
* [002-cd-or-not-cd <img src='./lib/assets/hard.png' width='38' height='12' />](spec/21sh/pipe/mixed/002-cd-or-not-cd)
* [003-unsetenv-or-not-unsetenv <img src='./lib/assets/hard.png' width='38' height='12' />](spec/21sh/pipe/mixed/003-unsetenv-or-not-unsetenv)
* [004-setenv-or-not-setenv <img src='./lib/assets/hard.png' width='38' height='12' />](spec/21sh/pipe/mixed/004-setenv-or-not-setenv)
* **[redirections/](spec/21sh/redirections)**
* **[inputs/](spec/21sh/redirections/inputs)**
* [001-close-stdin](spec/21sh/redirections/inputs/001-close-stdin)
* [002-filename](spec/21sh/redirections/inputs/002-filename)
* [003-filename-with-whitespaces](spec/21sh/redirections/inputs/003-filename-with-whitespaces)
* [004-absolute-path](spec/21sh/redirections/inputs/004-absolute-path)
* [005-no-such-file](spec/21sh/redirections/inputs/005-no-such-file)
* **[outputs/](spec/21sh/redirections/outputs)**
* **[appending/](spec/21sh/redirections/outputs/appending)**
* [001-append-default-to-file](spec/21sh/redirections/outputs/appending/001-append-default-to-file)
* [002-append-stdout-to-file](spec/21sh/redirections/outputs/appending/002-append-stdout-to-file)
* [003-append-stderr-to-file](spec/21sh/redirections/outputs/appending/003-append-stderr-to-file)
* **[multiple/](spec/21sh/redirections/outputs/appending/multiple)**
* [001-append-twice-separately](spec/21sh/redirections/outputs/appending/multiple/001-append-twice-separately)
* **[closing/](spec/21sh/redirections/outputs/closing)**
* [001-close-default-output](spec/21sh/redirections/outputs/closing/001-close-default-output)
* [002-close-stdout](spec/21sh/redirections/outputs/closing/002-close-stdout)
* [003-close-stderr](spec/21sh/redirections/outputs/closing/003-close-stderr)
* [004-close-twice-outputs](spec/21sh/redirections/outputs/closing/004-close-twice-outputs)
* **[touching/](spec/21sh/redirections/outputs/touching)**
* [001-works](spec/21sh/redirections/outputs/touching/001-works)
* **[truncating/](spec/21sh/redirections/outputs/truncating)**
* [001-creates-file-if-not-exits](spec/21sh/redirections/outputs/truncating/001-creates-file-if-not-exits)
* [002-truncates-file-if-exists](spec/21sh/redirections/outputs/truncating/002-truncates-file-if-exists)
* [003-whitespace-before-filename](spec/21sh/redirections/outputs/truncating/003-whitespace-before-filename)
* **[multiple/](spec/21sh/redirections/outputs/truncating/multiple)**
* [001-separately](spec/21sh/redirections/outputs/truncating/multiple/001-separately)
* [002-together-stdout-first](spec/21sh/redirections/outputs/truncating/multiple/002-together-stdout-first)
* [003-together-stderr-first](spec/21sh/redirections/outputs/truncating/multiple/003-together-stderr-first)
* [004-together](spec/21sh/redirections/outputs/truncating/multiple/004-together)
* [005-together-with-whitespaces](spec/21sh/redirections/outputs/truncating/multiple/005-together-with-whitespaces)
* **[stderr/](spec/21sh/redirections/outputs/truncating/stderr)**
* [001-works](spec/21sh/redirections/outputs/truncating/stderr/001-works)
* **[stdout/](spec/21sh/redirections/outputs/truncating/stdout)**
* [001-with-explicit-fd](spec/21sh/redirections/outputs/truncating/stdout/001-with-explicit-fd)
* **[separators/](spec/21sh/separators)**
* **[semicolon/](spec/21sh/separators/semicolon)**
* [001-two-commands-sequentially](spec/21sh/separators/semicolon/001-two-commands-sequentially)
* [002-n-commands-sequentially](spec/21sh/separators/semicolon/002-n-commands-sequentially)
* [003-parse-error-empty-inline-command](spec/21sh/separators/semicolon/003-parse-error-empty-inline-command)
* [004-parse-error-empty-command](spec/21sh/separators/semicolon/004-parse-error-empty-command)
* **[42sh/](spec/42sh)**
* **[builtins/](spec/42sh/builtins)**
* **[export/](spec/42sh/builtins/export)**
* [001-display-env](spec/42sh/builtins/export/001-display-env)
* [002-export-basic-key-value-1](spec/42sh/builtins/export/002-export-basic-key-value-1)
* [003-export-basic-key-value-2](spec/42sh/builtins/export/003-export-basic-key-value-2)
* [004-export-empty-variable-1](spec/42sh/builtins/export/004-export-empty-variable-1)
* [005-export-empty-variable-2](spec/42sh/builtins/export/005-export-empty-variable-2)
* [006-export-update-env-variable](spec/42sh/builtins/export/006-export-update-env-variable)
* [007-existing-environment-variable](spec/42sh/builtins/export/007-existing-environment-variable)
* [008-local-to-environment](spec/42sh/builtins/export/008-local-to-environment)
* [009-export-with-equal-but-no-value-part1](spec/42sh/builtins/export/009-export-with-equal-but-no-value-part1)
* [010-export-with-equal-but-no-value-part2](spec/42sh/builtins/export/010-export-with-equal-but-no-value-part2)
* **[errors/](spec/42sh/builtins/export/errors)**
* [001-invalid-identifier-1](spec/42sh/builtins/export/errors/001-invalid-identifier-1)
* [002-invalid-identifier-2](spec/42sh/builtins/export/errors/002-invalid-identifier-2)
* [003-illegal-option](spec/42sh/builtins/export/errors/003-illegal-option)
* **[mixed/](spec/42sh/builtins/export/mixed)**
* [001-export-and-tmp-env-part1](spec/42sh/builtins/export/mixed/001-export-and-tmp-env-part1)
* [002-export-and-tmp-env-part2](spec/42sh/builtins/export/mixed/002-export-and-tmp-env-part2)
* **[options/](spec/42sh/builtins/export/options)**
* [001-export-with-only-p-parameter](spec/42sh/builtins/export/options/001-export-with-only-p-parameter)
* [002-export-p-param-and-token-should-add-local-var-only-part1](spec/42sh/builtins/export/options/002-export-p-param-and-token-should-add-local-var-only-part1)
* [003-export-p-param-and-token-should-add-local-var-only-part2](spec/42sh/builtins/export/options/003-export-p-param-and-token-should-add-local-var-only-part2)
* [004-export-n-param](spec/42sh/builtins/export/options/004-export-n-param)
* **[escaping/](spec/42sh/escaping)**
* [001-escape-single-character-1](spec/42sh/escaping/001-escape-single-character-1)
* [002-escape-single-character-2](spec/42sh/escaping/002-escape-single-character-2)
* [003-escape-single-character-3](spec/42sh/escaping/003-escape-single-character-3)
* [004-escape-single-character-4](spec/42sh/escaping/004-escape-single-character-4)
* [005-escape-single-character-5](spec/42sh/escaping/005-escape-single-character-5)
* **[mixed/](spec/42sh/escaping/mixed)**
* **[globbing/](spec/42sh/escaping/mixed/globbing)**
* **[brace-expansion/](spec/42sh/escaping/mixed/globbing/brace-expansion)**
* [001-it-does-not-expand-braces-1](spec/42sh/escaping/mixed/globbing/brace-expansion/001-it-does-not-expand-braces-1)
* [002-it-expands-braces-1](spec/42sh/escaping/mixed/globbing/brace-expansion/002-it-expands-braces-1)
* [003-it-expands-braces-2](spec/42sh/escaping/mixed/globbing/brace-expansion/003-it-expands-braces-2)
* **[bracket-expansion/](spec/42sh/escaping/mixed/globbing/bracket-expansion)**
* [001-it-does-not-expand-brackets](spec/42sh/escaping/mixed/globbing/bracket-expansion/001-it-does-not-expand-brackets)
* [002-escaped-inversion-mark](spec/42sh/escaping/mixed/globbing/bracket-expansion/002-escaped-inversion-mark)
* [003-it-takes-escaped-bracket-as-pattern-character](spec/42sh/escaping/mixed/globbing/bracket-expansion/003-it-takes-escaped-bracket-as-pattern-character)
* **[variable-expansion/](spec/42sh/escaping/mixed/variable-expansion)**
* [001-escape-variable-1](spec/42sh/escaping/mixed/variable-expansion/001-escape-variable-1)
* [002-it-does-not-escape-variable](spec/42sh/escaping/mixed/variable-expansion/002-it-does-not-escape-variable)
* [003-escape-variable-2](spec/42sh/escaping/mixed/variable-expansion/003-escape-variable-2)
* **[globbing/](spec/42sh/globbing)**
* **[brace-expansion/](spec/42sh/globbing/brace-expansion)**
* **[ascii-range/](spec/42sh/globbing/brace-expansion/ascii-range)**
* [001-simple-ascending-1](spec/42sh/globbing/brace-expansion/ascii-range/001-simple-ascending-1)
* [002-simple-ascending-2](spec/42sh/globbing/brace-expansion/ascii-range/002-simple-ascending-2)
* [003-simple-ascending-3](spec/42sh/globbing/brace-expansion/ascii-range/003-simple-ascending-3)
* [004-simple-descending-1](spec/42sh/globbing/brace-expansion/ascii-range/004-simple-descending-1)
* [005-simple-descending-2](spec/42sh/globbing/brace-expansion/ascii-range/005-simple-descending-2)
* [006-simple-descending-3](spec/42sh/globbing/brace-expansion/ascii-range/006-simple-descending-3)
* [007-identical-start-and-end](spec/42sh/globbing/brace-expansion/ascii-range/007-identical-start-and-end)
* [008-multiple-1](spec/42sh/globbing/brace-expansion/ascii-range/008-multiple-1)
* [009-multiple-2](spec/42sh/globbing/brace-expansion/ascii-range/009-multiple-2)
* [010-big-range](spec/42sh/globbing/brace-expansion/ascii-range/010-big-range)
* **[errors/](spec/42sh/globbing/brace-expansion/errors)**
* [001-invalid-pattern-1](spec/42sh/globbing/brace-expansion/errors/001-invalid-pattern-1)
* [002-invalid-pattern-2](spec/42sh/globbing/brace-expansion/errors/002-invalid-pattern-2)
* [003-invalid-pattern-3](spec/42sh/globbing/brace-expansion/errors/003-invalid-pattern-3)
* [004-invalid-pattern-4](spec/42sh/globbing/brace-expansion/errors/004-invalid-pattern-4)
* **[list-of-values/](spec/42sh/globbing/brace-expansion/list-of-values)**
* [001-nothing-to-be-done](spec/42sh/globbing/brace-expansion/list-of-values/001-nothing-to-be-done)
* [002-simple-test-1](spec/42sh/globbing/brace-expansion/list-of-values/002-simple-test-1)
* [003-simple-test-2](spec/42sh/globbing/brace-expansion/list-of-values/003-simple-test-2)
* **[numeric-range/](spec/42sh/globbing/brace-expansion/numeric-range)**
* [001-simple-ascending-1](spec/42sh/globbing/brace-expansion/numeric-range/001-simple-ascending-1)
* [002-simple-ascending-2](spec/42sh/globbing/brace-expansion/numeric-range/002-simple-ascending-2)
* [003-simple-ascending-3](spec/42sh/globbing/brace-expansion/numeric-range/003-simple-ascending-3)
* [004-simple-ascending-4](spec/42sh/globbing/brace-expansion/numeric-range/004-simple-ascending-4)
* [005-simple-ascending-5](spec/42sh/globbing/brace-expansion/numeric-range/005-simple-ascending-5)
* [006-simple-descending-1](spec/42sh/globbing/brace-expansion/numeric-range/006-simple-descending-1)
* [007-simple-descending-2](spec/42sh/globbing/brace-expansion/numeric-range/007-simple-descending-2)
* [008-simple-descending-3](spec/42sh/globbing/brace-expansion/numeric-range/008-simple-descending-3)
* [009-simple-descending-4](spec/42sh/globbing/brace-expansion/numeric-range/009-simple-descending-4)
* [010-simple-descending-5](spec/42sh/globbing/brace-expansion/numeric-range/010-simple-descending-5)
* [011-identical-positive-start-and-end](spec/42sh/globbing/brace-expansion/numeric-range/011-identical-positive-start-and-end)
* [012-identical-negative-start-and-end](spec/42sh/globbing/brace-expansion/numeric-range/012-identical-negative-start-and-end)
* [013-multiple-1](spec/42sh/globbing/brace-expansion/numeric-range/013-multiple-1)
* [014-multiple-2](spec/42sh/globbing/brace-expansion/numeric-range/014-multiple-2)
* [015-big-range](spec/42sh/globbing/brace-expansion/numeric-range/015-big-range)
* **[bracket-expansion/](spec/42sh/globbing/bracket-expansion)**
* **[multi/](spec/42sh/globbing/bracket-expansion/multi)**
* [001-range-and-char](spec/42sh/globbing/bracket-expansion/multi/001-range-and-char)
* [002-reverse-range-and-chars](spec/42sh/globbing/bracket-expansion/multi/002-reverse-range-and-chars)
* [003-reverse-multi-hard](spec/42sh/globbing/bracket-expansion/multi/003-reverse-multi-hard)
* [004-simple-bracket+char+range](spec/42sh/globbing/bracket-expansion/multi/004-simple-bracket+char+range)
* **[not/](spec/42sh/globbing/bracket-expansion/not)**
* [001-simple-opposit-match](spec/42sh/globbing/bracket-expansion/not/001-simple-opposit-match)
* [002-simple-opposite-range](spec/42sh/globbing/bracket-expansion/not/002-simple-opposite-range)
* **[range-pattern/](spec/42sh/globbing/bracket-expansion/range-pattern)**
* [001-alpha-range](spec/42sh/globbing/bracket-expansion/range-pattern/001-alpha-range)
* [002-numeric-range](spec/42sh/globbing/bracket-expansion/range-pattern/002-numeric-range)
* [003-ascii-range-1](spec/42sh/globbing/bracket-expansion/range-pattern/003-ascii-range-1)
* [004-ascii-range-2](spec/42sh/globbing/bracket-expansion/range-pattern/004-ascii-range-2)
* **[simple-pattern/](spec/42sh/globbing/bracket-expansion/simple-pattern)**
* [001-simple-list](spec/42sh/globbing/bracket-expansion/simple-pattern/001-simple-list)
* [002-multi-bracket](spec/42sh/globbing/bracket-expansion/simple-pattern/002-multi-bracket)
* [003-brackets-as-pattern](spec/42sh/globbing/bracket-expansion/simple-pattern/003-brackets-as-pattern)
* [004-multi-bracket-multi-char](spec/42sh/globbing/bracket-expansion/simple-pattern/004-multi-bracket-multi-char)
* **[single-char-pattern/](spec/42sh/globbing/bracket-expansion/single-char-pattern)**
* [001-single-char](spec/42sh/globbing/bracket-expansion/single-char-pattern/001-single-char)
* [002-closing-bracket-char](spec/42sh/globbing/bracket-expansion/single-char-pattern/002-closing-bracket-char)
* [003-opening-bracket-char](spec/42sh/globbing/bracket-expansion/single-char-pattern/003-opening-bracket-char)
* **[local-variable/](spec/42sh/local-variable)**
* [001-declare-and-expand-1](spec/42sh/local-variable/001-declare-and-expand-1)
* [002-declare-and-expand-2](spec/42sh/local-variable/002-declare-and-expand-2)
* [003-unknown-variable-does-not-result-in-new-argument](spec/42sh/local-variable/003-unknown-variable-does-not-result-in-new-argument)
* [004-existing-variable-in-environment-1](spec/42sh/local-variable/004-existing-variable-in-environment-1)
* [005-existing-variable-in-environment-2](spec/42sh/local-variable/005-existing-variable-in-environment-2)
* [006-existing-variable-in-environment-3](spec/42sh/local-variable/006-existing-variable-in-environment-3)
* [007-multiple-declaration-at-a-time](spec/42sh/local-variable/007-multiple-declaration-at-a-time)
* [008-multiple-declaration-with-same-name](spec/42sh/local-variable/008-multiple-declaration-with-same-name)
* [009-last-exit-status](spec/42sh/local-variable/009-last-exit-status)
* **[mixed/](spec/42sh/local-variable/mixed)**
* **[inline-environment-variable/](spec/42sh/local-variable/mixed/inline-environment-variable)**
* [001-local-variable-shouldnt-be-set](spec/42sh/local-variable/mixed/inline-environment-variable/001-local-variable-shouldnt-be-set)
* **[redirections/](spec/42sh/local-variable/mixed/redirections)**
* [001-truncating](spec/42sh/local-variable/mixed/redirections/001-truncating)
* [002-appending](spec/42sh/local-variable/mixed/redirections/002-appending)
* [003-reading](spec/42sh/local-variable/mixed/redirections/003-reading)
* **[tilde-expansion/](spec/42sh/local-variable/mixed/tilde-expansion)**
* [001-process-tilde-expansion](spec/42sh/local-variable/mixed/tilde-expansion/001-process-tilde-expansion)
* **[quoting/](spec/42sh/quoting)**
* **[double-quotes/](spec/42sh/quoting/double-quotes)**
* [001-it-works](spec/42sh/quoting/double-quotes/001-it-works)
* [002-concatenated-strings](spec/42sh/quoting/double-quotes/002-concatenated-strings)
* [003-first-argument-inhibited](spec/42sh/quoting/double-quotes/003-first-argument-inhibited)
* [004-multiline-1](spec/42sh/quoting/double-quotes/004-multiline-1)
* [005-multiline-2](spec/42sh/quoting/double-quotes/005-multiline-2)
* **[mixed/](spec/42sh/quoting/double-quotes/mixed)**
* **[escaping/](spec/42sh/quoting/double-quotes/mixed/escaping)**
* [001-escape-double-quote-1](spec/42sh/quoting/double-quotes/mixed/escaping/001-escape-double-quote-1)
* [002-escape-double-quote-2](spec/42sh/quoting/double-quotes/mixed/escaping/002-escape-double-quote-2)
* [003-escape-double-quote-3](spec/42sh/quoting/double-quotes/mixed/escaping/003-escape-double-quote-3)
* [004-it-results-in-error](spec/42sh/quoting/double-quotes/mixed/escaping/004-it-results-in-error)
* [005-it-does-not-escape-double-quote](spec/42sh/quoting/double-quotes/mixed/escaping/005-it-does-not-escape-double-quote)
* **[globbing/](spec/42sh/quoting/double-quotes/mixed/globbing)**
* **[brace-expansion/](spec/42sh/quoting/double-quotes/mixed/globbing/brace-expansion)**
* [001-it-does-not-expand-braces-1](spec/42sh/quoting/double-quotes/mixed/globbing/brace-expansion/001-it-does-not-expand-braces-1)
* [002-it-does-not-expand-braces-2](spec/42sh/quoting/double-quotes/mixed/globbing/brace-expansion/002-it-does-not-expand-braces-2)
* [003-it-does-not-expand-braces-3](spec/42sh/quoting/double-quotes/mixed/globbing/brace-expansion/003-it-does-not-expand-braces-3)
* [004-it-does-not-expand-braces-4](spec/42sh/quoting/double-quotes/mixed/globbing/brace-expansion/004-it-does-not-expand-braces-4)
* [005-it-does-not-expand-braces-5](spec/42sh/quoting/double-quotes/mixed/globbing/brace-expansion/005-it-does-not-expand-braces-5)
* **[bracket-expansion/](spec/42sh/quoting/double-quotes/mixed/globbing/bracket-expansion)**
* [001-it-works-1](spec/42sh/quoting/double-quotes/mixed/globbing/bracket-expansion/001-it-works-1)
* [002-it-works-2](spec/42sh/quoting/double-quotes/mixed/globbing/bracket-expansion/002-it-works-2)
* **[variable-expansion/](spec/42sh/quoting/double-quotes/mixed/variable-expansion)**
* [001-expansion-enabled](spec/42sh/quoting/double-quotes/mixed/variable-expansion/001-expansion-enabled)
* **[mixed/](spec/42sh/quoting/mixed)**
* [001-simple-and-double-quotes](spec/42sh/quoting/mixed/001-simple-and-double-quotes)
* [002-multiline](spec/42sh/quoting/mixed/002-multiline)
* **[globbing/](spec/42sh/quoting/mixed/globbing)**
* **[brace-expansion/](spec/42sh/quoting/mixed/globbing/brace-expansion)**
* [001-it-does-not-expand-braces-1](spec/42sh/quoting/mixed/globbing/brace-expansion/001-it-does-not-expand-braces-1)
* **[bracket-expansion/](spec/42sh/quoting/mixed/globbing/bracket-expansion)**
* [001-it-works-1](spec/42sh/quoting/mixed/globbing/bracket-expansion/001-it-works-1)
* [002-it-works-2](spec/42sh/quoting/mixed/globbing/bracket-expansion/002-it-works-2)
* **[variable-expansion/](spec/42sh/quoting/mixed/variable-expansion)**
* [001-it-does-not-expand-in-quotes](spec/42sh/quoting/mixed/variable-expansion/001-it-does-not-expand-in-quotes)
* **[simple-quotes/](spec/42sh/quoting/simple-quotes)**
* [001-it-works](spec/42sh/quoting/simple-quotes/001-it-works)
* [002-concatenated-strings](spec/42sh/quoting/simple-quotes/002-concatenated-strings)
* [003-first-argument-inhibited](spec/42sh/quoting/simple-quotes/003-first-argument-inhibited)
* [004-multiline-1](spec/42sh/quoting/simple-quotes/004-multiline-1)
* [005-multiline-2](spec/42sh/quoting/simple-quotes/005-multiline-2)
* **[mixed/](spec/42sh/quoting/simple-quotes/mixed)**
* **[escaping/](spec/42sh/quoting/simple-quotes/mixed/escaping)**
* [001-escape-simple-quote-1](spec/42sh/quoting/simple-quotes/mixed/escaping/001-escape-simple-quote-1)
* [002-escape-simple-quote-2](spec/42sh/quoting/simple-quotes/mixed/escaping/002-escape-simple-quote-2)
* [003-escape-simple-quote-3](spec/42sh/quoting/simple-quotes/mixed/escaping/003-escape-simple-quote-3)
* [004-it-does-not-escape-simple-quote-1](spec/42sh/quoting/simple-quotes/mixed/escaping/004-it-does-not-escape-simple-quote-1)
* [005-it-does-not-escape-simple-quote-2](spec/42sh/quoting/simple-quotes/mixed/escaping/005-it-does-not-escape-simple-quote-2)
* **[globbing/](spec/42sh/quoting/simple-quotes/mixed/globbing)**
* **[brace-expansion/](spec/42sh/quoting/simple-quotes/mixed/globbing/brace-expansion)**
* [001-it-does-not-expand-braces-1](spec/42sh/quoting/simple-quotes/mixed/globbing/brace-expansion/001-it-does-not-expand-braces-1)
* [002-it-does-not-expand-braces-2](spec/42sh/quoting/simple-quotes/mixed/globbing/brace-expansion/002-it-does-not-expand-braces-2)
* [003-it-does-not-expand-braces-3](spec/42sh/quoting/simple-quotes/mixed/globbing/brace-expansion/003-it-does-not-expand-braces-3)
* [004-it-does-not-expand-braces-4](spec/42sh/quoting/simple-quotes/mixed/globbing/brace-expansion/004-it-does-not-expand-braces-4)
* [005-it-does-not-expand-braces-5](spec/42sh/quoting/simple-quotes/mixed/globbing/brace-expansion/005-it-does-not-expand-braces-5)
* **[bracket-expansion/](spec/42sh/quoting/simple-quotes/mixed/globbing/bracket-expansion)**
* [001-it-works-1](spec/42sh/quoting/simple-quotes/mixed/globbing/bracket-expansion/001-it-works-1)
* [002-it-works-2](spec/42sh/quoting/simple-quotes/mixed/globbing/bracket-expansion/002-it-works-2)
* **[variable-expansion/](spec/42sh/quoting/simple-quotes/mixed/variable-expansion)**
* [001-expansion-disabled](spec/42sh/quoting/simple-quotes/mixed/variable-expansion/001-expansion-disabled)
* **[shellscript/](spec/42sh/shellscript)**
* **[if/](spec/42sh/shellscript/if)**
* [001-simple-if-1](spec/42sh/shellscript/if/001-simple-if-1)
* [002-simple-if-2](spec/42sh/shellscript/if/002-simple-if-2)
* [003-simple-if-3](spec/42sh/shellscript/if/003-simple-if-3)
* [004-nested-if](spec/42sh/shellscript/if/004-nested-if)
* [005-hard-nested-if](spec/42sh/shellscript/if/005-hard-nested-if)
* **[until/](spec/42sh/shellscript/until)**
* [001-simple-until-1](spec/42sh/shellscript/until/001-simple-until-1)
* [002-simple-until-2](spec/42sh/shellscript/until/002-simple-until-2)
* [003-simple-until-3](spec/42sh/shellscript/until/003-simple-until-3)
* [004-nested-until](spec/42sh/shellscript/until/004-nested-until)
* [005-hard-nested-until](spec/42sh/shellscript/until/005-hard-nested-until)
* **[while/](spec/42sh/shellscript/while)**
* [001-simple-while-1](spec/42sh/shellscript/while/001-simple-while-1)
* [002-simple-while-2](spec/42sh/shellscript/while/002-simple-while-2)
* [003-simple-while-3](spec/42sh/shellscript/while/003-simple-while-3)
* [004-nested-while](spec/42sh/shellscript/while/004-nested-while)
* [005-hard-nested-while](spec/42sh/shellscript/while/005-hard-nested-while)
* **[subshell/](spec/42sh/subshell)**
* [001-tokens-are-recognized](spec/42sh/subshell/001-tokens-are-recognized)
* [002-multiple-levels-of-subshells](spec/42sh/subshell/002-multiple-levels-of-subshells)
* [003-multiline](spec/42sh/subshell/003-multiline)
* [004-exit-status](spec/42sh/subshell/004-exit-status)
* [005-copy-of-environment](spec/42sh/subshell/005-copy-of-environment)
* **[errors/](spec/42sh/subshell/errors)**
* [001-parse-error-1](spec/42sh/subshell/errors/001-parse-error-1)
* [002-parse-error-2](spec/42sh/subshell/errors/002-parse-error-2)
* [003-parse-error-3](spec/42sh/subshell/errors/003-parse-error-3)
* [004-parse-error-4](spec/42sh/subshell/errors/004-parse-error-4)
* **[mixed/](spec/42sh/subshell/mixed)**
* **[builtins/](spec/42sh/subshell/mixed/builtins)**
* **[cd/](spec/42sh/subshell/mixed/builtins/cd)**
* [001-it-does-not-change-current-directory](spec/42sh/subshell/mixed/builtins/cd/001-it-does-not-change-current-directory)
* [002-multiline](spec/42sh/subshell/mixed/builtins/cd/002-multiline)
* **[exit/](spec/42sh/subshell/mixed/builtins/exit)**
* [001-exiting-subshell](spec/42sh/subshell/mixed/builtins/exit/001-exiting-subshell)
* **[setenv/](spec/42sh/subshell/mixed/builtins/setenv)**
* [001-it-does-not-modify-parent-environment](spec/42sh/subshell/mixed/builtins/setenv/001-it-does-not-modify-parent-environment)
* **[unsetenv/](spec/42sh/subshell/mixed/builtins/unsetenv)**
* [001-it-does-not-modify-parent-environment](spec/42sh/subshell/mixed/builtins/unsetenv/001-it-does-not-modify-parent-environment)
* **[escaping/](spec/42sh/subshell/mixed/escaping)**
* [001-escaped-subshell-1](spec/42sh/subshell/mixed/escaping/001-escaped-subshell-1)
* [002-escaped-subshell-2](spec/42sh/subshell/mixed/escaping/002-escaped-subshell-2)
* **[inline-environment-variable/](spec/42sh/subshell/mixed/inline-environment-variable)**
* [001-modifies-the-child-environment-only-1](spec/42sh/subshell/mixed/inline-environment-variable/001-modifies-the-child-environment-only-1)
* [002-modifies-the-child-environment-only-2](spec/42sh/subshell/mixed/inline-environment-variable/002-modifies-the-child-environment-only-2)
* **[piping/](spec/42sh/subshell/mixed/piping)**
* [001-subshells-inside-piped-command](spec/42sh/subshell/mixed/piping/001-subshells-inside-piped-command)
* [002-pipes-inside-subshells](spec/42sh/subshell/mixed/piping/002-pipes-inside-subshells)
* [003-imbricated-subshells-and-pipes](spec/42sh/subshell/mixed/piping/003-imbricated-subshells-and-pipes)
* **[quoting/](spec/42sh/subshell/mixed/quoting)**
* [001-with-simple-quotes](spec/42sh/subshell/mixed/quoting/001-with-simple-quotes)
* [002-with-double-quotes](spec/42sh/subshell/mixed/quoting/002-with-double-quotes)
* [003-with-simple-and-double-quotes](spec/42sh/subshell/mixed/quoting/003-with-simple-and-double-quotes)
* **[bonuses/](spec/bonuses)**
* **[builtins/](spec/bonuses/builtins)**
* **[env/](spec/bonuses/builtins/env)**
* [001-unset-variables <img src='./lib/assets/non-posix.png' width='63' height='12' /> <img src='./lib/assets/pending.png' width='54' height='12' />](spec/bonuses/builtins/env/001-unset-variables)
* [002-unset-and-set-variable <img src='./lib/assets/non-posix.png' width='63' height='12' /> <img src='./lib/assets/pending.png' width='54' height='12' />](spec/bonuses/builtins/env/002-unset-and-set-variable)
* **[inline-environment-variable/](spec/bonuses/inline-environment-variable)**
* [001-modifies-child-environment-1](spec/bonuses/inline-environment-variable/001-modifies-child-environment-1)
* [002-modifies-child-environment-2](spec/bonuses/inline-environment-variable/002-modifies-child-environment-2)
* [003-modifies-PATH-only](spec/bonuses/inline-environment-variable/003-modifies-PATH-only)
* **[redirections/](spec/bonuses/redirections)**
* [001-append-twice-outputs-together <img src='./lib/assets/non-posix.png' width='63' height='12' /> <img src='./lib/assets/hard.png' width='38' height='12' /> <img src='./lib/assets/pending.png' width='54' height='12' />](spec/bonuses/redirections/001-append-twice-outputs-together)
* **[separators/](spec/bonuses/separators)**
* **[and/](spec/bonuses/separators/and)**
* [001-run-twice](spec/bonuses/separators/and/001-run-twice)
* [002-do-not-run-second](spec/bonuses/separators/and/002-do-not-run-second)
* [003-run-until-failing](spec/bonuses/separators/and/003-run-until-failing)
* **[errors/](spec/bonuses/separators/and/errors)**
* [001-parse-error-at-beginning](spec/bonuses/separators/and/errors/001-parse-error-at-beginning)
* [002-parse-error-too-much-symbol](spec/bonuses/separators/and/errors/002-parse-error-too-much-symbol)
* **[mixed/](spec/bonuses/separators/mixed)**
* [001-and-or](spec/bonuses/separators/mixed/001-and-or)
* [002-and-or](spec/bonuses/separators/mixed/002-and-or)
* [003-and-or](spec/bonuses/separators/mixed/003-and-or)
* [004-or-and](spec/bonuses/separators/mixed/004-or-and)
* [005-or-and](spec/bonuses/separators/mixed/005-or-and)
* [006-or-and](spec/bonuses/separators/mixed/006-or-and)
* **[or/](spec/bonuses/separators/or)**
* [001-run-first-only](spec/bonuses/separators/or/001-run-first-only)
* [002-run-second-only](spec/bonuses/separators/or/002-run-second-only)
* [003-run-until-succeeding](spec/bonuses/separators/or/003-run-until-succeeding)
* **[errors/](spec/bonuses/separators/or/errors)**
* [001-parse-error-at-beginning](spec/bonuses/separators/or/errors/001-parse-error-at-beginning)
* [002-parse-error-too-much-symbol](spec/bonuses/separators/or/errors/002-parse-error-too-much-symbol)
* **[tilde-expansion/](spec/bonuses/tilde-expansion)**
* [001-expanded-with-HOME-1](spec/bonuses/tilde-expansion/001-expanded-with-HOME-1)
* [002-expanded-with-HOME-2](spec/bonuses/tilde-expansion/002-expanded-with-HOME-2)
* [003-expanded-with-PWD-1](spec/bonuses/tilde-expansion/003-expanded-with-PWD-1)
* [004-expanded-with-PWD-2](spec/bonuses/tilde-expansion/004-expanded-with-PWD-2)
* [005-expanded-with-OLDPWD-1](spec/bonuses/tilde-expansion/005-expanded-with-OLDPWD-1)
* [006-expanded-with-OLDPWD-2](spec/bonuses/tilde-expansion/006-expanded-with-OLDPWD-2)
* **[not-expanded/](spec/bonuses/tilde-expansion/not-expanded)**
* [001-not-expanded-with-HOME-1](spec/bonuses/tilde-expansion/not-expanded/001-not-expanded-with-HOME-1)
* [002-not-expanded-with-HOME-2](spec/bonuses/tilde-expansion/not-expanded/002-not-expanded-with-HOME-2)
* [003-not-expanded-with-PWD](spec/bonuses/tilde-expansion/not-expanded/003-not-expanded-with-PWD)
* [004-not-expanded-with-OLDPWD](spec/bonuses/tilde-expansion/not-expanded/004-not-expanded-with-OLDPWD)
* **[minishell/](spec/minishell)**
* **[binary/](spec/minishell/binary)**
* [001-binary-path-relative](spec/minishell/binary/001-binary-path-relative)
* [002-binary-path-absolute](spec/minishell/binary/002-binary-path-absolute)
* [003-binary-test-exec-order](spec/minishell/binary/003-binary-test-exec-order)
* [004-binary-test-empty-path](spec/minishell/binary/004-binary-test-empty-path)
* [005-binary-test-wrong-path](spec/minishell/binary/005-binary-test-wrong-path)
* [006-binary-undefined-path](spec/minishell/binary/006-binary-undefined-path)
* [007-binary-permission-denied](spec/minishell/binary/007-binary-permission-denied)
* [008-binary-too-many-symbolic-links-encountered](spec/minishell/binary/008-binary-too-many-symbolic-links-encountered)
* **[builtins/](spec/minishell/builtins)**
* **[cd/](spec/minishell/builtins/cd)**
* [001-no-arg](spec/minishell/builtins/cd/001-no-arg)
* [002-current-directory](spec/minishell/builtins/cd/002-current-directory)
* [003-current-directory-2](spec/minishell/builtins/cd/003-current-directory-2)
* [004-parent-directory](spec/minishell/builtins/cd/004-parent-directory)
* [005-root-path](spec/minishell/builtins/cd/005-root-path)
* [006-root-path-2](spec/minishell/builtins/cd/006-root-path-2)
* [007-symbolic-link](spec/minishell/builtins/cd/007-symbolic-link)
* [008-symbolic-link-2](spec/minishell/builtins/cd/008-symbolic-link-2)
* [009-following-links <img src='./lib/assets/hard.png' width='38' height='12' />](spec/minishell/builtins/cd/009-following-links)
* [010-update-OLDPWD](spec/minishell/builtins/cd/010-update-OLDPWD)
* [011-dotdot](spec/minishell/builtins/cd/011-dotdot)
* [012-dot](spec/minishell/builtins/cd/012-dot)
* [013-absolute-path](spec/minishell/builtins/cd/013-absolute-path)
* **[errors/](spec/minishell/builtins/cd/errors)**
* [001-not-a-directory](spec/minishell/builtins/cd/errors/001-not-a-directory)
* [002-not-a-directory-2](spec/minishell/builtins/cd/errors/002-not-a-directory-2)
* [003-permission-denied](spec/minishell/builtins/cd/errors/003-permission-denied)
* [004-permission-denied-2](spec/minishell/builtins/cd/errors/004-permission-denied-2)
* [005-too-many-symbolic-links-encountered](spec/minishell/builtins/cd/errors/005-too-many-symbolic-links-encountered)
* [006-too-many-symbolic-links-encountered-2](spec/minishell/builtins/cd/errors/006-too-many-symbolic-links-encountered-2)
* [007-no-such-file-or-directory](spec/minishell/builtins/cd/errors/007-no-such-file-or-directory)
* [008-no-such-file-or-directory-2](spec/minishell/builtins/cd/errors/008-no-such-file-or-directory-2)
* [009-no-such-file-or-directory-symlink](spec/minishell/builtins/cd/errors/009-no-such-file-or-directory-symlink)
* [010-no-such-file-or-directory-symlink-2](spec/minishell/builtins/cd/errors/010-no-such-file-or-directory-symlink-2)
* **[options/](spec/minishell/builtins/cd/options)**
* [001-not-following-links](spec/minishell/builtins/cd/options/001-not-following-links)
* [002-oldpwd](spec/minishell/builtins/cd/options/002-oldpwd)
* **[env/](spec/minishell/builtins/env)**
* [001-env-same-value-as-parent](spec/minishell/builtins/env/001-env-same-value-as-parent)
* [002-env-check-usefull-var](spec/minishell/builtins/env/002-env-check-usefull-var)
* [003-ignore-environment](spec/minishell/builtins/env/003-ignore-environment)
* [005-set-variables](spec/minishell/builtins/env/005-set-variables)
* **[errors/](spec/minishell/builtins/env/errors)**
* [001-command-not-found](spec/minishell/builtins/env/errors/001-command-not-found)
* [002-illegal-option](spec/minishell/builtins/env/errors/002-illegal-option)
* **[multiple-options/](spec/minishell/builtins/env/multiple-options)**
* [001-ignore-environment-and-set-variable](spec/minishell/builtins/env/multiple-options/001-ignore-environment-and-set-variable)
* **[exit/](spec/minishell/builtins/exit)**
* [001-without-any-argument](spec/minishell/builtins/exit/001-without-any-argument)
* [002-status-passed-as-argument](spec/minishell/builtins/exit/002-status-passed-as-argument)
* [003-status-of-last-command](spec/minishell/builtins/exit/003-status-of-last-command)
* **[errors/](spec/minishell/builtins/exit/errors)**
* [001-too-many-args](spec/minishell/builtins/exit/errors/001-too-many-args)
* [002-non-numeric-argument](spec/minishell/builtins/exit/errors/002-non-numeric-argument)
* **[mixed/](spec/minishell/builtins/mixed)**
* [001-setenv-unsetenv](spec/minishell/builtins/mixed/001-setenv-unsetenv)
* **[setenv/](spec/minishell/builtins/setenv)**
* [001-no-argument](spec/minishell/builtins/setenv/001-no-argument)
* [002-add-new-variable](spec/minishell/builtins/setenv/002-add-new-variable)
* [003-set-existing-variable](spec/minishell/builtins/setenv/003-set-existing-variable)
* [004-invalid-identifier](spec/minishell/builtins/setenv/004-invalid-identifier)
* [005-add-and-set-multiple-variables](spec/minishell/builtins/setenv/005-add-and-set-multiple-variables)
* **[unsetenv/](spec/minishell/builtins/unsetenv)**
* [001-unsetenv-first-elem](spec/minishell/builtins/unsetenv/001-unsetenv-first-elem)
* [002-unsetenv-mult-envp](spec/minishell/builtins/unsetenv/002-unsetenv-mult-envp)
* [003-unsetenv-mult-envp-inline](spec/minishell/builtins/unsetenv/003-unsetenv-mult-envp-inline)
* **[misc/](spec/minishell/misc)**
* [001-copy-of-environment](spec/minishell/misc/001-copy-of-environment)
<!--END_LIST_TESTS-->
# Development
## Coding convention
* Scope indentation must be done with 2 spaces
* Variable names must be upper case (e.g. `INDEX`)
* Global variables must be prefixed with `GLOBAL_` (e.g. `GLOBAL_TOKEN`)
* Variable expansion must be surrounded by curly braces (e.g. `${VARIABLE}`)
* Arguments of functions and commands must be surrounded by double or simple quotes (e.g. `run_assert "STDERR"`)
* Semicolon are banned so that words like `then` and `do` are always at start of lines (e.g. wrong inline code: `if [ ... ]; then cmd; fi`)
* Folder names may only contain alphanumeric and `-`
## Adding new test
An integration test must be **self-sufficient**, that means executing the full test suite or only one test must result in the same failed or success status. The framework 42ShellTester brings you tools for that!
Firstly, tests are executed inside a temporary folder `tmp/` that is created at launch time and placed at the root installation folder of the framework. You may generate temporary files, binaries and folders that are needed for your test, but pay attention to not touch external folders. Use the `before_exec` callback to generate these resources.
Secondly, each test is executed within a sub-shell, so that you may modify the environment without disrupting the test suite. Use the `before_exec` callback to modify the environment.
Thirdly, a test must concern one single feature at a time, that means **wherever possible** you must avoid the use of multiple builtins or capabilities (e.g. do not use a pipe `|` within a test that concerns the builtin `env`, or again use absolute paths to binaries like `/bin/ls` to let the Shell implementation not support the `PATH`, except if you precisely test this feature!).
Fourthly, when a test need binaries like `/bin/env` or `/bin/echo`, prefer to recode your own, simplier and multi-platform, and place it in `support/` folder. Then use the `before_exec` callback to compile it and make it available for your test.
Sixthly, a test that is not POSIX compliant must contain a file named `non-posix` containing a small explanation of why.
Finally, don't write a README and let the task `generate_readmes` do it for you :-) A description may be added in a file named `description` that will appear at the top of the README.
Follow the guideline to add a new test:
1. Create a sub-folder in `spec/` (e.g. `spec/minishell/builtin/cd/new-test/`)
2. If necessary, create a file `before_exec` that contains the shell commands that prepare the environment and the temporary resources (e.g. `mkdir valid_folder`)
2. Create a file `stdin` that contains the shell command you want to test (e.g. `cd invalid_folder`)
3. Create the files `stdout` and/or `stderr` that contain the expected output assertions (e.g. in stderr: `expected_to_not be_empty`) (see available assertions and verbs bellow)
4. You may also create a file `misc` that contains special expectations not concerning output on standard and error (e.g. `expected_to_not exit_with_status 0`)
5. If necessary, create a file `description` that describes more precisely the purpose of the test (e.g. `Trying to access invalid folder must display an error on standard error and result in a failure status code`) (the description will be included at top of the auto-generated README)
6. If the test is not POSIX compliant, create a file `non-posix` that explains why.
## Assertions
* **`expected_to`** / **`expected_to_not`** + *`verb`*: An assertion beginning with **expected_to** (or its opposite **expected_to_not**) makes the test resulting in failure status if the expectation that follows **does not** comply.
* **`might`** / **`might_not`** + *`verb`*: An assertion beginning with **might** (or its opposite **might_not**) always makes the test resulting in success status. When the expectation that follows **may not** comply, it is nevertheless considered as success but it displays a warning message.
## Verbs
* **`be_empty`**: Actual output is empty.
* **`create_file`** + *`$filename`*: Actual command creates a file named *$filename*. May also be followed with a file test:
* **`matching_regex`** + *`$regex`*: At least one line of the file matches with the regular expression *$regex*.
* **`not_matching_regex`** + *`$regex`*: Any line of the file does match with the regular expression *$regex*.
* **`with_nb_of_lines`** + *`$int`*: The file contains exactly *$int* lines.
* **`exit_with_status`** + *`$int`*: The Shell termination results in the exit status *$int*.
* **`have_nb_of_lines`** + *`$int`*: Actual output contains exactly *$int* lines.
* **`match_regex`** + *`$regex`*: At least one line of actual output does match with the regular expression *$regex*.
* **`once`**: The matching is limited to only one occurrence.
* *`$int`* **`times`**: The matching must exactly occur *$int* times.
* **`match_each_regex_of_file`** + *`$filename`*: Actual output does match with each regular expression contained in the file named *$filename* (in an indifferent order).
## Adding new verb
A verb is a function that is prefixed by `run_verb_` and that returns `0` or `1` according to the tested behavior. It may return a status `255` when bad or missing argument.
At runtime, the framework provides a list of variables that can be used by the verbs:
* **`RESPONSE`**: The path to the file containing actual output (STDOUT or STDERR)
* **`RESPONSE_EXIT_STATUS`**: The exit status of the Shell termination
* **`EXPECTED_TO_ARGS[]`**: An array containing the arguments following the verb
Follow the guideline to add a new verb:
1. Choose the best name that respects the *CamelCase* convention and that can be human-readable when used with an assertion (e.g. `expected_to be_empty` can be read `actual output is expected to be empty`)
2. Create a file in `lib/verbs/` with the exact name of the verb and that is prefixed with `run_verb_` (e.g. `lib/verbs/run_verb_be_empty.sh`
3. Add a *shebang*: `#!/bin/sh` and a comment that describes the tested behavior
4. Create a function with the exact name of the verb and that is prefixed with `run_verb_` (the same as the file name) and make it respect the following rules:
* Local variables must be declared with `local`
* No output can be done with `echo` or `printf`
* Function returns `0` on succes, `1` on fail or `255` on bad use
* Use the array `EXPECTED_TO_ARGS[]` to take advantage of arguments (e.g. `expected_to match_regex "regex"`, then `EXPECTED_TO_ARGS[0]` contains `regex`)
## Support binaries
The framework 42ShellTester provides several binaries to be used within the tests. Using them instead of using Unix binaries prevents from undefined behaviors and compatibility errors.
Find the available list of support binaries bellow:
<!--START_SUPPORT_BINARIES_LIST-->
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)**: A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)**: A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)**: A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)**: A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)**: A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)**: A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)**: A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)**: A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)**: A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)**: A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)**: A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)**: A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)**: A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".
<!--END_SUPPORT_BINARIES_LIST-->
## Tasks
* `bash ./tasks/generate_readmes.sh` (only on master branch) to automaticaly generate the README files of tests
# The Team
* **Adrien Nouvel** [@anouvel](https://github.com/anouvel)
* **Gabriel Kuma** [@gabkk](https://github.com/gabkk)
* **Jean-Michel Gigault** [@jgigault](https://github.com/jgigault)
## Logo credits
Edouard Audeguy
Illustrateur / Infographiste
https://edouardaudeguy.wix.com/portfolio
# 42shelltest-tmp

145
42sh/42shelltest-tmp/lib/assert.sh Normal file
View file

@ -0,0 +1,145 @@
#!/bin/bash
# /*
# Assert logic
#
# run_assert
# @param -> prefix applied to output file name
# @param -> output that is tested (STDOUT, STDERR or MISC)
# function that:
# - sets the variable RESPONSE with the path of the file that stores the actual output
# - iterates over the current test configuration file ('stdout', 'stderr' or 'misc')
# - calls the expected type of assertion ('expected', 'might' or their opposite)
#
# run_expected_to
# run_expected_to_not
# run_might
# run_might_to
# @param -> current test (e.g. 'expected_to be_empty')
# functions that calls the verbs and treats their exit status
# */
run_assert()
{
local LINE
local PREFIX_STD="${1}"
local EXPECTED_STD="RESPONSE_${PREFIX_STD}${2}"
local RESPONSE="${!EXPECTED_STD}"
local EXPECTED_STD_NAME="${2}"
local RESPONSE_EXIT_STATUS_VAR="${PREFIX_STD}EXIT_STATUS"
local RESPONSE_EXIT_STATUS="${!RESPONSE_EXIT_STATUS_VAR}"
local TEST_CMD
local OLD_IFS="${IFS}"
local ASSERT_STATUS="0"
local CURRENT_ASSERT_STATUS
local DISPLAY_LINE
IFS=$'\n'
for LINE in $(awk '{gsub(/\\\\/, "\\\\\\\\\\\\\\\\"); print}' "${TEST}/$(echo "${EXPECTED_STD_NAME}" | awk '{print tolower($0)}')")
do
TEST_CMD="$(echo "${LINE}" | awk '{ print $1 }')"
DISPLAY_LINE="$(printf "${LINE}" | awk -v GLOBAL_TOKEN="${GLOBAL_TOKEN}" -v GLOBAL_INSTALLDIR="${GLOBAL_INSTALLDIR}" -v GLOBAL_TMP_DIRECTORY="${GLOBAL_TMP_DIRECTORY}" -v PATH="${PATH}" -v HOME="${HOME}" '{i=1; while(i <= NF) {gsub(/^"/, "`", $i); gsub(/"$/, "`", $i); i++}; gsub(/\\\\\\\\/, "\\"); gsub(/\$\{GLOBAL_TOKEN\}/, GLOBAL_TOKEN); gsub(/\$\{GLOBAL_INSTALLDIR\}/, GLOBAL_INSTALLDIR); gsub(/\$\{GLOBAL_TMP_DIRECTORY\}/, GLOBAL_TMP_DIRECTORY); gsub(/\$\{PATH\}/, PATH); gsub(/\$\{HOME\}/, HOME); print}')"
eval "run_${TEST_CMD}" ${LINE}
CURRENT_ASSERT_STATUS="${?}"
if [ "${CURRENT_ASSERT_STATUS}" != "0" ]
then
[ "${ASSERT_STATUS}" == "0" -o "${ASSERT_STATUS}" == "2" ] && ASSERT_STATUS="${CURRENT_ASSERT_STATUS}"
fi
done
IFS="${OLD_IFS}"
return "${ASSERT_STATUS}"
}
run_expected_to()
{
shift 1
local EXPECTED_TO_CMD="${1}"
shift 1
local -a EXPECTED_TO_ARGS='(${@})'
local ASSERT_STATUS
eval "run_verb_${EXPECTED_TO_CMD}"
ASSERT_STATUS="${?}"
case "${ASSERT_STATUS}" in
0)
printf "${C_GREEN} %-10s %s${C_CLEAR}\n" "SUCCESS" "${DISPLAY_LINE}" ;;
1)
printf "${C_RED} %-10s %s${C_CLEAR}\n" "FAILURE" "${DISPLAY_LINE}" ;;
255)
printf "${C_RED} [!] INVALID TEST COMMAND: %s${C_CLEAR}\n" "${DISPLAY_LINE}" ;;
esac
return "${ASSERT_STATUS}"
}
run_expected_to_not()
{
shift 1
local EXPECTED_TO_CMD="${1}"
shift 1
local -a EXPECTED_TO_ARGS='(${@})'
local ASSERT_STATUS
eval "run_verb_${EXPECTED_TO_CMD}"
ASSERT_STATUS="${?}"
case "${ASSERT_STATUS}" in
1)
ASSERT_STATUS="0"
printf "${C_GREEN} %-10s %s${C_CLEAR}\n" "SUCCESS" "${DISPLAY_LINE}" ;;
0)
ASSERT_STATUS="1"
printf "${C_RED} %-10s %s${C_CLEAR}\n" "FAILURE" "${DISPLAY_LINE}" ;;
255)
printf "${C_RED} [!] INVALID TEST COMMAND: %s${C_CLEAR}\n" "${DISPLAY_LINE}" ;;
esac
return "${ASSERT_STATUS}"
}
run_might()
{
shift 1
local EXPECTED_TO_CMD="${1}"
shift 1
local -a EXPECTED_TO_ARGS='(${@})'
local ASSERT_STATUS
eval "run_verb_${EXPECTED_TO_CMD}"
ASSERT_STATUS="${?}"
case "${ASSERT_STATUS}" in
0)
printf "${C_GREEN} %-10s %s${C_CLEAR}\n" "SUCCESS" "${DISPLAY_LINE}" ;;
1)
ASSERT_STATUS="2"
printf "${C_YELLOW} %-10s %s${C_CLEAR}\n" "WARNING" "${DISPLAY_LINE}" ;;
255)
printf "${C_RED} [!] INVALID TEST COMMAND: %s${C_CLEAR}\n" "${DISPLAY_LINE}" ;;
esac
return "${ASSERT_STATUS}"
}
run_might_not()
{
shift 1
local EXPECTED_TO_CMD="${1}"
shift 1
local -a EXPECTED_TO_ARGS='(${@})'
local ASSERT_STATUS
eval "run_verb_${EXPECTED_TO_CMD}"
ASSERT_STATUS="${?}"
case "${ASSERT_STATUS}" in
1)
ASSERT_STATUS="0"
printf "${C_GREEN} %-10s %s${C_CLEAR}\n" "SUCCESS" "${DISPLAY_LINE}" ;;
0)
ASSERT_STATUS="2"
printf "${C_YELLOW} %-10s %s${C_CLEAR}\n" "WARNING" "${DISPLAY_LINE}" ;;
255)
printf "${C_RED} [!] INVALID TEST COMMAND: ${EXPECTED_STD_NAME} %s${C_CLEAR}\n" "${DISPLAY_LINE}" ;;
esac
return "${ASSERT_STATUS}"
}

21
42sh/42shelltest-tmp/lib/assets/42ShellTester.ascii Normal file
View file

@ -0,0 +1,21 @@
#### ########
#### ## ####
#### #####
########### ##### #
########### ########
####
################### ####
###################
###################
################### #####
########## #####
########## ############
########## ############
# ########## ############
### ######### #####
##### ####### #####
####### ##### #####
######### ### #####
####
###
##

BIN
42sh/42shelltest-tmp/lib/assets/42ShellTester.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 88 KiB

BIN
42sh/42shelltest-tmp/lib/assets/42ShellTester_250x250.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 12 KiB

BIN
42sh/42shelltest-tmp/lib/assets/42ShellTester_416x416.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 20 KiB

BIN
42sh/42shelltest-tmp/lib/assets/42ShellTester_cropped.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 21 KiB

BIN
42sh/42shelltest-tmp/lib/assets/42shTestsTeamLogo.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 5 KiB

BIN
42sh/42shelltest-tmp/lib/assets/42shTestsTeamLogo_sm.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 5.2 KiB

5
42sh/42shelltest-tmp/lib/assets/README.md Normal file
View file

@ -0,0 +1,5 @@
## logo credits
<img align="right" src="./42ShellTester_cropped.png" width="45%" />Edouard Audeguy
Illustrateur / Infographiste
https://edouardaudeguy.wix.com/portfolio

BIN
42sh/42shelltest-tmp/lib/assets/hard.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 570 B

BIN
42sh/42shelltest-tmp/lib/assets/non-posix.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 725 B

BIN
42sh/42shelltest-tmp/lib/assets/pending.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 654 B

280
42sh/42shelltest-tmp/lib/main.sh Normal file
View file

@ -0,0 +1,280 @@
#!/bin/bash
# /*
# Main function
#
# run_main
# function that:
# - iterates over the spec folder
# - executes the tests and their callbacks
# - displays the results
# */
run_main()
{
local TEST
local TEST_NAME
local TEST_FULLNAME
local RESULT
local RESPONSE_STDOUT
local RESPONSE_STDERR
local EXIT_STATUS
local RESPONSE_REFERENCE_STDOUT
local RESPONSE_REFERENCE_STDERR
local REFERENCE_EXIT_STATUS
local RUN_TEST
local RUN_ASSERT
local TEST_STATUS
local ASSERT_STATUS
local LOG_CURRENT_TEST
local LOG_CURRENT_TEST_STDOUT
local LOG_CURRENT_TEST_STDERR
local LOG_CURRENT_TEST_MISC
local LOG_SUCCESS_TESTS
local LOG_FAILED_TESTS
local AWK_PATH="$(which "awk")"
local OLD_IFS="${IFS}"
local UNAME=`uname`
local FIND="find"
# Use find instead find -E on Linux
if [ {UNAME} == "Darwin" ]; then
FIND= "find -E"
fi
if [ ! -f "${GLOBAL_PROG}" ]
then
[ "${GLOBAL_PROG}" == "" ] && printf "%s\n" "Missing argument: specify the binary to test" && return
[ ! -f "${GLOBAL_PROG}" -a ! -f "$(which "${GLOBAL_PROG}")" ] && printf "%s\n" "Wrong argument: no such file '"${GLOBAL_PROG}"'" && return
fi
IFS=$'\n'
for TEST in $(${FIND} "${GLOBAL_INSTALLDIR}/spec" -type d -regex "${GLOBAL_INSTALLDIR}/spec/.*${GLOBAL_SPECS_FILTER}.*")
do
[ -f "${TEST}/pending" -a "${GLOBAL_RUN_PENDING_TESTS}" == "0" ] && (( GLOBAL_TOTAL_PENDING_TESTS = GLOBAL_TOTAL_PENDING_TESTS + 1 ))
if [ -f "${TEST}/stdin" ] && [ ! -f "${TEST}/non-posix" -o "${GLOBAL_RUN_POSIX_ONLY}" == "0" ] && [ ! -f "${TEST}/pending" -o "${GLOBAL_RUN_PENDING_TESTS}" == "1" -o "${GLOBAL_RUN_ALL_TESTS}" == "1" ] && [ ! -f "${TEST}/hard" -o "${GLOBAL_RUN_HARD_TESTS}" == "1" -o "${GLOBAL_RUN_ALL_TESTS}" == "1" ]
then
# compile support binaries
make -C "${GLOBAL_INSTALLDIR}/support/" TARGET_DIR=${GLOBAL_TMP_DIRECTORY} 1>- 2>-
TEST_NAME="${TEST##*/}"
TEST_FULLNAME="${TEST##*spec/}"
RUN_TEST=0
TEST_STATUS="0"
LOG_CURRENT_TEST="${TEST_FULLNAME}"
LOG_CURRENT_TEST_STDOUT=""
LOG_CURRENT_TEST_STDERR=""
LOG_CURRENT_TEST_MISC=""
RESPONSE_STDOUT="${GLOBAL_TMP_DIRECTORY}/${TEST_FULLNAME//\//-}.stdout"
RESPONSE_STDERR="${GLOBAL_TMP_DIRECTORY}/${TEST_FULLNAME//\//-}.stderr"
RESPONSE_REFERENCE_STDOUT="${GLOBAL_TMP_DIRECTORY}/${TEST_FULLNAME//\//-}.ref.stdout"
RESPONSE_REFERENCE_STDERR="${GLOBAL_TMP_DIRECTORY}/${TEST_FULLNAME//\//-}.ref.stderr"
rm -f "${GLOBAL_TMP_DIRECTORY}/stdin"
local INDEX=1
local LINE
local TOTAL=$(awk 'END {print NR+1}' "${TEST}/stdin")
while [ "$INDEX" -le "$TOTAL" ]
do
awk -v INDEX="${INDEX}" -v GLOBAL_TOKEN="${GLOBAL_TOKEN}" -v GLOBAL_INSTALLDIR="${GLOBAL_INSTALLDIR}" -v GLOBAL_TMP_DIRECTORY="${GLOBAL_TMP_DIRECTORY}" -v PATH="${PATH}" -v HOME="${HOME}" 'NR == INDEX {gsub(/\$\{GLOBAL_TOKEN\}/, GLOBAL_TOKEN); gsub(/\$\{GLOBAL_INSTALLDIR\}/, GLOBAL_INSTALLDIR); gsub(/\$\{GLOBAL_TMP_DIRECTORY\}/, GLOBAL_TMP_DIRECTORY); gsub(/\$\{PATH\}/, PATH); gsub(/\$\{HOME\}/, HOME); print; exit}' "${TEST}/stdin" >>"${GLOBAL_TMP_DIRECTORY}/stdin"
(( INDEX += 1 ))
done
(
SUBSHELL_EXIT_STATUS=
if [ -f "${TEST}/before_exec" ]
then
local INDEX=0
local TOTAL=$(${AWK_PATH} 'END {print NR+1}' "${TEST}/before_exec")
while [ "$INDEX" -le "$TOTAL" ]
do
eval $(${AWK_PATH} -v INDEX="${INDEX}" 'NR == INDEX {print $0; exit}' "${TEST}/before_exec")
(( INDEX += 1 ))
done
fi
eval "${GLOBAL_PROG}" < "${GLOBAL_TMP_DIRECTORY}/stdin" 1> "${RESPONSE_STDOUT}.raw" 2> "${RESPONSE_STDERR}.raw"
SUBSHELL_EXIT_STATUS=${?}
if [ -f "${TEST}/after_exec" ]
then
local INDEX=0
local TOTAL=$(${AWK_PATH} 'END {print NR+1}' "${TEST}/after_exec")
while [ "$INDEX" -le "$TOTAL" ]
do
eval $(${AWK_PATH} -v INDEX="${INDEX}" 'NR == INDEX {print $0; exit}' "${TEST}/after_exec")
(( INDEX += 1 ))
done
fi
exit "${SUBSHELL_EXIT_STATUS}"
)
EXIT_STATUS=${?}
awk '{gsub(/\033\[[0-9;]*m/, ""); print}' "${RESPONSE_STDOUT}.raw" > "${RESPONSE_STDOUT}"
awk '{gsub(/\033\[[0-9;]*m/, ""); print}' "${RESPONSE_STDERR}.raw" > "${RESPONSE_STDERR}"
if [ "${GLOBAL_PROG_REFERENCE}" != "" ]
then
(
SUBSHELL_EXIT_STATUS=
if [ -f "${TEST}/before_exec" ]
then
local INDEX=0
local TOTAL=$(${AWK_PATH} 'END {print NR+1}' "${TEST}/before_exec")
while [ "$INDEX" -le "$TOTAL" ]
do
eval $(${AWK_PATH} -v INDEX="${INDEX}" 'NR == INDEX {print $0; exit}' "${TEST}/before_exec")
(( INDEX += 1 ))
done
fi
eval "${GLOBAL_PROG_REFERENCE}" < "${GLOBAL_TMP_DIRECTORY}/stdin" 1> "${RESPONSE_REFERENCE_STDOUT}.raw" 2> "${RESPONSE_REFERENCE_STDERR}.raw"
SUBSHELL_EXIT_STATUS=${?}
if [ -f "${TEST}/after_exec" ]
then
local INDEX=0
local TOTAL=$(${AWK_PATH} 'END {print NR+1}' "${TEST}/after_exec")
while [ "$INDEX" -le "$TOTAL" ]
do
eval $(${AWK_PATH} -v INDEX="${INDEX}" 'NR == INDEX {print $0; exit}' "${TEST}/after_exec")
(( INDEX += 1 ))
done
fi
exit "${SUBSHELL_EXIT_STATUS}"
)
REFERENCE_EXIT_STATUS=${?}
awk '{gsub(/\033\[[0-9;]*m/, ""); print}' "${RESPONSE_REFERENCE_STDOUT}.raw" > "${RESPONSE_REFERENCE_STDOUT}"
awk '{gsub(/\033\[[0-9;]*m/, ""); print}' "${RESPONSE_REFERENCE_STDERR}.raw" > "${RESPONSE_REFERENCE_STDERR}"
fi
if [ -f "${TEST}/stdout" ]
then
RUN_ASSERT="0"
if [ "${GLOBAL_PROG_REFERENCE}" != "" ]
then
run_assert "REFERENCE_" "STDOUT" 1>- 2>-
RUN_ASSERT="${?}"
fi
if [ "${RUN_ASSERT}" == "0" ]
then
LOG_CURRENT_TEST_STDOUT="$(run_assert "" "STDOUT")"
ASSERT_STATUS="${?}"
if [ "${ASSERT_STATUS}" != "0" ]
then
[ "${TEST_STATUS}" == "0" -o "${TEST_STATUS}" == "2" ] && TEST_STATUS="${ASSERT_STATUS}"
fi
RUN_TEST=1
fi
fi
if [ -f "${TEST}/stderr" ]
then
RUN_ASSERT="0"
if [ "${GLOBAL_PROG_REFERENCE}" != "" ]
then
run_assert "REFERENCE_" "STDERR" 1>- 2>-
RUN_ASSERT="${?}"
fi
if [ "${RUN_ASSERT}" == "0" ]
then
LOG_CURRENT_TEST_STDERR="$(run_assert "" "STDERR")"
ASSERT_STATUS="${?}"
if [ "${ASSERT_STATUS}" != "0" ]
then
[ "${TEST_STATUS}" == "0" -o "${TEST_STATUS}" == "2" ] && TEST_STATUS="${ASSERT_STATUS}"
fi
RUN_TEST=1
fi
fi
if [ -f "${TEST}/misc" ]
then
RUN_ASSERT="0"
if [ "${GLOBAL_PROG_REFERENCE}" != "" ]
then
run_assert "REFERENCE_" "MISC" 1>- 2>-
RUN_ASSERT="${?}"
fi
if [ "${RUN_ASSERT}" == "0" ]
then
LOG_CURRENT_TEST_MISC="$(run_assert "" "MISC")"
ASSERT_STATUS="${?}"
if [ "${ASSERT_STATUS}" != "0" ]
then
[ "${TEST_STATUS}" == "0" -o "${TEST_STATUS}" == "2" ] && TEST_STATUS="${ASSERT_STATUS}"
fi
RUN_TEST=1
fi
fi
if [ "${RUN_TEST}" == "1" ]
then
(( GLOBAL_TOTAL_TESTS = GLOBAL_TOTAL_TESTS + 1 ))
if [ "${TEST_STATUS}" != "0" -o "${GLOBAL_SHOW_SUCCESS}" == "1" ]
then
GLOBAL_LOG="$(printf "%s\n\n%s\n\n${C_BOLD}%s${C_CLEAR}" "${GLOBAL_LOG}" "----------------------------------------------------------------" "${LOG_CURRENT_TEST}")"
case "${TEST_STATUS}" in
0) GLOBAL_LOG="$(printf "%s ${C_GREEN}%s${C_CLEAR}" "${GLOBAL_LOG}" "(SUCCESS)")" ;;
1) GLOBAL_LOG="$(printf "%s ${C_RED}%s${C_CLEAR}" "${GLOBAL_LOG}" "(FAILED)")" ;;
2) GLOBAL_LOG="$(printf "%s ${C_YELLOW}%s${C_CLEAR}" "${GLOBAL_LOG}" "(WARNING)")" ;;
255) GLOBAL_LOG="$(printf "%s ${C_RED}%s${C_CLEAR}" "${GLOBAL_LOG}" "(RUNTIME ERROR)")" ;;
esac
[ -f "${TEST}/description" ] && GLOBAL_LOG="$(printf "%s\n\n Description:\n${C_GREY}%s${C_CLEAR}" "${GLOBAL_LOG}" "$(awk '{printf " %s\n", $0}' "${TEST}/description")")"
[ -f "${TEST}/before_exec" ] && GLOBAL_LOG="$(printf "%s\n\n Before test:\n${C_GREY}%s${C_CLEAR}" "${GLOBAL_LOG}" "$(awk -v GLOBAL_TOKEN="${GLOBAL_TOKEN}" -v GLOBAL_INSTALLDIR="${GLOBAL_INSTALLDIR}" -v GLOBAL_TMP_DIRECTORY="${GLOBAL_TMP_DIRECTORY}" -v PATH="${PATH}" -v HOME="${HOME}" '{gsub(/\$\{GLOBAL_TOKEN\}/, GLOBAL_TOKEN); gsub(/\$\{GLOBAL_INSTALLDIR\}/, GLOBAL_INSTALLDIR); gsub(/\$\{GLOBAL_TMP_DIRECTORY\}/, GLOBAL_TMP_DIRECTORY); gsub(/\$\{PATH\}/, PATH); gsub(/\$\{HOME\}/, HOME); printf " %02s: %s\n", NR, $0}' "${TEST}/before_exec")")"
GLOBAL_LOG="$(printf " %s\n\n STDIN:\n${C_GREY}%s${C_CLEAR}" "${GLOBAL_LOG}" "$(awk '{printf " %02s: %s\n", NR, $0}' "${GLOBAL_TMP_DIRECTORY}/stdin")")"
if [ "${LOG_CURRENT_TEST_STDOUT}" != "" ]
then
GLOBAL_LOG="$(printf "%s\n\n STDOUT:\n%s\n${C_GREY}%s${C_CLEAR}" "${GLOBAL_LOG}" "${LOG_CURRENT_TEST_STDOUT}" "$(awk '{printf " %02s: %s\n", NR, $0} END {if (NR==0) { print " (no output)" }}' "${RESPONSE_STDOUT}")")"
else
GLOBAL_LOG="$(printf "%s\n\n STDOUT:\n${C_GREY}%s${C_CLEAR}" "${GLOBAL_LOG}" "$(awk '{printf " %02s: %s\n", NR, $0} END {if (NR==0) { print " (no output)" }}' "${RESPONSE_STDOUT}")")"
fi
if [ "${LOG_CURRENT_TEST_STDERR}" != "" ]
then
GLOBAL_LOG="$(printf "%s\n\n STDERR:\n%s\n${C_GREY}%s${C_CLEAR}" "${GLOBAL_LOG}" "${LOG_CURRENT_TEST_STDERR}" "$(awk '{printf " %02s: %s\n", NR, $0} END {if (NR==0) { print " (no output)" }}' "${RESPONSE_STDERR}")")"
else
GLOBAL_LOG="$(printf "%s\n\n STDERR:\n${C_GREY}%s${C_CLEAR}" "${GLOBAL_LOG}" "$(awk '{printf " %02s: %s\n", NR, $0} END {if (NR==0) { print " (no output)" }}' "${RESPONSE_STDERR}")")"
fi
[ "${LOG_CURRENT_TEST_MISC}" != "" ] && GLOBAL_LOG="$(printf "%s\n\n MISC:\n%s" "${GLOBAL_LOG}" "${LOG_CURRENT_TEST_MISC}")"
[ -f "${TEST}/after_exec" ] && GLOBAL_LOG="$(printf "%s\n\n After test:\n${C_GREY}%s${C_CLEAR}" "${GLOBAL_LOG}" "$(awk -v GLOBAL_TOKEN="${GLOBAL_TOKEN}" -v GLOBAL_INSTALLDIR="${GLOBAL_INSTALLDIR}" -v GLOBAL_TMP_DIRECTORY="${GLOBAL_TMP_DIRECTORY}" -v PATH="${PATH}" -v HOME="${HOME}" '{gsub(/\$\{GLOBAL_TOKEN\}/, GLOBAL_TOKEN); gsub(/\$\{GLOBAL_INSTALLDIR\}/, GLOBAL_INSTALLDIR); gsub(/\$\{GLOBAL_TMP_DIRECTORY\}/, GLOBAL_TMP_DIRECTORY); gsub(/\$\{PATH\}/, PATH); gsub(/\$\{HOME\}/, HOME); printf " %02s: %s\n", NR, $0}' "${TEST}/after_exec")")"
[ "${TEST_STATUS}" == "1" ] && (( GLOBAL_TOTAL_FAILED_TESTS = GLOBAL_TOTAL_FAILED_TESTS + 1 ))
fi
case "${TEST_STATUS}" in
0) printf "${C_GREEN}.${C_CLEAR}" ;;
1) printf "${C_RED}x${C_CLEAR}" ;;
2) printf "${C_YELLOW}~${C_CLEAR}" ;;
255) printf "${C_RED}!${C_CLEAR}" ;;
esac
fi
fi
done
IFS="${OLD_IFS}"
}

16
42sh/42shelltest-tmp/lib/verbs/be_empty.sh Normal file
View file

@ -0,0 +1,16 @@
#!/bin/bash
# /*
# Test emptiness of output
# RESPONSE -> actual output (stdout or stderr)
# */
run_verb_be_empty()
{
if [ "$(awk '{print}' "${RESPONSE}")" == "" ]
then
return 0
else
return 1
fi
}

47
42sh/42shelltest-tmp/lib/verbs/create_file.sh Normal file
View file

@ -0,0 +1,47 @@
#!/bin/bash
# /*
# Test file creation
# EXPECTED_TO_ARGS[0]* -> expected file path
# EXPECTED_TO_ARGS[1] -> file test (with_regexp, without_regexp, with_nb_of_lines)
# EXPECTED_TO_ARGS[2] -> argument of file test
# */
run_verb_create_file()
{
if [ -f "${EXPECTED_TO_ARGS[0]}" ]
then
if [ "${EXPECTED_TO_ARGS[1]}" == "" ]
then
return 0
else
case "${EXPECTED_TO_ARGS[1]}" in
matching_regex)
if [ "$(awk -v regexp="${EXPECTED_TO_ARGS[2]}" '$0 ~ regexp {print}' "${EXPECTED_TO_ARGS[0]}")" == "" ]
then
return 1
else
return 0
fi ;;
not_matching_regex)
if [ "$(awk -v regexp="${EXPECTED_TO_ARGS[2]}" '$0 ~ regexp {print}' "${EXPECTED_TO_ARGS[0]}")" == "" ]
then
return 0
else
return 1
fi ;;
with_nb_of_lines)
if [ "$(awk 'END {print NR}' "${EXPECTED_TO_ARGS[0]}")" == "${EXPECTED_TO_ARGS[2]}" ]
then
return 0
else
return 1
fi ;;
*)
return 255 ;;
esac
fi
else
return 1
fi
}

17
42sh/42shelltest-tmp/lib/verbs/exit_with_status.sh Normal file
View file

@ -0,0 +1,17 @@
#!/bin/bash
# /*
# Test exit status
# EXPECTED_TO_ARGS[0]* -> expected exit status (integer)
# RESPONSE_EXIT_STATUS -> actual exit status
# */
run_verb_exit_with_status()
{
if [ "${RESPONSE_EXIT_STATUS}" == "${EXPECTED_TO_ARGS[0]}" ]
then
return 0
else
return 1
fi
}

17
42sh/42shelltest-tmp/lib/verbs/have_nb_of_lines.sh Normal file
View file

@ -0,0 +1,17 @@
#!/bin/bash
# /*
# Test number of output lines
# EXPECTED_TO_ARGS[0]* -> expected number of lines (integer)
# RESPONSE -> actual output (stdout or stderr)
# */
run_verb_have_nb_of_lines()
{
if [ "$(awk 'END {printf NR}' "${RESPONSE}")" == "${EXPECTED_TO_ARGS[0]}" ]
then
return 0
else
return 1
fi
}

28
42sh/42shelltest-tmp/lib/verbs/match_each_regex_of_file.sh Normal file
View file

@ -0,0 +1,28 @@
#!/bin/bash
# /*
# Multiple test regular expression
# EXPECTED_TO_ARGS[0]* -> file path that stores expected regular expression
# RESPONSE -> actual output (stdout or stderr)
# */
run_verb_match_each_regex_of_file()
{
local INDEX=0 ERROR=0 TOTAL LINE
TOTAL=$(awk 'END {print NR+1}' "${EXPECTED_TO_ARGS[0]}")
while [ "${INDEX}" -le "${TOTAL}" ]
do
LINE="$(awk -v INDEX="${INDEX}" 'NR == INDEX {print; exit}' "${EXPECTED_TO_ARGS[0]}")"
if [ "$(awk -v regexp="${LINE}" '$0 ~ regexp {print}' "${RESPONSE}")" == "" ]
then
ERROR=1
fi
(( INDEX += 1 ))
done
if [ ${ERROR} -eq 1 ]
then
return 1
else
return 0
fi
}

38
42sh/42shelltest-tmp/lib/verbs/match_regex.sh Normal file
View file

@ -0,0 +1,38 @@
#!/bin/bash
# /*
# Test regular expression
# EXPECTED_TO_ARGS[0]* -> expected regular expression match
# EXPECTED_TO_ARGS[1]* -> value 'once' or if next argument is value 'times', the number of times
# RESPONSE -> actual output (stdout or stderr)
# */
run_verb_match_regex()
{
local NB_OF_TIMES="0" RESULT
if [ "${EXPECTED_TO_ARGS[1]}" == "once" ]
then
NB_OF_TIMES="1"
fi
if [ "${EXPECTED_TO_ARGS[2]}" == "times" ]
then
NB_OF_TIMES="${EXPECTED_TO_ARGS[1]}"
fi
RESULT="$(awk -v regexp="${EXPECTED_TO_ARGS[0]}" 'BEGIN {TOTAL=0} $0 ~ regexp {TOTAL++} END {printf TOTAL}' "${RESPONSE}")"
if [ "${NB_OF_TIMES}" == "0" ]
then
if [ "${RESULT}" != "0" ]
then
return 0
else
return 1
fi
else
if [ "${RESULT}" == "${NB_OF_TIMES}" ]
then
return 0
else
return 1
fi
fi
}

3075
42sh/42shelltest-tmp/log Normal file
View file

File diff suppressed because one or more lines are too long

6
42sh/42shelltest-tmp/spec/README.md Normal file
View file

@ -0,0 +1,6 @@
# spec
* [21sh](./21sh)
* [42sh](./42sh)
* [bonuses](./bonuses)
* [minishell](./minishell)

9
42sh/42shelltest-tmp/spec/bonuses/README.md Normal file
View file

@ -0,0 +1,9 @@
# bonuses
*[spec](..) > bonuses*
* [builtins](./builtins)
* [inline-environment-variable](./inline-environment-variable)
* [redirections](./redirections)
* [separators](./separators)
* [tilde-expansion](./tilde-expansion)

5
42sh/42shelltest-tmp/spec/bonuses/builtins/README.md Normal file
View file

@ -0,0 +1,5 @@
# builtins
*[spec > bonuses](..) > builtins*
* [env](./env)

63
42sh/42shelltest-tmp/spec/bonuses/builtins/env/001-unset-variables/README.md vendored Normal file
View file

@ -0,0 +1,63 @@
# 001-unset-variables
*[spec > bonuses > builtins > env](..) > 001-unset-variables*
The purpose of this test is to check that the builtin `env` implement the option `-u` to unset environment variables.
### What is done before test
```bash
export TESTVARIABLE="${GLOBAL_TOKEN}"
```
### Shell commands that are sent to the standard entry
```bash
env -u HOME -u PATH -u TESTVARIABLE ./display_env
```
### What is expected on standard output
```bash
expected_to_not match_regex "HOME="
expected_to_not match_regex "PATH="
expected_to_not match_regex "TESTVARIABLE="
```
### What is expected on error output
```bash
expected_to be_empty
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

1
42sh/42shelltest-tmp/spec/bonuses/builtins/env/001-unset-variables/before_exec vendored Normal file
View file

@ -0,0 +1 @@
export TESTVARIABLE="${GLOBAL_TOKEN}"

1
42sh/42shelltest-tmp/spec/bonuses/builtins/env/001-unset-variables/description vendored Normal file
View file

@ -0,0 +1 @@
The purpose of this test is to check that the builtin `env` implement the option `-u` to unset environment variables.

1
42sh/42shelltest-tmp/spec/bonuses/builtins/env/001-unset-variables/non-posix vendored Normal file
View file

@ -0,0 +1 @@
`env -u` is not registered in the POSIX standard.

0
42sh/42shelltest-tmp/spec/bonuses/builtins/env/001-unset-variables/pending vendored Normal file
View file

1
42sh/42shelltest-tmp/spec/bonuses/builtins/env/001-unset-variables/stderr vendored Normal file
View file

@ -0,0 +1 @@
expected_to be_empty

1
42sh/42shelltest-tmp/spec/bonuses/builtins/env/001-unset-variables/stdin vendored Normal file
View file

@ -0,0 +1 @@
env -u HOME -u PATH -u TESTVARIABLE ./display_env

3
42sh/42shelltest-tmp/spec/bonuses/builtins/env/001-unset-variables/stdout vendored Normal file
View file

@ -0,0 +1,3 @@
expected_to_not match_regex "HOME="
expected_to_not match_regex "PATH="
expected_to_not match_regex "TESTVARIABLE="

63
42sh/42shelltest-tmp/spec/bonuses/builtins/env/002-unset-and-set-variable/README.md vendored Normal file
View file

@ -0,0 +1,63 @@
# 002-unset-and-set-variable
*[spec > bonuses > builtins > env](..) > 002-unset-and-set-variable*
The purpose of this test is to check if env -u works to unset variables for a given binary, we are also checking if an argument not prefix with -u is add to the environment of the given binary.### What is done before test
```bash
# unset all environment variables except PATH
for VARIABLE in $(env | awk 'BEGIN {FS="="} $0 !~ /^PATH/ {print $1}'); do unset "${VARIABLE}"; done;
export HOME="/my/home"
```
### Shell commands that are sent to the standard entry
```bash
env -u HOME TESTVARIABLE=${GLOBAL_TOKEN} ./display_env
```
### What is expected on standard output
```bash
expected_to match_regex "^TESTVARIABLE=${GLOBAL_TOKEN}$"
expected_to_not match_regex "^HOME="
```
### What is expected on error output
```bash
expected_to be_empty
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

4
42sh/42shelltest-tmp/spec/bonuses/builtins/env/002-unset-and-set-variable/before_exec vendored Normal file
View file

@ -0,0 +1,4 @@
# unset all environment variables except PATH
for VARIABLE in $(env | awk 'BEGIN {FS="="} $0 !~ /^PATH/ {print $1}'); do unset "${VARIABLE}"; done;
export HOME="/my/home"

1
42sh/42shelltest-tmp/spec/bonuses/builtins/env/002-unset-and-set-variable/description vendored Normal file
View file

@ -0,0 +1 @@
The purpose of this test is to check if env -u works to unset variables for a given binary, we are also checking if an argument not prefix with -u is add to the environment of the given binary.

0
42sh/42shelltest-tmp/spec/bonuses/builtins/env/002-unset-and-set-variable/non-posix vendored Normal file
View file

0
42sh/42shelltest-tmp/spec/bonuses/builtins/env/002-unset-and-set-variable/pending vendored Normal file
View file

1
42sh/42shelltest-tmp/spec/bonuses/builtins/env/002-unset-and-set-variable/stderr vendored Normal file
View file

@ -0,0 +1 @@
expected_to be_empty

1
42sh/42shelltest-tmp/spec/bonuses/builtins/env/002-unset-and-set-variable/stdin vendored Normal file
View file

@ -0,0 +1 @@
env -u HOME TESTVARIABLE=${GLOBAL_TOKEN} ./display_env

2
42sh/42shelltest-tmp/spec/bonuses/builtins/env/002-unset-and-set-variable/stdout vendored Normal file
View file

@ -0,0 +1,2 @@
expected_to match_regex "^TESTVARIABLE=${GLOBAL_TOKEN}$"
expected_to_not match_regex "^HOME="

6
42sh/42shelltest-tmp/spec/bonuses/builtins/env/README.md vendored Normal file
View file

@ -0,0 +1,6 @@
# env
*[spec > bonuses > builtins](..) > env*
* [001-unset-variables](./001-unset-variables)
* [002-unset-and-set-variable](./002-unset-and-set-variable)

62
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/001-modifies-child-environment-1/README.md Normal file
View file

@ -0,0 +1,62 @@
# 001-modifies-child-environment-1
*[spec > bonuses > inline-environment-variable](..) > 001-modifies-child-environment-1*
The purpose of this test is to check that a binary may have its environment to be modified by appending variables inline.
### What is done before test
```bash
unset "${GLOBAL_TOKEN}_VARIABLE"
```
### Shell commands that are sent to the standard entry
```bash
${GLOBAL_TOKEN}_VARIABLE=${GLOBAL_TOKEN}_VALUE ./display_env
./display_env
```
### What is expected on standard output
```bash
expected_to match_regex "^${GLOBAL_TOKEN}_VARIABLE=${GLOBAL_TOKEN}_VALUE$" once
```
### What is expected on error output
```bash
expected_to be_empty
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

1
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/001-modifies-child-environment-1/before_exec Normal file
View file

@ -0,0 +1 @@
unset "${GLOBAL_TOKEN}_VARIABLE"

1
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/001-modifies-child-environment-1/description Normal file
View file

@ -0,0 +1 @@
The purpose of this test is to check that a binary may have its environment to be modified by appending variables inline.

1
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/001-modifies-child-environment-1/stderr Normal file
View file

@ -0,0 +1 @@
expected_to be_empty

2
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/001-modifies-child-environment-1/stdin Normal file
View file

@ -0,0 +1,2 @@
${GLOBAL_TOKEN}_VARIABLE=${GLOBAL_TOKEN}_VALUE ./display_env
./display_env

1
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/001-modifies-child-environment-1/stdout Normal file
View file

@ -0,0 +1 @@
expected_to match_regex "^${GLOBAL_TOKEN}_VARIABLE=${GLOBAL_TOKEN}_VALUE$" once

64
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/002-modifies-child-environment-2/README.md Normal file
View file

@ -0,0 +1,64 @@
# 002-modifies-child-environment-2
*[spec > bonuses > inline-environment-variable](..) > 002-modifies-child-environment-2*
The purpose of this test is to check that a binary may have its environment to be modified by appending variables inline.
### What is done before test
```bash
unset "${GLOBAL_TOKEN}_VARIABLE"
```
### Shell commands that are sent to the standard entry
```bash
${GLOBAL_TOKEN}_VARIABLE1=${GLOBAL_TOKEN}_VALUE1 ${GLOBAL_TOKEN}_VARIABLE2=${GLOBAL_TOKEN}_VALUE2 ${GLOBAL_TOKEN}_VARIABLE3=${GLOBAL_TOKEN}_VALUE3 ./display_env
./display_env
```
### What is expected on standard output
```bash
expected_to match_regex "^${GLOBAL_TOKEN}_VARIABLE1=${GLOBAL_TOKEN}_VALUE1$" once
expected_to match_regex "^${GLOBAL_TOKEN}_VARIABLE2=${GLOBAL_TOKEN}_VALUE2$" once
expected_to match_regex "^${GLOBAL_TOKEN}_VARIABLE3=${GLOBAL_TOKEN}_VALUE3$" once
```
### What is expected on error output
```bash
expected_to be_empty
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

1
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/002-modifies-child-environment-2/before_exec Normal file
View file

@ -0,0 +1 @@
unset "${GLOBAL_TOKEN}_VARIABLE"

1
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/002-modifies-child-environment-2/description Normal file
View file

@ -0,0 +1 @@
The purpose of this test is to check that a binary may have its environment to be modified by appending variables inline.

1
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/002-modifies-child-environment-2/stderr Normal file
View file

@ -0,0 +1 @@
expected_to be_empty

2
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/002-modifies-child-environment-2/stdin Normal file
View file

@ -0,0 +1,2 @@
${GLOBAL_TOKEN}_VARIABLE1=${GLOBAL_TOKEN}_VALUE1 ${GLOBAL_TOKEN}_VARIABLE2=${GLOBAL_TOKEN}_VALUE2 ${GLOBAL_TOKEN}_VARIABLE3=${GLOBAL_TOKEN}_VALUE3 ./display_env
./display_env

3
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/002-modifies-child-environment-2/stdout Normal file
View file

@ -0,0 +1,3 @@
expected_to match_regex "^${GLOBAL_TOKEN}_VARIABLE1=${GLOBAL_TOKEN}_VALUE1$" once
expected_to match_regex "^${GLOBAL_TOKEN}_VARIABLE2=${GLOBAL_TOKEN}_VALUE2$" once
expected_to match_regex "^${GLOBAL_TOKEN}_VARIABLE3=${GLOBAL_TOKEN}_VALUE3$" once

73
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/003-modifies-PATH-only/README.md Normal file
View file

@ -0,0 +1,73 @@
# 003-modifies-PATH-only
*[spec > bonuses > inline-environment-variable](..) > 003-modifies-PATH-only*
The purpose of this test is to check that a binary may have its environment to be modified by appending variables inline.
### What is done before test
```bash
rm -rf "temporary_directory"
mkdir -p "temporary_directory"
cd "temporary_directory"
```
### Shell commands that are sent to the standard entry
```bash
PATH=.. write_on_stdout ${GLOBAL_TOKEN}
exit_with_status 42
```
### What is expected on standard output
```bash
expected_to match_regex "^${GLOBAL_TOKEN}$"
```
### What is expected on error output
```bash
expected_to_not be_empty
might match_regex "[Cc]ommand not found"
```
### What miscellaneous behaviors are expected
```bash
expected_to_not exit_with_status "42"
expected_to_not exit_with_status "0"
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

3
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/003-modifies-PATH-only/before_exec Normal file
View file

@ -0,0 +1,3 @@
rm -rf "temporary_directory"
mkdir -p "temporary_directory"
cd "temporary_directory"

1
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/003-modifies-PATH-only/description Normal file
View file

@ -0,0 +1 @@
The purpose of this test is to check that a binary may have its environment to be modified by appending variables inline.

2
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/003-modifies-PATH-only/misc Normal file
View file

@ -0,0 +1,2 @@
expected_to_not exit_with_status "42"
expected_to_not exit_with_status "0"

2
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/003-modifies-PATH-only/stderr Normal file
View file

@ -0,0 +1,2 @@
expected_to_not be_empty
might match_regex "[Cc]ommand not found"

2
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/003-modifies-PATH-only/stdin Normal file
View file

@ -0,0 +1,2 @@
PATH=.. write_on_stdout ${GLOBAL_TOKEN}
exit_with_status 42

1
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/003-modifies-PATH-only/stdout Normal file
View file

@ -0,0 +1 @@
expected_to match_regex "^${GLOBAL_TOKEN}$"

7
42sh/42shelltest-tmp/spec/bonuses/inline-environment-variable/README.md Normal file
View file

@ -0,0 +1,7 @@
# inline-environment-variable
*[spec > bonuses](..) > inline-environment-variable*
* [001-modifies-child-environment-1](./001-modifies-child-environment-1)
* [002-modifies-child-environment-2](./002-modifies-child-environment-2)
* [003-modifies-PATH-only](./003-modifies-PATH-only)

70
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/README.md Normal file
View file

@ -0,0 +1,70 @@
# 001-append-twice-outputs-together
*[spec > bonuses > redirections](..) > 001-append-twice-outputs-together*
A double right redirection opens the file with the oflag `O_APPEND`, so that its size is not truncated to 0 and output is written at the end of file. If the file does not exist, it is created.
In this test, twice outputs are appended to the same file.
### What is done before test
```bash
rm -f "new_file_stderr_and_stdout"
```
### Shell commands that are sent to the standard entry
```bash
./write_on_stdout_and_stderr ${GLOBAL_TOKEN}_stdout ${GLOBAL_TOKEN}_stderr &>>new_file_stderr_and_stdout
```
### What is expected on standard output
```bash
expected_to_not match_regex "${GLOBAL_TOKEN}_stdout"
```
### What is expected on error output
```bash
expected_to_not match_regex "${GLOBAL_TOKEN}_stderr"
```
### What miscellaneous behaviors are expected
```bash
expected_to create_file "new_file_stderr_and_stdout" matching_regex "${GLOBAL_TOKEN}_stdout$"
expected_to create_file "new_file_stderr_and_stdout" matching_regex "${GLOBAL_TOKEN}_stderr$"
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

1
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/before_exec Normal file
View file

@ -0,0 +1 @@
rm -f "new_file_stderr_and_stdout"

2
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/description Normal file
View file

@ -0,0 +1,2 @@
A double right redirection opens the file with the oflag `O_APPEND`, so that its size is not truncated to 0 and output is written at the end of file. If the file does not exist, it is created.
In this test, twice outputs are appended to the same file.

1
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/hard Normal file
View file

@ -0,0 +1 @@
This test only succeed with the reference ZSH.

2
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/misc Normal file
View file

@ -0,0 +1,2 @@
expected_to create_file "new_file_stderr_and_stdout" matching_regex "${GLOBAL_TOKEN}_stdout$"
expected_to create_file "new_file_stderr_and_stdout" matching_regex "${GLOBAL_TOKEN}_stderr$"

1
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/non-posix Normal file
View file

@ -0,0 +1 @@
The POSIX standard does not specify the capability for a Shell to append twice outputs to the same file.

0
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/pending Normal file
View file

1
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/stderr Normal file
View file

@ -0,0 +1 @@
expected_to_not match_regex "${GLOBAL_TOKEN}_stderr"

1
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/stdin Normal file
View file

@ -0,0 +1 @@
./write_on_stdout_and_stderr ${GLOBAL_TOKEN}_stdout ${GLOBAL_TOKEN}_stderr &>>new_file_stderr_and_stdout

1
42sh/42shelltest-tmp/spec/bonuses/redirections/001-append-twice-outputs-together/stdout Normal file
View file

@ -0,0 +1 @@
expected_to_not match_regex "${GLOBAL_TOKEN}_stdout"

5
42sh/42shelltest-tmp/spec/bonuses/redirections/README.md Normal file
View file

@ -0,0 +1,5 @@
# redirections
*[spec > bonuses](..) > redirections*
* [001-append-twice-outputs-together](./001-append-twice-outputs-together)

7
42sh/42shelltest-tmp/spec/bonuses/separators/README.md Normal file
View file

@ -0,0 +1,7 @@
# separators
*[spec > bonuses](..) > separators*
* [and](./and)
* [mixed](./mixed)
* [or](./or)

55
42sh/42shelltest-tmp/spec/bonuses/separators/and/001-run-twice/README.md Normal file
View file

@ -0,0 +1,55 @@
# 001-run-twice
*[spec > bonuses > separators > and](..) > 001-run-twice*
The purpose of this test is to check that the AND operator `&&` works with two valid commands.
### Shell commands that are sent to the standard entry
```bash
./write_on_stdout ${GLOBAL_TOKEN}_LEFT && ./write_on_stdout ${GLOBAL_TOKEN}_RIGHT
```
### What is expected on standard output
```bash
might match_regex "${GLOBAL_TOKEN}_LEFT"
might match_regex "${GLOBAL_TOKEN}_RIGHT"
```
### What is expected on error output
```bash
might be_empty
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/001-run-twice/description Normal file
View file

@ -0,0 +1 @@
The purpose of this test is to check that the AND operator `&&` works with two valid commands.

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/001-run-twice/stderr Normal file
View file

@ -0,0 +1 @@
might be_empty

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/001-run-twice/stdin Normal file
View file

@ -0,0 +1 @@
./write_on_stdout ${GLOBAL_TOKEN}_LEFT && ./write_on_stdout ${GLOBAL_TOKEN}_RIGHT

2
42sh/42shelltest-tmp/spec/bonuses/separators/and/001-run-twice/stdout Normal file
View file

@ -0,0 +1,2 @@
might match_regex "${GLOBAL_TOKEN}_LEFT"
might match_regex "${GLOBAL_TOKEN}_RIGHT"

63
42sh/42shelltest-tmp/spec/bonuses/separators/and/002-do-not-run-second/README.md Normal file
View file

@ -0,0 +1,63 @@
# 002-do-not-run-second
*[spec > bonuses > separators > and](..) > 002-do-not-run-second*
The purpose of this test is to check that the AND operator `&&` makes the right command to not be executed if the left one exits with an error status code.
The Shell should exit with the status code of the executed command.
### Shell commands that are sent to the standard entry
```bash
./exit_with_status 42 && ./write_on_stdout ${GLOBAL_TOKEN}
```
### What is expected on standard output
```bash
might_not match_regex ${GLOBAL_TOKEN}
might be_empty
```
### What is expected on error output
```bash
might be_empty
```
### What miscellaneous behaviors are expected
```bash
might exit_with_status "42"
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

2
42sh/42shelltest-tmp/spec/bonuses/separators/and/002-do-not-run-second/description Normal file
View file

@ -0,0 +1,2 @@
The purpose of this test is to check that the AND operator `&&` makes the right command to not be executed if the left one exits with an error status code.
The Shell should exit with the status code of the executed command.

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/002-do-not-run-second/misc Normal file
View file

@ -0,0 +1 @@
might exit_with_status "42"

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/002-do-not-run-second/stderr Normal file
View file

@ -0,0 +1 @@
might be_empty

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/002-do-not-run-second/stdin Normal file
View file

@ -0,0 +1 @@
./exit_with_status 42 && ./write_on_stdout ${GLOBAL_TOKEN}

2
42sh/42shelltest-tmp/spec/bonuses/separators/and/002-do-not-run-second/stdout Normal file
View file

@ -0,0 +1,2 @@
might_not match_regex ${GLOBAL_TOKEN}
might be_empty

62
42sh/42shelltest-tmp/spec/bonuses/separators/and/003-run-until-failing/README.md Normal file
View file

@ -0,0 +1,62 @@
# 003-run-until-failing
*[spec > bonuses > separators > and](..) > 003-run-until-failing*
The purpose of this test is to check that using the AND separator `&&` with chained commands results in the execution of all until the first fail.
### Shell commands that are sent to the standard entry
```bash
./exit_with_status 0 && ./exit_with_status 0 && ./exit_with_status 0 && ./exit_with_status 0 && ./write_on_stdout ${GLOBAL_TOKEN}_FIRST && ./exit_with_status 42 && ./write_on_stdout ${GLOBAL_TOKEN}_SECOND
```
### What is expected on standard output
```bash
expected_to match_regex "${GLOBAL_TOKEN}_FIRST"
expected_to_not match_regex "${GLOBAL_TOKEN}_SECOND"
```
### What is expected on error output
```bash
expected_to be_empty
```
### What miscellaneous behaviors are expected
```bash
expected_to exit_with_status "42"
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/003-run-until-failing/description Normal file
View file

@ -0,0 +1 @@
The purpose of this test is to check that using the AND separator `&&` with chained commands results in the execution of all until the first fail.

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/003-run-until-failing/misc Normal file
View file

@ -0,0 +1 @@
expected_to exit_with_status "42"

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/003-run-until-failing/stderr Normal file
View file

@ -0,0 +1 @@
expected_to be_empty

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/003-run-until-failing/stdin Normal file
View file

@ -0,0 +1 @@
./exit_with_status 0 && ./exit_with_status 0 && ./exit_with_status 0 && ./exit_with_status 0 && ./write_on_stdout ${GLOBAL_TOKEN}_FIRST && ./exit_with_status 42 && ./write_on_stdout ${GLOBAL_TOKEN}_SECOND

2
42sh/42shelltest-tmp/spec/bonuses/separators/and/003-run-until-failing/stdout Normal file
View file

@ -0,0 +1,2 @@
expected_to match_regex "${GLOBAL_TOKEN}_FIRST"
expected_to_not match_regex "${GLOBAL_TOKEN}_SECOND"

8
42sh/42shelltest-tmp/spec/bonuses/separators/and/README.md Normal file
View file

@ -0,0 +1,8 @@
# and
*[spec > bonuses > separators](..) > and*
* [001-run-twice](./001-run-twice)
* [002-do-not-run-second](./002-do-not-run-second)
* [003-run-until-failing](./003-run-until-failing)
* [errors](./errors)

65
42sh/42shelltest-tmp/spec/bonuses/separators/and/errors/001-parse-error-at-beginning/README.md Normal file
View file

@ -0,0 +1,65 @@
# 001-parse-error-at-beginning
*[spec > bonuses > separators > and > errors](..) > 001-parse-error-at-beginning*
Parsing test.
The purpose of this test is to check that the AND operator `&&` must be placed after a valid command.
If not, the Shell should display an error and exit with an error status code.
### Shell commands that are sent to the standard entry
```bash
&& ./write_on_stdout ${GLOBAL_TOKEN}
```
### What is expected on standard output
```bash
might_not match_regex "${GLOBAL_TOKEN}"
might be_empty
```
### What is expected on error output
```bash
might_not be_empty
might match_regex "([Ss]yntax|[Pp]arse) error"
```
### What miscellaneous behaviors are expected
```bash
might_not exit_with_status "0"
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

3
42sh/42shelltest-tmp/spec/bonuses/separators/and/errors/001-parse-error-at-beginning/description Normal file
View file

@ -0,0 +1,3 @@
Parsing test.
The purpose of this test is to check that the AND operator `&&` must be placed after a valid command.
If not, the Shell should display an error and exit with an error status code.

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/errors/001-parse-error-at-beginning/misc Normal file
View file

@ -0,0 +1 @@
might_not exit_with_status "0"

2
42sh/42shelltest-tmp/spec/bonuses/separators/and/errors/001-parse-error-at-beginning/stderr Normal file
View file

@ -0,0 +1,2 @@
might_not be_empty
might match_regex "([Ss]yntax|[Pp]arse) error"

1
42sh/42shelltest-tmp/spec/bonuses/separators/and/errors/001-parse-error-at-beginning/stdin Normal file
View file

@ -0,0 +1 @@
&& ./write_on_stdout ${GLOBAL_TOKEN}

2
42sh/42shelltest-tmp/spec/bonuses/separators/and/errors/001-parse-error-at-beginning/stdout Normal file
View file

@ -0,0 +1,2 @@
might_not match_regex "${GLOBAL_TOKEN}"
might be_empty

65
42sh/42shelltest-tmp/spec/bonuses/separators/and/errors/002-parse-error-too-much-symbol/README.md Normal file
View file

@ -0,0 +1,65 @@
# 002-parse-error-too-much-symbol
*[spec > bonuses > separators > and > errors](..) > 002-parse-error-too-much-symbol*
Parsing test.
The purpose of this test is to check that more than two '&' operators are detected as a syntax error.
It should not execute the two commands `write_on_stdout` but display an error and exit with an error status code.
### Shell commands that are sent to the standard entry
```bash
./write_on_stdout ${GLOBAL_TOKEN} &&& ./write_on_stdout ${GLOBAL_TOKEN}
```
### What is expected on standard output
```bash
might_not match_regex "${GLOBAL_TOKEN}"
might be_empty
```
### What is expected on error output
```bash
might_not be_empty
might match_regex "([Ss]yntax|[Pp]arse) error"
```
### What miscellaneous behaviors are expected
```bash
expected_to_not exit_with_status "0"
```
### Variables
The following variables may appear in this test:
* ${**GLOBAL_INSTALLDIR**} -> The installation directory of 42ShellTester
* ${**GLOBAL_TMP_DIRECTORY**} -> The temporary directory in which tests are executed
* ${**GLOBAL_TOKEN**} -> A token that changes value at launch time
* ${**PATH**} -> The standard environment variable PATH
* ${**HOME**} -> The standard environment variable HOME
### Support binaries
The following binaries may appear in this test:
* **[./create_file](http://github.com/we-sh/42ShellTester/tree/master/support/create-file)** -> A binary that creates file named argv[1] + "_FILE" If argv[1] is not set, the file is named "TOKEN_FILE"
* **[./delete_file](http://github.com/we-sh/42ShellTester/tree/master/support/delete-file)** -> A binary that delete all files called in argument.
* **[./display_env](http://github.com/we-sh/42ShellTester/tree/master/support/display-env)** -> A binary that iterates on `**envp` and write each element on standard output.
* **[./display_program_name](http://github.com/we-sh/42ShellTester/tree/master/support/display-program-name)** -> A binary that writes its name on standard ouput.
* **[./display_pwd](http://github.com/we-sh/42ShellTester/tree/master/support/display-pwd)** -> A binary that writes on standard output the absolute path of the current directory returned by `getcwd(3)`, encountered with the strings `PWD:` and `:PWD`.
* **[./exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/exit-with-status)** -> A binary that immediately exits with the status given as first argument.
* **[./read_on_stdin](http://github.com/we-sh/42ShellTester/tree/master/support/read-on-stdin)** -> A binary that reads on standard entry and write each line on standard output suffixed with the character `@` (e.g. same behavior as `cat -e` and the *newline* character). When `read(2)` returns `-1`, then the string `STDIN READ ERROR` is written on standard error.
* **[./sleep_and_exit_with_status](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-exit-with-status)** -> A binary that sleeps for a duration in seconds given as first argument and then exits with status given as second argument.
* **[./sleep_and_write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/sleep-and-write-on-stderr)** -> A binary that sleeps for a duration in seconds given as first argument and then writes on STDERR the string given as second argument without EOL.
* **[./write_all_arguments_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-all-arguments-on-stdout)** -> A binary that writes on standard output each argument separated by the symbol `@`. If no argument is given, it writes the string "nothing to be written on stdout".
* **[./write_on_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stderr)** -> A binary that writes on standard error the first given argument (the same behavior as `echo` but with only one argument) and exits with an error status code given as second argument. If no argument is given, it writes the string "write on stderr" and exit with status `1`.
* **[./write_on_stdout](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout)** -> A binary that writes on standard output the first given argument (the same behavior as `echo` but with only one argument). If no argument is given, it writes the string "write on stdout".
* **[./write_on_stdout_and_stderr](http://github.com/we-sh/42ShellTester/tree/master/support/write-on-stdout-and-stderr)** -> A binary that writes on standard output the first given argument, and writes on standard error the second given argument. If an argument is missing, it writes the strings "write on stdout" and "write on stderr".

Some files were not shown because too many files have changed in this diff Show more