mirror of https://github.com/saimn/sigal.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
39 lines
872 B
39 lines
872 B
12 years ago
|
=========================
|
||
|
|
Contributing guidelines
|
||
|
|
=========================
|
||
|
|
|
||
|
|
.. include:: ../CONTRIBUTING.rst
|
||
|
|
|
||
|
|
Setting up the development environment
|
||
|
|
--------------------------------------
|
||
|
|
|
||
|
|
Using a virtualenv_::
|
||
|
|
|
||
|
|
git clone https://github.com/saimn/sigal.git
|
||
|
|
cd sigal
|
||
|
|
virtualenv venv
|
||
|
|
. venv/activate
|
||
|
|
|
||
|
|
Install sigal in development mode::
|
||
|
|
|
||
|
|
pip install -e .
|
||
|
|
|
||
|
|
Install additional dependencies for development (Sphinx, ...)::
|
||
|
|
|
||
|
|
pip install -r requirements.txt
|
||
|
|
|
||
|
|
Building the docs
|
||
|
|
-----------------
|
||
|
|
|
||
|
|
- Run ``make docs`` (or ``make html`` in the ``docs/`` directory).
|
||
|
|
|
||
|
|
Running the test suite
|
||
|
|
----------------------
|
||
|
|
|
||
|
|
- Run ``make test`` (or ``py.test``).
|
||
|
|
- Run ``make coverage`` to get the coverage report.
|
||
|
|
- Using tox_ you can also run the tests on multiple versions of python.
|
||
|
|
|
||
|
|
.. _tox: https://testrun.org/tox/
|
||
|
|
.. _virtualenv: https://virtualenv.pypa.io/
|