diff --git a/docs/contributing.rst b/docs/contributing.rst new file mode 100644 index 0000000..ba61c15 --- /dev/null +++ b/docs/contributing.rst @@ -0,0 +1,54 @@ +============ +Contributing +============ + +Test simple changes +=================== + +Requests-OAuthlib is using `tox`_ as main test tool. +It helps creating the required virtualenv for your python version. +For example, if you have installed Python3.7: + +.. sourcecode:: bash + + $ tox -e py37 + + +Validate documentation changes +============================== + +Tox contains also a build method to generate documentation locally. + +.. sourcecode:: bash + + $ tox -e docs,readme + +Then open the HTML page in `_build/html/index.html` + + +Verify all pythons versions +=========================== + +Requests-OAuthlib supports multiple versions of Python. +You can test all Python versions conveniently using `tox`_. + +.. sourcecode:: bash + + $ tox + +In order to run successfully, you will need all versions of Python installed. We recommend using `pyenv`_ to install those Python versions. + +.. sourcecode:: bash + + $ pyenv install 2.7.18 + $ pyenv install 3.4.10 + $ pyenv install 3.5.10 + $ pyenv install 3.6.14 + $ pyenv install 3.7.11 + $ pyenv install pypy2.7-7.1.1 + $ pyenv install pypy3.6-7.1.1 + +.. _`tox`: https://tox.readthedocs.io/en/latest/install.html +.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/installation/ +.. _`pyenv`: https://github.com/pyenv/pyenv + diff --git a/docs/index.rst b/docs/index.rst index e933eb3..ad5138d 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -72,6 +72,7 @@ Getting Started: examples/examples api + contributing