pytest-custom-report
A plugin for defining your own characters to be used when displaying test outcomes in pytest (passed, failed, skipped etc).
For example, if you wanted to see a PILE OF POO (U+1F4A9) glyph displayed in the terminal report for each failing test:
pytest --report-failed=💩To persist your custom characters, add a section like this in the configuration file (i.e. in pytest.ini, tox.ini, setup.cfg or whatever):
[pytest] report_failed = 💩 report_failed_verbose = OH CRAP
Installation and Usage
pip install pytest-custom-reportThis will add new command-line arguments and configuration file options to pytest (detailed in the following section). Command line arguments take precedence over configuration file settings. The plugin is always enabled, but unless you've configured your own symbols the pytest defaults are used.
To execute tests with the plugin disabled temporarily, use this:
pytest -p no:pytest-custom-reportIf you're trying to use emojis but you can't see the glyphs properly in your terminal, you may be missing unicode fonts with the upper plane - you could install for example GNU Unifont.
Configuration
The table below shows the available options as well as pytest's default style for each outcome.
| test outcome | command-line argument name | .ini file config key | default report symbol |
|---|---|---|---|
passed |
--report-passed |
report_passed |
. |
xpassed |
--report-xpassed |
report_xpassed |
X |
failed |
--report-failed |
report_failed |
F |
xfailed |
--report-xfailed |
report_xfailed |
x |
skipped |
--report-skipped |
report_skipped |
s |
error |
--report-error |
report_error |
E |
When tests are executed with -v or --verbose flag enabled, you'll see longer strings displayed and one-line per test outcome. These can be specified too.
| test outcome | command-line argument name | .ini file config key | default report string |
|---|---|---|---|
passed |
--report-passed-verbose |
report_passed_verbose |
PASSED |
xpassed |
--report-xpassed-verbose |
report_xpassed_verbose |
XPASS |
failed |
--report-failed-verbose |
report_failed_verbose |
FAILED |
xfailed |
--report-xfailed-verbose |
report_xfailed_verbose |
XFAIL |
skipped |
--report-skipped-verbose |
report_skipped_verbose |
SKIPPED |
error |
--report-error-verbose |
report_error_verbose |
ERROR |
Example config file
Here is some example pytest.ini content that you can copy-paste and modify to your liking:
[pytest] report_passed = ✔ report_xpassed = 🦄 report_failed = ✗ report_xfailed = 👎 report_skipped = ? report_error = 🔥 report_passed_verbose = OH YEAH report_xpassed_verbose = WHAT IN TARNATION? report_failed_verbose = OH CRAP report_xfailed_verbose = YEAH WHATEVER report_skipped_verbose = DON'T CARE report_error_verbose = YOU MEDDLING KIDS!
