Projet : objets dés

Projet sur le codage d'objets en python. Notre but est de pouvoir créer des dés virtuels pour pouvoir jouer au 421.

Fonctionnalités d'un Dé

Si on veut pouvoir utiliser nos dés virtuels comme un vrai dé physique, la classe Dé doit être capable de :

• créer un objet sans paramètre (sa valeur est alors 1),

• connaître et donner la valeur du dé,

• lancer un dé en utilisant une méthode nommée lancer() qui ne rend rien, mais change la valeur du dé de façon aléatoire.

La valeur du dé doit être un entier entre 1 et 6.

Modélisation UML

Des spécifications précédentes, on doit pouvoir en déterminer la modélisation UML.

Squelette python

On va créer tous les fichiers nécessaires dans le projet, mais avant de coder directement commençons par créer le squelette du projet.

class Dé:
    def __init__(self):
        pass

    def lancer(self):
        pass

On a pas fini ! Il faut encore écrire les tests relatifs à notre classe. Pour l'instant on ne peut guère que vérifier que l'on crée bien un objet de la classe Dé.

from dé import Dé


def test_init():
    dé = Dé()
    assert isinstance(dé, Dé)

from dé import Dé


def test_init():
    assert isinstance(Dé(), Dé)

Il nous reste une chose à faire pour que notre code python soit conforme à l'UML : la déclaration des attributs. En python les attributs sont affecté dans le constructeur.

class Dé:
    def __init__(self):
        self.valeur = 1

    def lancer(self):
        pass

from dé import Dé

# ...

def test_valeur():
    dé = Dé()
    assert dé.valeur == 1

from dé import Dé

# ...

def test_valeur():
    assert Dé().valeur == 1

Code Classe

Terminons l'implémentation de la classe Dé en codant la méthode Dé.lancer().

Dans la documentation et lorsque l'on décrit une méthode, som nom de la méthode est toujours accolé au nom de la classe qui la définit. Par exemple : Dé.lancer() signifie :

• la méthode lancer de la classe Dé
• cette méthode ne prend pas de paramètre.

>>> un_dé = Dé()
>>> un_dé.lancer()

>>> un_dé = Dé()
>>> Dé.lancer(un_dé)

On a toutes les information nécessaire pour le faire :

class Dé:
   # ...

    def lancer(self):
        self.valeur = random.randrange(1, 6 + 1)

On a pas fini le code puisqu'il manque les tests de la méthode Dé.lancer() ! On a cependant un soucis car il est impossible de tester le hasard (on pourrait n'avoir pas de chance et lancer 10 fois le dé sans que la valeur ne change sans que ce soit mal codé). Comme on a besoin que nos fonctionnent toujours, il faut trouver ce qui est toujours vrai après un lancer :

from dé import Dé

# ...

def test_lancer():
    dé = Dé()
    dé.lancer()
    assert 1 <= dé.valeur <= 6

User stories

L'idée est d'écrire une succession d'actions faites par un utilisateur typique afin de réaliser une tâche précise avec notre programme. Par exemple :

Codez cette user story si on devait la coder :

from dé import Dé

# 1. créer un dé sans paramètre
dé = Dé() 

# 2. afficher à l'écran sa valeur (ça doit être 1)
print(dé.valeur)

# 3. lancer le dé 10 fois et affiche la valeur du dé après chaque lancer
for i in range(10):
    dé.lancer()
    print(dé.valeur)

La user story fait office de test fonctionnel qui permet de vérifier que le code correspond aux attentes des utilisateurs :

Au final :

Affichage

Pour l'instant, lorsque l'on tente d'afficher un dé on obtient le charabia suivant :

>>> dé = Dé()
>>> print(dé)
<__main__.Dé object at 0x10a691010>

Ce qui n'est pas très informatif. On peut bien sur afficher sa valeur :

>>> dé = Dé()
>>> print(dé.valeur)
1

Mais représenter un dé par un entier ce n'est pas très joli. Nous allons coder une méthode spécifique pour représenter notre objet sous la forme d'une chaîne de caractère : la méthode Dé.texte().

>>> d = Dé()
>>> print(d.texte())
⚀
>>> d.valeur = 4
>>> print(d.texte())
⚃

Vous pourrez maintenant utiliser cette méthode pour l'affichage de tous vos dés, en particulier pour les user stories !

Programme principal

Avant de coder le programme principal :

Une fois tout ok, on peut commencer à créer le code du main.py :

from dé import Dé

valeur_initiale = int(input("valeur initiale du dé : "))
valeur_finale = int(input("valeur finale du dé : "))

dé = Dé()
dé.valeur = valeur_initiale

nombre_lancer = 0
while dé.valeur != valeur_finale:
    dé.lancer()
    nombre_lancer += 1

print("Il a fallu : ", nombre_lancer, "lancers")

Code Python de la classe Dé