Sample FastAPI application

Sample FastAPI application.

Template

Note that this is a template project. You will need to make changes to this application if you want to make use of it. Please read the Template readme file for more information on what this project does and how to use the template.

Development setup

Prerequisites

(Optional) Install Pyenv (Linux, Windows) and the Python installation needed for this project:

pyenv install

Install poetry to your system by following the setup instructions convenient for you.

Important

You should NOT install poetry into your virtual environment as stated in their docs, as this may mess with your dependencies.

Setup

Create a virtual environment:

# Note: For POSIX, pyenv can create a named virtual environment which you can use instead.
# For Windows, pyenv-win exists, but doesn't have this feature afaik.

# Create a local virtual environment (inside .venv/)
python3 -m venv .venv

# Activate it:

# Windows
./.venv/Scripts/activate

# POSIX
source ./.venv/bin/activate

Create development environment and install dependencies (pre-made script does it):

# [Windows] Run the `scripts/dev-setup.bat` script:
./scripts/dev-setup.bat

# [POSIX] Run the `scripts/dev-setup.sh` shell script using any bash-compatible shell:
bash ./scripts/dev-setup.sh

Note

This scripts does the following: Creates a dev/ folder needed to save log files and other persistent files used by the app, installs the requirements of the app using poetry, installs pre-commit hooks to this repository and also runs the pre-commit hooks.

Create a .env file from the given example and edit it:

cp .env.example .env

# Open the new .env file in your favourite editor and make the required changes

Run the dev server using F5 key in VSCode. You can also use the dev-launch shell script:

# Windows
./scripts/dev-launch.bat

# POSIX
bash ./scripts/dev-launch.sh

You can also run the cli script:

sample-fastapi --help

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!