Установка

Flask зависит от некоторых внешних библиотек, таких как Werkzeug и Jinja2. Werkzeug — это набор инструментов для WSGI, стандартного Python-интерфейса между веб-приложениями и различными серверами как для разработки, так и для развертывания. Jinja2 рендерит шаблоны.

Так как быстро получить всё это на свой компьютер? Существует множество способов, но самый крутой метод — virtualenv, поэтому давайте посмотрим на него в первую очередь.

Для начала вам потребуется Python 2.6 или более поздней версии, поэтому убедитесь, что у вас установлена актуальная версия Python 2.x. Для использования Flask с Python 3 ознакомьтесь со статьёй Поддержка Python 3.

virtualenv

Virtualenv, вероятно, то, что вам нужно использовать во время разработки, и если у вас есть доступ к оболочке на ваших производственных машинах, то, скорее всего, вам также потребуется использовать его там.

Какую проблему решает virtualenv? Если вы, как и я, любите Python, то, скорее всего, вы хотите использовать его для проектов помимо веб-приложений на основе Flask. Но чем больше у вас проектов, тем больше вероятность того, что вы будете работать с различными версиями самого Python или, по крайней мере, с различными версиями библиотек Python. По правде говоря, библиотеки довольно часто нарушают обратную совместимость, и маловероятно, что какое-либо серьёзное приложение будет иметь нулевые зависимости. Так что же делать, если два или более ваших проекта имеют конфликтующие зависимости?

Virtualenv на помощь! Virtualenv позволяет устанавливать несколько параллельных версий Python, по одной для каждого проекта. Он не устанавливает фактически отдельные копии Python, но обеспечивает умный способ изоляции различных сред проектов. Давайте посмотрим, как работает virtualenv.

Если вы используете Mac OS X или Linux, скорее всего, следующая команда будет работать для вас:

$ sudo pip install virtualenv

Вероятно, virtualenv будет установлен на вашей системе. Возможно, он даже есть в вашем менеджере пакетов. Если вы используете Ubuntu, попробуйте:

$ sudo apt-get install python-virtualenv

Если вы работаете в Windows и у вас нет команды easy_install, вам необходимо сначала установить её. Дополнительную информацию о том, как это сделать, см. в разделе pip и setuptools в Windows. После установки выполните те же команды, что и выше, но без префикса sudo.

После установки virtualenv просто запустите оболочку и создайте свою собственную среду. Я обычно создаю папку проекта и папку venv внутри:

$ mkdir myproject
$ cd myproject
$ virtualenv venv
New python executable in venv/bin/python
Installing setuptools, pip............done.

Теперь, когда вы захотите работать над проектом, вам нужно будет только активировать соответствующую среду. В системах OS X и Linux сделайте следующее:

$ . venv/bin/activate

Если вы пользователь Windows, следующая команда для вас:

$ venv\Scripts\activate

В любом случае вы теперь должны использовать свой virtualenv (обратите внимание, как изменилась подсказка вашей оболочки, чтобы показать активную среду).

И если вы хотите вернуться в реальный мир, используйте следующую команду:

$ deactivate

После этого подсказка вашей оболочки должна стать такой же, как и раньше.

Теперь перейдём к следующему шагу. Введите следующую команду, чтобы активировать Flask в вашем virtualenv:

$ pip install Flask

Через несколько секунд всё будет готово.

Установка по всей системе

Это тоже возможно, хотя я этого не рекомендую. Просто выполните pip с правами root:

$ sudo pip install Flask

(В системах Windows запустите её в окне командной строки с правами администратора и исключите sudo.)

Работа с последними версиями

Если вы хотите работать с последней версией Flask, есть два способа: либо позволить pip загрузить версию разработки, либо указать ему работать с git checkout. В любом случае рекомендуется использовать virtualenv.

Получите git checkout в новом virtualenv и запустите в режиме разработки:

$ git clone http://github.com/pallets/flask.git
Initialized empty Git repository in ~/dev/flask/.git/
$ cd flask
$ virtualenv venv
New python executable in venv/bin/python
Installing setuptools, pip............done.
$ . venv/bin/activate
$ python setup.py develop
...
Finished processing dependencies for Flask

Это загрузит зависимости и активирует git head в качестве текущей версии внутри virtualenv. Затем всё, что вам нужно сделать, это запустить git pull origin для обновления до последней версии.

`pip` и `setuptools` в Windows

Иногда получение стандартных «инструментов упаковки Python», таких как pip, setuptools и virtualenv, может быть немного сложнее, но ничего особенно сложного. Необходимый ключевой пакет — pip; он позволит вам установить всё остальное (например, virtualenv). К счастью, есть «скрипт запуска», который вы можете запустить для установки.

Если у вас сейчас нет pip, то get-pip.py установит его для вас.

get-pip.py

После загрузки он должен быть двойным щелчком. Если у вас уже есть pip, вы можете обновить их, выполнив:

> pip install --upgrade pip setuptools

Чаще всего, как только вы откроете командную строку, вы захотите иметь возможность ввести pip и python, которые запустят эти вещи, но это может не происходить автоматически в Windows, потому что она не знает, где находятся эти исполняемые файлы (попробуйте!).

Чтобы исправить это, вы должны иметь возможность перейти в каталог установки Python (например, C:Python27), затем перейти в Tools, затем в Scripts, найти файл win_add2path.py и запустить его. Откройте новое окно командной строки и проверьте, можете ли вы теперь просто ввести python для запуска интерпретатора.

Наконец, чтобы установить virtualenv, вы можете просто выполнить:

> pip install virtualenv

После этого вы можете продолжить установку, следуя инструкциям выше.