Cleanup and docs

Author: BeyondEvil

.travis.yml

@@ -9,6 +9,9 @@ jobs:
       before_install: skip
       addons: skip
       env: TOXENV=linting
+      cache:
+        directories:
+          - $HOME/.cache/pre-commit
 
     -
       name: Docs

docs/development.rst

@@ -1,6 +1,25 @@
 Development
 ===========
 
+To contribute to `pytest-selenium` you can use `Pipenv`_ to manage
+a python virutal environment and `pre-commit <https://pre-commit.com/>`_ to help you with
+styling and formatting.
+
+To setup the virtual environment and pre-commit, run:
+
+.. code-block:: bash
+
+  $ pipenv install --dev
+  $ pipenv run pre-commit install
+
+If you're not using `Pipenv`_, to install `pre-commit`, run:
+
+.. code-block:: bash
+
+  $ pip install pre-commit
+  $ pre-commit install
+
+
 Automated Testing
 -----------------
 
@@ -14,11 +33,22 @@ not, you can find it on the
 The only way to trigger Travis CI to run again for a pull request, is to submit
 another change to the pull branch.
 
+You can do this with `git commit --allow-empty`
+
 Running Tests
 -------------
 
 You will need `Tox <http://tox.testrun.org/>`_ installed to run the tests
-against the supported Python versions.
+against the supported Python versions. If you're using `Pipenv`_ it will be
+installed for you.
+
+With `Pipenv`_, run:
+
+.. code-block:: bash
+
+  $ pipenv run tox
+
+Otherwise, to install and run, do:
 
 .. code-block:: bash
 
@@ -74,3 +104,5 @@ Follow these steps to release a new version of the project:
 6. Tag the release with the new release version (``git tag v<new tag>``)
 7. Push the tag (``git push upstream --tags``)
 8. Done. You can monitor the progress on `Travis <https://travis-ci.org/pytest-dev/pytest-selenium/>`_
+
+.. _Pipenv: https://docs.pipenv.org/en/latest/

tox.ini

@@ -28,18 +28,6 @@ basepython = python3
 deps = pre-commit
 commands = pre-commit run --all-files --show-diff-on-failure
 
-[testenv:flake8]
-skip_install = true
-basepython = python
-deps = flake8
-commands = flake8 {posargs:.}
-
-[testenv:black]
-skip_install = true
-basepython = python
-deps = black
-commands = black --check {posargs:.}
-
 [flake8]
 max-line-length = 88
 exclude = .eggs,.tox,docs