طرح بندی پروژه

یک دایرکتوری برای پروژه بسازید و وارد آن شوید:

$ mkdir flask-tutorial
$ cd flask-tutorial

سپس مقدمه نصب را ببنید تا محیط های مجازی را راه‌اندازی کنید و فلاسک را برای پروژه خودتان نصب کنید.

این آموزش فرض میکند که شما الان در دایرکتوری flask-tutorial کار میکنید. اسم فایل ها در بالای هر قطعه کد است و در این دایرکتوری هستند.


یک برنامه فلاسک میتواند ساده و یک فایل باشد.

hello.py
from flask import Flask

app = Flask(__name__)


@app.route('/')
def hello():
    return 'Hello, World!'

با این حال، با بزرگتر شدن یک پروژه، نگه داشتن تمام کدها در یک فایل بسیار سخت می شود. پروژه‌های پایتون از پکیج ها برای سازماندهی کدها در چندین ماژول استفاده می‌کنند که می‌توانند در صورت نیاز وارد شوند و این آموزش این کار را میخواهد انجام دهد.

دایرکتوری پروژه شامل موارد زیر خواهد بود:

  • flaskr/ یک پکیج پایتون حاوی کد بزنامه شما و فایل ها است.

  • tests/ یک دایرکتوری حاوی ماژول های تست است.

  • .venv/, a Python virtual environment where Flask and other dependencies are installed.

  • فایل های نصبی که به پایتون می گویند چگونه پروژه شما را نصب کند.

  • شما باید عادت کنید که از هر نوع ورژن کنترلی برای پروژه های خود صرف نظر از اندازه آن استفاده کنید، مثل ورژن کنترل git.

  • هر فایل پروژه دیگری که ممکن است در آینده اضافه کنید.

در پایان، طرح پروژه شما به شکل زیر خواهد بود:

/home/user/Projects/flask-tutorial
├── flaskr/
│   ├── __init__.py
│   ├── db.py
│   ├── schema.sql
│   ├── auth.py
│   ├── blog.py
│   ├── templates/
│   │   ├── base.html
│   │   ├── auth/
│   │   │   ├── login.html
│   │   │   └── register.html
│   │   └── blog/
│   │       ├── create.html
│   │       ├── index.html
│   │       └── update.html
│   └── static/
│       └── style.css
├── tests/
│   ├── conftest.py
│   ├── data.sql
│   ├── test_factory.py
│   ├── test_db.py
│   ├── test_auth.py
│   └── test_blog.py
├── .venv/
├── pyproject.toml
└── MANIFEST.in

اگر از کنترل نسخه استفاده می کنید، فایل های زیر که در حین اجرای پروژه شما تولید می شوند باید نادیده گرفته شوند. ممکن است فایل های دیگری بر اساس ویرایشگر مورد استفاده شما وجود داشته باشد. به طور کلی فایل هایی را که ننوشته اید نادیده بگیرید. به عنوان مثال، با git:

.gitignore
.venv/

*.pyc
__pycache__/

instance/

.pytest_cache/
.coverage
htmlcov/

dist/
build/
*.egg-info/

با راه اندازی برنامه ادامه دهید.