Whl файл как установить

Обновлено: 06.07.2024

У меня возникли проблемы с установкой пакета Python (в частности, JPype1 0.5.7) на моей Windows-машине и вы хотите установить его с помощью двоичных файлов Crystaloph Gohlke Window. (Что, по моему опыту, облегчило большую часть суеты для многих других установок пакета.)

Однако, в то время как Кристоф раньше использовал файлы .exe в прошлом, в последнее время кажется, что он загружает файлы .whl.

Но как установить .whl файлы?

Я нашел документы на колесе, но они не кажутся такими неудобными в объяснении, как устанавливать файлы .whl.
Этот вопрос является дубликатом с этим вопросом, на который прямо не ответил.

Что все-таки вызвало этот переход от exe к whl? Обычно люди пытаются сделать вещи проще, а не сложнее. @ rhaskett благо по сравнению с .exe в том, что издатели должны загрузить только один диск (обычно) для поддержки всех версий Python. Вы правы, однако, колеса не так просто для людей, пытающихся установить пакеты. Было бы здорово, если бы вы могли дважды щелкнуть файлы .whl. @cgohlke связывании говорит нужно установить пакет колеса, divenex ниже говорит один не. Кто прав? pip install . не требует колесного пакета; pip wheel . делает.

Я просто использовал следующее, что было довольно просто. Сначала откройте консоль, затем cd, где вы загрузили файл, например some-package.whl, и используйте

Примечание. Если pip.exe не распознается, вы можете найти его в каталоге "Scripts", из которого был установлен python. Если pip не установлен, эта страница может помочь: Как установить pip в Windows?

Примечание: для уточнения
Если вы скопируете файл *.whl на локальный диск (например, C:\some-dir\some-file.whl), используйте следующие параметры командной строки -

Вам не нужно pip install wheel . pip install some-package.whl достаточно. Только убедитесь, что пип обновлен, как заявлено бурхан-халидом. Кроме того, вы должны открыть командную строку как администратор, чтобы запустить pip в Windows python -m pip install some-package.whl также работает, если pip не найден в PATH. добавьте c: \ python27 \ scripts в путь, так что используйте pip Установка модуля Python в автономном режиме бесит. Нет пипса, очевидно. Хорошо, так что есть setup.py . Но это не работает? О, это требует setuptools. Замечательно. Хорошо, установи setuptools - что это, .whl? О, это требует пипса! Такое ощущение, что я застрял в петле. Для Python 3 я использовал pip3 вместо pip (у меня было 2.7, а теперь 3.4). В любом случае, это дружеское напоминание о том, что иногда pip3 - это то, что вам нужно.

Чтобы установить с колеса, укажите каталог, в который загружено колесо. Например, для установки package_name.whl :

Удостоверьтесь, что вы обновили первый пункт, чтобы включить поддержку колес:

Я нахожусь в той же лодке, что и OP.

С помощью командной строки Windows из каталога:

Изменив каталог, где находится whl, он просто сообщает мне, что "pip не распознан". Вернемся к C:\Python34\Scripts> , затем, используя полную команду выше, чтобы предоставить местоположение "где/ее/скачано", он говорит Requirement 'scikit_image-. -win32.whl' looks like a filename, but the filename does not exist .

Итак, я сбросил копию .whl в Python34/Scripts, снова запустил ту же самую команду (с тем, что --find-links= все еще идет в другую папку), и на этот раз она сработала.

@EinarSundgren Я не согласен, он перечислил все шаги, которые привели его к решению проблемы оп. Дополнительный пример, после открытия командной строки, я просто вставил в него и нажал Enter. Больше ничего не требуется: C:\Python34\python.exe -m pip install requests Он автоматически загрузил пакет «запросов» и установил его. Этот последний комментарий работал отлично для меня. Может быть опубликован в качестве ответа!

Вам нужно запустить pip.exe из командной строки на моем компьютере. Я набираю C:/Python27/Scripts/pip2.exe install numpy

У меня нет каталога Scripts . Pip не поставляется с обычной установкой? @jozxyqk: нет. Посмотрите здесь инструкции по установке: pip.pypa.io/en/latest/install.html

В Windows вы не можете просто обновить с помощью pip install --upgrade pip , потому что используется pip.exe , и при этом будет заменена ошибка. Вместо этого вы должны обновить pip следующим образом:

Затем проверьте версию pip :

Если он показывает серию 6.x , имеется поддержка колес.

Только тогда вы можете установить пакет колес следующим образом:

Я только что обновил pip в Windows 7, используя pip install --upgrade pip и он работал нормально, так что часть того, что вы говорите, кажется неверной. Возможно, ребята понимают это и решают проблему в более новых версиях . Я не знаю. По крайней мере, когда был опубликован ответ (в начале 2015 года), я обнаружил ошибку. Возможно Вы правы. На самом деле, в большинстве случаев Пип говорит мне, что есть более новая версия, и предлагает обновить себя, поэтому я редко делаю это вручную. Запустив Python 3.5.2 в Windows 10, «python -m pip install --upgrade pip» только что успешно обновил pip-8.1.1 до pip-8.1.2

Существует несколько версий файлов на большом сайте Кристофа Голке.

Что-то, что я нашел важным при установке колес с этого сайта, это сначала запустить его с консоли Python:

чтобы вы знали, какую версию вы должны установить для своего компьютера. Выбор неправильной версии может привести к сбою в установке пакета (особенно если вы не используете правильный тег CPython, например, cp27).

Спасибо, были проблемы с поиском этой информации! Тем не менее, я не уверен, как прочитать вывод, чтобы определить, какая версия мне нужна.

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

1) Запустите две команды в командной строке под правами администратора:

2) Кроме того, они могут быть скопированы в файл wheel.bat и выполнены с помощью флажка "Запуск от имени администратора".

Предполагается, что PS pip.exe находится в PATH.

Update:

(1) Их можно объединить в одну строку:

(2) Синтаксис для .bat файлов несколько отличается:

Также его вывод можно сделать более подробным:

Полезно! Спасибо, Аксил и Энтони. Предположительно, чтобы избежать зависимости от папки Scripts, находящейся в пути, вы можете использовать: cmd / c python -m pip install "% 1" & pause Ну, я был не прав. Вы должны использовать pip.exe. Однако еще одна проблема заключается в том, что если вы используете команду ftype, как показано, «пауза» будет запускаться в командной строке, а не сохраняться в реестре как часть ассоциации файлов. Вам нужно будет запустить regedit, чтобы добавить «& pause» в команду оболочки в реестре. (Просто найдите в реестре pythonwheel.) @DaveBurton Я исправил и обновил свой ответ. Спасибо.

Чтобы не загружать такие файлы, вы можете попробовать:

Для получения дополнительной информации см. это.

убедитесь, что вы установили последнюю версию pip, прежде чем через python -m pip install --upgrade pip

Новые пользователи Python в Windows часто забывают добавить каталог Python\Scripts в переменную PATH во время установки. Я рекомендую использовать пусковую установку Python и выполнить pip как script с помощью переключателя -m . Затем вы можете установить колеса для конкретной версии Python (если установлено более одного), а каталог Scripts не должен находиться в PATH. Поэтому откройте командную строку, перейдите (с помощью команды cd ) в папку, где находится файл .whl, и введите:

Замените 3.6 на свою версию Python или просто введите -3 , если в PATH появится первая версия Python. И с активной виртуальной средой: py -m pip install your_whl_file.whl .

Конечно, вы также можете устанавливать пакеты из PyPI таким образом, например

У меня проблемы с установкой пакета Python (в частности, JPype1 0.5.7) на мой компьютер с Windows, и я хотел бы установить его с помощью бинарных файлов Christoph Gohlke's Window. (Что, по моему опыту, облегчило большую часть суеты для многих других установок пакетов.)

Однако, хотя Кристоф раньше предоставлял файлы .exe, в последнее время кажется, что он загружает файлы .whl.

Но как мне установить .whl файлы?

Примечания

Я нашел документы на колесе, но они не так просты в объяснении того, как установить .whl файлы.
Этот вопрос дублируется с этим вопросом, который не был т прямо ответил.

Я просто использовал следующее, что было довольно просто. Сначала откройте консоль, затем перейдите к тому месту, где вы скачали свой файл, например some-package.whl, и используйте

Примечание: если pip.exe не распознается, вы можете найти его в каталоге «Scripts», откуда был установлен python. Если pip не установлен, эта страница может помочь: Как установить pip в Windows?

Примечание: для уточнения
Если вы копируете файл *.whl на свой локальный диск (например, C: \ some-dir \ some-file.whl ), используйте следующие параметры командной строки:

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

CD (смените каталог) на загруженный пакет и установите его вручную -
pip install PACKAGENAME.whl
например:
pip install ad3‑2.1‑cp27‑cp27m‑win32.whl

Я хотел бы предложить вам точный способ установки .whl файла. Сначала я столкнулся со многими проблемами, но потом решил, вот мой трюк для установки .whl файлов.

Следуйте инструкциям, чтобы импортировать модуль

Убедитесь, что ваш файл .whl хранится в папке python 2.7 / 3.6 / 3.7 / . Первоначально, когда вы загружаете .whl файл, файл хранится в загруженной папке, я предлагаю изменить папку. Это облегчает установку файла.
Откройте командную строку и откройте папку, в которой вы сохранили файл, введя

3. Теперь введите команду, написанную ниже

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

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

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

На MacOS с pip , установленным через MacPorts на MacPorts python2.7, мне пришлось использовать решение @Dunes:

Где python был заменен питоном MacPorts в моем случае, что для меня python2.7 или python3.5 .

Параметр -m - «Запустить модуль библиотеки как скрипт» в соответствии с man-страницей.

(Ранее я запускал sudo port install py27-pip py27-wheel для установки pip и wheel сначала в мою установку на python 2.7.)

Загрузите пакет (.whl).

Поместите файл в папку скриптов каталога python

Используйте командную строку для установки пакета.

Вы должны запустить pip.exe из командной строки на моем компьютере. Я печатаю C:/Python27/Scripts/pip2.exe install numpy

Вы можете установить .whl файл, используя pip install filename . Хотя, чтобы использовать его в этой форме, он должен находиться в том же каталоге, что и ваша командная строка, в противном случае укажите полное имя файла вместе с его адресом, например pip install C:\Some\PAth\filename .

Также убедитесь, что файл .whl той же платформы, что и вы, выполните python -V , чтобы узнать, какую версию Python вы используете, и, если это win32 или 64, установите правильную версию в соответствии с ней.

РЕДАКТИРОВАТЬ: ЭТО НЕ ДЛИННЕЕ ЧАСТЬ PIP

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

Для получения дополнительной информации см. Это.

На сайте великого Кристофа Гольке есть несколько версий файлов.

При установке колес с этого сайта я считаю важным сначала запустить его из консоли Python:

Так что вы знаете, какую версию вы должны установить для своего компьютера. Выбор неправильной версии может привести к сбою установки пакета (особенно если вы не используете правильный тег CPython, например, cp27).

Во-первых, убедитесь, что вы обновили пип, чтобы включить поддержку колес:

Затем для установки с колеса укажите каталог, в который загружается колесо. Например, чтобы установить package_name.whl :

Я в той же лодке, что и ОП.

С помощью командной строки Windows из каталога:

Перейдя в каталог, в котором находился whl, он просто сообщает мне, что pip не распознан. Возвращаясь к C:\Python34\Scripts> , затем используя указанную выше полную команду для указания местоположения «где / его / загружено», он говорит Requirement 'scikit_image-. -win32.whl' looks like a filename, but the filename does not exist .

Поэтому я удалил копию .whl в Python34 / Scripts, снова выполнил ту же самую команду (при этом --find-links= все еще переходил в другую папку), и на этот раз она сработала.

В Windows вы не можете просто обновить с помощью pip install --upgrade pip , потому что pip.exe используется и при его замене возникнет ошибка. Вместо этого вы должны обновить pip следующим образом:

Затем проверьте версию pip :

Если это показывает 6.x ряд, есть поддержка колеса.

Только тогда вы можете установить пакет с колесом так:

Новые пользователи Python в Windows часто забывают добавить каталог Python \ Scripts в переменную PATH во время установки. Я рекомендую использовать средство запуска Python и выполнять pip как скрипт с переключателем -m . Затем вы можете установить диски для конкретной версии Python (если установлено более одной), и каталог Scripts не обязательно должен находиться в PATH. Итак, откройте командную строку, перейдите (с помощью команды cd ) к папке, в которой находится файл .whl, и введите:

Замените 3.6 на вашу версию Python или просто введите -3 , если нужная версия Python появляется первой в PATH. И с активной виртуальной средой: py -m pip install your_whl_file.whl .

Конечно, вы также можете установить пакеты из PyPI, например,

Чтобы иметь возможность устанавливать файлы колес с помощью простого двойного щелчка на них, вы можете сделать следующее:

Инфраструктура системы пакетов для Python долго подвергалась критике как от разработчиков, так и от системных администраторов. Долгое время даже само комьюнити не могло прийти к соглашению, какие именно инструменты использовать в каждом конкретном случае. Уже существуют distutils, setuptools, distribute, distutils2 в качестве базовых механизмов распространения и virtualenv, buildout, easy_install и pip в качестве высокоуровневых инструментов управления всем этим беспорядком.

До setuptools основным форматом распространения были исходные файлы или некоторые бинарные MSI-дистрибутивы для Windows. Под Linux были изначально сломанный bdist_dumb и bdist_rpm , который работал только на системах, основанных на Red Hat. Но даже bdist_rpm работал недостаточно хорошо для того, чтобы люди начали его использовать.

Python eggs – обычные zip-архивы, содержащие python-пакет и необходимые метаданные. Хотя многие люди, вероятно, никогда намеренно не собирали egg'и, их формат метаданных до сих пор жив-здоров. И все разворачивают свои проекты с использованием setuptools.

К сожалению, некоторое время спустя сообщество разделилось, и часть его провозгласила смерть бинарных форматов и 'яиц' в частности. После этого pip, замена easy_install, перестал принимать egg-формат.

Потом прошло еще немного времени, и отказ от бинарных пакетов стал доставлять неудобства. Люди всё больше и больше стали деплоить на облачные сервера, а необходимость перекомпиляции C-шных библиотек на каждой машине не слишком радует. Так как 'яйца' на тот момент были малопонятны (я так полагаю), их переделали в новых PEP-ах, и назвали 'колёсами' [wheels].

В дальнейшем предполагается, что все действия происходят в virtualenv-окружении.

Что за колесо?

Начнём с простого. Что представляют собой 'колёса' и чем они отличаются от 'яиц'? Оба формата являются zip-файлами. Главная разница в том, что egg можно импортировать без распаковки, wheel же придётся распаковать. Хотя нет никаких технических причин, делающих 'колёса' неимпортируемыми, поддержка их прямого импорта никогда даже не планировалась.

Другое различие в том, что 'яйца' содержат скомпилированные байткод, а 'колёса' – нет. Главное преимущество этого в том, что нет необходимости создавать отдельные wheel'ы для каждой версии Python до тех пор, пока не придётся распространять слинкованные через libpython модули. Хотя в новых версиях Python 3 при использовании стабильного ABI даже это уже можно провернуть.

Однако wheel-формат тоже не лишен проблем, некоторые из которых он наследует от 'яиц'. Например, бинарные дистрибутивы под Linux до сих пор неприемлемы для большинства из-за двух недостатков: Python сам по себе компилируется под Linux в разных формах, и модули линкуются с разными системными библиотеками. Первая проблема вызвана сосуществованием несовместимых версий Python 2: USC2 и USC4. В зависимости от режима компиляции меняется ABI. В настоящее время wheel (насколько я могу судить) не содержит информации о том, с каким режимом Unicode связана библиотека. Отдельная проблема в том, что дистрибутивы Linux меньше совместимы между собой, чем хотелось бы, и обстоятельства могут сложиться так, что сборка, скомпилированная под один дистрибутив, не будет работать на остальных.

Всё это выливается в то, что, вообще говоря, на данный момент бинарные 'колёса' нельзя загружать на PyPI как несовместимые с различными системами.

В дополнение ко всему этому wheel сейчас знает только две крайности: бинарные пакеты и пакеты, содержащие чистый python-код. Бинарные пакеты специфичны для Python ветки 2.x. Сейчас это не кажется большой проблемой, потому что цикл 2.x подходит к концу, и пакетов, собранных только для 2.7, хватит надолго. Но если бы вдруг речь пошла про Python 2.8, была бы интересна возможность заявить, что этот пакет не зависит от версии Python, но он содержит бинарники, поэтому он не может не зависеть от архитектуры.

Единственный случай, оправдывающий существование такого пакета – это когда он содержит распределенные библиотеки, загружаемые с ctypes из CFFI. Такие библиотеки не связаны через libpython и не зависимы от реализации языка (их можно использовать даже с pypy).

Но есть и светлая сторона: ничто не запрещает использовать бинарные wheel’ы в своих собственных однородных инфраструктурах.

Сборка колеса

Итак, теперь мы знаем, что такое wheel. Как сделать своё собственное 'колесо'? Сборка из собственных библиотек – простейший процесс. Всё, что нужно – свежая версия setuptools и библиотека wheel . Как только они оба установлены, 'колесо' собирается следующей командой:

Wheel будет создан в директории пакета. Однако есть одна вещь, которой следует опасаться: распространение бинарников. По умолчанию собираемое 'колесо' (при условии, что в setup.py не используется никаких бинарных шагов) состоит из pure-python кода. Это значит, что даже если распространять .so , .dylib или .dll как часть своего пакета, полученное 'колесо' будет выглядеть платформо-независимым.

Решение этой проблемы – вручную реализовать Distribution из setuptools, скинув флаг чистоты в false :

Установка колеса

С использованием свежей версии pip 'колесо' ставится следующим образом:

Но что с зависимостями? Тут появляются некоторые сложности. Обычно одним из требований к пакету является возможность его установки даже без подключения к интернету. К счастью, pip позволяет отключать загрузку из индекса и устанавливать директорию, содержащую всё необходимое для установки. Если у нас есть wheel’ы для всех зависимостей необходимых версий, можно сделать следующее:

Таким образом будет установлена версия 1.0 пакета package в наше виртуальное окружение.

Колёса для зависимостей

Окей, но что, если у нас нет .whl для всех наших зависимостей? Pip в теории позволяет решить эту проблему использованием команды wheel . Это должно работать как-то так:

Эта команда выгрузит все пакеты, от которых зависит наш пакет, в указанную папку. Но есть пара проблем.
Первая состоит в том, что в команде в настоящий момент есть баг, который не выгружает зависимости, которые уже являются 'колёсами'. Так что если зависимость уже доступна на PyPI в wheel-формате, она не будет загружена.

Это временно решается shell-скриптом, который вручную перемещает из кэша скачанные wheel’ы.

Вторая проблема чуть серьёзней: как pip найдет наш собственный пакет, если его нет на PyPI? Правильно, никак. Документация в таком случае рекомендует использовать не pip wheel package , а pip wheel -r requirements.txt , где requirements.txt содержит все необходимые зависимости.

Сборка пакетов c использованием DevPI

Такое временное решение проблемы зависимостей вполне применимо в простых ситуациях, но что делать, если есть множество внутренних python-пакетов, зависящих друг от друга? Такая конструкция быстро разваливается.

К счастью, в прошлом году Holker Krekel создал решение этой беды под названием DevPI, который по существу является хаком, эмулирующим работу pip с PyPI. После установки на компьютер DevPI работает как прозрачный прокси перед PyPI и позволяет pip-у устанавливать пакеты из локального репозитория. К тому же все пакеты, скачанные с PyPI, автоматически кэшируются, так что даже если отключить сеть, эти пакеты будут доступны для установки. И, в конце концов, появляется возможность загрузки своих собственных пакетов на локальный сервер, чтобы ссылаться на них так же, как и на хранящиеся в публичном индексе.

Я рекомендую установить DevPI в локальный virtualenv, после чего добавить ссылки на devpi-server и devpi в PATH .

После этого остаётся просто запустить devpi-server , и он будет работать до ручной остановки.

После запуска его необходимо единожды проинициализировать:

Так как я использую DevPI 'для себя', имена пользователя DevPI и системного пользователя совпадают. На последнем шаге создаётся индекс по имени проекта (при необходимости можно создать несколько).

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

Я размешаю эту команду в скрипт postactivate моего virtualenv для предотвращения случайной загрузки из неверного индекса.

Для размещения собственных wheel’ов в локальном DevPI используется утилита devpi :

Флаг --no-vcs отключает магию, которая пытается определить систему контроля версий и перемещает некоторые файлы в первую очередь. Мне это не нужно, так как в моих проектах распространяются файлы, которые я не включаю в VCS (бинарники, например).

Напоследок я настоятельно рекомендую разбить файлы setup.py таким образом, что PyPI их отвергнет, а DevPI примет, чтобы случайно не зарелизить свой код с помощью setup.py resease . Самый простой способ это сделать – добавить неверный классификатор PyPI:

Заворачиваем

Теперь всё готово для начала использования внутренних зависимостей и сборки собственных 'колёс'. Как только они появятся, их можно заархивировать, загрузить на другой сервер и установить в отдельный virtualenv.
Весь процесс станет чуть проще, когда pip wheel перестанет игнорировать существующие wheel-пакеты. А пока приведенный выше shell-скрипт – не худшее решение.

В сравнении с 'яйцами'

Сейчас wheel-формат более притягателен, чем egg. Его разработка активнее, PyPI начал добавлять его поддержку и, так как с ним начинают работать утилиты, он похож на лучшее решение. 'Яйца' пока что поддерживаются только easy_install, хотя большинство давно перешло на pip.

Я считаю, что сообщество Zope до сих пор крупнейшее из базирующихся на egg-формате и buildout. И я считаю, что если решение на основе 'яиц' в вашем случае применимо, его и стоит применять. Я знаю, что многие не используют eggs вовсе, предпочитая создавать virtualenv-ы, архивировать их и рассылать по разным серверам. Как раз для такого развёртывания wheels – лучшее решение, так как у разных серверов могут быть разные пути к библиотекам. Встречалась проблема, связанная с тем, что .pyc -файлы создавались на билд-сервере для virtualenv, а эти файлы содержат конкретные пути к файлам. С использованием wheel .pyc создаются после установки в виртуальное окружение и автоматически будут иметь корректные пути.

Итак, теперь он у вас есть. Python на колёсах. И это вроде даже работает, и, возможно, стоит потраченного времени.

Но как установить .whl файлы?

Я нашел документы на колесе, но они не кажутся такими неудобными в объяснении, как устанавливать файлы .whl.
Этот вопрос является дубликатом с этим вопросом, на который прямо не ответил.

Чтобы установить с колеса, укажите каталог, в который загружено колесо. Например, для установки package_name.whl :

Удостоверьтесь, что вы обновили первый пункт, чтобы включить поддержку колес:

Я нахожусь в той же лодке, что и OP.

С помощью командной строки Windows из каталога:

Вам нужно запустить pip.exe из командной строки на моем компьютере. Я набираю C:/Python27/Scripts/pip2.exe install numpy

Затем проверьте версию pip :

Если он показывает серию 6.x , имеется поддержка колес.

Только тогда вы можете установить пакет колес следующим образом:

Существует несколько версий файлов на большом сайте Кристофа Голке.

Что-то, что я нашел важным при установке колес с этого сайта, это сначала запустить его с консоли Python:

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

1) Запустите две команды в командной строке под правами администратора:

Предполагается, что PS pip.exe находится в PATH.

Update:

(1) Их можно объединить в одну строку:

(2) Синтаксис для .bat файлов несколько отличается:

Также его вывод можно сделать более подробным:

Чтобы не загружать такие файлы, вы можете попробовать:

Для получения дополнительной информации см. это.

убедитесь, что вы установили последнюю версию pip, прежде чем через python -m pip install --upgrade pip

Конечно, вы также можете устанавливать пакеты из PyPI таким образом, например

Читайте также: