.. _installation: Инсталяция ========== Flask зависит от двух внешних библиотек, `Werkzeug `_ и `Jinja2 `_. Werkzeug - это инструментарий для WSGI, стандартного интерфейса Python между веб-приложениями и различными серверами, предназначенный как для разработки, так и развёртывания. Jinja2 занимается отображением шаблонов. Итак, как же быстро получить всё необходимое на ваш компьютер? Есть много способов, которыми вы это можете проделать, но самый обалденный - это virtualenv, так что давайте глянем в первую очередь на него. Для начала вам понадобится Python 2.5 или выше, так что убедитесь, что у вас инсталлирован свежий Python 2.x. На момент написания, спецификация WSGI для Python 3 ещё не была закончена, поэтому Flask не может поддерживать Python версий 3.x. .. _virtualenv: virtualenv ---------- Virtualenv - это возможно, то самое, что вы захотите использовать во время разработки, и если у вас есть доступ к командной оболочке на рабочем сервере, возможно, вы захотите использовать его также и здесь. Какую из пробем решает virtualenv? Если вам нравится Python так, как он нравится мне, скорее всего, вы захотите использовать его и в других проектах - вне приложений, созданных на базе Flask. Но чем больше у вас проектов, тем больше вероятность, что вы будете работать с разными версиями самого Python, или по крайней мере с различными версиями библиотек Python. Посмотрим правде в глаза: довольно часто библиотеки нарушают обратную совместимость, и маловерояно, что серьёзное приложение будет работать вообще без каких-либо зависимостей. Так что же делать, если два или более из ваших проектов имеют конфликтующие зависимости? Наше спасение - Virtualenv! Virtualenv предоставляет несколько соседствующих друг с другом установленных версий Python, по одному для каждого проекта. На самом деле он реально не устанавливает различные версии Python, но обеспечивает хитрый способ создать для проектов несколько изолированных друг от друга окружений. Давайте посмотрим, как работает virtualenv. Если вы работаете с MacOS X или с Linux, есть вероятность, что заработает одна из следующих двух команд:: $ sudo easy_install virtualenv или даже лучше:: $ sudo pip install virtualenv Возможно, одна из этих команд установит virtualenv на вашей системе. А может оказаться. что это позволит сделать даже ваш пакетный менеджер. Если вы используете Ubuntu, попробуйте:: $ sudo apt-get install python-virtualenv Если у вас Windows и команда `easy_install` не работает, вам необходимо сначала установить её. Чтобы получить дополнительную информацию о том, как это можно сделать, проверьте раздел :ref:`windows-easy-install`. Установив данную команду, запустите её, как указано чуть выше, но без префикса `sudo`. После того, как virtualenv была установлена, просто запустите командный интерпретатор и создайте ваше собственное окружение. Обычно в таких случаях я создаю папку проекта, а в ней - папку `venv`:: $ mkdir myproject $ cd myproject $ virtualenv venv New python executable in venv/bin/python Installing distribute............done. Теперь, когда вы захотите работать над проектом, вам необходимо лишь активировать соответствующее окружение. Под MacOS X и Linux, выполните следующее:: $ . venv/bin/activate Если вы используете Windows, для вас подойдёт следующая команда:: $ venv\scripts\activate В любом случае, теперь вы должны использовать вашу virtualenv (обратите внимание, как изменилось приглашение вашей командной оболочки - для того, чтобы показать активное окружение). Теперь, чтобы загрузить и активировать в вашем virtualenv Flask, вы можете просто ввести команду:: $ pip install Flask Через несколько секунд вы сможете двинуться в дальнейший путь. Установка непосредственно в систему ----------------------------------- Возможен и такой вариант установки, но я бы вам его не рекомендовал. Просто запустите `pip` с привелегиями суперпользователя:: $ sudo pip install Flask (Под Windows, запустите ту же команду, но только без `sudo`, внутри окна с командной строкой, запущенного с привелегиями администратора системы) Жизнь на переднем краю ---------------------- Если вы хотите работать с самой последней версией Flask, существует два пути: можно указать `pip`, чтобы он загрузил версию для разработки, или можно работать со срезом с текущего состояния репозитория git. В обоих случаях, рекомендуется пользоваться virtualenv. Получите срез с последнего состояния git в новом окружении virtualenv и запустите в режиме разработки:: $ git clone http://github.com/mitsuhiko/flask.git Initialized empty Git repository in ~/dev/flask/.git/ $ cd flask $ virtualenv venv --distribute New python executable in venv/bin/python Installing distribute............done. $ . venv/bin/activate $ python setup.py develop ... Finished processing dependencies for Flask Будет скачанан и активирована в virtualenv текущая версия, соответствующая последнему (головному) срезу из git. В дальнейшем, чтобы обновиться до последней версии, всё, что вам будет необходимо сделать - это выполнить ``git pull origin``. Чтоб получить версию для разработки без git, просто сделайте следующее:: $ mkdir flask $ cd flask $ virtualenv venv --distribute $ . venv/bin/activate New python executable in venv/bin/python Installing distribute............done. $ pip install Flask==dev ... Finished processing dependencies for Flask==dev .. _windows-easy-install: `pip` и `distribute` в MS Windows --------------------------------- В Window установить `easy_install` немного сложнее, но всё равно довольно легко. Самый простой путь сделать это - скачав файл `distribute_setup.py`_, запустить его. Простейший способ запустить файл - это открыть папку с загрузками и дважды щёлкнуть мышкой на файле. Далее, добавьте команду папку с `easy_install`, а также другими скриптами Python в список путей для поиска команд (переменная окружения `PATH`. Чтобы сделать это, нажмите правой кнопкой мыши на значёк "Мой компьютер" ("Компьютер"), находящийся на рабочем столи или в меню "Пуск", и выберите "Свойства". Далее нажмите "Дополнительные свойства системы" (в Windows XP закладка будет называться "Расширенные"). Далее, нажмите кнопку "Пепеменные среды". Наконец, дважды кликните на переменной "Path" в секции "Системные переменные", и добавьте путь к папке со скриптами интерпретатора Python. Убидитесь, что вы отделили его от существующих значений точкой с запятой. Предпожим, что вы используете Python 2.7, установленный в папку по умолчанию, тогда добавьте следующее значение:: ;C:\Python27\Scripts Вот и всё! Чтоб проверить, что всё работает, откройте Командную строку и выполните ``easy_install``. Если у вас Windows Vistа или Windows 7, и при этом включен Контроль Учётных Записей (UAC), будут запрошены администраторские привилегии. Теперь, когда у вас есть ``easy_install``, вы можете использовать его для установки ``pip``:: > easy_install pip .. _distribute_setup.py: http://python-distribute.org/distribute_setup.py