mon-package-python 0.1.0__tar.gz

mon_package_python-0.1.0/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.

mon_package_python-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,129 @@
+# 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/pyproject.toml

@@ -0,0 +1,79 @@
+[tool.poetry]
+name = "mon-package-python"
+version = "0.1.0"
+description = "Un package Python professionnel créé avec Poetry"
+authors = ["Votre Nom <votre.email@example.com>"]
+readme = "README.md"
+license = "MIT"
+homepage = "https://github.com/username/mon-package-python"
+repository = "https://github.com/username/mon-package-python"
+keywords = ["python", "package", "example"]
+packages = [{include = "mon_package_python", from = "src"}]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+[tool.poetry.dependencies]
+python = "^3.10"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^9.0.0"
+ruff = "^0.15.0"
+# pytest-cov et sphinx sont désactivés pour Python 3.13 Microsoft Store
+
+# pytest-cov = "^7.0.0"
+# sphinx = "^7.2.0"
+# sphinx-rtd-theme = "^1.3.0"
+# pre-commit = "^3.5.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4", # flake8-comprehensions
+    "UP", # pyupgrade
+]
+ignore = [
+    "E501",  # line too long, handled by formatter
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+addopts = [
+    "--verbose",
+    "--strict-markers",
+]
+# Options de coverage désactivées (pytest-cov non installé)
+# Décommentez si vous installez pytest-cov:
+# addopts = [
+#     "--verbose",
+#     "--strict-markers",
+#     "--cov=src",
+#     "--cov-report=term-missing",
+#     "--cov-report=html",
+# ]

mon_package_python-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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]