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:
Usage
To use Pifpaf, simply call the pifpaf run $daemon <command> 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
$
You can also run it with no command line provided:
$ eval `pifpaf run memcached` $ env | grep PIFPAF PIFPAF_PID=13387 PIFPAF_DAEMON=memcached PIFPAF_URL=memcached://localhost:11212 PIFPAF_MEMCACHED_URL=memcached://localhost:11212 $ kill $PIFPAF_PID
Killing the daemon whose PID is contained in $PIFPAF_PID will stop the launched daemon and clean the test environment.
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_PID the PID of the pifpaf daemon
PIFPAF_$daemon_* variables, which contains daemon specific variables, such as port, database name, URL, etc.
How it works under the hood
Pifpaf will start the asked daemon using the current Posix user. The data file of the daemon will be placed in a temporary directory. The system-wide configured daemon that might exists is not touched at all.
Pifpaf expected to find daemon binaries on your system (like mysql, mysqld, pg_config, pg_ctl, rabbitmq-server, etc).
When the Python fixture is cleaned or when Pifpaf is terminated, the daemon is stopped and the temporary directory removed.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pifpaf-0.0.11.tar.gz.
File metadata
- Download URL: pifpaf-0.0.11.tar.gz
- Upload date:
- Size: 20.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7e811c6c441edf8d4c46226224232a61ecc755e0471c6288c11ee548dc86117b |
|
| MD5 | e960734ce91f705bdb7872508773e698 |
|
| BLAKE2b-256 | d6f2af97c0b414d0474816d49159bbbc689cd061980ca03eeef35cf517ee7ff1 |
