mon-package-python 0.1.0

Un package Python professionnel créé avec Poetry

Mon Package Python

Un package Python professionnel avec toutes les meilleures pratiques de développement.

🚀 Installation

pip install mon-package-python

Ou pour un environnement de développement :

git clone https://github.com/username/mon-package-python.git
cd mon-package-python
poetry install

📖 Utilisation

from mon_package_python.string_ops import reverse_string, count_vowels

# Inverser une chaîne
result = reverse_string("Hello World")
print(result)  # "dlroW olleH"

# Compter les voyelles
vowels = count_vowels("Hello World")
print(vowels)  # 3

🛠️ Fonctionnalités

• ✅ Manipulation de chaînes de caractères
• ✅ Opérations mathématiques
• ✅ Utilitaires de données
• ✅ Documentation complète
• ✅ Tests unitaires avec >80% de couverture

📚 Documentation

La documentation complète est disponible sur GitHub Pages.

🧪 Tests

Pour exécuter les tests :

poetry run pytest

Avec couverture de code :

poetry run pytest --cov

🔧 Développement

Pré-requis

• Python 3.10+
• Poetry

Installation de l'environnement de développement

# Installer les dépendances
poetry install

# Activer l'environnement virtuel
poetry shell

# Installer les pre-commit hooks
pre-commit install

Workflow de développement

1. Créer une branche pour votre fonctionnalité

   git checkout -b feature/ma-nouvelle-fonctionnalite
   

2. Faire vos modifications avec des commits atomiques

3. Exécuter les tests

   poetry run pytest
   

4. Vérifier la qualité du code

   ruff check --fix .
   

5. Créer une Pull Request

📦 Structure du Projet

mon-package-python/
├── .github/
│   └── workflows/          # GitHub Actions CI/CD
├── docs/                   # Documentation Sphinx
├── src/
│   └── mon_package_python/ # Code source
│       ├── __init__.py
│       ├── string_ops.py
│       └── math_ops.py
├── tests/                  # Tests unitaires
│   ├── __init__.py
│   ├── test_string_ops.py
│   └── test_math_ops.py
├── .gitignore
├── .pre-commit-config.yaml
├── pyproject.toml
├── README.md
└── LICENSE