| Name | tox-extra JSON |
| Version |
2.1.0
JSON |
| download |
| home_page | None |
| Summary | Performs extra checks before or after running |
| upload_time | 2024-11-18 22:10:33 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | MIT |
| keywords |
git
tox
tox-plugin
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# tox-extra
This [tox plugin](https://github.com/topics/tox-plugin) adds a few extra checks
like:
- [tox-extra](#tox-extra)
- [Checks Git Dirty Status](#checks-git-dirty-status)
- [Checks system dependencies using bindep](#checks-system-dependencies-using-bindep)
## Checks Git Dirty Status
It ensures exit code 1 if git reports dirty or untracked files _after_ the run.
Usage example:
```shell
$ tox -e py
...
ERROR: Git reported dirty status. Git should never report dirty status at the end of testing, regardless if status is passed, failed or aborted.
On branch devel
Your branch is up to date with 'origin/devel'.
Untracked files:
(use "git add <file>..." to include in what will be committed)
some-untracked.txt
nothing added to commit but untracked files present (use "git add" to track)
__________________________________________ summary ___________________________________________
ERROR: py: failed
```
The goal of this plugin is to help developers be aware of files modified by tests
or untracked files before they commit the code. This plugin also does not take into
consideration the global `.gitignore`, something that can make git miss reporting
some untracked files, the goal being to assure that when a new developer clones and
runs the tests they do not endup with an unexpected git status.
If you have any cases where you expect to have git report dirty, please
add `--allow-dirty` to the command call to disable this check.
## Checks system dependencies using bindep
If a `bindep.txt` config file is found, tox will run `bindep [profiles]` to
check if dependencies, including test ones, are present. There is no need to
install bindep your self.
This plugin will add the following list of bindep profiles:
- `test` is always added as tox itself is a test tool
- exact tox env name
- tox env name itself split by `-'
- `pythonX.Y` and `pyXY` based on which python current tox env will use
This should allow developers to modify their `bindep.txt` file to include
system dependencies specific to a single tox environment if they wish.
To disable bindep feature, you can define `TOX_EXTRA_BINDEP=0` in your
environment.
Raw data
{
"_id": null,
"home_page": null,
"name": "tox-extra",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Sorin Sbarnea <sorin.sbarnea@gmail.com>",
"keywords": "git, tox, tox-plugin",
"author": null,
"author_email": "Sorin Sbarnea <sorin.sbarnea@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/bc/48/f41983e7f6fd2163c5abc21b82e33f497d7e138cb52cfa1dd2fb1095a6ce/tox_extra-2.1.0.tar.gz",
"platform": null,
"description": "# tox-extra\n\nThis [tox plugin](https://github.com/topics/tox-plugin) adds a few extra checks\nlike:\n\n- [tox-extra](#tox-extra)\n - [Checks Git Dirty Status](#checks-git-dirty-status)\n - [Checks system dependencies using bindep](#checks-system-dependencies-using-bindep)\n\n## Checks Git Dirty Status\n\nIt ensures exit code 1 if git reports dirty or untracked files _after_ the run.\n\nUsage example:\n\n```shell\n$ tox -e py\n...\nERROR: Git reported dirty status. Git should never report dirty status at the end of testing, regardless if status is passed, failed or aborted.\nOn branch devel\nYour branch is up to date with 'origin/devel'.\n\nUntracked files:\n (use \"git add <file>...\" to include in what will be committed)\n\tsome-untracked.txt\n\nnothing added to commit but untracked files present (use \"git add\" to track)\n__________________________________________ summary ___________________________________________\nERROR: py: failed\n```\n\nThe goal of this plugin is to help developers be aware of files modified by tests\nor untracked files before they commit the code. This plugin also does not take into\nconsideration the global `.gitignore`, something that can make git miss reporting\nsome untracked files, the goal being to assure that when a new developer clones and\nruns the tests they do not endup with an unexpected git status.\n\nIf you have any cases where you expect to have git report dirty, please\nadd `--allow-dirty` to the command call to disable this check.\n\n## Checks system dependencies using bindep\n\nIf a `bindep.txt` config file is found, tox will run `bindep [profiles]` to\ncheck if dependencies, including test ones, are present. There is no need to\ninstall bindep your self.\n\nThis plugin will add the following list of bindep profiles:\n\n- `test` is always added as tox itself is a test tool\n- exact tox env name\n- tox env name itself split by `-'\n- `pythonX.Y` and `pyXY` based on which python current tox env will use\n\nThis should allow developers to modify their `bindep.txt` file to include\nsystem dependencies specific to a single tox environment if they wish.\n\nTo disable bindep feature, you can define `TOX_EXTRA_BINDEP=0` in your\nenvironment.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Performs extra checks before or after running",
"version": "2.1.0",
"project_urls": {
"changelog": "https://github.com/tox-dev/tox-extra/releases",
"homepage": "https://github.com/tox-dev/tox-extra",
"issues": "https://github.com/tox-dev/tox-extra/issues",
"repository": "https://github.com/tox-dev/tox-extra"
},
"split_keywords": [
"git",
" tox",
" tox-plugin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "28d486554b25ef5ec620c8e0d6ca7d7872b854f09f522818567da4532305f549",
"md5": "e3838e5629b72ee92a72c328f2a0fb08",
"sha256": "151905212cc2258923901607a7d693b8aa4c45cb33616808c68cc8aff9f6734f"
},
"downloads": -1,
"filename": "tox_extra-2.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e3838e5629b72ee92a72c328f2a0fb08",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6517,
"upload_time": "2024-11-18T22:10:31",
"upload_time_iso_8601": "2024-11-18T22:10:31.756677Z",
"url": "https://files.pythonhosted.org/packages/28/d4/86554b25ef5ec620c8e0d6ca7d7872b854f09f522818567da4532305f549/tox_extra-2.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bc48f41983e7f6fd2163c5abc21b82e33f497d7e138cb52cfa1dd2fb1095a6ce",
"md5": "e3be750784ca7437f0ec8af28a0f5239",
"sha256": "4ff0589cada2a0ca672c4598fd42691605f801358d5e508c2d07d27f9800de29"
},
"downloads": -1,
"filename": "tox_extra-2.1.0.tar.gz",
"has_sig": false,
"md5_digest": "e3be750784ca7437f0ec8af28a0f5239",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 15698,
"upload_time": "2024-11-18T22:10:33",
"upload_time_iso_8601": "2024-11-18T22:10:33.710686Z",
"url": "https://files.pythonhosted.org/packages/bc/48/f41983e7f6fd2163c5abc21b82e33f497d7e138cb52cfa1dd2fb1095a6ce/tox_extra-2.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-18 22:10:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tox-dev",
"github_project": "tox-extra",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "tox-extra"
}
