Le moyen le plus simple d'extraire votre fichier Requirements.txt en Python

Introduction :

En tant que développeurs Python, la gestion des dépendances d'un projet est une tâche de routine qui passe souvent inaperçue, jusqu'à ce que ce ne soit pas le cas. La simplicité du gel pip > Requirements.txt peut être attrayant, mais dans des projets plus complexes, il peut entraîner des problèmes inattendus qui perturbent le flux de travail. Après avoir rencontré plusieurs obstacles, j'ai découvert une approche plus fiable et plus raffinée de la gestion des dépendances, que j'aimerais partager.

Le problème avec le gel des pips :

La commande pip freeze > Requirements.txt est devenu une pratique standard pour de nombreux développeurs. Bien que cela fonctionne dans la plupart des cas, cela présente quelques inconvénients importants :

1. Inclusion de packages inutiles : pip freeze capture tous les packages installés, y compris ceux qui ont été automatiquement installés en tant que dépendances d'autres packages. Cela se traduit par un fichier Requirements.txt volumineux qui peut inclure des packages dont votre projet ne dépend pas directement.

2. Conflits de versions : L'inclusion de dépendances installées automatiquement peut parfois introduire des conflits de versions, en particulier lorsque ces dépendances ne sont pas nécessaires à votre projet mais sont requises par d'autres packages.

3. Problèmes spécifiques à l'environnement : pip freeze reflète l'état actuel de votre environnement, qui peut inclure des packages installés pour des besoins locaux spécifiques, entraînant des problèmes lors de la réplication de l'environnement sur une autre machine.

Rencontrer les obstacles :

J'ai été confronté à ces problèmes en essayant de reproduire l'environnement de mon projet. J'ai utilisé pip freeze pour générer un fichier conditions.txt, mais lorsque j'ai essayé d'installer ces dépendances dans un nouvel environnement virtuel, j'ai rencontré l'erreur suivante :

ERROR: Could not find a version that satisfies the requirement cloud-init==23.1.2 (from -r requirements.txt (line 13)) (from versions: none)
ERROR: No matching distribution found for cloud-init==23.1.2 (from -r requirements.txt (line 13))

Cette erreur était frustrante car cloud-init est un package qui n'a jamais été directement installé par moi. Il a été intégré en tant que dépendance, mais pip freeze l'a capturé comme s'il s'agissait d'un citoyen de première classe de mon projet.

Trouver la solution :

Pour résoudre ces problèmes, je suis passé à une approche plus raffinée utilisant pipreqs et pip-tools. Voici le processus étape par étape qui a résolu mes problèmes de gestion des dépendances :

1. Installation des outils nécessaires

Tout d'abord, j'ai installé pipreqs et pip-tools, qui offrent une approche plus granulaire de la gestion des dépendances :

pip install pipreqs pip-tools

2. Utilisation de pipreqs pour générer des exigences.in

Au lieu d'utiliser pip freeze, j'ai utilisé pipreqs pour générer un fichier exigences.in, qui inclut uniquement les packages directement utilisés dans mon projet. Cela évite l'inclusion de dépendances inutiles :

pipreqs ./ --savepath requirements.in --force --ignore ./venv/,./test_venv/ --mode no-pin

Voici ce que fait chaque drapeau :

• --savepath Requirements.in : Spécifie le fichier de sortie.
• --force : force l'écrasement de tout fichier existant.
• --ignore ./venv/,./test_venv/ : ignore les répertoires de l'environnement virtuel pour empêcher l'analyse des fichiers non pertinents.
• --mode no-pin : empêche l'épinglage de version, permettant plus de flexibilité.

3. Compilation du fichier requis.txt

Ensuite, j'ai utilisé pip-compile de pip-tools pour générer le fichier requis final.txt :

pip-compile

Cette étape garantit que seules les versions nécessaires des packages sont incluses, fournissant ainsi un fichier Requirements.txt propre et sans conflit.

4. Installation des dépendances

Enfin, j'ai installé les dépendances à partir du fichier Requirements.txt nouvellement généré :

pip install -r requirements.txt

Cette approche a abouti à un fichier Requirements.txt plus simple et plus gérable, exempt de packages inutiles et de conflits de versions.

Conclusion :

Passer de pip freeze à un processus de gestion des dépendances plus robuste à l'aide de pipreqs et pip-tools a changé la donne pour mon flux de travail. Cela a non seulement résolu les problèmes immédiats, mais m'a également permis de mieux contrôler les dépendances de mon projet.

Si vous comptez sur le gel des pips et que vous êtes confronté à des défis similaires, je vous recommande fortement d'essayer cette approche. C'est un petit changement qui peut faire une grande différence dans la stabilité et la portabilité de vos projets Python.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!