How baibhab-adhikari/flask-restful-api-tutorial works
Project type and purpose
• This is a standalone REST‐only backend service, built with Python and Flask (plus Flask-Smorest), packaged in Docker. Its sole responsibility is to expose CRUD endpoints for items, stores, tags, and users and to persist data in a relational database (via SQLAlchemy and Alembic migrations).
File structure
• Top‐level artifacts
· Dockerfile & docker-entrypoint.sh: containerization and startup script
· .env.example: environment variables for secrets, database URL, etc.
· requirements.txt: Python dependencies
· app.py: Flask application factory, blueprint registration
· db.py: SQLAlchemy database initialization and session management
· schemas.py: pydantic/Marshmallow schemas used by Flask-Smorest for request/response validation
• Directories
· resources/: each file (item.py, store.py, tag.py, user.py) defines a Flask-Smorest Blueprint, request/response handlers, HTTP methods
· models/: SQLAlchemy model classes (Item, Store, Tag, User, ItemTags, JWTBlocklist)
· migrations/: Alembic configuration and versioned migration scripts
• No frontend or microservices—just one stateless API container plus a backing database.
README for additional insights
• The title confirms it is a “REST API tutorial with Flask, Flask-Smorest, Docker.”