Belajar Flask - Blueprints & Application Factory

#Pendahuluan

Aplikasi di episode-episode sebelumnya hidup dalam satu file app.py — nyaman untuk belajar, tapi tidak bertahan saat aplikasi tumbuh: puluhan route, model, dan helper dalam satu file sulit dibaca dan diuji. Episode 9 mengajarkan dua pola yang membuat aplikasi Flask scalable: blueprints untuk memecah fitur menjadi modul, dan application factory untuk merangkai semuanya dengan rapi. Ini adalah episode struktur — setelah ini, seluruh series memakai arsitektur yang sama. Kuasai baik-baik.

#Blueprints: Modul Fitur

Blueprint adalah "aplikasi mini" yang bisa punya route, template, static files, dan error handler sendiri, lalu diregistrasikan ke aplikasi induk. Contoh struktur nyata:

app/
  __init__.py          # create_app() + registrasi blueprint
  config.py            # config classes (episode 8)
  extensions.py        # init objek extension (db, login, dll)
  models/
    __init__.py
    user.py
  routes/
    __init__.py
    auth.py            # blueprint auth
    main.py            # blueprint main
  templates/
    base.html
    auth/
      login.html
    main/
      index.html
  static/
    css/
    js/
run.py                 # entry point `flask --app run`

Setiap modul fitur (auth, main, admin) menjadi blueprint:

app/routes/auth.py - blueprint auth

from flask import Blueprint, render_template
 
auth_bp = Blueprint(
    "auth",
    __name__,
    url_prefix="/auth",
    template_folder="templates",
    static_folder="static",
)
 
@auth_bp.route("/login", methods=["GET", "POST"])
def login():
    return render_template("auth/login.html")

Perhatikan tiga argumen kunci: url_prefix="/auth" membuat semua route otomatis di bawah /auth/...; template_folder dan static_folder memungkinkan blueprint memakai folder template/static sendiri — berguna untuk aplikasi dengan banyak modul terpisah.

#Blueprint-Specific Templates dan Static

Default-nya, template blueprint digabung dengan template aplikasi. Dengan template_folder="templates" relatif terhadap lokasi blueprint, Flask mencari file template di folder tersebut terlebih dahulu — misalnya app/routes/auth/auth_templates/login.html untuk auth_bp.

Pola penamaan yang disarankan: prefix folder template dengan nama blueprint (auth/login.html) untuk menghindari bentrok nama antar blueprint. Untuk static per blueprint, static_folder="static" diekspos di /auth/static/... dan dirujuk dengan url_for('auth.static', filename='...').

#Registering Blueprint di Factory

Semua blueprint diregistrasikan di create_app():

app/__init__.py - create_app()

from flask import Flask
from app.config import DevelopmentConfig, ProductionConfig, TestingConfig
from app.routes.auth import auth_bp
from app.routes.main import main_bp
 
 
def create_app(config: str | None = None) -> Flask:
    app = Flask(__name__)
    app.config.from_object(config or DevelopmentConfig)
 
    app.register_blueprint(auth_bp)
    app.register_blueprint(main_bp)
 
    return app

Versi di atas sudah memakai config classes (episode 8) — pilih config dari parameter atau environment. Entry point-nya sederhana:

run.py - entry point

from app import create_app
 
app = create_app()
 
if __name__ == "__main__":
    app.run()

Jalankan dengan flask --app run run. Keuntungan factory sekarang terlihat: testing bisa membuat instance dengan TestingConfig tanpa menyentuh config global.

#Init Extension yang Benar

Pola yang harus dihindari: menginisialisasi extension (database, login manager) di module level tanpa aplikasi. Pola yang benar — extension object di extensions.py, init di factory:

app/extensions.py - init extension

from flask_sqlalchemy import SQLAlchemy
from flask_login import LoginManager
 
db = SQLAlchemy()
login_manager = LoginManager()

app/__init__.py - bind extension ke app

from app.extensions import db, login_manager
 
 
def create_app(config) -> Flask:
    app = Flask(__name__)
    app.config.from_object(config)
 
    db.init_app(app)
    login_manager.init_app(app)
 
    app.register_blueprint(auth_bp)
    app.register_blueprint(main_bp)
 
    return app

Extension dibuat sekali di extensions.py (tanpa aplikasi), lalu di-init_app(app) di dalam factory. Inilah extension pattern resmi Flask — memungkinkan beberapa instance aplikasi (test, prod) memakai extension yang sama tanpa bentrok state. Kita pakai pola ini terus dari episode 10 sampai seterusnya.

#Error Handler per Blueprint

Blueprint bisa punya error handler sendiri untuk scope-nya:

Error handler spesifik blueprint

@auth_bp.app_errorhandler(404)
def auth_not_found(e: Exception) -> tuple[dict, int]:
    return {"error": "halaman auth tidak ditemukan"}, 404

@blueprint.app_errorhandler hanya menangkap error yang terjadi di route blueprint tersebut — berbeda dengan @app.errorhandler yang global. Berguna untuk API blueprint yang ingin format error berbeda dari halaman web.

#Memecah Blueprint Terlalu Kecil

Jangan juga berlebihan: satu blueprint per route/file. Pedoman praktis:

Blueprint adalah batas fitur, bukan batas file. Kelompokkan route berdasarkan domain (auth, items, admin, api) — bukan per halaman.

#Common Pitfalls Blueprint & Factory

• Lupa url_prefix: semua blueprint tanpa prefix akan bertabrakan route-nya.
• Registrasi blueprint di luar factory: sulit testing dan state bocor antar test.
• Template bentrok antar blueprint: selalu prefix folder template dengan nama blueprint.
• db.init_app dipanggil dua kali: crash; panggil sekali di factory.
• Blueprint mengimpor aplikasi: blueprint tidak boleh import app untuk mengakses current_app — pakai proxy current_app dari flask (episode 2).

#Penutup

Pada episode 9 ini, kalian telah menguasai arsitektur modular Flask.

Inti yang harus dibawa pulang:

• Blueprint memecah aplikasi menjadi modul fitur dengan url_prefix, template, dan static sendiri.
• Application factory create_app() merangkai config, extension, dan blueprint.
• Extension diinisialisasi via pola db = SQLAlchemy() + db.init_app(app) di factory.
• Error handler per blueprint untuk format error berbeda per modul.
• Grup route per fitur — jangan terlalu pecah, jangan terlalu besar.

Di episode 10 selanjutnya, kita masuk dunia data: SQLAlchemy & database — Flask-SQLAlchemy 3.x, models dan relationships, session scope, hingga CRUD dengan SQLite/PostgreSQL. Pastikan lab kalian siap, karena mulai sekarang aplikasi kita punya database!