Flask — Blueprints
Welcome to Flask — Blueprints in our Flask Complete Masterclass! Modularize Flask applications with Blueprints: creating course_bp, defining route prefixes, registering blueprints in application factory, and domain separation.
In Flask web application development, understanding Blueprints is essential for building scalable, maintainable Python backends, microservices, and web applications. Flask provides explicit, pythonic control over request processing, routing dispatch, templates, and database ORM management.
- Master key mechanisms behind Blueprints
- Understand request-response lifecycle and WSGI dispatching
- Implement production-ready Python code with error handling
- Avoid common architectural pitfalls and security vulnerabilities
Flask follows WSGI standards (Web Server Gateway Interface) to connect Python application logic to web servers like Gunicorn or Nginx, making it modular and easy to deploy across cloud environments.
from flask import Flask, request, jsonify, render_template, redirect, url_for, session, flash, abort
import os
app = Flask(__name__)
app.config['SECRET_KEY'] = 'super-secret-key-for-session-security'Here is the standard Python syntax and structure for implementing Blueprints in Flask:
@app.route('/api/courses', methods=['GET', 'POST'])
def handle_courses():
if request.method == 'POST':
data = request.get_json() or {}
return jsonify({"message": "Created", "data": data}), 201
return jsonify({"chapter": 22, "title": "Blueprints"})from flask import Flask, request, jsonify
app = Flask(__name__)
@app.route('/api/demo', methods=['GET'])
def get_demo():
return jsonify({
"status": "success",
"chapter_number": 22,
"topic": "Blueprints",
"framework": "Flask 3.0+"
})
if __name__ == '__main__':
app.run(host='127.0.0.1', port=5000, debug=True)# Set application entrypoint and run development server
flask --app app run --debug
# Output:
# * Serving Flask app 'app'
# * Debug mode: on
# * Running on http://127.0.0.1:5000{
"status": "success",
"chapter_number": 22,
"topic": "Blueprints",
"framework": "Flask 3.0+"
}
app.py: The primary Flask application entry point containing routes and application instantiation.config.py: Centralized environment variables, secret keys, and database connection strings.requirements.txt: Pinned Python package dependencies (Flask, Flask-SQLAlchemy, Pytest, Gunicorn).
| Code Snippet | Line Explanation |
|---|---|
app = Flask(__name__) | Creates the Flask application object instance using current module name. |
@app.route(...) | Registers view function as an HTTP route handler for matching URL paths. |
request.get_json() | Parses incoming HTTP POST/PUT JSON payload into a Python dictionary. |
jsonify(...) | Serializes Python data types to JSON format with application/json headers. |
1. HTTP client (Browser / Postman / cURL) sends a request to Flask server.
2. WSGI server (Werkzeug / Gunicorn) passes the request environment to Flask app.
3. Flask URL Map matches path and dispatches execution to registered view function.
4. View function executes Python logic, queries database or template, and returns response.
5. Flask converts return value to WSGI response object and sends HTTP status to client.
- Hardcoding secret keys directly in code — always use environment variables (os.environ.get).
- Running debug=True in production — exposes interactive debugger to public web.
- Circular imports between models and routes — use Flask Blueprints and App Factory pattern.
Write a Flask route handler that accepts a POST request with JSON payload containing name and email, validates that email contains @, and returns a 201 Created response.
Open in Python IDE →Q1 What is the default port for Flask development server?
Port 5000 (http://127.0.0.1:5000).
Q2 Which function converts Python dictionaries into HTTP JSON responses?
jsonify() from Flask package.
- Flask is a lightweight Python WSGI web application framework
- View functions are connected to URLs using @app.route() decorator
- Request data is accessed via request.args, request.form, or request.get_json()
- Always use virtual environments and keep secret keys in environment configuration files