Skip to content

Commit 15fd82c

Browse files
committed
Updated README and raised version to 0.1.1
1 parent fa3f0b6 commit 15fd82c

File tree

2 files changed

+16
-49
lines changed

2 files changed

+16
-49
lines changed

README.rst

Lines changed: 15 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -18,63 +18,30 @@ tox-envreport
1818
:target: https://ci.appveyor.com/project/useblocks/tox-envreport/branch/master
1919
:alt: See Build Status on AppVeyor
2020

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.
3823

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``.
3926

4027
Installation
4128
------------
42-
43-
You can install "tox-envreport" via `pip`_ from `PyPI`_::
44-
45-
$ pip install tox-envreport
46-
29+
``pip install tox-envreport``
4730

4831
Usage
4932
-----
5033

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.
6235

36+
There is nothing more to do or to configure.
6337

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.
6642

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*.
6846

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``.

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ def read(fname):
1515
name='tox-envreport',
1616
description='A simple plugin to use with tox',
1717
long_description=read('README.rst'),
18-
version='0.1.0',
18+
version='0.1.1',
1919
author='team useblocks',
2020
author_email='team@useblocks.com',
2121
maintainer='team useblocks',

0 commit comments

Comments
 (0)