• en
  • Language: ru
  • Documentation version: 1.1.x

Планировка проекта

Создайте каталог проекта и войдите в него:

$ mkdir flask-tutorial
$ cd flask-tutorial

Затем следуйте инструкциям installation instructions для настройки виртуальной среды Python и установки Flask для вашего проекта.

С этого момента в учебнике предполагается, что вы работаете из каталога flask-tutorial. Имена файлов в верхней части каждого блока кода относятся к этому каталогу.


Приложение Flask может быть простым, как один файл.

hello.py
from flask import Flask

app = Flask(__name__)


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

Однако, когда проект становится больше, хранить весь код в одном файле становится непосильной задачей. В проектах Python используются пакеты для организации кода в несколько модулей, которые можно импортировать по мере необходимости, и в данном учебнике это также будет сделано.

Каталог проекта будет содержать:

  • flaskr/, пакет Python, содержащий код и файлы вашего приложения.

  • tests/, каталог, содержащий тестовые модули.

  • venv/, виртуальная среда Python, в которой устанавливается Flask и другие зависимости.

  • Установочные файлы, указывающие Python, как установить ваш проект.

  • Конфигурация контроля версий, например 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/
├── setup.py
└── MANIFEST.in

Если вы используете контроль версий, следующие файлы, создаваемые при запуске проекта, следует игнорировать. В зависимости от используемого редактора могут быть и другие файлы. В общем, игнорируйте файлы, которые вы не писали. Например, при использовании git:

.gitignore
venv/

*.pyc
__pycache__/

instance/

.pytest_cache/
.coverage
htmlcov/

dist/
build/
*.egg-info/

Продолжить Настройка приложения.