Install local Environment
Configuration
To get local environment working, we recommend to use a custom domain, as ‘georiviere.local’. Define it in your /etc/hosts.
Copy the env dist file
cp .env.dist .env
Set required values, for postgres database access
Init database:
docker-compose run --rm web ./manage.py migrate
Create user:
docker-compose run --rm web ./manage.py createsuperuser
Run:
docker-compose up
Launch tests :
docker-compose run --rm web ./manage.py test
With coverage :
docker-compose run --rm web coverage run ./manage.py test
docker-compose run --rm web coverage report -m
Dependencies :
Manage all project dependencies with pip-tools
Use included pip-tools to generate requirements (python version should match georiviere version)
Global dependencies :
set global dependency in requirements.in
docker-compose run --rm web pip-compile
pip-tools does not upgrade any package by default. Package is upgrade only if new dependency require another version that already fixed in requirements.txt file.
To upgrade a package, run :
docker-compose run --rm web pip-compile --upgrade-package django==3.1.*
Development packages are separated in dev-requirements.in. dev-requirements.txt depends on requirements.txt. Each time you run pip-compile, dev-requirements.txt is updated. Each time you run pip-compile for requirements.txt, you should run pip-compile for dev-requirements.txt.
docker-compose run --rm web pip-compile dev-requirements.in
Warning
Geotrek is used as main library of this project. Sub-dependencies are not yet managed in geotrek setup.py. When you update geotrek, you should update requirements according geotrek dependencies versions.