1.2 Syntaxe et Typage Graduel

2. Commentaires vs Docstrings

• # Commentaire : Pour expliquer comment le code fonctionne techniquement.
• """ Docstring """ : Pour documenter ce que fait une fonction (accessible via help()).

def scan_system():
    """Effectue un scan des paquets installés."""
    # On utilise pip list ici car c'est le plus simple
    pass

print(scan_system.__doc__)

3. Constantes et Transtypage

En Python, les constantes n'existent pas techniquement. On utilise des MAJUSCULES par convention.

VERSION_MAX = "3.10"
# Transtypage (Conversion)
version_num = float(VERSION_MAX) 

4. Type Hints (La Règle d'Or)

Indiquer les types attendu. Le bon compromis: dans les signatures des fonctions/procédures.

Pour le projet pyCycloneFlow, nous allons typer les entrées et les sorties de nos fonctions. C'est le meilleur compromis entre sécurité et rapidité.

# ✅ BONNE PRATIQUE : Typer la signature
def get_version(package_name: str) -> str | None:
    # Pas besoin de typer les variables internes
    version = "1.0.0" 
    return version