Simple Flask API Boilerplate enhanced with JWT authentication, SqlAlchemy, SQLite persistence and deployment scripts via Docker - Provided by AppSeed. It has all the ready-to-use bare minimum essentials.

Features:

• ✅ Up-to-date dependencies
• ✅ API Definition - the unified API structure implemented by this server
• ✅ Flask-restX, Flask-jwt_extended
• ✅ Docker, Unitary tests
• 🚀 Instant Deploy on RENDER using Python Deployer
  • python.exe deployer.py flask <THIS_REPO> "run:app"

Can be used with other React Starters for a complete Full-Stack experience:

React Node JS Berry	React Node Soft Dashboard	React Node Horizon

Get the code

$ git clone https://github.com/app-generator/api-server-flask.git $ cd api-server-flask

Start the app in Docker

$ docker-compose up --build 

The API server will start using the PORT 5000.

1. Getting Started
2. Project Structure
3. Modules
4. Testing

Step #1 - Clone the project

$ git clone https://github.com/app-generator/api-server-flask.git $ cd api-server-flask

Step #2 - create virtual environment using python3 and activate it (keep it outside our project directory)

$ # Virtualenv modules installation (Unix based systems) $ virtualenv env $ source env/bin/activate $ $ # Virtualenv modules installation (Windows based systems) $ # virtualenv env $ # .\env\Scripts\activate

Step #3 - Install dependencies in virtualenv

$ pip install -r requirements.txt

Step #4 - setup flask command for our app

$ export FLASK_APP=run.py $ export FLASK_ENV=development

For Windows-based systems

$ (Windows CMD) set FLASK_APP=run.py $ (Windows CMD) set FLASK_ENV=development $ $ (Powershell) $env:FLASK_APP = ".\run.py" $ (Powershell) $env:FLASK_ENV = "development"

Step #5 - set .env for GitHub social login

$ GITHUB_CLIENT_ID= $ GITHUB_CLIENT_SECRET=

Step #6 - start test APIs server at localhost:5000

$ flask run

Use the API via POSTMAN or Swagger Dashboard.

api-server-flask/ ├── api │   ├── config.py │   ├── __init__.py │   ├── models.py │   └── routes.py ├── Dockerfile ├── README.md ├── requirements.txt ├── run.py └── tests.py

For a fast set up, use this POSTMAN file: api_sample

Register - api/users/register (POST request)

POST api/users/register Content-Type: application/json { "username":"test", "password":"pass", "email":"test@appseed.us" } 

Login - api/users/login (POST request)

POST /api/users/login Content-Type: application/json { "password":"pass", "email":"test@appseed.us" } 

Logout - api/users/logout (POST request)

POST api/users/logout Content-Type: application/json authorization: JWT_TOKEN (returned by Login request) { "token":"JWT_TOKEN" } 

Run tests using pytest tests.py

Flask API Server - provided by AppSeed