Suite of tools and fixtures to manage daemons for testing
Project description
Pifpaf is a suite of fixtures and a command-line tool that allows to start and stop daemons for a quick throw-away usage. This is typically useful when needing these daemons to run integration testing. It originaly evolved from its precussor overtest.
Supported daemons
Pifpaf currently supports:
Redis (with sentinel mode)
Usage
To use Pifpaf, simply call the pifpaf run $daemon program that you need. It will setup the temporary environment and export a few environment variable for you to accesss it:
$ pifpaf run postgresql psql template1
Expanded display is used automatically.
Line style is unicode.
SET
psql (9.4.5)
Type "help" for help.
template1=# \l
List of databases
Name │ Owner │ Encoding │ Collate │ Ctype │ Access privileges
───────────┼───────┼──────────┼─────────────┼─────────────┼───────────────────
postgres │ jd │ UTF8 │ en_US.UTF-8 │ en_US.UTF-8 │
template0 │ jd │ UTF8 │ en_US.UTF-8 │ en_US.UTF-8 │ =c/jd ↵
│ │ │ │ │ jd=CTc/jd
template1 │ jd │ UTF8 │ en_US.UTF-8 │ en_US.UTF-8 │ =c/jd ↵
│ │ │ │ │ jd=CTc/jd
(3 rows)
template1=# \q
$
Environment variables
Pifpaf exports a few environment variable:
PIFPAF_DAEMON which contains the name of the daemon launched
PIFPAF_URL which contains the URL to the daemon
PIFPAF_$daemon_* variables, which contains daemon specific variables, such as port, database name, URL, etc.
