# pytest-sugar ✨
[](https://github.com/Teemu/pytest-sugar/actions)
[](https://pypi.org/project/pytest-sugar/)
[](https://pypi.org/project/pytest-sugar/)
This plugin extends [pytest](http://pytest.org) by showing failures and errors instantly, adding a progress bar, improving the test results, and making the output look better.
## Installation
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
## How to contribute 👷♂️
[](https://github.com/codespaces/new?hide_repo_select=true&ref=master&repo=10950375)
Make sure to read our [Code of Conduct](https://github.com/Teemu/pytest-sugar/blob/master/.github/CODE_OF_CONDUCT.md). 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 git@github.com: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:
```markdown
Release type: patch
For long-running tests, display minutes and not only seconds.
```
## Requirements
You will need the following prerequisites in order to use pytest-sugar:
- Python 3.8 or newer
- pytest 6.2 or newer
## Running on Windows
If you are seeing gibberish, you might want to try changing charset and fonts. See [this comment]( https://github.com/Teemu/pytest-sugar/pull/49#issuecomment-146567670) for more details.
## Similar projects
- [pytest-rich](https://github.com/nicoddemus/pytest-rich)
- [pytest-pretty](https://github.com/samuelcolvin/pytest-pretty)
Raw data
{
"_id": null,
"home_page": "https://github.com/Teemu/pytest-sugar",
"name": "pytest-sugar",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Teemu, Janne Vanhala and others",
"author_email": "orkkiolento@gmail.com, janne.vanhala@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/f5/ac/5754f5edd6d508bc6493bc37d74b928f102a5fff82d9a80347e180998f08/pytest-sugar-1.0.0.tar.gz",
"platform": "any",
"description": "# pytest-sugar \u2728\n\n[](https://github.com/Teemu/pytest-sugar/actions)\n[](https://pypi.org/project/pytest-sugar/)\n[](https://pypi.org/project/pytest-sugar/)\n\n\nThis plugin extends [pytest](http://pytest.org) by showing failures and errors instantly, adding a progress bar, improving the test results, and making the output look better.\n\n\n\n## Installation\n\nTo install pytest-sugar:\n\n python -m pip install pytest-sugar\n\nOnce installed, the plugin is activated automatically. Run your tests normally:\n\n pytest\n\nIf you would like more detailed output (one test per line), then you may use the verbose option:\n\n pytest --verbose\n\nIf you would like to run tests without pytest-sugar, use:\n\n pytest -p no:sugar\n\n## How to contribute \ud83d\udc77\u200d\u2642\ufe0f\n\n[](https://github.com/codespaces/new?hide_repo_select=true&ref=master&repo=10950375)\n\nMake sure to read our [Code of Conduct](https://github.com/Teemu/pytest-sugar/blob/master/.github/CODE_OF_CONDUCT.md). 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.\n\n````\ngit clone git@github.com:Teemu/pytest-sugar.git\ncd pytest-sugar\npython -m venv .venv\nsource .venv/bin/activate\necho \".venv\" >> .git/info/exclude\npip install -e \".[dev]\"\npre-commit install\n````\n\nThere are two ways of running tests. We have our proper tests:\n\n````\npytest .\n````\n\nThere are also fake tests that can be used to visualise the output:\n\n````\npytest faketests\n````\n\nWhen 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:\n\n```markdown\nRelease type: patch\n\nFor long-running tests, display minutes and not only seconds.\n```\n\n## Requirements\n\nYou will need the following prerequisites in order to use pytest-sugar:\n\n- Python 3.8 or newer\n- pytest 6.2 or newer\n\n## Running on Windows\n\nIf you are seeing gibberish, you might want to try changing charset and fonts. See [this comment]( https://github.com/Teemu/pytest-sugar/pull/49#issuecomment-146567670) for more details.\n\n## Similar projects\n\n- [pytest-rich](https://github.com/nicoddemus/pytest-rich)\n- [pytest-pretty](https://github.com/samuelcolvin/pytest-pretty)\n\n\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "pytest-sugar is a plugin for pytest that changes the default look and feel of pytest (e.g. progressbar, show tests that fail instantly).",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/Teemu/pytest-sugar",
"Issue Tracker": "https://github.com/Teemu/pytest-sugar/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "92fb889f1b69da2f13691de09a111c16c4766a433382d44aa0ecf221deded44a",
"md5": "2c378bc59496395b7ba9b4afb6597435",
"sha256": "70ebcd8fc5795dc457ff8b69d266a4e2e8a74ae0c3edc749381c64b5246c8dfd"
},
"downloads": -1,
"filename": "pytest_sugar-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2c378bc59496395b7ba9b4afb6597435",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 10171,
"upload_time": "2024-02-01T18:30:29",
"upload_time_iso_8601": "2024-02-01T18:30:29.395156Z",
"url": "https://files.pythonhosted.org/packages/92/fb/889f1b69da2f13691de09a111c16c4766a433382d44aa0ecf221deded44a/pytest_sugar-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f5ac5754f5edd6d508bc6493bc37d74b928f102a5fff82d9a80347e180998f08",
"md5": "f74f51203bffda323ff57a307fe821bd",
"sha256": "6422e83258f5b0c04ce7c632176c7732cab5fdb909cb39cca5c9139f81276c0a"
},
"downloads": -1,
"filename": "pytest-sugar-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "f74f51203bffda323ff57a307fe821bd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14992,
"upload_time": "2024-02-01T18:30:36",
"upload_time_iso_8601": "2024-02-01T18:30:36.735744Z",
"url": "https://files.pythonhosted.org/packages/f5/ac/5754f5edd6d508bc6493bc37d74b928f102a5fff82d9a80347e180998f08/pytest-sugar-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-01 18:30:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Teemu",
"github_project": "pytest-sugar",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "pytest-sugar"
}
JSON
