Conversion de scripts Python en fichiers exécutables

Introduction

Dans ce tutoriel, nous allons explorer la conversion de scripts Python en fichiers exécutables Windows en quatre étapes simples. Bien qu’il existe de nombreuses façons de le faire, nous couvrirons, selon l’opinion populaire, la plus simple jusqu’à présent.

Ce tutoriel a été conçu après avoir examiné de nombreuses erreurs courantes que les gens rencontrent en effectuant cette tâche, et contient donc des informations détaillées pour installer et configurer toutes les dépendances ainsi. N’hésitez pas à sauter une étape, si vous avez déjà ces dépendances installées. Sans plus attendre, commençons.

Etape 1 : Installer cURL

cURL fournit une bibliothèque et un outil de ligne de commande pour transférer des données en utilisant divers protocoles. Nous en avons besoin pour télécharger le gestionnaire de paquets pip à l’étape suivante. Beaucoup d’entre vous l’auraient déjà configuré, ce que vous pouvez vérifier en exécutant la commande suivante :

$ curl --version

Si la commande ci-dessus renvoie une version de curl, vous pouvez sauter les prochaines instructions de cette étape. Quant aux autres, vous pouvez installer curl en suivant ces trois étapes :

Cependant, cela signifie que vous ne pouvez utiliser la commande curl que dans ce dossier particulier. Afin de pouvoir utiliser la commande curl depuis n’importe où sur votre machine, faites un clic droit sur curl.exe, cliquez sur « Propriétés » et copiez la valeur « Emplacement ». Ensuite, faites un clic droit sur « Mon PC » et cliquez sur « Propriétés ». Dans le panneau d’options situé à gauche, sélectionnez l’option « Paramètres système avancés ». Elle a été mise en évidence dans la capture d’écran ci-dessous.

Dans la fenêtre qui apparaît, cliquez sur « Variables d’environnement » près du coin inférieur droit. Il a été mis en évidence dans la capture d’écran ci-dessous.

Dans la fenêtre suivante, trouvez et double-cliquez sur la variable utilisateur nommée « Path », puis cliquez sur « New ». Une nouvelle zone de texte sera créée dans cette fenêtre ; collez la valeur « Emplacement » du fichier « curl.exe » que vous avez copié précédemment, puis cliquez sur « OK ».

cURL devrait maintenant être accessible depuis n’importe quel endroit de votre système. Confirmez votre installation en exécutant la commande ci-dessous :

$ curl --version

Passons à l’étape suivante.

Étape 2 : Installer pip

Dans cette étape, nous allons installer pip, qui est essentiellement un gestionnaire de paquets pour les paquets Python. Nous en avons besoin dans l’étape suivante pour installer la bibliothèque pyinstaller. La plupart d’entre vous l’auraient déjà configuré, pour vérifier, exécutez la commande suivante :

$ pip --version

Si la commande ci-dessus a renvoyé une version de pip, vous pouvez sauter les prochaines instructions de cette étape.

Pour le reste, vous pouvez installer pip en exécutant les deux commandes suivantes dans l’invite de commande :

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

$ python get-pip.py

C’est tout. Pip a maintenant été installé sur votre machine locale ! Vous pouvez exécuter la commande suivante pour confirmation :

$ pip --version

Avant de passer à l’étape suivante, vous devez répéter ce que nous avons fait pour curl.exe afin de pouvoir accéder à la commande pip depuis n’importe où dans votre machine, mais cette fois-ci, nous le ferons pour « pip.exe ».

Touchez la touche Windows et recherchez « pip.exe », puis faites un clic droit sur le premier résultat de la recherche et cliquez sur « Ouvrir l’emplacement du fichier », cela vous mènera au dossier dans lequel se trouve ce fichier. Cliquez avec le bouton droit de la souris sur le fichier « pip.exe », puis sélectionnez « Propriétés ». Après cela, copiez la valeur « Location » et collez-la dans la variable Path comme nous l’avons fait à l’étape 1.

Étape 3 : Installer PyInstaller

Dans cette étape, nous allons installer pyinstaller en utilisant pip. Nous avons besoin de pyinstaller pour convertir nos scripts Python en fichiers exécutables (.exe). Il vous suffit de copier-coller la commande ci-dessous dans votre invite de commande et de l’exécuter :

$ pip install pyinstaller

Encore, pour confirmer votre installation, exécutez la commande suivante :

$ pyinstaller --version

Note : Si Anaconda est installé sur votre système, alors vous utilisez probablement conda le gestionnaire de paquets à la place. Dans ce cas, exécutez les commandes ci-dessous, dans l’ordre :

$ conda install -c conda-forge pyinstaller$ conda install -c anaconda pywin32

Cette étape marque la fin de toutes les installations. Dans l’étape suivante, nous allons convertir nos fichiers Python en un exécutable avec une seule commande.

Etape 4 : Convertir les fichiers Python en exécutables

C’est la dernière étape. Nous allons utiliser pyinstaller pour convertir nos fichiers .py en .exe avec une seule commande. Alors, faisons-le !

Ouvrez l’invite de commande et naviguez jusqu’au répertoire dans lequel se trouve votre fichier/script Python. Vous pouvez également ouvrir ce répertoire à l’aide de l’explorateur de fichiers, en faisant un clic droit + shift, puis en sélectionnant « Ouvrir l’invite de commande dans ce dossier ». Avant de convertir votre fichier, vous devez vérifier que votre fichier fonctionne comme prévu. À cette fin, j’ai écrit un script Python de base qui imprime le nombre 10 lorsqu’il est exécuté.

Exécutons le script et voyons s’il fonctionne bien avant de le convertir en fichier exécutable. Exécutez la commande suivante sur votre invite de commande :

$ python name_of_your_file.py

Dans mon cas, le nom du fichier était ‘sum.py’.

Pour créer un fichier exécutable autonome dans le même répertoire que votre fichier Python, exécutez la commande suivante :

$ pyinstaller --onefile <file_name>.py

Cette instruction peut prendre un certain temps pour se terminer. Une fois terminée, elle générera trois dossiers. Vous pouvez trouver le fichier exécutable dans le dossier ‘dist’. Veuillez noter que l’argument  » onefile  » indique à pyinstaller de créer un seul fichier exécutable.

Exécutons maintenant notre fichier exécutable pour voir si la procédure a fonctionné !

Ta-da ! Cela a fonctionné comme prévu.

Une petite astuce, si votre fichier exécutable se ferme trop vite pour que vous puissiez remarquer la sortie, vous pouvez ajouter une ligne input() à la fin de votre fichier Python, qui maintient le prompt ouvert en attendant l’utilisation de l’entrée. C’est ainsi que j’ai pu faire une capture d’écran de ma sortie également.

Notez également que si votre exécutable dépend d’autres fichiers exécutables, comme phantomjs, vous devez les conserver dans le même répertoire que celui de votre fichier Python afin que pyinstaller puisse l’inclure dans l’exécutable.

Conclusion

Dans ce tutoriel, nous avons abordé en détail la conversion de scripts Python en fichiers exécutables à l’aide de la bibliothèque pyinstaller de Python en quatre étapes. Nous avons commencé par installer cURL, puis pip et pyinstaller. Enfin, nous avons converti un exemple de fichier Python en fichier exécutable pour nous assurer que la procédure fonctionne sous Windows.