This is a template application that can be used to quickly create an API using Python and the Flask framework. This template includes a number of already implemented features and modules, including:
- Python/Flask-based API that writes to a database using API key authentication with example endpoints
- PostgreSQL database + Alembic migrations configured for updating the database when the SQLAlchemy database models are updated
- Thorough formatting & linting tools
- Logging, with formatting in both human-readable and JSON formats
- Backend script that generates a CSV locally or on S3 with proper credentials
- Ability to run the various utility scripts inside or outside of Docker
- Restructured and improved API request and response error handling which gives more details than the out-of-the-box approach for both Connexion and Pydantic
- Easy environment variable configuration for local development using a
local.envfile
The template application is intended to work with the infrastructure from template-infra.
To get started using the template application on your project:
-
Run the download and install script in your project's root directory.
curl https://raw.githubusercontent.com/navapbc/template-application-flask/main/template-only-bin/download-and-install-template.sh | bash -sThis script will:
- Clone the template repository
- Copy the template files into your project directory
- Remove any files specific to the template repository.
-
Optional, if using the Platform infra template: Follow the steps in the
template-infraREADME to set up the various pieces of your infrastructure.
If you are using template-infra, you may want to increase the default memory allocated to the ECS service to 2048 Mb (2 Gb) to avoid the gunicorn workers running out of memory. This is because the application is currently configured to create multiple workers based on the number of virtual CPUs available, which can take up more memory.
Now you're ready to get started.