Run tests in parallel

Author: kura

.github/workflows/ci.yml

@@ -45,7 +45,9 @@ jobs:
           sudo make install
           popd
       - name: Run tests
-        run: tox -vv
+        env:
+          TOX_PARALLEL_NO_SPINNER: 1
+        run: tox -vvp
       - name: Generate coverage report
         run: tox -e coverage-report
       - name: Upload coverage

Makefile

@@ -55,23 +55,23 @@ test:
 
 .PHONY: test_py37
 test_py37:
-	tox -vv -e py37,py37-setproctitle,py37-uvloop
+	tox -vvp -e py37,py37-setproctitle,py37-uvloop
 
 .PHONY: test_py38
 test_py38:
-	tox -vv -e py38,py38-setproctitle,py38-uvloop
+	tox -vvp -e py38,py38-setproctitle,py38-uvloop
 
 .PHONY: test_py39
 test_py39:
-	tox -vv -e py39,py39-setproctitle,py39-uvloop
+	tox -vvp -e py39,py39-setproctitle,py39-uvloop
 
 .PHONY: test_pypy3
 test_pypy:
-	tox -vv -e pypy3,pypy3-setproctitle,py39-uvloop
+	tox -vvp -e pypy3,pypy3-setproctitle,py39-uvloop
 
 .PHONY: test_pyston-3
 test_pyston-3:
-	tox -vv -e pyston-3,pyston-3-setproctitle,pyston-3-uvloop
+	tox -vvp -e pyston-3,pyston-3-setproctitle,pyston-3-uvloop
 
 .PHONY: test_build
 test_build:

README.rst

@@ -26,6 +26,12 @@ randomly do either of those two actions.
 Think of Blackhole sort of like a honeypot in terms of how it handles mail, but
 it's specifically designed with testing in mind.
 
+Python support
+==============
+
+- Python 3.7+
+- PyPy 3.7+
+- Pyston 2.2+
 
 Documentation
 =============

docs/source/overview.rst

@@ -31,8 +31,16 @@ Overview
 Requirements
 ============
 
+Python support
+--------------
+
 - Python 3.7+, PyPy 3.7+, or Pyston 2.2+
 
+Extras
+------
+
+- `setproctitle` if you wish to have named processes
+- `uvloop` if you wish to use `libuv`
 
 .. _installation:
 
@@ -46,6 +54,27 @@ PyPI
 
   pip install blackhole
 
+Installing with extas
+#####################
+
+- For uvloop support
+
+.. code-block:: bash
+
+  pip install blackhole[uvloop]
+
+- For setproctitle support
+
+.. code-block:: bash
+
+  pip install blackhole[setproctitle]
+
+For both `uvloop` and `setproctitle`
+
+.. code-block:: bash
+
+  pip install blackhole[uvloop,setproctitle]
+
 Source
 ------
 

tox.ini

@@ -33,6 +33,7 @@ python =
 
 [testenv]
 setenv = VIRTUALENV_NO_DOWNLOAD=1
+parallel_show_output = true
 deps =
     setproctitle: setproctitle
     uvloop: uvloop