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.

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.

ParadigmeIdée centraleExemple vu dans les sujets
ImpératifInstructions qui changent l'étatBoucles for et tests des exercices de calcul
ObjetClasses, attributs, méthodesClasses Piece et Villa (Métropole 2022)
FonctionnelFonctions qui renvoient des résultatsFonctions 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.

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.

  1. 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.
  2. 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.
  3. 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.
  4. Ne cherchez pas le code: Un exercice de documentation se résout avec la spécification : le fonctionnement interne n'est pas nécessaire.
  5. 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é

Mode Bac : ce qui rapporte des points

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.

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.

  1. 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.
  2. Apprenez la définition d'API: Interface qui décrit ce qu'un module propose, sans montrer comment il le fait.
  3. Relisez les exercices de classes: Dans le sujet des villas, repérez les attributs et les méthodes de Piece et de Villa.
  4. Écrivez une documentation pour vos propres fonctions: Un commentaire en docstring qui donne le rôle, les types et les conditions d'utilisation.
  5. 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