Cx_freeze est un outil de création d’exécutable Python. Il permet de créer des exécutables autonomes à partir de scripts Python. Autrement dit, on peut distribuer les applications que l’on développe de manière autonome. Ainsi les utilisateurs finaux n’ont pas besoin d’installer Python sur leurs ordinateurs. Dans cet article nous allons détailler comment cx_freeze procède.
Avant tout, cx_Freeze est un utilitaire Python open source. Comme nous l’avons expliqué il permet de créer des exécutables autonomes à partir de scripts Python. cx_Freeze inclut tous les fichiers et dépendances nécessaires pour que le script s’exécute même si Python n’est pas installé. Il fonctionne sur Windows, macOS et Linux.
Installation de cx_Freeze
Pour installer cx_freeze sur le système, on peut utiliser la commande pip.
Utilisation de cx_Freeze
Pour créer l’exécutable, il faut dans un premier temps créer un script de configuration pour cx_Freeze. Ce script spécifie les paramètres d’interprétation des scripts de l’application et les scripts de l’application eux-même.
Voici le script de configuration « parametre.py » :
Voici le script « exp.py » :
Pour créer l'exécutable, il faut exécutez le script de configuration à l'aide de la commande suivante :
Le dossier « build » viens d’être créé dans l’arborescence de vos fichiers à côté de vos deux scripts.
On trouvera l'exécutable dans le dossier « buid ». Celui-ci peut être utilisé n’importe où.
Pour terminer, si le script est mis à jour alors il faudra relancer la commande vu plus haut.
Particularités
Voici quelques particularités importantes à connaitre pour l'utilisation de cx_Freeze :
Pour créer un exécutable avec cx_Freeze, comme nous l’avons vu, il faut généralement écrire un script de configuration qui spécifie les options de compilation, les fichiers sources à inclure, les modules externes…
Attention à la gestion des dépendances. Il faut s’assurer d'inclure toutes les dépendances requises par le script dans le script de configuration. Cela inclut les bibliothèques tierces que le script utilise (numpy, pandas, math…).
Il faut vérifier la compatibilité des plates-formes que l’on utilise. Si cx_Freeze fonctionne sur plusieurs plates-formes il est possible de devoir ajuster la configuration en fonction de la plate-forme cible. Par exemple, spécifier les bibliothèques partagées appropriées pour chaque plate-forme. Une fois l'exécutable créé, il faut s’assurer de tester son fonctionnement sur différentes plates-formes cibles pour garantir sa compatibilité.
Si l’application utilise des fichiers externes (comme des fichiers excel, des bases de données, des images…), assurez-vous d'inclure ces fichiers dans votre distribution en utilisant l'option include_files dans le script de configuration.
La création d'exécutables peut entraîner des fichiers plus volumineux que le script source, car toutes les bibliothèques et dépendances sont incluses. Il faut donc surveiller la taille de l’exécutable.
En cas de mise à jour du script source, il faut penser également mettre à jours le script de configuration. Eventuellement exécuter à nouveau le script de configuration. Cela permet aussi de prendre en compte les nouvelles options et changement de configuration.
Conclusion
En résumé, cx_Freeze est un outil puissant pour créer des exécutables Python, mais il nécessite une configuration appropriée et une compréhension des particularités de l’application pour fonctionner correctement. Il est recommandé de consulter la documentation de cx_Freeze et d'effectuer des tests approfondis pour garantir la fiabilité de votre distribution.
Vous trouverez toute la documentation sur ce lien.
Si vous rencontrez des besoins de formations, n’hésitez pas à vous tourner vers nous.
Comments