2020-06-01 09:37:30 +08:00
Contributing to Tianshou
========================
2020-03-29 10:22:03 +08:00
2020-04-11 19:29:46 +08:00
Install Develop Version
2020-06-02 08:51:14 +08:00
-----------------------
2020-03-29 10:22:03 +08:00
2020-04-11 19:29:46 +08:00
To install Tianshou in an "editable" mode, run
.. code-block :: bash
2020-06-01 08:30:09 +08:00
pip3 install -e ".[dev]"
2020-04-11 19:29:46 +08:00
in the main directory. This installation is removable by
.. code-block :: bash
python3 setup.py develop --uninstall
PEP8 Code Style Check
2020-06-02 08:51:14 +08:00
---------------------
2020-04-11 19:29:46 +08:00
We follow PEP8 python code style. To check, in the main directory, run:
.. code-block :: bash
flake8 . --count --show-source --statistics
Test Locally
2020-06-02 08:51:14 +08:00
------------
2020-04-11 19:29:46 +08:00
This command will run automatic tests in the main directory
.. code-block :: bash
2020-05-16 08:48:12 +08:00
pytest test --cov tianshou -s --durations 0 -v
2020-04-11 19:29:46 +08:00
Test by GitHub Actions
2020-06-02 08:51:14 +08:00
----------------------
2020-04-11 19:29:46 +08:00
2020-04-13 19:37:27 +08:00
1. Click the `` Actions `` button in your own repo:
2020-04-11 19:29:46 +08:00
.. image :: _static/images/action1.jpg
:align: center
2. Click the green button:
.. image :: _static/images/action2.jpg
:align: center
3. You will see `` Actions Enabled. `` on the top of html page.
4. When you push a new commit to your own repo (e.g. `` git push `` ), it will automatically run the test in this page:
.. image :: _static/images/action3.png
:align: center
Documentation
2020-06-02 08:51:14 +08:00
-------------
2020-04-11 19:29:46 +08:00
Documentations are written under the `` docs/ `` directory as ReStructuredText (`` .rst `` ) files. `` index.rst `` is the main page. A Tutorial on ReStructuredText can be found `here <https://pythonhosted.org/an_example_pypi_project/sphinx.html> `_ .
API References are automatically generated by `Sphinx <http://www.sphinx-doc.org/en/stable/> `_ according to the outlines under `` docs/api/ `` and should be modified when any code changes.
To compile documentation into webpages, run
.. code-block :: bash
make html
under the `` docs/ `` directory. The generated webpages are in `` docs/_build `` and can be viewed with browsers.
2020-06-01 08:30:09 +08:00
Chinese Documentation
2020-06-02 08:51:14 +08:00
---------------------
2020-06-01 08:30:09 +08:00
2020-06-02 08:51:14 +08:00
Chinese documentation is in https://tianshou.readthedocs.io/zh/latest/
