По умолчанию интерпретатор уже комплектуется большим количеством библиотек – использование сетевых протоколов, обработка файлов, шифрование и многое другое. Однако некоторые специфические функции изначально не поддерживаются, для их реализации необходимо установить дополнительные библиотеки. К примеру, это могут быть библиотеки для работы с базами данных, графикой и так далее.
Для инсталляции нужных компонентов в Puthon удобнее всего использовать встроенную утилиту pip. Она самостоятельно найдет указанную библиотеку в репозитории PyPI, загрузит нужный файлы и произведет установку. Если для работы библиотеки требуются другие библиотеки, они также будут установлены.
Однако возможности утилиты гораздо шире. Можно посмотреть перечень уже установленных библиотек, удалить указанную или посмотреть информацию о ней. Общий формат команды выглядит следующим образом:
pip <Команда и опции> <Универсальные опции>
Секция <Команда и опция> определяет основной функционал утилиты – установка или удаление библиотеки, вывод списка установленных, предоставление информации и так далее.. Секция <Универсальные опции> позволяет указать дополнительные настройки самого приложения. Для вывода всех доступных команд с описанием можно использовать команду help, указав опцию –h.
Далее будут рассмотрены основные команды.
install. Инсталляция указанной библиотеки. Общий формат:
pip install [<Опции>] <Название библиотеки>
Если не указывать опции, будет просто загружена и установлена указанная библиотека. Если она уже установлена ранее, установка будет пропущена. Доступны следующие опции:
— —force-reinstall. Выполнение полной переустановки библиотеки. Часто используется одновременно с опцией –U;
— U или —upgrade. Обновление указанной библиотеки до последней версии;
— —compile. После установки библиотеки принудительно откомпилировать ее код. Это позволяет заметно ускорить запуск приложений, которые используют данную библиотеку.
Если необходимо установить конкретную версию библиотеки, параметр <Название библиотеки> может принять следующий формат:
«<Название библиотеки><Оператор сравнения><Номер версии>»
К примеру, необходимо установить библиотеку Pillow с индексом 8.3.0, команда будет иметь вид:
pip install "pillow==8.3.0"
Если номер модификации будет опущен, утилита выберет в репозитории самую актуальную. То есть допускается использование команд вида:
pip install "pillow==8.3"
Более того, вместо номера можно указать символ *, которые представляет собой символ подстановки. В этом случае также будет выбираться максимальный индекс для данного шаблона.
Поддерживаются стандартные операторы сравнения:
< – меньше;
== – равно;
> – больше;
>= – не меньше (больше или равно);
<= – не больше (меньше или равно);
~= – совместимо (будет описан позже).
Допускается использование нескольких условий, разделенных запятыми. Будут искаться версии, которые удовлетворяют всем условиям, если их несколько – выбирается самая свежая.
Оператор совместимости (~=) по умолчанию устанавливает указанную версию, но если она отсутствует:
— если модификация указана, загружается библиотека с указанными номерами старшей, младшей версий и указанной или, если таковая отсутствует, наиболее актуальной модификацией из имеющихся;
— если не указана — с заданным номером старшей версии и
указанными или, если таковые отсутствуют, наиболее актуальными младшей версией и модификацией.
list – вывод перечня всех установленных ранее библиотек с указанием версии. Доступна только одна опция –format. Можно указать colums (в виде таблицы), json (будет использоваться формат JSON) или freeze (просто список).
show – отображение информации об указанной библиотеке. Формат:
pip show [<Опции>] <Название библиотеки>
Осуществляется вывод названия библиотеки, версия, разработчик, официальный сайт, тип лицензии, электронная почта, путь установки, список зависимых библиотек. Доступна только опция –f (—files), которая дополняет отчет списком всех файлов в составе библиотеки.
uninstall – деинсталляция указанной библиотеки. В ответ будет выведен список каталогов, в которых присутствуют файлы данной библиотеки, а также запрос на дополнительное подтверждение со стороны пользователя. Необходимо ввести y для подтверждения или n для отмены. Если указать опцию –y, запрос будет пропущен.
help – отображение справочной информации о приложении pip или отдельных команд. Формат:
pip help [<название команды>]
Если название команды не указывать, в окне отобразится перечень всех поддерживаемых команд и опций. Аналогичный результат можно получить, если просто запустить в консоли pip без параметров.
Если добавить определенную команду, будет выведена информация, которая относится только к ней.
Универсальные опции, которые можно использовать с pip:
—proxy. Позволяет явно указать прокси-сервер для доступа в сеть. Используется следующий формат:
--proxy=[<Имя пользователя>:<Пароль>@]<Интернет-адрес>:<Порт>
Пример использования:
pip install pillow --proxy=user23:pAsSOr@192.168.10.1:3128
-v (—verbose). Отображение более подробных сведений о выполняемых действиях. Можно дублировать опцию до трех раз, что повышает детализацию сведений.
-q (—quiet). Указывает на необходимость вывода менее подробных сведений, также можно указать до трех раз.
—no-cache-dir. Принудительное отключение кэширования библиотек на локальном диске. Можно использовать только вместе с командной install.
-h (—help). Отображение справочной информации о текущей команде, включая доступные опции. Результат аналогичен упомянутой ранее конструкции help <команда>.
Все дополнительные библиотеки по умолчанию устанавливаются по пути <каталог инсталляции Python>\Lib\site-packages.
Некоторые библиотеки в своем составе могут иметь приложение, которые запускаются из консоли. Для таких утилит при установке используется путь <Каталог установки Python>\Scripts. Полный путь в процессе установки добавляется в системную переменную PATH, поэтому любое приложение из данной папки можно запустить через консоль, указав ее имя.
Если Python был инсталлирован пользователем в каталог c:\Program Files (либо c:\Program Files (x86), то для дополнительных библиотек будет использоваться путь формата:
c:\Users\<Имя учетной записи>\AppData\Roaming\Python\Python<Номер версии>\site-packages
Программы, входящие в библиотеку:
c:\Users\<Имя учетной записи>\AppData\Roaming\Python\Python<Номер
версии>\Scripts
Стоит учитывать, что путь к папке с программами автоматически не добавляется в переменную PATH, поэтому необходимо добавить самостоятельно или для запуска указывать полный путь.