# --- Structure standard d'un package publiable (src layout, recommande) ---
# mon_package/
#   pyproject.toml
#   README.md
#   LICENSE
#   src/
#     mon_package/
#       __init__.py
#       core.py
#       py.typed              # signale que le package fournit des type hints
#   tests/
#     test_core.py

# pyproject.toml complet pour publication
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "mon-package-genial"
version = "0.1.0"
description = "Un package Python qui resout un vrai probleme"
readme = "README.md"
requires-python = ">=3.9"
license = "MIT"
authors = [
    {name = "Alice Dupont", email = "alice@example.com"}
]
keywords = ["utilitaire", "cli", "exemple"]
classifiers = [
    "Programming Language :: Python :: 3",
    "License :: OSI Approved :: MIT License",
    "Operating System :: OS Independent",
]
dependencies = [
    "click>=8.0",
    "requests>=2.28",
]

[project.urls]
Homepage = "https://github.com/alice/mon-package-genial"
Repository = "https://github.com/alice/mon-package-genial"
Issues = "https://github.com/alice/mon-package-genial/issues"

[project.scripts]
mon-cli = "mon_package.cli:main"

[project.optional-dependencies]
dev = ["pytest>=7.0", "build>=1.0", "twine>=4.0"]

# src/mon_package/__init__.py
"""Mon package genial, expose son API publique."""

from mon_package.core import fonction_principale

__version__ = "0.1.0"
__all__ = ["fonction_principale"]

# --- Cycle de build et publication ---

# 1. Installer les outils de build
pip install build twine

# 2. Construire les artefacts (wheel .whl et source distribution .tar.gz)
python -m build
# genere : dist/mon_package_genial-0.1.0-py3-none-any.whl
#          dist/mon_package_genial-0.1.0.tar.gz

# 3. Verifier les artefacts avant publication
twine check dist/*

# 4. Publier d'abord sur TestPyPI pour valider (fortement recommande)
twine upload --repository testpypi dist/*
pip install --index-url https://test.pypi.org/simple/ mon-package-genial

# 5. Publier sur PyPI (production) -- IRREVERSIBLE pour ce numero de version
twine upload dist/*

# 6. Une fois publie, n'importe qui peut installer :
pip install mon-package-genial

# --- Versionnement semantique (SemVer) : MAJOR.MINOR.PATCH ---
# 1.0.0 -> 1.0.1 : correction de bug (patch), retro-compatible
# 1.0.1 -> 1.1.0 : nouvelle fonctionnalite (minor), retro-compatible
# 1.1.0 -> 2.0.0 : changement cassant (major), rupture de compatibilite

# Automatiser le versionnement avec des tags git + CI
git tag v0.1.0
git push origin v0.1.0

# .github/workflows/publish.yml : publication automatisee via GitHub Actions
name: Publish to PyPI
on:
  release:
    types: [published]
jobs:
  build-and-publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: pip install build twine
      - run: python -m build
      - run: twine upload dist/*
        env:
          TWINE_USERNAME: __token__
          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}