mon-package-python 0.1.0__py3-none-any.whl

mon_package_python/__init__.py

@@ -0,0 +1,26 @@
+"""
+Mon Package Python
+==================
+
+Un package Python professionnel avec toutes les meilleures pratiques.
+
+Modules disponibles:
+- string_ops: Opérations sur les chaînes de caractères
+- math_ops: Opérations mathématiques utiles
+"""
+
+__version__ = "0.1.0"
+__author__ = "Votre Nom"
+__email__ = "votre.email@example.com"
+
+from mon_package_python.string_ops import (
+    capitalize_words,
+    count_vowels,
+    reverse_string,
+)
+
+__all__ = [
+    "reverse_string",
+    "count_vowels",
+    "capitalize_words",
+]

mon_package_python/math_ops.py

@@ -0,0 +1,210 @@
+"""
+Module pour les opérations mathématiques.
+
+Ce module fournit des fonctions mathématiques utilitaires.
+"""
+
+from typing import List, Union
+
+
+def factorial(n: int) -> int:
+    """
+    Calcule la factorielle d'un nombre.
+
+    Args:
+        n (int): Le nombre dont on veut calculer la factorielle (n >= 0).
+
+    Returns:
+        int: La factorielle de n.
+
+    Examples:
+        >>> factorial(5)
+        120
+        >>> factorial(0)
+        1
+        >>> factorial(3)
+        6
+
+    Raises:
+        ValueError: Si n est négatif.
+        TypeError: Si n n'est pas un entier.
+    """
+    if not isinstance(n, int):
+        raise TypeError(f"Expected int, got {type(n).__name__}")
+    if n < 0:
+        raise ValueError("Factorial is not defined for negative numbers")
+    if n == 0 or n == 1:
+        return 1
+    return n * factorial(n - 1)
+
+
+def is_prime(n: int) -> bool:
+    """
+    Vérifie si un nombre est premier.
+
+    Args:
+        n (int): Le nombre à vérifier.
+
+    Returns:
+        bool: True si le nombre est premier, False sinon.
+
+    Examples:
+        >>> is_prime(7)
+        True
+        >>> is_prime(10)
+        False
+        >>> is_prime(2)
+        True
+
+    Raises:
+        TypeError: Si n n'est pas un entier.
+    """
+    if not isinstance(n, int):
+        raise TypeError(f"Expected int, got {type(n).__name__}")
+    if n < 2:
+        return False
+    if n == 2:
+        return True
+    if n % 2 == 0:
+        return False
+
+    # Vérifier les diviseurs impairs jusqu'à sqrt(n)
+    i = 3
+    while i * i <= n:
+        if n % i == 0:
+            return False
+        i += 2
+    return True
+
+
+def fibonacci(n: int) -> List[int]:
+    """
+    Génère la suite de Fibonacci jusqu'au n-ième terme.
+
+    Args:
+        n (int): Le nombre de termes à générer (n >= 0).
+
+    Returns:
+        List[int]: La liste des n premiers termes de Fibonacci.
+
+    Examples:
+        >>> fibonacci(5)
+        [0, 1, 1, 2, 3]
+        >>> fibonacci(8)
+        [0, 1, 1, 2, 3, 5, 8, 13]
+        >>> fibonacci(1)
+        [0]
+
+    Raises:
+        ValueError: Si n est négatif.
+        TypeError: Si n n'est pas un entier.
+    """
+    if not isinstance(n, int):
+        raise TypeError(f"Expected int, got {type(n).__name__}")
+    if n < 0:
+        raise ValueError("n must be non-negative")
+    if n == 0:
+        return []
+    if n == 1:
+        return [0]
+
+    fib = [0, 1]
+    for _ in range(2, n):
+        fib.append(fib[-1] + fib[-2])
+    return fib
+
+
+def mean(numbers: List[Union[int, float]]) -> float:
+    """
+    Calcule la moyenne d'une liste de nombres.
+
+    Args:
+        numbers (List[Union[int, float]]): Liste de nombres.
+
+    Returns:
+        float: La moyenne des nombres.
+
+    Examples:
+        >>> mean([1, 2, 3, 4, 5])
+        3.0
+        >>> mean([10, 20, 30])
+        20.0
+
+    Raises:
+        ValueError: Si la liste est vide.
+        TypeError: Si la liste contient des éléments non numériques.
+    """
+    if not numbers:
+        raise ValueError("Cannot calculate mean of empty list")
+    if not all(isinstance(x, (int, float)) for x in numbers):
+        raise TypeError("All elements must be numbers")
+
+    return sum(numbers) / len(numbers)
+
+
+def median(numbers: List[Union[int, float]]) -> float:
+    """
+    Calcule la médiane d'une liste de nombres.
+
+    Args:
+        numbers (List[Union[int, float]]): Liste de nombres.
+
+    Returns:
+        float: La médiane des nombres.
+
+    Examples:
+        >>> median([1, 2, 3, 4, 5])
+        3.0
+        >>> median([1, 2, 3, 4])
+        2.5
+
+    Raises:
+        ValueError: Si la liste est vide.
+        TypeError: Si la liste contient des éléments non numériques.
+    """
+    if not numbers:
+        raise ValueError("Cannot calculate median of empty list")
+    if not all(isinstance(x, (int, float)) for x in numbers):
+        raise TypeError("All elements must be numbers")
+
+    sorted_numbers = sorted(numbers)
+    n = len(sorted_numbers)
+
+    if n % 2 == 1:
+        return float(sorted_numbers[n // 2])
+    else:
+        mid1, mid2 = sorted_numbers[n // 2 - 1], sorted_numbers[n // 2]
+        return (mid1 + mid2) / 2.0
+
+
+def gcd(a: int, b: int) -> int:
+    """
+    Calcule le plus grand commun diviseur (PGCD) de deux nombres.
+
+    Utilise l'algorithme d'Euclide.
+
+    Args:
+        a (int): Premier nombre.
+        b (int): Deuxième nombre.
+
+    Returns:
+        int: Le PGCD de a et b.
+
+    Examples:
+        >>> gcd(48, 18)
+        6
+        >>> gcd(100, 50)
+        50
+        >>> gcd(17, 13)
+        1
+
+    Raises:
+        TypeError: Si a ou b ne sont pas des entiers.
+    """
+    if not isinstance(a, int) or not isinstance(b, int):
+        raise TypeError("Both arguments must be integers")
+
+    a, b = abs(a), abs(b)
+    while b:
+        a, b = b, a % b
+    return a

mon_package_python/string_ops.py

@@ -0,0 +1,144 @@
+"""
+Module pour les opérations sur les chaînes de caractères.
+
+Ce module fournit des fonctions utilitaires pour manipuler
+les chaînes de caractères de manière efficace.
+"""
+
+
+def reverse_string(s: str) -> str:
+    """
+    Inverse l'ordre des caractères d'une chaîne.
+
+    Args:
+        s (str): La chaîne à inverser.
+
+    Returns:
+        str: La chaîne inversée.
+
+    Examples:
+        >>> reverse_string("Hello")
+        'olleH'
+        >>> reverse_string("Python")
+        'nohtyP'
+
+    Raises:
+        TypeError: Si l'argument n'est pas une chaîne.
+    """
+    if not isinstance(s, str):
+        raise TypeError(f"Expected str, got {type(s).__name__}")
+    return s[::-1]
+
+
+def count_vowels(s: str) -> int:
+    """
+    Compte le nombre de voyelles dans une chaîne.
+
+    Les voyelles prises en compte sont: a, e, i, o, u (minuscules et majuscules).
+
+    Args:
+        s (str): La chaîne dans laquelle compter les voyelles.
+
+    Returns:
+        int: Le nombre de voyelles trouvées.
+
+    Examples:
+        >>> count_vowels("Hello World")
+        3
+        >>> count_vowels("AEIOU")
+        5
+        >>> count_vowels("xyz")
+        0
+
+    Raises:
+        TypeError: Si l'argument n'est pas une chaîne.
+    """
+    if not isinstance(s, str):
+        raise TypeError(f"Expected str, got {type(s).__name__}")
+
+    vowels: str = "aeiouAEIOU"
+    return sum(1 for char in s if char in vowels)
+
+
+def capitalize_words(s: str) -> str:
+    """
+    Met en majuscule la première lettre de chaque mot.
+
+    Args:
+        s (str): La chaîne à modifier.
+
+    Returns:
+        str: Une nouvelle chaîne avec chaque mot capitalisé.
+
+    Examples:
+        >>> capitalize_words("hello world")
+        'Hello World'
+        >>> capitalize_words("python programming")
+        'Python Programming'
+        >>> capitalize_words("the quick brown fox")
+        'The Quick Brown Fox'
+
+    Raises:
+        TypeError: Si l'argument n'est pas une chaîne.
+    """
+    if not isinstance(s, str):
+        raise TypeError(f"Expected str, got {type(s).__name__}")
+
+    return " ".join(word.capitalize() for word in s.split())
+
+
+def remove_whitespace(s: str) -> str:
+    """
+    Supprime tous les espaces blancs d'une chaîne.
+
+    Args:
+        s (str): La chaîne à traiter.
+
+    Returns:
+        str: La chaîne sans espaces.
+
+    Examples:
+        >>> remove_whitespace("Hello World")
+        'HelloWorld'
+        >>> remove_whitespace("  Python   Programming  ")
+        'PythonProgramming'
+
+    Raises:
+        TypeError: Si l'argument n'est pas une chaîne.
+    """
+    if not isinstance(s, str):
+        raise TypeError(f"Expected str, got {type(s).__name__}")
+
+    return "".join(s.split())
+
+
+def is_palindrome(s: str) -> bool:
+    """
+    Vérifie si une chaîne est un palindrome.
+
+    Un palindrome est un mot qui se lit de la même façon dans les deux sens.
+    La fonction ignore les espaces et la casse.
+
+    Args:
+        s (str): La chaîne à vérifier.
+
+    Returns:
+        bool: True si c'est un palindrome, False sinon.
+
+    Examples:
+        >>> is_palindrome("radar")
+        True
+        >>> is_palindrome("A man a plan a canal Panama")
+        True
+        >>> is_palindrome("hello")
+        False
+
+    Raises:
+        TypeError: Si l'argument n'est pas une chaîne.
+    """
+    if not isinstance(s, str):
+        raise TypeError(f"Expected str, got {type(s).__name__}")
+
+    # Normaliser: enlever les espaces et mettre en minuscules
+    normalized = "".join(s.split()).lower()
+    return normalized == normalized[::-1]

mon_package_python-0.1.0.dist-info/METADATA

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: mon-package-python
+Version: 0.1.0
+Summary: Un package Python professionnel créé avec Poetry
+License: MIT
+License-File: LICENSE
+Keywords: python,package,example
+Author: Votre Nom
+Author-email: votre.email@example.com
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Project-URL: Homepage, https://github.com/username/mon-package-python
+Project-URL: Repository, https://github.com/username/mon-package-python
+Description-Content-Type: text/markdown
+
+# Mon Package Python
+
+[![Tests](https://github.com/username/mon-package-python/actions/workflows/tests.yaml/badge.svg)](https://github.com/username/mon-package-python/actions/workflows/tests.yaml)
+[![Documentation](https://github.com/username/mon-package-python/actions/workflows/sphinx_doc.yaml/badge.svg)](https://username.github.io/mon-package-python/)
+[![PyPI version](https://badge.fury.io/py/mon-package-python.svg)](https://badge.fury.io/py/mon-package-python)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+
+Un package Python professionnel avec toutes les meilleures pratiques de développement.
+
+## 🚀 Installation
+
+```bash
+pip install mon-package-python
+```
+
+Ou pour un environnement de développement :
+
+```bash
+git clone https://github.com/username/mon-package-python.git
+cd mon-package-python
+poetry install
+```
+
+## 📖 Utilisation
+
+```python
+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](https://username.github.io/mon-package-python/).
+
+## 🧪 Tests
+
+Pour exécuter les tests :
+
+```bash
+poetry run pytest
+```
+
+Avec couverture de code :
+
+```bash
+poetry run pytest --cov
+```
+
+## 🔧 Développement
+
+### Pré-requis
+
+- Python 3.10+
+- Poetry
+
+### Installation de l'environnement de développement
+
+```bash
+# 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é
+   ```bash
+   git checkout -b feature/ma-nouvelle-fonctionnalite
+   ```
+
+2. Faire vos modifications avec des commits atomiques
+
+3. Exécuter les tests
+   ```bash
+   poetry run pytest
+   ```
+
+4. Vérifier la qualité du code
+   ```bash
+   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
+```
+
+
+
+

mon_package_python-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+mon_package_python/__init__.py,sha256=trkvDUmpFxT0huoCkTfNJVQyJ9ZXR6tdYmbasooayZE,517
+mon_package_python/math_ops.py,sha256=CU9zlgCcb8_nUbrLVi2l5OC1NDAPZdJr6TosN1abfPg,4765
+mon_package_python/string_ops.py,sha256=jU0S_rKk2znCUVYnZAGwXEPNcEQmsCALJnFeNokpRsg,3538
+mon_package_python-0.1.0.dist-info/licenses/LICENSE,sha256=D6bbnwae2RxRX0IzchEHctB8AaNWQvExFFeEpk0iOy0,1066
+mon_package_python-0.1.0.dist-info/METADATA,sha256=ZM6sMSVKu4PrnHleSK_M-LQG_igRflQMAmGED5Z-z2c,3832
+mon_package_python-0.1.0.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+mon_package_python-0.1.0.dist-info/RECORD,,

mon_package_python-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.3.1
+Root-Is-Purelib: true
+Tag: py3-none-any

mon_package_python-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Votre Nom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.