Service for saving favorite places.
Install the appropriate software:
- Docker Desktop.
- Git.
- PyCharm (optional).
Clone the repository to your computer:
git clone https://github.com/mnv/python-course-favorite-places.git
-
To configure the application copy
.env.sample
into.env
file:cp .env.sample .env
This file contains environment variables that will share their values across the application. The sample file (
.env.sample
) contains a set of variables with default values. So it can be configured depending on the environment. -
Build the container using Docker Compose:
docker compose build
This command should be run from the root directory where
Dockerfile
is located. You also need to build the docker container again in case if you have updatedrequirements.txt
. -
To run application correctly set up the database. Apply migrations to create tables in the database:
docker compose run favorite-places-app alembic upgrade head
-
Now it is possible to run the project inside the Docker container:
docker compose up
When containers are up server starts at http://0.0.0.0:8010/docs. You can open it in your browser.
To first initialize migration functionality run:
docker compose exec favorite-places-app alembic init -t async migrations
This command will create a directory with configuration files to set up asynchronous migrations' functionality.
To create new migrations that will update database tables according updated models run this command:
docker compose run favorite-places-app alembic revision --autogenerate -m "your description"
To apply created migrations run:
docker compose run favorite-places-app alembic upgrade head
The project contains a special Makefile
that provides shortcuts for a set of commands:
-
Build the Docker container:
make build
-
Generate Sphinx documentation run:
make docs-html
-
Autoformat source code:
make format
-
Static analysis (linters):
make lint
-
Autotests:
make test
The test coverage report will be located at
src/htmlcov/index.html
. So you can estimate the quality of automated test coverage. -
Run autoformat, linters and tests in one command:
make all
Run these commands from the source directory where Makefile
is located.
The project integrated with the Sphinx documentation engine. It allows the creation of documentation from source code. So the source code should contain docstrings in reStructuredText format.
To create HTML documentation run this command from the source directory where Makefile
is located:
make docs-html
After generation documentation can be opened from a file docs/build/html/index.html
.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.