À propos du projet
Copier-python est un modèle Copier pour créer de nouveaux projets Python avec une chaîne d'outils moderne et directive déjà configurée. Il s'utilise via la ligne de commande pour générer un projet à un chemin choisi plutôt que d'être une bibliothèque d'exécution.
Démarrage rapide
- Installez les prérequis : mise-en-place pour la gestion de la chaîne d'outils, et Copier lui-même (par exemple via `mise use -g copier` ou `uv tool install copier`).
- Générez un projet avec `copier copy "gh:smkent/copier-python" /chemin/du/nouveau/projet`.
- Le site de documentation couvre les exigences et les détails d'utilisation supplémentaires.
Outils inclus
- mise-en-place ("mise") pour gérer la chaîne d'outils de développement.
- La suite d'outils Astral : uv, ruff et ty.
- prek, fournissant des hooks git compatibles avec pre-commit.
- pytest comme framework de test, avec le support de codecov.io.
- Zensical pour la documentation du projet, avec déploiement automatique vers GitHub Pages.
Automatisation des mises à jour et des releases
- Les mises à jour du projet sont supportées via Renovate conjointement avec `copier update`, permettant aux projets générés d'intégrer les modifications du modèle.
- L'automatisation des releases couvre la publication d'un package PyPI et la construction d'une image de conteneur, pilotée par GitHub Actions.
Crédits
Le modèle indique qu'il a été inspiré par pawamoy/copier-uv et ritwiktiwari/copier-astral. Il est distribué sous une licence incluse dans le dépôt, et est également publié sur PyPI sous le nom de copier-python.
À qui s'adresse-t-il
Aux développeurs qui souhaitent un point de départ reproductible pour des packages et applications Python, avec la gestion des dépendances, le linting/formatage, les hooks git, les tests, la documentation et les releases pilotées par CI configurés dès le départ, et qui souhaitent que ces projets générés restent miscibles aux mises à jour lorsque le modèle évolue.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.