Python génère de nombreux fichiers qui ne devraient pas être committés : bytecode compilé (__pycache__, .pyc), répertoires d'environnement virtuel, packages de distribution, rapports de couverture et paramètres spécifiques à l'IDE.
Ce modèle utilise le gitignore Python officiel de GitHub combiné avec les règles VirtualEnv et les patterns courants IDE/OS. Il fonctionne avec pip, poetry, pipenv, conda, pytest, mypy et tous les workflows Python majeurs.
Comment utiliser
1. Examinez les modèles présélectionnés ci-dessous
2. Ajoutez ou supprimez des modèles selon votre projet (ex : ajoutez Django, Flask)
3. Cliquez sur « Copier » ou « Télécharger » pour obtenir le fichier
4. Placez-le à la racine de votre projet
Questions frequentes
Dois-je committer mon environnement virtuel ?
Jamais. Les environnements virtuels (venv, .venv, env) peuvent être énormes et sont spécifiques à la machine. Ajoutez-les au .gitignore et utilisez requirements.txt ou pyproject.toml pour les recréer.
Dois-je ignorer __pycache__ et les fichiers .pyc ?
Oui. Ce sont des fichiers bytecode compilés générés automatiquement par Python. Ils sont spécifiques à la machine et seront régénérés quand Python exécutera votre code.
Dois-je committer les checkpoints Jupyter notebook ?
Non. Le répertoire .ipynb_checkpoints est auto-généré par Jupyter et devrait être ignoré. Les notebooks eux-mêmes (fichiers .ipynb) devraient être committés.
Quelle est la différence entre venv et virtualenv ?
venv est le module intégré à Python 3.3+ pour créer des environnements virtuels. virtualenv est un package tiers qui existait avant venv et offre quelques fonctionnalités supplémentaires. Les deux créent des dossiers qui doivent être ignorés par Git.
Dois-je ignorer le fichier poetry.lock ?
Non ! Comme package-lock.json pour Node.js, poetry.lock garantit que tous les développeurs utilisent exactement les mêmes versions de dépendances. Il doit être versionné. Ignorez seulement le dossier .venv créé par Poetry.
Comment gérer les fichiers de configuration PyCharm ?
Le dossier .idea/ contient les paramètres PyCharm/JetBrains. Ce modèle l'ignore par défaut car les configurations IDE sont souvent spécifiques à chaque développeur. Si votre équipe veut partager certains paramètres, vous pouvez exclure des fichiers spécifiques.
Dois-je ignorer les fichiers .egg-info ?
Oui. Les dossiers .egg-info et dist/ sont créés lors du packaging de votre projet Python. Ce sont des artefacts de build qui ne doivent pas être versionnés — ils peuvent être recréés avec 'python setup.py' ou 'pip install -e .'.