Commentaires et documentation
Exercices corrigés

def trier_liste(liste): # Tri par sélection - algorithme quadratique O(n²) n = len(liste) for i in range(n): # Trouver l'index du plus petit élément min_idx = i for j in range(i+1, n): if liste[j] < liste[min_idx]: min_idx = j # Échanger l'élément minimum avec le premier élément non trié liste[i], liste[min_idx] = liste[min_idx], liste[i] return liste # Exemple d'utilisation donnees = [64, 34, 25, 12, 22, 11, 90] resultat = trier_liste(donnees.copy()) # Utilisation de copy() pour ne pas modifier l'original print(f"Données triées: {resultat}")

def calculer_factorielle(n): """ Calcule la factorielle d'un nombre entier positif. Args: n (int): Le nombre entier pour lequel calculer la factorielle. Doit être >= 0. Returns: int: La factorielle de n (n!). Raises: ValueError: Si n est négatif. Examples: >>> calculer_factorielle(5) 120 >>> calculer_factorielle(0) 1 """ if n < 0: raise ValueError("n doit être un entier positif ou zéro") if n == 0 or n == 1: return 1 resultat = 1 for i in range(2, n + 1): resultat *= i return resultat def trier_et_filtrer(nombres, seuil): """ Trie une liste de nombres et ne garde que ceux supérieurs au seuil. Args: nombres (list): Liste de nombres à trier et filtrer seuil (float): Valeur minimale à garder dans le résultat Returns: list: Liste triée contenant seulement les nombres >= seuil """ nombres_filtres = [n for n in nombres if n >= seuil] return sorted(nombres_filtres)

class CompteBancaire: """ Représente un compte bancaire avec des opérations de base. Attributes: titulaire (str): Le nom du titulaire du compte solde (float): Le solde actuel du compte numero_compte (str): Numéro unique du compte """ def __init__(self, titulaire, numero_compte, solde_initial=0): """ Initialise un nouveau compte bancaire. Args: titulaire (str): Le nom du titulaire numero_compte (str): Numéro unique du compte solde_initial (float, optional): Solde initial. Defaults to 0. """ self.titulaire = titulaire self.numero_compte = numero_compte self.solde = solde_initial self._historique_operations = [] # Attribut privé def deposer(self, montant): """ Dépose un montant sur le compte. Args: montant (float): Montant à déposer (> 0) Returns: bool: True si l'opération a réussi, False sinon """ if montant <= 0: return False self.solde += montant self._historique_operations.append(f"Dépôt: +{montant}") return True def retirer(self, montant): """ Retire un montant du compte si le solde est suffisant. Args: montant (float): Montant à retirer (> 0) Returns: bool: True si l'opération a réussi, False sinon """ if montant <= 0 or montant > self.solde: return False self.solde -= montant self._historique_operations.append(f"Retrait: -{montant}") return True

\"\"\" Module de gestion des opérations mathématiques de base. Ce module fournit des fonctions pour effectuer des opérations arithmétiques de base et des conversions d'unités. Functions: addition(a, b): Retourne la somme de a et b soustraction(a, b): Retourne la différence entre a et b multiplication(a, b): Retourne le produit de a et b division(a, b): Retourne le quotient de a par b conversion_celsius_fahrenheit(celsius): Convertit Celsius en Fahrenheit conversion_fahrenheit_celsius(fahrenheit): Convertit Fahrenheit en Celsius Author: Nom de l'auteur Date: Date de création Version: 1.0.0 \"\"\" def addition(a, b): \"\"\" Additionne deux nombres. Args: a (float): Premier nombre b (float): Deuxième nombre Returns: float: Somme des deux nombres \"\"\" return a + b def division(a, b): \"\"\" Divise deux nombres. Args: a (float): Numérateur b (float): Dénominateur (ne doit pas être zéro) Returns: float: Quotient de a par b Raises: ZeroDivisionError: Si b est égal à zéro \"\"\" if b == 0: raise ZeroDivisionError("Division par zéro impossible") return a / b def conversion_celsius_fahrenheit(celsius): \"\"\" Convertit une température de Celsius en Fahrenheit. Args: celsius (float): Température en degrés Celsius Returns: float: Température en degrés Fahrenheit \"\"\" return (celsius * 9/5) + 32 # Fin du module

def exemple_pep257(param1, param2=None): \"\"\" Une fonction exemple suivant PEP 257. Description détaillée de la fonction. Cette fonction fait quelque chose d'utile et suit les conventions PEP 257 pour la documentation. Args: param1 (str): Description du premier paramètre. param2 (int, optional): Description du deuxième paramètre. Defaults to None. Ce paramètre est optionnel. Returns: bool: True si l'opération réussit, False sinon. Raises: TypeError: Si param1 n'est pas une chaîne. ValueError: Si param2 est négatif. Examples: >>> exemple_pep257("test") True >>> exemple_pep257("test", 5) True \"\"\" if not isinstance(param1, str): raise TypeError("param1 doit être une chaîne") if param2 is not None and param2 < 0: raise ValueError("param2 ne doit pas être négatif") # Code de la fonction return True class ExempleClasse: \"\"\" Une classe exemple suivant PEP 257. Cette classe sert d'exemple pour montrer comment documenter correctement une classe selon les conventions PEP 257. Attributes: attribut_public (str): Un attribut public de la classe. _attribut_prive (int): Un attribut privé de la classe. \"\"\" def __init__(self, valeur): \"\"\" Initialise l'instance de la classe. Args: valeur (str): Valeur initiale pour l'attribut public. \"\"\" self.attribut_public = valeur self._attribut_prive = 0