Modularité, API et paradigmes de programmation au Bac NSI : lire une documentation
Mis à jour le · AprenAI
Ce thème est rare au Bac NSI : un seul exercice de ce type apparaît dans les annales digitalisées de Métropole (2021, 1,25 point), et il consiste à lire la documentation de randint pour trouver les valeurs possibles. La notion à retenir est qu'une API se lit comme un contrat, avec ses bornes et ses types, sans qu'il soit nécessaire de connaître le code de la fonction.
- 6 sujets officiels
- 1,2 % des sujets
- 2021-2025 années
Que recouvrent la modularité, les API et les paradigmes de programmation ?
La modularité consiste à découper un programme en morceaux indépendants, des fonctions, des classes ou des modules, que l'on peut écrire, tester et réutiliser séparément. En Python, un module est un fichier de code que l'on importe : from random import randint charge la fonction randint du module random. Utiliser un module évite de réécrire ce qui existe déjà, et réduit le risque d'erreur. Le programme principal ne sait pas comment le module travaille : il ne connaît que ce qu'il propose.
Ce que propose un module s'appelle son API (interface de programmation). Elle regroupe les fonctions et les classes utilisables, avec pour chacune son nom, ses paramètres, son type de retour et sa spécification : ce qu'elle fait, ce qu'elle suppose et ce qu'elle renvoie. La documentation de la fonction randint(a, b) du module random dit : « Renvoie un entier aléatoire N tel que a <= N <= b. Alias pour randrange(a, b+1) ». Toute l'information utile à l'utilisateur est là : le résultat est un entier, et les deux bornes a et b sont comprises. Les en-têtes avec les types, comme puissance(x: float, n: int) -> float dans le sujet de Métropole 2024 (sujet 2), font partie de cette documentation : ils indiquent le type de chaque paramètre après le signe deux-points et celui du résultat après la flèche.
Un paradigme de programmation est une façon d'organiser un programme. Le paradigme impératif décrit une suite d'instructions qui modifient l'état des variables, avec des boucles et des tests. Le paradigme objet regroupe données et traitements dans des classes dont on crée des objets. L'exercice de Métropole 2022 (sujet 1 de remplacement), sur les villas, en est un exemple : une classe Piece a un nom et une superficie, une classe Villa contient des pièces et fournit des méthodes comme surface() et equip(). Le paradigme fonctionnel privilégie des fonctions qui renvoient des résultats sans modifier l'état, et les fonctions récursives s'y prêtent bien. Un même programme peut mélanger ces styles, ce que font la plupart des sujets du Bac.
- Module: Fichier de code Python que l'on importe pour utiliser ses fonctions et ses classes.
- API: Ensemble des fonctions et classes qu'un module met à disposition, décrites par leur nom, leurs paramètres et leur spécification.
- Spécification: Description de ce que fait une fonction, de ce qu'elle suppose en entrée et de ce qu'elle renvoie.
- Paradigme impératif: Programmation par suites d'instructions qui modifient l'état des variables.
- Paradigme objet: Programmation où données et méthodes sont regroupées dans des classes et leurs objets.
- Paradigme fonctionnel: Programmation à base de fonctions qui calculent un résultat sans modifier l'état.
| Paradigme | Idée centrale | Exemple vu dans les sujets |
|---|---|---|
| Impératif | Instructions qui changent l'état | Boucles for et tests des exercices de calcul |
| Objet | Classes, attributs, méthodes | Classes Piece et Villa (Métropole 2022) |
| Fonctionnel | Fonctions qui renvoient des résultats | Fonctions récursives comme anagramme |
Quels sujets de Bac sont tombés sur la modularité et les API ?
Les annales digitalisées de Métropole ne contiennent qu'un exercice rattaché à ce thème : en 2021, dans le sujet des Candidats libres 2 (exercice 4, 1,25 point, difficulté faible). Il représente 0,7 % des exercices de la série. Cela ne veut pas dire que la modularité disparaît des sujets : les notions de module, d'API, de classes et d'objets sont présentes dans beaucoup d'exercices, mais les annales les rattachent à d'autres thèmes (programmation orientée objet, récursivité, structures de données). En 2022 et en 2026, des énoncés de réseau mentionnent même la programmation orientée objet dans leur introduction.
- Lire la documentation d'une fonction (1): Candidats libres 2021 (sujet 2, exercice 4) : à partir de la documentation de random.randint(a, b), il faut dire parmi 0, 1, 3.5, 9, 10 et 11 lesquelles peuvent être renvoyées par randint(0, 10). L'exercice enchaîne ensuite avec le mélange récursif de Fischer-Yates, qui utilise cette fonction pour tirer un indice entre 0 et ind.
- Exercice 4 - Documentation du module random · Métropole Candidat libre 2021 (sujet 2) · Lire la documentation d'une fonction
Entraîne-toi : Modularité, API et paradigmes de programmation (6 sujets officiels)
Tous les sujets de NSI sur « Modularité, API et paradigmes de programmation » (2021-2025), avec le corrigé.
Comment répondre à une question sur la documentation d'une API ?
Reprenons l'exercice des Candidats libres 2021 (sujet 2, exercice 4). La documentation indique : « Renvoie un entier aléatoire N tel que a <= N <= b ». Pour randint(0, 10), les valeurs possibles sont donc les entiers N tels que 0 <= N <= 10. Passons les propositions en revue. 0 est un entier compris entre 0 et 10 : possible. 1 : possible. 3.5 n'est pas un entier mais un flottant : impossible. 9 : possible. 10 : possible, car la borne supérieure est incluse, contrairement à ce qui se passe avec range(0, 10) ou avec randrange(0, 10). 11 dépasse la borne : impossible. La réponse est donc 0, 1, 9 et 10.
Le piège du sujet est double : le type (3.5 est un flottant) et les bornes (10 est inclus, 11 est exclu). L'alias donné par la documentation, randrange(a, b+1), aide à raisonner : puisque randrange exclut sa borne supérieure, randint(a, b) la compense avec b + 1 pour l'inclure.
- Lisez la spécification mot à mot: Repérez le type du résultat (entier) et les inégalités avec leurs signes, larges ou strictes.
- Remplacez les paramètres par les valeurs de l'appel: Pour randint(0, 10), a = 0 et b = 10 : N est un entier avec 0 <= N <= 10.
- Testez chaque proposition contre le type puis contre les bornes: Un flottant n'est pas un entier, 11 est hors intervalle, 10 est à l'intérieur.
- Ne cherchez pas le code: Un exercice de documentation se résout avec la spécification : le fonctionnement interne n'est pas nécessaire.
- Réutilisez l'API dans la suite de l'exercice: Dans melange, j = randint(0, ind) donne un indice valide entre 0 et ind, y compris ind lui-même, d'où un possible échange d'un élément avec lui-même.
À ne pas confondre en modularité
- randint(a, b) ≠ randrange(a, b): randint inclut b, randrange l'exclut. randint(a, b) équivaut à randrange(a, b + 1).
- Module ≠ Fonction: Un module est un fichier qui contient des fonctions et des classes. On importe le module, puis on appelle ses fonctions.
- Utiliser une API ≠ Écrire le code: Utiliser une API demande de connaître la spécification, pas l'implémentation. Un autre auteur peut changer le code interne sans toucher à l'API.
- Classe ≠ Objet: La classe est le modèle (Villa), l'objet est une instance (la villa Bellevue, par exemple).
- Paradigme objet ≠ Paradigme fonctionnel: L'objet range des données et des méthodes dans des classes. Le fonctionnel compose des fonctions qui renvoient des résultats sans changer d'état.
- Entier ≠ Flottant: 3.5 est un flottant. randint ne renvoie que des entiers.
Mode Bac : ce qui rapporte des points
- randint: Entier N tel que a <= N <= b, les deux bornes incluses. Alias de randrange(a, b+1).
- Import: from random import randint charge la fonction pour l'utiliser directement.
- API: Un module se manipule par ses fonctions et leur documentation, sans connaître le code.
- Annotations de types: nom(x: float, n: int) -> float : types des paramètres et du résultat.
- Trois paradigmes: Impératif, objet, fonctionnel : savoir caractériser chacun en une phrase.
Quelles erreurs font perdre des points sur la documentation d'une fonction ?
La solution disponible pour ce thème est un corrigé de référence sans barème de pénalités. Elle montre pourtant les pièges de la question.
- Exclure la borne supérieure: Avec randint(0, 10), la valeur 10 est possible. Les deux bornes sont incluses, la documentation l'écrit avec des inégalités larges.
- Accepter une valeur non entière: 3.5 ne peut pas être renvoyé : c'est un flottant, alors que randint renvoie un entier.
- Accepter une valeur hors intervalle: 11 est supérieur à la borne 10, il est impossible.
- Cocher trop peu de valeurs: La question est « quelles sont celles qui peuvent être renvoyées » : plusieurs réponses sont attendues (0, 1, 9 et 10), pas une seule.
- Confondre randint et randrange: randrange(a, b) exclut b. Si vous mélangez les deux, vous perdez la borne 10.
Comment réviser la modularité et les paradigmes pour le Bac NSI ?
Les annales digitalisées ne contiennent qu'un exercice de ce thème, ce qui laisse peu de matière pour s'entraîner. Le plus rentable est de relier ces notions aux autres thèmes de programmation.
- Lisez la documentation de quelques fonctions: Pour random, regardez randint, randrange et choice : à chaque fois, relevez le type du résultat et le traitement des bornes.
- Apprenez la définition d'API: Interface qui décrit ce qu'un module propose, sans montrer comment il le fait.
- Relisez les exercices de classes: Dans le sujet des villas, repérez les attributs et les méthodes de Piece et de Villa.
- Écrivez une documentation pour vos propres fonctions: Un commentaire en docstring qui donne le rôle, les types et les conditions d'utilisation.
- Retrouvez le même mélange dans la récursivité: L'exercice du mélange récursif de Fischer-Yates prolonge directement la question sur randint.
Que renvoie randint(0, 10) en Python ?
Un entier N tel que 0 <= N <= 10, les deux bornes étant incluses. Les valeurs 0, 1, 9 et 10 sont possibles, pas 3.5 ni 11.
Quelle est la différence entre randint et randrange ?
randint(a, b) inclut b, alors que randrange(a, b) l'exclut. La documentation précise que randint est un alias de randrange(a, b+1).
Qu'est-ce qu'une API en NSI ?
C'est l'ensemble des fonctions et classes qu'un module met à disposition, décrites par leur nom, leurs paramètres et ce qu'elles renvoient. On l'utilise sans connaître son code.
Quels sont les paradigmes de programmation à connaître ?
Le paradigme impératif (suites d'instructions), le paradigme objet (classes et méthodes) et le paradigme fonctionnel (fonctions qui renvoient des résultats).
Comment importer une fonction d'un module ?
Avec from module import fonction, par exemple from random import randint, puis on appelle randint(0, 10) directement.
Plus sur l'épreuve de NSI
- Piles, files, listes et dictionnaires · 66 sujets
- Programmation orientée objet · 46 sujets
- Arbres et arbres binaires de recherche · 50 sujets
- Graphes : modélisation et parcours · 27 sujets
- Bases de données et SQL · 83 sujets
- Binaire, entiers et opérateurs booléens · 16 sujets
- Architectures matérielles et systèmes d'exploitation · 32 sujets
- Réseaux : adressage IP et sous-réseaux · 39 sujets
- Protocoles de routage : RIP et OSPF · 51 sujets
- Sécurisation des communications : chiffrement et HTTPS · 9 sujets
- Récursivité · 24 sujets
- Mise au point des programmes : bugs, assertions et tests · 13 sujets
- Programme comme donnée, calculabilité et décidabilité · 2 sujets
- Diviser pour régner · 8 sujets
- Programmation dynamique · 7 sujets
- Recherche textuelle et algorithme de Boyer-Moore · 3 sujets
- Coût des algorithmes, tris et recherche · 23 sujets