| Index: README.md |
| =================================================================== |
| --- a/README.md |
| +++ b/README.md |
| @@ -0,0 +1,26 @@ |
| +# python-abp |
| + |
| +A library for working with Adblock Plus filter lists |
| + |
| +## Testing |
| + |
| +Unit tests for `python-abp` are located in the `/tests` directory. |
| +[Pytest](http://pytest.org/) is used for quickly running the tests |
| +during development. |
| +[Tox](https://tox.readthedocs.org/) is used for testing in different |
| +environments (Python 2.7, Python 3.5 and PyPy) and code quality |
| +reporting. |
| + |
| +In order to execute the tests, first create and activate development |
| +virtualenv: |
| + |
| + $ python setup.py devenv |
| + $ . devenv/bin/activate |
| + |
| +With the development virtualenv activated use pytest for a quick test run: |
| + |
| + (devenv) $ py.test tests |
| + |
| +and tox for a comprehensive report: |
| + |
| + (devenv) $ tox |