Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/idris-rampurawala/flask-boilerplate
A Flask Boilerplate to quickly get started with production-grade flask application. It has some additional packages pre-configured for ease of development.
https://github.com/idris-rampurawala/flask-boilerplate
celery-workers flask flask-application flask-backend flask-boilerplate python python3
Last synced: about 1 month ago
JSON representation
A Flask Boilerplate to quickly get started with production-grade flask application. It has some additional packages pre-configured for ease of development.
- Host: GitHub
- URL: https://github.com/idris-rampurawala/flask-boilerplate
- Owner: idris-rampurawala
- License: mit
- Created: 2020-07-20T14:25:11.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-05-20T19:18:12.000Z (over 1 year ago)
- Last Synced: 2024-08-13T07:08:23.424Z (5 months ago)
- Topics: celery-workers, flask, flask-application, flask-backend, flask-boilerplate, python, python3
- Language: Python
- Homepage:
- Size: 94.7 KB
- Stars: 81
- Watchers: 3
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - idris-rampurawala/flask-boilerplate - A Flask Boilerplate to quickly get started with production-grade flask application. It has some additional packages pre-configured for ease of development. (Python)
README
# Flask Boilerplate
[](LICENSE)
Flask Boilerplate to quickly get started with production grade flask application with some additional packages and configuration prebuilt.
You can find an in-depth article on this implementation [here](https://dev.to/idrisrampurawala/flask-boilerplate-structuring-flask-app-3kcd).
# Contributing
We encourage you to contribute to Flask Boilerplate! Please check out the [Contributing](CONTRIBUTING.md) guidelines about how to proceed.
# Getting Started
### Prerequisites
- Python 3.11.3 or higher
- Up and running Redis client
### Project setup
```sh
# clone the repo
$ git clone https://github.com/idris-rampurawala/flask-boilerplate.git
# move to the project folder
$ cd flask-boilerplate
```
If you want to install redis via docker
```sh
$ docker run -d --name="flask-boilerplate-redis" -p 6379:6379 redis
```
### Creating virtual environment
- Install `pipenv` a global python project `pip install pipenv`
- Create a `virtual environment` for this project
```shell
# creating pipenv environment for python 3
$ pipenv --three
# activating the pipenv environment
$ pipenv shell
# install all dependencies (include -d for installing dev dependencies)
$ pipenv install -d
# if you have multiple python 3 versions installed then
$ pipenv install -d --python 3.11
```
### Configuration
- There are 3 configurations `development`, `staging` and `production` in `config.py`. Default is `development`
- Create a `.env` file from `.env.example` and set appropriate environment variables before running the project
### Running app
- Run flask app `python run.py`
- Logs would be generated under `log` folder
### Running celery workers
- Run redis locally before running celery worker
- Celery worker can be started with following command
```sh
# run following command in a separate terminal
$ celery -A celery_worker.celery worker --loglevel='INFO'
# (append `--pool=solo` for windows)
```
# Preconfigured Packages
Includes preconfigured packages to kick start flask app by just setting appropriate configuration.
| Package | Usage |
|----- |----- |
| [celery](https://docs.celeryproject.org/en/stable/getting-started/introduction.html) | Running background tasks |
| [redis](https://redislabs.com/lp/python-redis/) | A Python Redis client for caching |
| [flask-cors](https://flask-cors.readthedocs.io/) | Configuring CORS |
| [python-dotenv](https://pypi.org/project/python-dotenv/) | Reads the key-value pair from .env file and adds them to environment variable. |
| [marshmallow](https://marshmallow.readthedocs.io/en/stable/) | A package for creating Schema, serialization, deserialization |
| [webargs](https://webargs.readthedocs.io/) | A Python library for parsing and validating HTTP request objects |
`autopep8` & `flake8` as `dev` packages for `linting and formatting`
# Test
Test if this app has been installed correctly and it is working via following curl commands (or use in Postman)
- Check if the app is running via `status` API
```shell
$ curl --location --request GET 'http://localhost:5000/status'
```
- Check if core app API and celery task is working via
```shell
$ curl --location --request GET 'http://localhost:5000/api/v1/core/test'
```
- Check if authorization is working via (change `API Key` as per you `.env`)
```shell
$ curl --location --request GET 'http://localhost:5000/api/v1/core/restricted' --header 'x-api-key: 436236939443955C11494D448451F'
```
# License
This program is free software under MIT license. Please see the [LICENSE](LICENSE) file in our repository for the full text.