🛠️ Python Dev Toolkit

Un ensemble d'outils et de configurations standardisées pour le développement Python.

📋 Fonctionnalités

• ✅ Formatage automatique avec Black et isort
• ✅ Linting avec flake8
• ✅ Analyse de sécurité avec Bandit
• ✅ Configurations pré-configurées et prêtes à l'emploi
• ✅ Makefile avec commandes standardisées
• ✅ Pre-commit hooks (optionnel)

🚀 Installation rapide

# Dans votre projet Python
curl -sSL https://raw.githubusercontent.com/ClaraVnk/python-dev-toolkit/main/install.sh | bash

Ou manuellement :

# Cloner le repo
git clone https://github.com/ClaraVnk/python-dev-toolkit.git /tmp/python-dev-toolkit

# Copier les fichiers dans votre projet
cd votre-projet
cp /tmp/python-dev-toolkit/configs/.flake8 .
cp /tmp/python-dev-toolkit/Makefile.template Makefile

📦 Installation des outils

# Installer les outils de développement
pip install black isort flake8 bandit

Ou ajoutez à votre pyproject.toml :

[project.optional-dependencies]
dev = [
    "bandit[toml]>=1.7.5",
    "isort>=5.12.0",
    "black>=23.0.0",
    "flake8>=6.0.0",
]

🔧 Utilisation

Commandes Make disponibles

make format    # Formater le code (isort + black)
make lint      # Vérifier le style (flake8)
make security  # Vérifier la sécurité (bandit)
make check     # Tout vérifier (format + lint + security)
make clean     # Nettoyer les fichiers temporaires

Configuration personnalisée

Black

Éditez pyproject.toml :

[tool.black]
line-length = 88
target-version = ['py39']

isort

[tool.isort]
profile = "black"
line_length = 88

flake8

Éditez .flake8 :

[flake8]
max-line-length = 88
extend-ignore = E203,W503

Bandit

[tool.bandit]
exclude_dirs = ["/tests"]

🎯 Workflow recommandé

Avant chaque commit

make check

Avec pre-commit hooks (optionnel)

# Installer pre-commit
pip install pre-commit

# Copier la config
cp /tmp/python-dev-toolkit/configs/.pre-commit-config.yaml .

# Installer les hooks
pre-commit install

# Les hooks s'exécuteront automatiquement à chaque commit

📁 Structure du projet

python-dev-toolkit/
├── README.md                      # Ce fichier
├── LICENSE                        # Licence MIT
├── install.sh                     # Script d'installation
├── configs/
│   ├── .flake8                   # Configuration flake8
│   ├── pyproject.toml.template   # Template pyproject.toml
│   └── .pre-commit-config.yaml   # Pre-commit hooks
├── Makefile.template              # Template Makefile
└── examples/
    └── sample-project/            # Exemple d'utilisation

🔍 Configurations incluses

Flake8

• Longueur de ligne : 88 caractères (compatible Black)
• Ignore E203, W503 (incompatibles avec Black)
• Ignore E501, F401, F841 (configurable)

Black

• Longueur de ligne : 88 caractères
• Target Python 3.9+
• Format uniforme et déterministe

isort

• Profile "black" (compatible)
• Tri automatique des imports
• Groupes : stdlib → third-party → local

Bandit

• Analyse de sécurité du code
• Détection des vulnérabilités communes
• Exclut les dossiers de tests

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

1. Fork le projet
2. Créer une branche (git checkout -b feature/amelioration)
3. Commit vos changements (git commit -m 'Ajout fonctionnalité')
4. Push vers la branche (git push origin feature/amelioration)
5. Ouvrir une Pull Request

📝 Licence

MIT License - voir le fichier LICENSE

🙏 Crédits

Créé par @ClaraVnk

Inspiré par les meilleures pratiques de la communauté Python.

📚 Ressources

• Black Documentation
• isort Documentation
• flake8 Documentation
• Bandit Documentation
• Pre-commit Documentation