canaille-globuzma/CONTRIBUTING.rst

35 lines
811 B
ReStructuredText
Raw Normal View History

2020-11-06 10:44:25 +00:00
Contribute
==========
2020-11-05 16:51:59 +00:00
Contributions are welcome!
2020-11-06 10:44:25 +00:00
Unit tests
----------
2020-11-05 16:51:59 +00:00
To run the tests, you just need to run `tox`. Everything must be green before patches get merged.
2020-11-06 10:44:25 +00:00
Style
-----
2020-11-05 16:51:59 +00:00
We use `black` to format our code. Please apply `black` on your patches before submiting them.
2020-11-06 10:44:25 +00:00
Development environment
-----------------------
.. code-block:: console
cd demo
./run.sh # or `docker-compose up` to run it with docker
2020-11-12 08:30:39 +00:00
Then you have access to:
- A canaille server at http://localhost:5000
- A dummy client at http://localhost:5001
- Another dummy client at http://localhost:5002
2020-11-12 08:30:39 +00:00
The canaille server has some default users:
- A regular user which login and password are **user**;
- A moderator user which login and password are **moderator**;
- An admin user which admin and password are **admin**.