Setting Up Your Project

First we need to prepare a Python project. We will use a Python virtual environment, and the project configuration file pyproject.toml.

Important

Ligare requires a minimum Python version of 3.10.

Create a project directory, create a new virtual environment, and activate the virtual environment.

user@: $ mkdir my-ligare-app && cd my-ligare-app
user@: my-ligare-app $ python -m venv .venv
user@: my-ligare-app $ . .venv/bin/activate

The following commands are executed with the virtual environment activated.

Now we can create a minimal pyproject.toml file that lets us create our application, and install Ligare.web.

user@: my-ligare-app $ cat > pyproject.toml << EOF
[project]
requires-python = ">= 3.10"

name = "web-api"
version = "0.0.1"

dependencies = [
   "Ligare.web"
]

EOF

Once completed, our pyproject.toml should look like this.

Review example sources [web-api/pyproject.toml]

[project]
requires-python = ">= 3.10"

name = "web-api"
version = "0.0.1"

dependencies = [
    "Ligare.web"
]

Now we can install everything necessary to create a Ligare application.

Note

We use -e here so changes to our application can run without requiring a reinstall.

user@: my-ligare-app $ pip install -e .