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
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2020-11-05 16:51:59 +00:00
|
|
|
To try a development environment, you can run the docker image and then open https://127.0.0.1:5000
|
|
|
|
|
You can then connect with user *admin* and password *admin* to access an admin account, or user *user* and password *user* for a regular one.
|
|
|
|
|
|
2020-11-06 10:44:25 +00:00
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
cp canaille/conf/config.sample.toml canaille/conf/config.toml
|
|
|
|
|
cp canaille/conf/oauth-authorization-server.sample.json canaille/conf/oauth-authorization-server.json
|
|
|
|
|
cp canaille/conf/openid-configuration.sample.json canaille/conf/openid-configuration.json
|
2020-11-06 17:38:14 +00:00
|
|
|
cd dev
|
2020-11-06 10:44:25 +00:00
|
|
|
docker-compose up
|
