Python >> Tutoriel Python >  >> Python

Comment installer un package Python avec un fichier .whl ?

Formulation du problème : Soit un fichier yourPackage.whl qui réside dans le dossier C:\your\folder\ . Comment l'installer sur votre machine Windows ?

Fichiers d'arrière-plan .whl

Un .whl fichier (lire :roue file) est une archive zip qui contient tous les fichiers nécessaires pour exécuter une application Python.

Qu'est-ce qu'une roue ?

C'est un format de package intégré pour Python, c'est-à-dire une archive zip avec .whl suffixe comme dans yourPackage.whl . Le but d'une roue est de contenir tous les fichiers d'une installation conforme PEP qui correspond approximativement au format sur disque.

Il permet de migrer une application Python d'un système à un autre de manière simple et robuste.

Méthode 1 :Powershell + pip + cd

Ce GIF vous montre comment installer un .whl package (par exemple, téléchargé à partir de l'index Python Package) - si contrairement à moi, vous avez téléchargé le bon .whl fichier pour votre environnement ;):

  • Ouvrez votre ligne de commande Windows ou Powershell.
  • cd dans le dossier où le yourPackage.whl fichier réside.
cd C:\your\folder\
  • Facultatif :Installez pip sur Windows. Il y a de fortes chances qu'il soit déjà installé :il est fourni avec de nombreuses distributions Python.
  • Exécutez la commande suivante :
pip install yourPackage.whl

Méthode 2 :Powershell + pip sans cd

  • Ouvrez votre ligne de commande Windows ou Powershell.
  • Facultatif :Installez pip sur Windows. Il y a de fortes chances qu'il soit déjà installé :il est fourni avec de nombreuses distributions Python.
  • Exécutez la commande suivante :
pip install C:\your\folder\yourPackage.whl

Méthode 3 :Powershell + pip + roue

  • Ouvrez Powershell ou la ligne de commande dans Windows
  • Mise à jour pip pour s'assurer que wheel est pris en charge, ce qui n'est le cas que pour les nouvelles versions de pip :
pip install – upgrade pip
  • Exécutez la commande suivante :
pip install – use-wheel – no-index – find-links=C:\your\folder\ yourPackage

Dépannage

Si vous rencontrez des problèmes lors de l'installation, vous pouvez consulter la liste suivante avec les correctifs possibles, dans cet ordre :

  • Ouvrez la ligne de commande ou Powershell en tant qu'administrateur en cliquant avec le bouton droit sur le symbole du programme et sélectionnez "Ouvrir en tant qu'administrateur" :
  • Pour Python 3, vous devrez parfois utiliser la commande pip3 au lieu de pip :
pip3 install C:\your\folder\yourPackage.whl
  • Mise à niveau pip en utilisant la commande dans votre Powershell ou votre ligne de commande :
pip install – upgrade pip
  • Si pip ou pip3 ne fonctionne toujours pas, essayez d'exécuter la commande suivante pour installer le .whl paquet :
python -m pip install some-package.whl