easy_install: загрузка и установка Python-пакета
Easy Install - модуль python (easy_install), входящий в setuptools и позволяет автоматически загружать, компилировать, устанавливать Python-пакеты и управлять ими.
Для начального использования easy_install, достаточно указать имя файла, URL источника пакета или .egg-файл.
Пример 1. Установка пакета по имени, поиск в PyPI последней версии, автоматическая загрузка, билд и установка Python-пакета:
easy_install SQLObject
Пример 2. Установка и обновление пакет по имени пакета и версии, с помощью поиска ссылок на заданной странице загрузки:
easy_install -f http://pythonpaste.org/package_index.html SQLObject
Пример 3. Загрузка исходников с указанного URL, автоматический билд и установка пакета Python:
easy_install http://example.com/path/to/MyPackage-1.2.3.tgz
Пример 4. Установка ранее загруженного пакета в .egg-файле:
easy_install /my_downloads/OtherPackage-3.2.1-py2.3.egg
Example 5. Обновление ранее установленного пакета до последней версии с PyPI:
easy_install --upgrade PyProtocols
Пример 6. Установка источника дистрибутива, ранее загруженного в текущий каталог (новое в 0.5a9):
easy_install .
Пример 7. (новое в 0.6a1) Поиск источника пакета или URL системы контроля версий пакета, распаковка и проверка в ~/projects/sqlobject (имя всегда будет в нижнем регистре), где пакет будет проверен или отредактирован. (Пакет не будет установлен при этом, но его просто будет установить последующей командой easy_install ~/projects/sqlobject.
easy_install --editable --build-directory ~/projects SQLObject
Easy Install воспринимает URL (адреса), имена файлов, имена PyPI-пакетов (distutils "установочных" имён) и спецификаторы пакет+версия. В каждом случае, Easy Install пытается определить последнюю доступную версию для загрузки, которая соответствует Вашим критериям.
При загрузке и обработке загружаемых файлов, Easy Install определяет файлы источники distutils с расширениями .tgz, .tar, .tar.gz, .tar.bz2 или .zip. И конечно он обрабатывает ранее созданные .egg-пакеты как и установщики.win32.exe с использованием distutils.
По умолчанию, пакеты устанавливаются в рабочий каталог установки Python site-packages, без указания Вами опций -d или --install-dir для указания альтернативного каталога, или без указания альтернативного расположения файлов в файлах конфигурации distutils.
По умолчанию, любые скрипты, включённые в пакет, устанавливаются в стандартный каталог установки скриптов рабочей директории установки Python. Однако, если Вы укажете каталог установки в командной строке или конфигурационном файле, тогда каталог по умолчанию для установки скриптов будет тем же, что и каталог установки пакетов, чтобы быть уверенным, что у скрипта будет доступ к установленному пакету. Такое поведение Вы можете переопределить, используя опции -s или --script-dir.
Установленные пакеты добавляются в файл easy-install.pth в папке установки, так что Python всегда будет использовать самые свежие версии пакета. Если Вы хотите дать возможность выбора, какую версию использовать при выполнении, используйте опцию -m или --multi-version option.