Development

How to configure a development environment

Requirements and recommended tools

• Python 3.8
• Node.js 14.3.0
• nvm (recommended)
• Visual Studio Code

Requirements to install the dependencies

Windows

Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/

Linux

Refer to the contents of the provided Dockerfile for a reference of required packages to compile all dependencies. In general, tools to compile C libraries are necessary, packages required by Pillow to handle JPEGs, and SQLite.

libjpeg-dev
zlib1g-dev

Using PostgreSQL

This page documents how to connect to a development instance of the PostgreSQL database using pgAdmin with Docker. When developing web applications, it is often useful to connect directly to the development environment database, for example to inspect the shape of the database after running migrations.

Run an instance of pgAdmin, mapping the local port 8080 to the container's port 80 (change the local port as desired).

docker run -p 8080:80 \
  -e 'PGADMIN_DEFAULT_EMAIL=user@domain.com' \
  -e 'PGADMIN_DEFAULT_PASSWORD=SuperSecret' \
  -d dpage/pgadmin4

Configuring a development environment

Watch the following video tutorial, which presents Torino and explains how to configure a development environment, to know how to run the solution locally: Presenting Torino: configuring a development environment.