فلask اغلب به خاطر سادگی و فلسفه «میکرو» فریمورک خود تحسین میشود. اگرچه این ویژگی آن را برای نمونههای اولیه سریع و اسکریپتهای کوچک انتخابی عالی میکند، اما تکیه بر ساختار تکفایلی به سرعت با افزایش اندازه برنامه به یک نقطه ضعف تبدیل میشود. برای توسعهدهندگان متوسط و پیشرفته که هدفشان ساخت سیستمهای قدرتمند و آماده تولید است، درک نحوه ماژولار کردن کد نه تنها یک بهترین شیوه، بلکه یک ضرورت است.
در این پست، الگوهای معماری مورد نیاز برای مقیاسدهی مؤثر برنامههای Flask را بررسی خواهیم کرد. ما از حلقه ساده app.run() فراتر رفته و به ابزارهای اصلی که Flask برای سازماندهی فراهم میکند، میپردازیم: Blueprints برای جداسازی منطقی عملکرد و Extensions برای اجزای قابل استفاده مجدد و مشترک.
محدودیتهای الگوی تکفایلی
در یک آموزش Flask معمولی برای مبتدیان، برنامه شما به این شکل به نظر میرسد:
from flask import Flask
app = Flask(__name__)
@app.route('/')
def home():
return 'Hello, World!'
if __name__ == '__main__':
app.run(debug=True)اگرچه این الگو کارآمد است، اما مسیرها (routes)، نماها (views)، منطق پایگاه داده و پیکربندی شما را در یک فایل مونولیتیک به هم پیوند میدهد. با افزودن مسیرهای بیشتر، وارد کردن مدلها و جلسات پایگاه داده شلوغ میشود، واردات دایرهای پدید میآید و تست ویژگیهای فردی دشوار میگردد. برای حل این مشکل، باید ساختار را معرفی کنیم.
تسلط بر Blueprints برای ماژولار کردن
Blueprints مکانیزم اصلی برای سازماندهی برنامههای Flask به اجزای ماژولار هستند. یک Blueprint را به عنوان مجموعهای از عملیات در نظر بگیرید که میتوان آن را چندین بار یا با پیکربندیهای مختلف روی یک برنامه Flask ثبت کرد.
به جای ریختن همه چیز در برنامه اصلی، برنامه خود را به ماژولهای منطقی مانند users، auth و blog تقسیم میکنیم. در اینجا نحوه ساختاردهی یک Blueprint کاربری پایه آورده شده است:
# app/blueprints/auth.py
from flask import Blueprint, render_template, redirect, url_for
auth_bp = Blueprint('auth', __name__, url_prefix='/auth')
@auth_bp.route('/login')
def login():
# Logic for login
return render_template('auth/login.html')
@auth_bp.route('/logout')
def logout():
return redirect(url_for('auth.login'))با پیشوند قرار دادن URL با /auth، اطمینان حاصل میکنیم که تمام مسیرهای موجود در این بلوپرینت دارای فضای نام (namespaced) باشند. این امر به توسعهدهندگانی که روی ماژول احراز هویت کار میکنند اجازه میدهد بدون نگرانی از تداخل با برنامه اصلی یا سایر بلوپرینتها، کار کنند.
برای استفاده از این بلوپرینت، آن را در کارخانه برنامه (application factory) خود ثبت میکنید:
# app/__init__.py
from flask import Flask
from .blueprints.auth import auth_bp
def create_app():
app = Flask(__name__)
app.register_blueprint(auth_bp)
return appاستفاده از Extensions برای قابلیت استفاده مجدد
در حالی که Blueprints به مدیریت مسیرها و سازماندهی میپردازند، Extensions وضعیت مشترک و یکپارچهسازیهای پیچیده را مدیریت میکنند. در یک محیط تولید، شما به ندرت درایورهای پایگاه داده یا دستکاریکنندههای احراز هویت خود را از صفر مینویسید. در عوض، به اکستنشنهای به خوبی نگهداری شده تکیه میکنید.
برای یک برنامه آماده تولید، اکستنشنهای رایج عبارتند از:
- Flask-SQLAlchemy: برای مدیریت ORM پایگاه داده.
- Flask-Migrate: برای مدیریت مهاجرتهای طرح پایگاه داده از طریق Alembic.
- Flask-Login: برای مدیریت وضعیت جلسات کاربران.
- Flask-WTF: برای اعتبارسنجی فرمها و محافظت در برابر CSRF.
کلید استفاده از اکستنشنها در یک برنامه بزرگ، راهاندازی آنها در الگوی کارخانه برنامه است. این اطمینان حاصل میکند که اکستنشن به نمونه خاص برنامه متصل میشود، که امکان چندین نمونه برنامه (مفید برای تست) را فراهم کرده و از آلودگی وضعیت جهانی (global state) جلوگیری میکند.
# app/extensions.py
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate
# Instantiate extensions without binding to app
db = SQLAlchemy()
migrate = Migrate()
def init_extensions(app):
db.init_app(app)
migrate.init_app(app, db)
return appساختار دایرکتوری پروژه خود را تنظیم کنید
ترکیب Blueprints و Extensions منجر به یک ساختار دایرکتوری تمیز و مقیاسپذیر میشود. یک چیدمان توصیه شده برای یک برنامه متوسط تا بزرگ به این صورت است:
my_project/
├── app/
│ ├── __init__.py # Application factory
│ ├── extensions.py # Extension initialization
│ ├── blueprints/
│ │ ├── __init__.py
│ │ ├── auth/
│ │ └── blog/
│ ├── models/
│ └── templates/
├── migrations/ # Alembic migration files
├── tests/
└── requirements.txtنتیجهگیری
ساخت یک برنامه Flask آماده تولید نیازمند فراتر رفتن از اسکریپتهای ساده است. با استفاده از Blueprints، شما جداسازی نگرانیها (separation of concerns) را به دست میآورید که کدبیس شما را برای پیمایش و تست آسانتر میکند. با بهرهگیری از Extensions، شما به عملکردی قدرتمند و آزمایش شده توسط جامعه دسترسی پیدا میکنید بدون اینکه نیاز به اختراع دوباره چرخ باشد.
پذیرش الگوی کارخانه برنامه (Application Factory) همراه با این ابزارها اطمینان حاصل میکند که برنامه Flask شما قابل نگهداری، مقیاسپذیر و آماده برای پاسخگویی به نیازهای محیط تولید باقی بماند. از امروز شروع به بازسازی اسکریپتهای مونولیتیک خود به این ساختار ماژولار کنید تا جریان کاری توسعه خود را برای آینده ایمن سازید.