Встановлення модулів у Python за допомогою pip

Автор: Фред Ґіббс Переклали на українську: Мар’яна Юрків, Анастасія Юрків Оригінал уроку: https://programminghistorian.org/en/lessons/installing-python-modules-pip

Існує багато способів встановлення зовнішніх бібліотек для Python; цей урок пояснює один із найпоширеніших методів, а саме використання менеджера пакетів pip.

Мета уроку

У цьому уроці ви дізнаєтеся, як завантажувати та встановлювати модулі Python. Існує багато способів встановлення зовнішніх модулів, але для цього уроку ми скористаємося менеджером пакетів під назвою pip, яку можна легко встановити на macOS, Linux і Windows. Починаючи з версії Python 2.7.9 і новіших, pip встановлюється за замовчуванням. Цей урок буде корисним для тих, хто використовує старіші версії Python, які все ще досить поширені.

Знайомство з модулями

Однією з ключових переваг використання Python є наявність великої кількості чудових бібліотек, які широко доступні та легко встановлюються. Вони можуть значно заощадити ваш час на написання коду або спростити виконання певних завдань (наприклад, створення CSV-файлу або збирання даних із вебсторінки). Часто, шукаючи рішення проблем в Google, ви можете натрапити на приклади коду, що використовують бібліотеки, про які ви раніше не чули. Не варто цього лякатися! Після встановлення бібліотек на ваш комп'ютер, ви зможете легко підключати їх, імпортуючи на початку свого коду. Крім цього, ви маєте можливість імпортувати стільки бібліотек, скільки вам потрібно, наприклад

import csv
import requests
import kmlwriter
import pprint

Для нових користувачів Python перша спроба завантаження та встановлення зовнішніх модулів може здаватися непростою, оскільки існує багато способів це зробити (що лише додає плутанини); у цьому уроці ми розглянемо один із найпростіших і найпоширеніших методів встановлення модулів Python.

Мета полягає в тому, щоб встановити програму на ваш комп’ютер, яка автоматично завантажуватиме та встановлюватиме для нас модулі Python. Ми скористаємося менеджером пакетів під назвою pip.

Примітка: починаючи з версії Python 3.4, pip включено до стандартної інсталяції. Отже, якщо у вас версія Python 3.4+, то pip уже інстальовано на вашому комп'ютері автоматично під час встановлення Python і ви сміло можете переходити до пункту Встановлення модулів Python. Є багато причин, чому у вас може бути інша версія, і якщо у вас версія нижча ніж 3.4, наступні інструкції допоможуть вам.

Інструкції для Mac і Linux

Згідно з документацією pip, ми можемо завантажити Python-сценарій для автоматичної інсталяції pip. На Mac або Linux можна встановити pip через командний рядок, використовуючи команду curl, яка завантажує сценарій для встановлення pip.

curl -O https://bootstrap.pypa.io/get-pip.py

Після завантаження файлу get-pip.py його необхідно запустити за допомогою інтерпретатора Python. Однак, якщо ви спробуєте виконати команду:

Для Mac:

python get-pip.py

Для Linux:

python3 get-pip.py

сценарій, ймовірно, не запуститься через відсутність дозволів на зміну певних системних каталогів. За замовчуванням ці каталоги захищені, щоб сторонні сценарії не могли змінювати важливі файли та не загрожували безпеці вашої системи. У такій ситуації — а також у будь-яких випадках, коли ви довіряєте сценарію і хочете дозволити йому вносити зміни до системних папок — можна скористатися командою sudo (від англ. "Super User DO") перед командою python, наприклад:

Для Mac:

sudo python get-pip.py

Для Linux:

sudo python3 get-pip.py

Для багатьох популярних дистрибутивів (Ubuntu, Debian, Fedora, Arch Linux) є зручніші способи встановлення pip безпосередньо через пакетний менеджер:

Ubuntu/Debian:

sudo apt update
sudo apt install python3-pip

Fedora:

sudo dnf install python3-pip

Інструкції для Windows

Для Windows найкращий і найнадійніший спосіб встановити pip — це перевірити, чи вже встановлений Python, і, за потреби, оновити його або встановити заново з офіційного сайту. Нижче наведено оновлену інструкцію, яка враховує сучасні підходи.

Спершу відкрийте командний рядок (cmd) або PowerShell та введіть команди:

python --version 
pip --version

Якщо обидві команди працюють — значить, pip уже встановлений, і нічого додатково робити не потрібно.

Якщо команди не розпізнаються, це означає, що Python не встановлено або не додано до змінної середовища PATH. У такому разі перейдіть на офіційний сайт python.org і завантажте останню версію Python для Windows. Під час встановлення обов’язково встановіть прапорець "Add Python to PATH" (Додати Python до PATH) перед натисканням "Install Now". Це дозволить використовувати Python та pip у будь-якому командному рядку.

Після встановлення знову перевірте наявність pip. У більшості випадків він уже буде встановлений разом із Python. Якщо pip відсутній, запустіть у терміналі:

python -m ensurepip --default-pip

А щоб оновити pip до останньої версії:

python -m pip install --upgrade pip

Якщо у вас встановлена версія Python нижча за 3.4, радимо оновити Python, оскільки старі версії більше не підтримуються і можуть бути небезпечними для використання. Встановлення pip вручну в таких випадках недоцільне.

Якщо стандартні способи не працюють, можна скористатися резервним варіантом — скриптом get-pip.py. Завантажте файл за посиланням get-pip.py і збережіть його у зручному місці, наприклад, у директорії, де встановлений Python.

Далі відкрийте командний рядок, перейдіть у цю директорію за допомогою команди cd, і запустіть скрипт:

python get-pip.py

У разі виникнення проблем із доступом або помилок інсталяції радимо звертатися до спільноти Python на StackOverflow або переглянути документацію на офіційному сайті pip.

Встановлення модулів Python

Тепер, коли у вас є pip, ви можете легко встановлювати модулі Python, оскільки pip виконує всю роботу за вас. Коли ви знайдете модуль, який хочете використати, зазвичай документація або інструкції зі встановлення містять необхідну команду pip, наприклад:

pip install requests 
pip install beautifulsoup4 
pip install simplekml

Пам’ятайте, що з тих самих причин, описаних вище (на системах Mac або Linux, але не на Windows), вам може знадобитися запускати pip з правами адміністратора за допомогою sudo, наприклад:

sudo pip install requests

Іноді, особливо на Windows, може бути корисним використовувати прапорець -m, щоб допомогти Python знайти модуль pip, наприклад:

python -m pip install pandas

Успіхів із встановленням!

Про авторів

Фред Ґіббс — доцент кафедри історії в Університеті Нью-Мексико.

Переклад українською: Мар’яна Юрків, доцент кафедри картографії та геопросторового моделювання Національного університету “Львівська політехніка”, ORCID; Анастасія Юрків, випускниця Львівського національного університету імені Івана Франка.

Переклад рецензували: Володимир Нікулішин, доцент кафедри Картографії та геопросторового моделювання Національного Університету "Львівська Політехніка", к.т.н, ГІС розробник, Python розробник; Ворожейкін Євген, старший викладач кафедри філософської антропології філософії культури та культурології Українського державного університету імені Михайла Драгоманова, ORCID.

Рекомендоване цитування: Ґіббс, Фред. "Встановлення модулів у Python за допомогою pip", Programming Historian, переклали Мар’яна Юрків та Анастасія Юрків, Посібник з цифрової історії, 2025.