FAQ: Установка библиотек для Python

Примеры в данной инструкции были сделаны в windows 10 и python 3.6.4 x64

Для корректной установки библиотек вам необходимо иметь правильно настроенное окружение, поэтому перед установкой проверьте условия, описанные ниже:

• имя пользователя должно быть написано на латинице (это одно из ограничений windows);
• в переменной окружения path должен быть путь до папки с python и до папки Scripts (которая располагается в папке с python);
• python должен быть установлен "для всех пользователей", то есть установлен в "Program Files", либо в другую папку находящуюся в корне диска С.
  Идеальным вариантом будет создать в корне диска C папку bin и устанавливать туда всё необходимое для разработки. Такой подход спасет от разных
  неприятных недоразумений, связанных с ограничениями некоторых инструментов.

Вы можете настроить все вручную, либо провести правильную установку python, как это сделать будет показано рассказано в разделе "Правильная установка python в windows".

Автоматизированная установка
Автоматизированная установка проводится при помощи утилиты pip. Она сама подбирает необходимую версию библиотеки с https://pypi.python.org/pypi и устанавливает ее.
Данный способ подходит для 90% случаев, потому что практически все библиотеки для python размещаются на pypi. Чтобы воспользоваться pip нужно выполнить 1 простую команду:
в результате выполнения данной команды будет установлена библиотека PyQt5. Другую библиотеку можно поставить просто, заменив PyQt5 на название нужной библиотеки.





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

Чтобы установить библиотеку, распространяемую в виде архива с исходными текстами нужно:

1. Скачать архив с библиотекой
2. Перейти в разархивированную папку командой cd <путь к папке>
3. Выполнить команду

   Bash
   1 python ./setup.py install

При установке библиотеки из whl файла необходимо:

1. Выбрать whl который совместим с вашей ОС и установленным python`ом.
   Определить для какого интерпретатора и какой ОС собран whl очень просто по его имени.
   Название whl в общем виде: {distribution}-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl.
   • distribution - название дистрибутива ('django', 'pyramid' и т д);
   • version - версия дистрибутива (1.0 и т д);
   • build tag - номер сборки, его указывать не обязательно;
   • language implementation and version tag - указывает для какой версии python написана библиотека ('py27', 'py2', 'py3');
   • abi tag - указывает с какой версией python совместим дистрибутив ('cp33', 'cp36', 'none');
   • platform tag - тег указывающий целевую платформу ('win', 'manylinux1', 'macosx', 'any').
   
   Например, для python-3.6.4-amd64.exe, нужно скачивать <название библиотеки>-<версия>-cp36-cp36m-win_amd64.whl.
   Рассмотрим больше примеров:
   • PyQt5-5.6-cp35-none-win_amd64.whl - подходит для 64-битного python 3.5 установленного в windows
   • matplotlib-2.1.2-cp36-cp36m-win32.whl - подходит для 32-битного python 3.6 установленного в windows
   • requests-2.18.4-py2.py3-none-any.whl - подходит для python 2 и 3, разрядность интерпретатора не имеет значения, подходит для всех ОС
2. Установить библиотеку командой

   Bash
   1 pip3 install <путь до whl файла>

Иногда бывает сложно найти whl подходящий для Вашего интерпретатора и ОС, если такая ситуация возникла можно поискать библиотеку сайте https://www.lfd.uci.edu/~gohlke/pythonlibs/.
Там регулярно выкладываются актуальные версии популярных библиотек для различных версий python.

Чтобы правильно установить python действуйте как показано на скриншотах, представленных ниже: