Adloun

Voici le fichier README rendu avec un projet

Exercice d'entraînement · niveau 2 · NSI (première), chapitre 11 — Conduire un projet · Travailler à plusieurs

Énoncé

Voici le fichier README rendu avec un projet.


Projet NSI
Jeu de morpion en Python.
Lancer jeu.py.

Citer six rubriques qui manquent, et récrire le fichier.

Corrigé

Les six manques. Ce README ne répond à aucune des questions que se pose la personne qui ouvre le dossier : (1) comment lancer, précisément — avec quelle commande, quelle version de Python ; (2) ce dont le programme a besoin — bibliothèques, fichiers de données ; (3) comment on joue, une fois lancé ; (4) comment lancer les tests ; (5) ce que le programme ne fait pas — ses limites connues ; (6) qui a fait quoi.


# Morpion -- projet NSI, premiere

Jeu de morpion a deux joueurs humains, dans le terminal.

## Lancer
    python3 partie.py
Python 3.10 ou plus recent. Aucune bibliotheque exterieure.

## Jouer
A chaque tour, saisir la ligne et la colonne separees par un espace,
de 0 a 2 :  1 2  pour la case du milieu a droite.
Le programme refuse les cases occupees et les coups hors grille.

## Tester
    python3 tests_regles.py
    python3 tests_grille.py
Les deux doivent afficher trois lignes "ok" et rien d'autre.

## Fichiers
    grille.py    creation, lecture, ecriture de la grille
    regles.py    coups legaux, detection du gagnant
    affichage.py affichage de la grille, saisie du coup
    partie.py    enchainement -- c'est le point d'entree

## Limites connues
- pas d'adversaire automatique ;
- la grille est fixee a 3x3 ;
- une saisie non numerique arrete le programme au lieu de
  redemander.

## Qui a fait quoi
    Nour     grille.py, tests_grille.py
    Camille  regles.py, tests_regles.py
    Yanis    affichage.py, partie.py, ce fichier

La rubrique la plus importante est « Tester ». Elle dit à quoi ressemble un fonctionnement correct — « trois lignes ok et rien d'autre » —, donc elle donne à un lecteur le moyen de vérifier lui-même, sans vous, que le projet marche chez lui.

Une remarque sur « Limites connues » : elle rend le même service dans le dossier que la phrase honnête à l'oral. Un défaut annoncé est un défaut maîtrisé ; le même défaut découvert par le correcteur est un défaut ignoré. Le contenu est identique, la lecture qu'on en fait ne l'est pas.

Les autres exercices de ce chapitre Le cours du chapitre

Un blocage sur cet exercice ? Le tuteur d'Adloun guide par questions, sans donner la réponse.