@@ -18,63 +18,30 @@ tox-envreport
18
18
:target: https://ci.appveyor.com/project/useblocks/tox-envreport/branch/master
19
19
:alt: See Build Status on AppVeyor
20
20
21
- A simple plugin to use with tox
22
-
23
- ----
24
-
25
- This `Pytest `_ plugin was generated with `Cookiecutter `_ along with `@obestwalter `_'s `Cookiecutter-tox-plugin `_ template.
26
-
27
-
28
- Features
29
- --------
30
-
31
- * TODO
32
-
33
-
34
- Requirements
35
- ------------
36
-
37
- * TODO
21
+ `tox-envreport ` is a plugin for `tox <https://tox.readthedocs.io/en/latest/ >`_
22
+ to document the setup of used virtual environments.
38
23
24
+ Collected information are stored in a file called ``env_report.json `` inside the `.tox ` folder.
25
+ For example: ``MY_PROJECT/.tox/env_report.json ``.
39
26
40
27
Installation
41
28
------------
42
-
43
- You can install "tox-envreport" via `pip `_ from `PyPI `_::
44
-
45
- $ pip install tox-envreport
46
-
29
+ ``pip install tox-envreport ``
47
30
48
31
Usage
49
32
-----
50
33
51
- * TODO
52
-
53
- Contributing
54
- ------------
55
- Contributions are very welcome. Tests can be run with `tox `_, please ensure
56
- the coverage at least stays the same before you submit a pull request.
57
-
58
- License
59
- -------
60
-
61
- Distributed under the terms of the `MIT `_ license, "tox-envreport" is free and open source software
34
+ The installation of the plugin is enough to automatically activate it for each tox run.
62
35
36
+ There is nothing more to do or to configure.
63
37
64
- Issues
65
- ------
38
+ Access reports
39
+ --------------
40
+ `tox-envreport ` creates one common ``env_report.json `` file, which contains all information about all used virtual
41
+ environments (venv) by tox.
66
42
67
- If you encounter any problems, please `file an issue `_ along with a detailed description.
43
+ Beside this a venv specific file is generated as well and contains information about the related venv only.
44
+ You can find this file in the venv-specific tox-folder. E.g: ``MY_PROJECT/.tox/py27/env_report_py27.json ``
45
+ for a venv called *py27 *.
68
46
69
- .. _`Cookiecutter` : https://github.com/audreyr/cookiecutter
70
- .. _`@obestwalter` : https://github.com/obestwalter
71
- .. _`MIT` : http://opensource.org/licenses/MIT
72
- .. _`BSD-3` : http://opensource.org/licenses/BSD-3-Clause
73
- .. _`GNU GPL v3.0` : http://www.gnu.org/licenses/gpl-3.0.txt
74
- .. _`Apache Software License 2.0` : http://www.apache.org/licenses/LICENSE-2.0
75
- .. _`cookiecutter-tox-plugin` : https://github.com/tox-dev/cookiecutter-tox-plugin
76
- .. _`file an issue` : https://github.com/useblocks/tox-envreport/issues
77
- .. _`pytest` : https://github.com/pytest-dev/pytest
78
- .. _`tox` : https://tox.readthedocs.io/en/latest/
79
- .. _`pip` : https://pypi.org/project/pip/
80
- .. _`PyPI` : https://pypi.org
47
+ The report file itself contains the venv-name as postfix. E.g.: ``env_report_py27.json ``.
0 commit comments