a plugin for py.test that changes the default look and feel of py.test (e.g. progressbar, show tests that fail instantly)
Python
1,535
455 commits
updated Dec 12, 2025
This plugin extends pytest by showing failures and errors instantly, adding a progress bar, improving the test results, and making the output look better.
To install pytest-sugar:
python -m pip install pytest-sugar
Once installed, the plugin is activated automatically. Run your tests normally:
pytest
If you would like more detailed output (one test per line), then you may use the verbose option:
pytest --verbose
If you would like to run tests without pytest-sugar, use:
pytest -p no:sugar
pytest-sugar provides several command-line options to customize its output and behavior. These options enhance test reporting and Playwright trace integration:
Show detailed test failures instead of one-line tracebacks. Use this if you want to see the full failure information instantly.
--old-summary
Force pytest-sugar output even if pytest doesn’t detect a real terminal. Useful when running tests in CI systems or other non-interactive environments.
--force-sugar
Specify the directory where Playwright trace files are stored. Defaults to Playwright default: "test-results"
--sugar-trace-dir <directory>
Disable Playwright trace file detection and output display. Use this if you want to turn off trace collection or display entirely.
--sugar-no-trace
Make sure to read our Code of Conduct. You can get started modifying the codebase with the following commands. Alternatively, you can try Github Codespaces (click the badge above). Push the changes to your repository & create a pull request.
git clone [email protected]:Teemu/pytest-sugar.git
cd pytest-sugar
python -m venv .venv
source .venv/bin/activate
echo ".venv" >> .git/info/exclude
pip install -e ".[dev]"
pre-commit install
There are two ways of running tests. We have our proper tests:
pytest .
There are also fake tests that can be used to visualise the output:
pytest faketests
When submitting a pull request, please add a RELEASE.md file in the root of the project that contains the release type (major, minor, patch) and a summary of the changes that will be used as the release changelog entry. For example:
Release type: patch
For long-running tests, display minutes and not only seconds.
You will need the following prerequisites in order to use pytest-sugar:
If you are seeing gibberish, you might want to try changing charset and fonts. See this comment for more details.
Overall
Maintained
Code review
PyPI
Latest release
Releases this year
(top 24 of 50)
583 followers · starred May 2025
325 followers · starred Oct 2022
424 followers · starred May 2023
2,623 followers · starred Feb 2019
a plugin for py.test that changes the default look and feel of py.test (e.g. progressbar, show tests that fail instantly)
Python
1,535
455 commits
updated Dec 12, 2025
This plugin extends pytest by showing failures and errors instantly, adding a progress bar, improving the test results, and making the output look better.
To install pytest-sugar:
python -m pip install pytest-sugar
Once installed, the plugin is activated automatically. Run your tests normally:
pytest
If you would like more detailed output (one test per line), then you may use the verbose option:
pytest --verbose
If you would like to run tests without pytest-sugar, use:
pytest -p no:sugar
pytest-sugar provides several command-line options to customize its output and behavior. These options enhance test reporting and Playwright trace integration:
Show detailed test failures instead of one-line tracebacks. Use this if you want to see the full failure information instantly.
--old-summary
Force pytest-sugar output even if pytest doesn’t detect a real terminal. Useful when running tests in CI systems or other non-interactive environments.
--force-sugar
Specify the directory where Playwright trace files are stored. Defaults to Playwright default: "test-results"
--sugar-trace-dir <directory>
Disable Playwright trace file detection and output display. Use this if you want to turn off trace collection or display entirely.
--sugar-no-trace
Make sure to read our Code of Conduct. You can get started modifying the codebase with the following commands. Alternatively, you can try Github Codespaces (click the badge above). Push the changes to your repository & create a pull request.
git clone [email protected]:Teemu/pytest-sugar.git
cd pytest-sugar
python -m venv .venv
source .venv/bin/activate
echo ".venv" >> .git/info/exclude
pip install -e ".[dev]"
pre-commit install
There are two ways of running tests. We have our proper tests:
pytest .
There are also fake tests that can be used to visualise the output:
pytest faketests
When submitting a pull request, please add a RELEASE.md file in the root of the project that contains the release type (major, minor, patch) and a summary of the changes that will be used as the release changelog entry. For example:
Release type: patch
For long-running tests, display minutes and not only seconds.
You will need the following prerequisites in order to use pytest-sugar:
If you are seeing gibberish, you might want to try changing charset and fonts. See this comment for more details.
Overall
Maintained
Code review
PyPI
Latest release
Releases this year
(top 24 of 50)
583 followers · starred May 2025
325 followers · starred Oct 2022
424 followers · starred May 2023
2,623 followers · starred Feb 2019