Менеджер пакетов PIP. Гайд по использованию

P IP – это менеджер пакетов. Он позволяет устанавливать и управлять пакетами на Python.

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

• вы заходите на сайт, выбираете нужную версию пакета;
• скачиваете ее, разархивируете, перекидываете в папку проекта;
• подключаете, прописываете пути, тестируете;

Вполне вероятно, что эта версия библиотеки вообще не подходит, и весь процесс повторяется заново. А если таких библиотек 10? Устанавливать их вручную?

Менеджер пакетов PIP – решает данную проблему. Весь процесс установки пакета сводится к выполнению консольной команды pip install package-name . Несложно представить, сколько времени это экономит.

Если вы работали с другими языками программирования, концепция pip может показаться вам знакомой. Pip похож на npm (в Javascript), composer (в PHP) или gem (в Ruby).

Pip или pip3?

В зависимости от того, какая версия Python установлена в системе, может потребоваться использовать pip3 вместо pip.

Если вы не знаете какая версия Python установлена на вашей системе, выполните следующие команды:

• python —version — для Python 2.x
• python3 —version — для Python 3.x
• python3.8 —version — для Python 3.8.x

Советуем использовать версию Python 3.6 и выше

Если команда «python» не найдена, установите Python по инструкции из предыдущей статьи.

Далее нужно убедиться, что сам PIP установлен и работает корректно. Узнать это поможет команда:

Команда отобразит в консоли версию pip, путь до pip и версию python, для которой в дальнейшем будут устанавливаться пакеты:

pip 19.2.3 from /usr/local/lib/python3.8/site-packages/pip (python 3.8)

☝️ Важный момент : в зависимости от того, какую версию Python вы будете использовать, команда может выглядеть как pip , pip3 или pip3.8

Альтернативный вариант вызова pip:

python3.7 -m pip install package-name

Флаг -m сообщает Python-у запустить pip как исполняемый модуль.

Если pip не установлен

Pip поставляется вместе с Python, и доступен после его установки. Если по какой-то причине pip не установлен на вашей системе, установить его будет не сложно.

Windows:

1. Скачайте файл get-pip.py и сохраните у себя на компьютере.
2. Откройте командную строку и перейдите в папку, в которой сохранен get-pip.py
3. В командной строке выполните команду: python get-pip.py или python3 get-pip.py
4. PIP установлен!

Linux (Ubuntu и Debian)

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

Для Питона 2-й версии, выполните команду:

apt-get install python-pip

Для Питона 3-ей версии:

apt-get install python3-pip

MacOS

• скачайте файл get-pip.py командой curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
• запустите скачанный файл командой: python get-pip.py или python3 get-pip.py

Должна появиться запись Successfully Installed. Процесс закончен, можно приступать к работе с PIP на MacOS!

Как обновить PIP

Иногда, при установке очередного пакета, можно видеть сообщение о том, что доступна новая версия pip.

WARNING: You are using pip version 19.2.3, however version 19.3.1 is available.

А в следующей за ней строке

You should consider upgrading via the ‘python -m pip install —upgrade pip’ command.

указана команда для обновления pip:

python -m pip install —upgrade pip

Команды PIP

Синтаксис pip выглядит следующим образом: pip + команда + доп. опции

Со всеми командами pip можно ознакомиться, выполнив pip help . Информацию по конкретной команде выведет pip help . Рассмотрим команды pip:

• pip install package-name — устанавливает последнюю версию пакета;
• pip install package-name==4.8.2 — устанавливает пакет версии 4.8.2;
• pip install package-name —upgrade — обновляет версию пакета;
• pip download — скачивает пакеты;
• pip uninstall — удаляет пакеты;
• pip freeze — выводит список установленных пакетов в необходимом формате ( обычно используется для записи в requirements.txt );
• pip list — выводит список установленных пакетов;
• pip list —outdated — выводит список устаревших пакетов;
• pip show — показывает информацию об установленном пакете;
• pip check — проверяет установленные пакеты на совместимость зависимостей;
• pip search — по введенному названию, ищет пакеты, опубликованные в PyPI;
• pip wheel — собирает wheel-архив по вашим требованиям и зависимостям;
• pip hash — Вычисляет хеши архивов пакетов;
• pip completion — вспомогательная команда используется для завершения основной команды;
• pip help — помощь по командам.

Пример работы с пакетами

PIP позволяет устанавливать, обновлять и удалять пакеты на компьютере. Ниже попробуем разобраться с работой менеджера pip на примере парсинга названий свежих статей на сайте habr.com.

• установим нужные пакеты;
• импортируем пакет в свой скрипте;
• разберемся, что такое requirements.txt
• обновим/удалим установленные пакеты;

Шаг #1. Установка.

Для начала, нам необходимо установить beautifulsoup4 – библиотеку для парсинга информации с веб-сайтов.

pip3 install beautifulsoup4

pip найдет последнюю версию пакета в официальном репозитории pypi.org . После скачает его со всеми необходимыми зависимостями и установит в вашу систему. Если вам нужно установить определенную версию пакета, укажите её вручную:

pip3 install beautifulsoup4==4.8.2

Данная команда способна даже перезаписать текущую версию на ту, что вы укажите.

Также для работы beautifulsoup нам понадобится пакет lxml :

pip install lxml

☝️ Важный момент : по умолчанию pip устанавливает пакеты глобально. Это может привести к конфликтам между версиями пакетов. На практике, чтобы изолировать пакеты текущего проекта, создают виртуальное окружение (virtualenv).

Шаг #2. Импортирование в скрипте.

Для того, чтобы воспользоваться функционалом установленного пакета, подключим его в наш скрипт, и напишем простой парсер:

from urllib.request import urlopen from bs4 import BeautifulSoup # скачиваем html page = urlopen(«https://habr.com/ru/top/») content = page.read() # сохраняем html в виде объекта BeautifulSoup soup = BeautifulSoup(content, «lxml») # Находим все теги «a» с классом «post__title_link» all_a_titles = soup.findAll(«a», < "class" : "post__title_link" >) # Проходим по каждому найденному тегу и выводим на экран название статьи for a_title in all_a_titles: print(a_title.text)

Шаг #3. requirements.txt.

Если вы просматривали какие-либо проекты Python на Github или где-либо еще, вы, вероятно, заметили файл под названием requirements.txt . Этот файл используется для указания того, какие пакеты необходимы для запуска проекта (в нашем случае beautifulsoup4 и lxml).

Файл requirements.txt создается командой:

pip freeze > requirements.txt

и выглядит следующим образом:

beautifulsoup4==4.8.2 lxml==4.4.2 soupsieve==1.9.5

Теперь ваш скрипт вместе с файлом requirements.txt можно сохранить в системе контроля версий (например git).

Для работы парсера в новом месте (например на компьютере другого разработчика или на удаленном сервере) необходимо затянуть файлы из системы контроля версий и выполнить команду:

pip install -r requirements.txt

Шаг #4. Обновление/удаление установленных пакетов.

Команда pip list —outdated выведет список всех устаревших пакетов. Обновить отдельно выбранный пакет поможет команда:

pip install package-name —upgrade

Однако бывают ситуации, когда нужно обновить сразу все пакеты из requirements.txt. Достаточно выполнить команду:

pip install -r requirements.txt —upgrade

Для удаления пакета выполните:

pip uninstall package-name

Для удаления всех пакетов из requirements.txt:

pip uninstall -r requirements.txt -y

Мы разобрали основы по работе с PIP. Как правило, этого достаточно для работы с большей частью проектов.

Обновление PIP для Python

PIP – утилита «Командной строки», предназначенная для работы с компонентами PyPI. Если данная программа инсталлирована на компьютере, это значительно облегчает процесс установки различных сторонних библиотек для языка программирования Python. Периодически рассматриваемый компонент обновляется, совершенствуется его код и добавляются нововведения. Далее мы рассмотрим процедуру обновления утилиты с помощью двух способов.

Обновляем PIP для Python

Система управления пакетами будет работать корректно только в том случае, когда используется ее стабильная версия. Периодически программные компоненты меняют свой вид, вследствие чего нуждается в обновлении и PIP. Давайте рассмотрим два разных метода инсталляции новой сборки, которые будут наиболее подходящими в определенных ситуациях.

Способ 1: Загрузка новой версии Python

PIP ставится на ПК вместе с Python, скачанным с официального сайта. Поэтому самым простым вариантом обновления будет скачивание самой свежей сборки Питон. Перед этим не обязательно удалять старую, новую можно поставить поверх или сохранить файлы в другом месте. Сначала мы рекомендуем убедиться в том, что установка свежей версии необходима. Для этого произведите следующие действия:

1. Откройте окно «Выполнить» путем нажатия комбинации клавиш Win + R, впишите cmd и нажмите Enter.

В отобразившемся окне «Командной строки» вам нужно ввести то, что указано ниже, и нажать на Enter:

Перед вами отобразится текущая сборка Питон. Если она ниже актуальной (на момент написания статьи это 3.7.0), значит, можно обновляться.

Процедура загрузки и распаковки новой версии происходит так:

1. Перейдите на официальный сайт Python по ссылке выше или через поиск в любом удобном браузере.
2. Выберите раздел «Downloads».

Кликните на соответствующую кнопку для перехода к списку доступных файлов.

В списке укажите сборку и ревизию, которую хотите поставить на свой компьютер.

Дождитесь окончания скачивания и запустите файл.

Обязательно поставьте галочку возле пункта «Add Python 3.7 то PATH». Благодаря этому программа будет автоматически добавлена в список системных переменных.

Задайте тип установки «Customize installation».

Теперь перед вами отобразится список всех доступных компонентов. Убедитесь, что пункт «pip» активирован, после чего кликните на «Next».

Отметьте галочками необходимые дополнительные параметры и выберите место расположения программных компонентов.

Мы советуем ставить Питон в корневую папку системного раздела на жестком диске.

Ожидайте завершения инсталляции. Во время этого процесса не закрывайте окно установщика и не перезагружайте ПК.

Вы будете уведомлены о том, что процесс завершен успешно.

Теперь команда PIP из системы управления пакетами с одноименным названием будет работать корректно со всеми дополнительными модулями и библиотеками. По завершении установки вы можете переходить к утилите и взаимодействовать с ней.

Способ 2: Ручное обновление PIP

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

1. Перейдите на официальную страницу скачивания PIP по ссылке выше.
2. Определитесь с подходящей версией из трех предложенных.

Переместитесь к исходному коду путем нажатия на надпись «get-pip.py».

Перед вами отобразится весь исходный код системы управления пакетами. В любом месте нажмите правой кнопкой мыши и выберите пункт «Сохранить как…».

Укажите удобное место на компьютере и сохраните данные туда. Его название и тип следует оставить неизменными.

Найдите файл на ПК, кликните на нем ПКМ и выберите пункт «Свойства».

С зажатой левой кнопкой мыши выделите строку «Расположение» и скопируйте ее нажатием на Ctrl + C.

Запустите окно «Выполнить» горячими клавишами Win + R, впишите туда cmd и кликните на «ОК».

В открывшемся окне введите команду cd , а затем вставьте скопированный ранее путь с помощью комбинации Ctrl + V. Нажмите на Enter.

Вы перейдете в выбранную директорию, где сохранен необходимый файл. Теперь его следует установить в Python. Для этого введите и активируйте следующую команду :

Начнется загрузка и инсталляция. Во время этой процедуры не закрывайте окно и не печатайте в нем ничего.

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

На этом процесс обновления закончен. Вы можете смело пользоваться утилитой, загружать дополнительные модули и библиотеки. Однако если при вводе команд возникают ошибки, рекомендуем произвести следующие действия, а после снова зайти в «Командную строку» и начать инсталляцию PIP.

Дело в том, что не всегда при распаковке Питон разных сборок происходит добавление системных переменных. Связано это чаще всего с невнимательностью пользователей. Для ручного создания этих данных сначала перейдите в меню «Пуск», где нажмите ПКМ на «Компьютер» и выберите пункт «Свойства».

Слева отобразится несколько разделов. Перейдите в «Дополнительные параметры системы».

Во вкладке «Дополнительно» кликните на «Переменные среды…».

Создайте системную переменную.

Задайте ей имя PythonPath , в значении введите следующую строку и нажмите на «ОК».

Где C: — раздел жесткого диска, где находится папка Python№.

Python№ — директория программы (Название меняется в зависимости от установленной версии).

Теперь можно закрыть все окна, перезагрузить компьютер и перейти к повторному выполнению второго метода обновления системы управления пакетами PIP.

Альтернативный метод добавления библиотек

Не у каждого юзера получается обновить PIP и пользоваться его встроенной утилитой для добавления модулей к Питон. К тому же не все версии программы корректно работают с данной системой. Поэтому мы предлагаем использовать альтернативный способ, который не требует предварительной инсталляции дополнительных компонентов. Вам нужно выполнить следующее:

Перейдите на сайт загрузки модулей и скачайте их в виде архива.

Откройте директорию через любой удобный архиватор и распакуйте содержимое в любую пустую папку на ПК.

Переместитесь к распакованным файлам и отыщите там Setup.py. Нажмите на нем правой кнопкой мыши и выберите «Свойства».

Скопируйте или запомните его расположение.

Запустите «Командную строку» и через функцию cd перейдите к скопированной директории.

Впишите следующую команду и активируйте ее:

Python setup.py install

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

Как видите, процесс обновления PIP довольно сложный, однако все получится, если следовать приведенным выше инструкциям. Если же утилита PIP не работает или не обновляется, мы предложили альтернативный метод установки библиотек, который в большинстве случаев функционирует корректно.