Compare revisions

**Sommaire**

[[TOC]]

# Informatique à l'ECL

*Remarque* Les liens vers les espaces Moodle sont ceux de 2020-2021. Je vous laisse rechercher les liens de ces mêmes cours pour l'année en cours !

---

## Enseignement de l'Informatique en 2A

### S7 - UE Approfondissement (App)

- [App 1-FH](https://pedagogie2.ec-lyon.fr/enrol/index.php?id=1105) - Multimédia : Concepts et technologies, [M. Ardabilian](mailto:mohsen.ardabilian@ec-lyon.fr), [E. Dellandréa](mailto:emmanuel.dellandrea@ec-lyon.fr)    

- [App 2-FH](https://pedagogie2.ec-lyon.fr/enrol/index.php?id=1106) - Stratégies de résolution de problèmes, [A. Saidi](mailto:alexandre.saidi@ec-lyon.fr)    

- [App 3-EG](https://pedagogie2.ec-lyon.fr/course/view.php?id=1107) - Applications concurrentes, mobiles et réparties en Java, [A. Saidi](mailto:alexandre.saidi@ec-lyon.fr), [S. Derrode](mailto:stephane.derrode@ec-lyon.fr)    

- [App 4-EG](https://pedagogie2.ec-lyon.fr/enrol/index.php?id=1108) - Analyse de données et reconnaissance des formes, [L. Chen](liming.chen@ec-lyon.fr), [E. Dellandréa](mailto:emmanuel.dellandrea@ec-lyon.fr)    

[*Détails des enseignements*](https://www.ec-lyon.fr/formation/ingenieure-generaliste/programme-formation/tronc-commun/offre-formation-tronc-commun?module=654102)

### S8 - UE Électifs (ELC)

- [ELC A11](https://pedagogie2.ec-lyon.fr/course/view.php?id=1137) - Programmation des interfaces graphiques en C++, [E. Dellandréa](mailto:emmanuel.dellandrea@ec-lyon.fr), [S. Derrode](mailto:stephane.derrode@ec-lyon.fr)    

- [ELC B2](https://pedagogie2.ec-lyon.fr/enrol/index.php?id=1140) - Algorithme collaboratifs et applications, [P. Michel](philippe.michel@ec-lyon.fr), [A. Saidi](mailto:alexandre.saidi@ec-lyon.fr)    

- [ELC C4](https://pedagogie2.ec-lyon.fr/enrol/index.php?id=1152) - Capteurs et traitement d'images, [L. Chen](liming.chen@ec-lyon.fr)       

- [ELC D3](https://pedagogie2.ec-lyon.fr/enrol/index.php?id=1160) - Applications Web, [D. Muller](mailto:daniel.muller@ec-lyon.fr), [R. Chalon](rene.chalon@ec-lyon.fr)    

- [ELC E1](https://pedagogie2.ec-lyon.fr/enrol/index.php?id=1170) - Algorithme et raisonnement, [A. Saidi](mailto:alexandre.saidi@ec-lyon.fr), [E. Dellandréa](mailto:emmanuel.dellandrea@ec-lyon.fr)     

[*Détails des enseignements*](https://www.ec-lyon.fr/formation/ingenieure-generaliste/programme-formation/parcours-electif/offre-formation-parcours?module=654204)

---

## Césure 2A / 3A - Centrale Digital Lab

Une année de césure professionnalisante et en immersion dans le numérique

 - 3 semaines de cours en *IA*, *Machine Learning*, *Big Data*, *Web*, *Data visualisation*    

 - 3 POC (*Proof-Of-Concept*) de 7 semaines, animés par des entreprises et en mode agile (formateurs CGI / Sopra)    

 - 1 stage en entreprise de 5 mois (à l'étranger)   

Plus d'information?

 - Teaser video : [youtube - Centrale Digital Lab](https://www.youtube.com/watch?v=dK0R9EFA4I8)    

 - Responsable du programme [René Chalon](mailto:rene.chalon@ec-lyon.fr)  

 - Plus d'information auprès de [Fatima Chouikhi](mailto:fatima.chouikhi@ec-lyon.fr)    

 - Site de l'ECL : [Centrale Digital Lab](https://www.ec-lyon.fr/formation/ingenieur-generaliste/construire-son-projet-professionnel/lyon-centrale-digital-lab)

---

## Enseignement de l'Informatique en 3A

### S9 – Modules Ouverts Disciplinaires (MOD)

- [MOD 2.1](https://pedagogie3.ec-lyon.fr/course/view.php?id=1210) - Défis informatique du Big Data, [S. Derrode](mailto:stephane.derrode@ec-lyon.fr)    

- [MOD 3.2](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1203) - Apprentissage profond & Intelligence Artificielle, [L. Chen](liming.chen@ec-lyon.fr), A. Bosio, [E. Dellandréa](mailto:emmanuel.dellandrea@ec-lyon.fr)    

- [MOD 4.4](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1241) - Recherche opérationnelle, [M. Zine](abdel-malek.zine@ec-lyon.fr), N. Bousquet, [A. Saidi](mailto:alexandre.saidi@ec-lyon.fr)    

- [MOD 4.6](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1249) - Systèmes de bases de données, [L. Chen](liming.chen@ec-lyon.fr)    

- [MOD 5.3](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1252) - Traitement et analyse des données visuelles et sonores, [M. Ardabilian](mailto:mohsen.ardabilian@ec-lyon.fr), [E. Dellandréa](mailto:emmanuel.dellandrea@ec-lyon.fr)    

- [MOD 7.1](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1250) - Systèmes d'information en entreprise, [R. Vuillemot](mailto:romain.vuillemot@ec-lyon.fr)

- [MOD 7.2](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1218) - Introduction à la data science, [A. Saidi](mailto:alexandre.saidi@ec-lyon.fr)

- [MOD 8.4](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1243) - Représentation et manipulation de données structurées, [D. Muller](mailto:daniel.muller@ec-lyon.fr)   

- [MOD 9.5](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1244) - Réseaux informatiques, [R. Chalon](rene.chalon@ec-lyon.fr)

[*Détails des enseignements*](https://www.ec-lyon.fr/formation/ingenieure-generaliste/programme-formation/parcours-electif/offre-formation-parcours?module=654017)

### S9 – Modules Ouverts Sectoriels (MOS)

- [MOS 4.3](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1423) - Informatique d'entreprise, [M. Ardabilian](mailto:mohsen.ardabilian@ec-lyon.fr), [D. Muller](mailto:daniel.muller@ec-lyon.fr)    

- [MOS 2.2](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1424) - Informatique graphique, [M. Ardabilian](mailto:mohsen.ardabilian@ec-lyon.fr), N. Bonneel    

- [MOS 4.4](https://pedagogie3.ec-lyon.fr/course/view.php?id=1430) - Nouvelles technologies de l'information et de la communication, [M. Ardabilian](mailto:mohsen.ardabilian@ec-lyon.fr), [D. Muller](mailto:daniel.muller@ec-lyon.fr)   

- [MOS 5.5](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1440) - Visualisation interactive de données,  [R. Vuillemot](mailto:romain.vuillemot@ec-lyon.fr)   

[*Détails des enseignements*](https://www.ec-lyon.fr/formation/ingenieure-generaliste/programme-formation/parcours-electif/offre-formation-parcours?module=654023)

### S9 – Modules Spécifiques Option (MSO)

- [MSO 3.1](https://pedagogie3.ec-lyon.fr/course/view.php?id=1369) - Technologies informatiques du Big Data, [S. Derrode](mailto:stephane.derrode@ec-lyon.fr)   

- [MSO 3.2](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1370) - Les systèmes d'information par la pratique, [R. Vuillemot](mailto:romain.vuillemot@ec-lyon.fr)   

- [MSO 3.3](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1371) - Internet des objets, [R. Chalon](rene.chalon@ec-lyon.fr), [D. Muller](mailto:daniel.muller@ec-lyon.fr)   

- [MSO 3.4](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1372) - Apprentissage automatique, [L. Chen](liming.chen@ec-lyon.fr), [E. Dellandréa](mailto:emmanuel.dellandrea@ec-lyon.fr)   

- [MSO 3.5](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1373) - Vision par ordinateur, [M. Ardabilian](mailto:mohsen.ardabilian@ec-lyon.fr), [L. Chen](liming.chen@ec-lyon.fr)    

- [MSO 3.6](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1374) - Calcul et modélisation géométrique pour  l'info. graphique, [M. Ardabilian](mailto:mohsen.ardabilian@ec-lyon.fr)   

- [MSO 3.7](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1375) - Apprentissage bayésien et exploration de textes, [A. Saidi](mailto:alexandre.saidi@ec-lyon.fr), [S. Derrode](mailto:stephane.derrode@ec-lyon.fr)

- [MSO 3.8](https://pedagogie3.ec-lyon.fr/enrol/index.php?id=1376) - Projet Informatique, toute l'équipe pédagogique   

[*Détails des enseignements*](https://www.ec-lyon.fr/formation/ingenieure-generaliste/programme-formation/parcours-electif/offre-formation-parcours?module=654039)

**Remarques**

 - Pour rappel (vu en cours), les BE #3 et #5 seront évalués par votre encadrant. Les consignes pour le rendu sont précisées dans les répertoires respectifs.    

 - Les slides du cours sont disponibles à l'adresse https://pedagogie1.ec-lyon.fr/course/view.php?id=969.

 - Dans le répertoire _tuto-git-gitlab_, vous trouverez les scénarios des 2 tutos joués en direct dans le cours #3. C'est le moment de vous exercer...

 - Les slides du cours sont disponibles sur [Moodle](https://pedagogie1.ec-lyon.fr/course/view.php?id=1024).

 - Dans le répertoire _tuto-git-gitlab_, vous trouverez les scénarios des 2 tutos joués en direct dans le cours #4. C'est le moment de vous exercer...

Stéphane Derrode et Thibault Rafaillac

 No newline at end of file

from Bibliotheque import Bibliotheque

from Lecteur      import Lecteur

if __name__ == '__main__':

    # Création d'une bibliothèque

    MS = Bibliotheque('Michel Serre')

    print("MS = ", MS)               # Affichage attendu : "MS = Nom de la biblio : Michel Serre"

    print("b1 = ", Bibliotheque(1))  # Affichage attendu : "b1 =  Nom de la biblio : 1"

    print('\n==>test bibliothèque vide')

    # Recherches

    print(MS.chercher_lecteur_numero(1))                       # Affichage attendu : None

    print(MS.chercher_livre_numero(1))                         # Affichage attendu : None

    print(MS.chercher_lecteur_nom('Levgueni Dimitri'))         # Affichage attendu : None

    print(MS.chercher_livre_titre('Les Hauts de Hurlevent'))   # Affichage attendu : None

    # Affichage

    MS.affiche_livres()   # Affichage attendu : (rien)

    MS.affiche_lecteurs() # Affichage attendu : (rien)

    MS.affiche_emprunts() # Affichage attendu : (rien)

    print('\n==>test bibliothèque non vide mais sans emprunt')

    MS.ajout_lecteur(Lecteur('Mzai Ahmed', 'Boulevard de la Paix', 1))

    MS.ajout_lecteur(Lecteur('Xu John',    'Rue de la Gare',       2))

    MS.ajout_livre('Le Père Goriot',  'Honoré de Balzac', -1, 101)

    MS.ajout_livre("Léon l'Africain", 'Amin Maalouf',      2, 102)

    MS.affiche_livres()   # Affichage attendu : le premier livre doit afficher 0 exemplaire (et non -1!)

    MS.affiche_lecteurs() # Affichage attendu : les 2 lecteurs

    MS.affiche_emprunts() # Affichage attendu : (rien)

    print(MS.chercher_lecteur_numero(1))          # Affichage attendu : le lecteur Mzai Ahmed

    print(MS.chercher_livre_numero(1))            # Affichage attendu : None

    print(MS.chercher_livre_numero(102))          # Affichage attendu : le livre Léon L'Africain

    print(MS.chercher_lecteur_nom('Xu John'))     # Affichage attendu : le lecteur Xu John

    print(MS.chercher_livre_titre('Samarcande'))  # Affichage attendu : None

    print('\n==>test bibliothèque non vide et avec emprunt')

    MS.emprunt_livre(8, 101)    # Affichage attendu : Emprunt impossible : lecteur inexistant (car 0 livre dispo)

    MS.emprunt_livre(1, 1001)   # Affichage attendu : Emprunt impossible : livre inexistant (car 0 livre dispo)

    MS.emprunt_livre(1, 101)    # Affichage attendu : Emprunt impossible (car 0 livre dispo)

    MS.emprunt_livre(1, 102)    # Affichage attendu : (rien) (car l'emprunt est OK)

    MS.affiche_emprunts()       # Affichage attendu : Emprunt - Numero lecteur : 1, Numero livre: 102, Date : 2021-xx-yy

    MS.retour_livre(33, 102)    # Affichage attendu : Aucun emprunt ne correspond a ces informations : 33 102

    MS.retour_livre(1, 102)     # Affichage attendu : (rien) (le livre emprunté a bien été rendu)

    MS.affiche_emprunts()       # Affichage attendu : (rien) (car il n'y a aucun livre emprunté)

    print(MS.retrait_livre(28))   # Affichage attendu : False

    print(MS.retrait_livre(101))  # Affichage attendu : False (car il n'y a aucun exemplaire de ce livre)

    MS.emprunt_livre(1, 102)      

    print(MS.retrait_livre(102))  # Affichage attendu : False car le livre est emprunté

    MS.retour_livre(1, 102)

    print(MS.retrait_livre(102))  # Affichage attendu : True

    print(MS.retrait_lecteur(28))   # Affichage attendu : False

    MS.ajout_livre("Léon l'Africain", 'Amin Maalouf',      2, 102)

    MS.emprunt_livre(1, 102)  

    print(MS.retrait_lecteur(1))    # Affichage attendu : False (car emprunt en cours)

    MS.retour_livre(1, 102)

    print(MS.retrait_lecteur(1))    # Affichage attendu : True

[[_TOC_]]

# TD2 : Modélisation de formes géométriques

# BE #2 : Modélisation de formes géométriques

Le but de ce BE est d'illustrer le concept d'héritage de la programmation objet, en concevant un module pour manipuler des formes géométriques avec Python. Vous commencerez par définir les classes et leurs attributs, puis implémenterez les méthodes, et les validerez avec des tests.

Nous allons aborder dans ce TD le concept d'héritage de la programmation objet, et l'utilisation de tests unitaires pour améliorer la qualité du logiciel.

Pour compléter cet énoncé, la dernière section propose de réfléchir à une schéma UML d'une application décrite par son cahier des charges.

Le but de ce TD est de concevoir un module pour manipuler des formes géométriques avec Python. Ce module sera utilisé dans les TDs suivants, donc les tests seront essentiels pour limiter les éventuels bugs. Vous commencerez par définir les classes et leurs attributs, puis implémenterez les méthodes, et les validerez avec des tests.

## Modélisation avec UML (1h)

---

## Modélisation avec UML (1h30)

Les formes géométriques sont représentées par des classes, et l'héritage sera utilisé pour factoriser les propriétés communes. Nous nous limitons à un repère à deux dimensions orthonormé, avec les axes croissant vers la droite et le bas. Les coordonnées dans ce repère sont des entiers relatifs (c'est-à-dire possiblement négatifs). Dans cet espace, nous choisissons de représenter les formes suivantes :

* Les rectangles caractérisés par leur origine (`x`, `y`) et leurs dimensions (`l`, `h`).

* Les ellipses caractérisées par leur origine (`x`, `y`) et leurs rayons aux axes (`rx`, `ry`).

* Un type de forme de votre choix (ex. triangle, polygone, étoile, ...), qui possède au moins une origine (`x`, `y`).

<center><img src="figures/formes.svg" style="width:80%"/></center>

* Les cercles caractérisés par leur origine (`x`, `y`) et leur rayon.

__Exercice 1 -__ Représentez les 3 classes dans un diagramme de classes UML (_voir https://app.diagrams.net pour dessiner en ligne, avec l'onglet UML sur la gauche de l'interface_). Il est recommandé de commencer les noms des classes par une majuscule et les attributs par une minuscule. Les attributs devraient-ils être publics ou privés ?

<center><img src="figures/formes.svg" style="width:70%"/></center>

Les attributs `x` et `y` étant partagés par les trois classes, on introduit l'héritage pour les regrouper. Toutes les formes géométriques hériteront d'une même classe __Forme__. L'intérêt de cette classe est double :

* Du point de vue des développeurs du module, les méthodes dont le code est identique entre formes (ex. translation) sont fusionnées dans __Forme__, réduisant la quantité de code à produire (et donc la multiplication des erreurs possibles).

* Du point de vue des utilisateurs du module, on peut écrire du code qui manipule des rectangles et des ellipses (*p. ex.* système de collisions de formes) sans avoir à écrire du code séparément pour les rectangles et les ellipses. Cet aspect sera illustré dans un prochain TD.

__Exercice 1 -__ Représentez les 3 classes dans un diagramme de classes UML (_voir [diagrams.net](https://app.diagrams.net) pour dessiner en ligne, avec l'onglet UML sur la gauche de l'interface_). Il est recommandé de commencer les noms des classes par une majuscule et les attributs par une minuscule. Durant tout ce BE on considérera uniquement des attributs privés.

__Exercice 2 -__ Mettez à jour le diagramme UML en incluant la classe __Forme__ et les relations d'héritage. Seuls les attributs seront inclus pour le moment.

Enfin, on vous demande de supporter a minima pour chaque forme les méthodes suivantes :

__Exercice 3 -__ On vous demande de supporter a minima pour chaque forme les méthodes suivantes :

* `deplacement(dx, dy)`, qui effectue une translation selon un vecteur donné.

* `translation(dx, dy)`, qui effectue une translation selon un vecteur donné.

* `contient_point(x, y)`, qui renvoie `True` si et seulement si le point donné est à l'intérieur de la forme ou sur sa frontière.

* `redimension_par_points(x0, y0, x1, y1)`, qui redimensionne la forme pour faire correspondre sa [boîte englobante](https://en.wikipedia.org/wiki/Minimum_bounding_rectangle) avec celle représentée par les points donnés.

* `redimension_par_points(x0, y0, x1, y1)`, qui redimensionne la forme telle qu'elle soit incluse dans le rectangle de coins (`x0`, `y0`) et (`x1`, `y1`). Dans le cas du cercle, il faudra également qu'il soit le plus proche du premier coin. Cette méthode est utile par exemple dans [diagrams.net](https://app.diagrams.net) pour le tracé de formes par appui-déplacement de souris.

__Exercice 3 -__ Complétez le diagramme UML avec ces méthodes. Les constructeurs devront également être renseignés (méthode `__init__` en Python), ainsi que les méthodes d'affichage (méthode `__str__` en Python).

Complétez le diagramme UML avec ces méthodes. Les constructeurs devront également être renseignés (méthode `__init__` en _Python_), ainsi que les méthodes d'accès (les fameux _getter_/_setter_) et d'affichage (méthode `__str__`).

__Exercice 4 -__ Écrivez un squelette de code correspondant à votre diagramme UML, dans un fichier _formes.py_. Seuls les constructeurs devront être implémentés. À l'intérieur des autres méthodes, vous mettrez l'instruction `pass` de Python (qui ne fait rien mais vous rappelle que le code est inachevé).

__Exercice 4 -__ Écrivez un squelette de code correspondant à votre diagramme UML, dans un fichier _formes.py_. Seuls les constructeurs devront être implémentés. À l'intérieur des autres méthodes, vous mettrez l'instruction `pass` de _Python_ (qui ne fait rien mais vous rappelle que le code est inachevé).

## Implémentation des méthodes (2h)

---

## Implémentation des méthodes (2h30)

Créez un fichier _test_formes.py_ dans le même dossier que _formes.py_ et initialisé avec le code suivant :

    assert e.contient_point(500, 500)

    assert not e.contient_point(101, 201)

def test_Cercle():

    c = Cercle(10, 20, 30)

    str(c)

    assert c.contient_point(0, 0)

    assert not c.contient_point(-19, -9)

    c.redimension_par_points(100, 200, 1100, 700)

    assert c.contient_point(500, 500)

    assert not c.contient_point(599, 500)

if __name__ == '__main__':

    test_Rectangle()

    test_Ellipse()

    test_Cercle()

```

La commande `assert` de Python permet de spécifier une assertion (une condition qui doit toujours être vraie) à un point du programme. Elle sert avant un bloc de code à en documenter les prérequis, et après un bloc de code à en vérifier les résultats. Son échec signifie alors un bug du programme. `assert` reçoit une expression (comme ce qu'on passe à `if`), et vérifie son résultat :

La commande `assert` de _Python_ permet de spécifier une assertion (une condition qui doit toujours être vraie) à un point du programme. Elle sert, avant un bloc de code, à en documenter les prérequis et, après un bloc de code, à en vérifier les résultats. Son échec signifie alors un bug du programme. `assert` reçoit une expression (comme ce qu'on passe à `if`), et vérifie son résultat :

* Si `True`, l'assertion est vraie donc pas de problème, `assert` ne fait rien.

* Si `False`, l'assertion est fausse donc une exception `AssertionError` est déclenchée.

* Si l'expression renvoie une autre valeur, celle-ci est convertie en booléen pour se ramener aux deux cas précédents.

La vérification de cette condition est faite une fois au moment de son exécution (l'assertion ne sera pas valide dans le reste du programme). Dans _test_formes.py_ on utilise `assert` pour tester une fonctionnalité qui n'est pas encore implémentée, l'exécution de ce fichier échouera tant que les méthodes de seront pas codées. À l'issue de cette partie, elle ne devra renvoyer aucune erreur !

La vérification de cette condition est faite une fois au moment de son exécution (l'assertion ne sera pas valide dans le reste du programme). Dans _test_formes.py_, on utilise `assert` pour tester une fonctionnalité qui n'est pas encore implémentée, l'exécution de ce fichier échouera tant que les méthodes de seront pas codées. À l'issue de cette partie, elle ne devra renvoyer plus aucune erreur !

__Exercice 5 -__ Implémentez les méthodes d'affichage (`__str__`) de chacune des classes dans _formes.py_. Vous pourrez vérifier leur bon fonctionnement en exécutant _formes.py_ (bouton Run File - F5), puis par exemple avec une commande `print(Rectangle(0, 0, 10, 10))` dans la console IPython.

__Exercice 5 -__ Implémentez les méthodes d'affichage (`__str__`) de chacune des classes dans _formes.py_. Vous pourrez vérifier leur bon fonctionnement en exécutant _formes.py_ (bouton `Run File - F5`), puis par exemple avec une commande `print(Rectangle(0, 0, 10, 10))` dans la console _IPython_.

__Exercice 6 -__ Implémentez les méthodes d'accès getter/setter pour les champs privés de chacune des classes. Pour vérifier que les champs sont bien privés, le code suivant __doit__ échouer avec une erreur `AttributeError` :

__Exercice 6 -__ Implémentez les méthodes d'accès (_getter_/_setter_) pour les champs privés de chacune des classes. Pour vérifier que les champs sont bien privés, le code suivant __doit__ échouer avec une erreur de type `AttributeError` :

```python

r = Rectangle(0, 0, 10, 10)

print(r.__l, r.__h)

print(r.__x, r.__y, r.__w, r.__h)

```

__Exercice 7 -__ Implémentez les méthodes `contient_point` des trois sous-classes. Vous vérifierez que les deux premiers `assert` des méthodes de test ne déclenchent pas d'erreur.

__Exercice 7 -__ Implémentez les méthodes `contient_point` des deux sous-classes. Vous vérifierez que les deux premiers `assert` des méthodes de test ne déclenchent pas d'erreur.

__Exercice 8 -__ Implémentez les méthodes `redimension_par_points` de chacune des sous-classes. Le fichier _test_formes.py_ doit à présent s'exécuter sans problème.

## Tests unitaires (1h)

Une fois développées, vos classes vont être utilisées pour des besoins que vous n'aviez pas forcément anticipés. Certains vont révéler des bugs, et vos classes seront amenées à évoluer, y compris pour acquérir de nouvelles méthodes. Les tests unitaires servent à documenter les cas d'utilisation supportés, et également à vous assurer qu'une modification de votre code n'a pas introduit un bug (une _régression_).

__Exercice 9 -__ Exécutez ce test sur votre code, et corrigez les éventuels bugs. Représentez ensuite, dans un logiciel de dessin (ex. [diagrams.net](https://app.diagrams.net)), le rectangle et les positions des points qui sont testés. Quels bugs sont visés par chacun de ces tests ?

On vous fournit une méthode de test plus exhaustive pour __Rectangle__ :

```python

def test_Rectangle():

    r = Rectangle(-20, -10, 40, 20)

    assert r.contient_point(0, 0)

    assert r.contient_point(-20, 0)

    assert r.contient_point(0, -10)

    assert r.contient_point(20, 0)

    assert r.contient_point(0, 10)

    assert not r.contient_point(-40, 0)

    assert not r.contient_point(0, -20)

    assert not r.contient_point(40, 0)

    assert not r.contient_point(0, 20)

    assert not r.contient_point(-40, -20)

    assert not r.contient_point(40, -20)

    assert not r.contient_point(40, 20)

    assert not r.contient_point(-40, 20)

    reference = str(r)

    r.redimension_par_points(-20, 10, 20, -10)

    assert str(r) == reference

    r.redimension_par_points(20, 10, -20, -10)

    assert str(r) == reference

    r.redimension_par_points(20, -10, -20, 10)

    assert str(r) == reference

    r.redimension_par_points(-20, -10, 20, 10)

    assert str(r) == reference

```

__Exercice 9 -__ Exécutez ce test sur votre code, et corrigez les éventuels bugs. Représentez ensuite dans un logiciel de dessin (ex. https://app.diagrams.net/) le rectangle et les positions des points qui sont testés. Quels bugs sont visés par chacun de ces tests ?

La rédaction de tests unitaires consiste souvent à anticiper les bugs courants, pour améliorer la qualité du logiciel dès sa conception. On cherche donc délibérément à provoquer des situations difficiles à gérer (ex. points _sur_ le bord du rectangle). De telles situations sont par exemple :

* le choix de `<` ou `<=` dans le code

* le traitement de valeurs négatives

* les erreurs d'arrondis dans les opérations avec `float`

* la gestion de valeurs nulles (ex. largeur ou hauteur)

__Exercice 10 -__ Dessinez une ellipse dans votre logiciel de dessin, et représentez tous les points qu'il convient de tester avec `contient_point`. Pour chaque point (ou groupe de points), indiquez le type de bug qu'il vise en particulier. Implémentez ces tests dans _test_formes.py_.

__Exercice 11 -__ Dessinez une forme issue de votre troisième classe dans le logiciel de dessin, et choisissez les points qu'il faudra tester. Implémentez une nouvelle méthode de tests pour cette classe dans _test_formes.py_.

__Exercice 11 -__ Dans le cas du cercle, la différence principale avec l'ellipse est la méthode `redimension_par_points` qui nécessite de placer le centre du cercle au plus près du premier point. Proposez des tests qui permettent de vérifier que la méthode positionne toujours correctement le cercle dans la boîte englobante d'entrée.

## Pour aller plus loin

Lorsque votre programme utilise un grand nombre de tests unitaires, il est possible d'automatiser leur collecte, leur exécution, et l'affichage d'un rapport synthétique. On utilisera alors le module [_pytest_](https://docs.pytest.org/en/stable/) pour Python.

❗ Son installation nécessite que vous ayez installé Anaconda pour l'utilisateur de la machine, et non global au système. Il suffit alors d'ouvrir un terminal d'Anaconda (sous Windows, Menu Démarrer -> Anaconda -> Anaconda Prompt, sous Linux/Mac le terminal de base suffit), et d'y lancer la commande suivante :

```sh

conda install pytest

```

---

## Schéma UML

Si vous rencontrez une erreur comme `conda: command not found`, c'est que l'exécutable `conda` n'est présent dans aucun des dossiers visités par le terminal (essayez `echo %PATH%` pour en afficher la liste sous Windows, et `echo $PATH` sous Linux/Mac). Sous Windows, vérifiez que vous ouvrez bien le terminal d'Anaconda (pas le terminal par défaut du système). Sous Linux/Mac, la commande `export PATH=~/anaconda3/bin:/usr/local/anaconda3/bin:/usr/anaconda3/bin:$PATH` va ajouter (temporairement) une liste de répertoires usuels à la liste de recherche.

Cet exercice a été proposé lors de l'examen S6, année 2020-2021.

__Exercice 12 -__ Vérifiez que _pytest_ est installé en exécutant la commande `import pytest` qui ne doit pas renvoyer d'erreur. Ensuite exécutez la commande `pytest.main()`. Combien de fichiers ont été "collectés" ? Combien de tests ont réussi ? Combien ont échoué ?

> La société « L’atelier des chefs » propose des cours de cuisine. Un cours réunit pendant 2h un chef et 2 à 5 apprentis. Pendant un cours, le chef propose une recette du catalogue (Moussaka, Fish and Ships, Osso buco, Tajine marocain, Soupe chinoise…) et aide les apprentis à réaliser cette recette dans le temps imparti. Dans un esprit de convivialité, tout le monde s’appelle par son prénom.

> Ils réalisent ensemble une recette composée d’ingrédients :

> -   une seule viande (parmi porc, veau, poulet) ;

> -   un ou plusieurs légumes (parmi carotte, choux, potiron) ;

> -   une ou plusieurs épices (parmi sel, poivre, curcuma).

__Exercice 13 -__ [pytest.raises](https://docs.pytest.org/en/stable/assert.html#assertions-about-expected-exceptions) permet de vérifier qu'un bloc de code déclenche une exception (`raises` ne fait rien si le code échoue, et échoue si le code ne déclenche pas d'exception). Lisez les exemples de la documentation et ajoutez des tests pour vérifier que les variables privées sont inaccessibles de l'extérieur de chaque classe.

> Dégager les éléments principaux de cet énoncé et réaliser un diagramme de classes UML permettant de modéliser un cours de cuisine. Il n’est pas nécessaire de préciser les attributs, mais préciser les cardinalités s’il y a lieu.

### Consignes pour le rendu (BE #3 - INF-TC2)

Ce BE est le premier devoir à rendre concernant INF-TC2. Le compte-rendu (CR) de votre travail devra être déposé sur _Pedagogie1_, sur l'espace de dépôt spécifique à votre groupe. Et cela dans un **délai d'une semaine après la dernière séance consacrée à ce BE** (délai de rigueur, aucun travail accepté au delà de cette date). Cette semaine de délai ne tient pas compte d'éventuelles vacances. Si vous avez un doute, le plus simple est de contrôler la date pour votre groupe sur _Pedagogie1_.

**Consignes:**

> - Le travail peut être individuel ou en binôme. Si vous travaillez en binôme, **un seul dépôt suffit !**.    

> - Le dépôt consistera en une unique archive (zip, rar ou tgz) contenant l'ensemble des fichiers suivants :   

     - La base de données *Hotellerie.db*, après exécution des requêtes de l'énoncé. 

     - Le fichier _HotelDB.py_, contenant la classe **HotelDB** et un programme principal permettant de rejouer l'ensemble des requêtes de cet énoncé.

     - La base de données de votre choix pour les 2 requêtes libres (si différentes de *Hotellerie.db*) ; Si elle est très volumineuse, donnez uniquement le chemin de téléchargement dans votre rapport). Ajoutez le fichier _Python_ qui met en œuvre les requêtes que vous aurez imaginées. 

     - Un rapport (format _pdf_ exclusivement) contenant     

         - une en-tête où devront figurer le nom des élèves, leur numéro de groupe, le nom de l'encadrant ainsi que le titre du BE.   

         - des commentaires sur la programmation de chacune des requêtes et les résultats obtenus.    

         - tout diagramme, toute figure ou toute explication que vous jugerez utile, mais dans un **nombre de pages limité à 10** (il n'est pas demandé de rédiger 10 pages, c'est une limite à ne pas dépasser !).

> - L'archive devra nécessairement porter le nom suivant : *nom1-BE3.zip* ou *nom1-nom2-BE3.zip* (pour les étourdis, pensez à remplacer *nom1* et *nom2* par vos propres noms :-) )

**Critères d'évaluation du travail**

Voici une liste (non exhaustive) de critères qui permettront à vos encadrants d'évaluer vos requêtes :

> - **Qualité du rapport** : apparence visuelle globale (lisibilité), orthographe, structure du rapport claire et cohérente. Qualité des représentations graphique (légendes, label sur les axes...).    

> - **Qualité de l'API** : choix des noms et arguments des méthodes, pas de requêtes SQL hors de la classe, code  d'affichage des texte et des graphiques forcément en dehors des méthodes-requêtes.   

> - **Qualité du code** : est-ce qu'il fonctionne sans erreur, le code est-il suffisamment commenté et aéré ? Tests multiples avec des paramètres inattendus ou erronés. Interception des erreurs potentielles par des exceptions.   

> - **Qualité des requêtes** : originalité et justification de l'intérêt, difficulté technique, valorisation dans le rapport.

 No newline at end of file

# Quelques exemples d'usage de la librairie matplotlib

# De nombreux exemples supplémentaires à cette adresse: https://matplotlib.org/gallery/index.html

# Remarque : N'oubliez pas plt.close()! après chaque figure

import matplotlib.pyplot as plt

import numpy             as np

if __name__ == '__main__':

	## function

	#############################################

	x = np.linspace(0, 2, 100)           # Generate evenly spaced numbers

	fig, ax = plt.subplots()             # Create a figure and an axis.

	ax.plot(x, x, label='linear')        # Plot some data on the axes.

	ax.plot(x, x**2, label='quadratic')  # Plot more data on the axes...

	ax.plot(x, x**3, label='cubic')      # ... and some more.

	ax.set_xlabel('x label')             # Add an x-label to the axes.

	ax.set_ylabel('y label')             # Add a y-label to the axes.

	ax.set_title("Simple Plot")          # Add a title to the axes.

	ax.legend()                          # Add a legend.

	#plt.show()                           # Display the plot (close to continue)

	plt.savefig('mpl_plot.png')          # Save the plot on the HD (current directory)

	plt.close()                          # Close the fig

	## scatter data

	#############################################

	data1, data2 = np.random.randn(2, 100)  # Draw random samples

	fig, ax = plt.subplots(1, 1)            # Create a figure and an axis.

	ax.plot(data1, data2, marker='x')       # Scatter plot

	plt.savefig('mpl_scatter.png')          # Save the plot on the HD

	plt.close()                             # Close the fig

	## error bar

	# https://matplotlib.org/api/_as_gen/matplotlib.pyplot.errorbar.html

	#############################################

	x = np.linspace(0, 10, 50)

	dy = 0.8

	y = np.sin(x) + dy * np.random.randn(50)

	plt.errorbar(x, y, yerr=dy, fmt='o', color='black', ecolor='lightgray', elinewidth=3, capsize=0);

	plt.savefig('mpl_errorbar.png')

	plt.close()

	## histogram (avec personalisation)

	# https://matplotlib.org/3.3.1/api/_as_gen/matplotlib.pyplot.hist.html

	#############################################

	x = np.random.randn(1000)

	plt.style.use('classic')

	fig=plt.figure(figsize=(5,3))

	ax = plt.axes(facecolor='#E6E6E6')

	# Afficher les ticks en dessous de l'axe

	ax.set_axisbelow(True)

	# Cadre en blanc

	plt.grid(color='w', linestyle='solid')

	# Cacher le cadre

	# ax.spines contient les lignes qui entourent la zone où les 

	# données sont affichées.

	for spine in ax.spines.values():

	    spine.set_visible(False)

	# Cacher les marqueurs en haut et à droite

	ax.xaxis.tick_bottom()

	ax.yaxis.tick_left()

	# Nous pouvons personnaliser les étiquettes des marqueurs

	# et leur appliquer une rotation

	marqueurs = [-3, -2, -1, 0, 1, 2]

	xtick_labels = ['A', 'B', 'C', 'D', 'E', 'F']

	plt.xticks(marqueurs, xtick_labels, rotation=30)

	# Changer les couleur des marqueurs

	ax.tick_params(colors='gray', direction='out')

	for tick in ax.get_xticklabels():

	    tick.set_color('gray')

	for tick in ax.get_yticklabels():

	    tick.set_color('gray')

	# Changer les couleurs des barres

	ax.hist(x, edgecolor='#E6E6E6', color='#EE6666')

	plt.savefig('mpl_histopersonalise.png')

	plt.close()

**Sommaire**

[[_TOC_]]

# BE #3 : Exceptions et Base de données SQL

L'objectif principal de ce BE concerne l'utilisation **des exceptions** ([lien](https://docs.python.org/fr/3/tutorial/errors.html) officiel, [tuto _devstory_](https://devstory.net/11421/python-exception-handling) sur les exceptions) pour améliorer la robustesse d'un code. Pour expérimenter ce concept clé, nous nous servirons du prétexte de la manipulation de bases de données à l'aide de requêtes _SQL_ (_Structured Query Language_), écrites en _Python_. Ce BE est composé de trois parties :

  1. **La première partie** (durée: 45 min.) présente quelques commandes élémentaires pour interroger une base _SQL_ à partir de _Python_;

  1. **La seconde partie** (durée: 75 min.) permet de découvrir comment manipuler une base de données _SQL_ en _Python_ orienté objet.    

  1. **La troisième partie** (durée: 120 min. et +) vous engage dans un travail plus personnalisé, pour mettre à profit vos connaissances sur la gestion des exceptions, la librairie graphique *matplotlib* et le langage d'interrogation de bases _SQL_.

Ce BE fera l'objet d'un compte-rendu (CR), seul ou en binôme. Avant de commencer, veuillez prendre connaissance des consignes concernant le rendu du travail (à respecter scrupuleusement) qui se trouvent dans le fichier [consignes_BE#3.md](./consignes_BE#3.md) (dans le même répertoire que cet énoncé). Les critères de notation y sont présentés.

--- 

## 1. Mini-tutoriel sur la base Hotellerie.db (45 min.)

Le système de gestion de base de données (SGBD) qui sera utilisé durant ce BE est _SQLite_. Ce système stocke une base de données dans un fichier d'extension _.sqlite_. La base de tests que nous allons utiliser dans cette partie (_hotellerie.db_) est disponible au même endroit que cet énoncé. Son schéma est le suivant :

<center><img src="figures/schema_bdd_hotellerie.png" style="width:70%"/></center>

La base est composée de 5 tables, ces tables étant composées d'un nombre variable de champs. Les champs soulignés représentent les clés primaires (ou *primary key (PK)* en anglais) de chaque table. En particulier, la clé primaire de la table **chambre** est composée des attributs *numchambre* et *numhotel* (cette dernière étant la clé primaire de la table **hotel**).

*Remarque* : Vous trouverez [ici](https://www.youtube.com/watch?v=VgTRNqn2fn0) une vidéo qui montre comment utiliser [draw.io](https://app.diagrams.net) pour créer un diagramme entité-association. Il NE vous est PAS demandé de dessiner le diagramme de cette base de données.

### 1.1 DB browser for SQLite (15 min.)

Toutes les opérations sur une base de données de ce type peuvent être effectuées en _Python_ via les classes et les méthodes présentes au sein du module _sqlite3_ ([doc officielle de la librairie](https://docs.python.org/3/library/sqlite3.html)). Pour manipuler de manière interactive le contenu de la base (créer, supprimer ou modifier des tables et des enregistrements, effectuer des requêtes _SQL_...), il existe des outils adaptés. L'outil retenu dans le cadre de ce BE s'appelle ``DB Browser for SQLite``. C'est un logiciel libre qui existe pour toutes les plate-formes : _Windows_, _MacOs_, nombreuses distributions _Linux_ et _Unix_...

 - Téléchargez et installez [DB Browser for SQLite](https://sqlitebrowser.org/) en suivant les instructions d'installation adaptées à votre système d'exploitation.    

 - Avec ce logiciel, ouvrez la base *hotellerie.db* et naviguez dans les tables (onglet `Structure de la Base de Données`) et les enregistrements (onglet `Parcourir les données`) pour prendre connaissance de la base (telle qu'elle est schématisée ci-dessus).

<center><img src="figures/DBBrowser.png" style="width:75%"/></center>

 - Dans l'onglet `Exécuter le SQL`, lancez la requête suivante   

```SQL

SELECT nom, ville

FROM hotel;

```  

La réponse apparaît sous forme de 12 lignes. Ça vous rappelle des choses ? Si non, alors voici quelques pointeurs pour vous rafraîchir la mémoire 

- [cours tutoriel sur SQL](https://www.1keydata.com/fr/sql/)

- [SQL : sélection, jointure, regroupement, filtre](http://cerig.pagora.grenoble-inp.fr/tutoriel/bases-de-donnees/chap20.htm)

- et tant d'autres...

### 1.2 Quelques requêtes en _Python_ (15 min.)

**Attention** Avant de lancer un requête sur la bdd avec _Python_, il est fortement conseillé de fermer `DB Browser for SQLite`, sinon vous pourriez soit avoir un plantage de votre programme, soit détruire la bdd (auquel cas il vous suffirait de la télécharger à nouveau depuis ce site Web).

Nous allons à présent chercher à reproduire la requête ci-dessus en utilisant _Python_ et le package _sqlite3_.  C'est une librairie objet dont la [documentation](https://docs.python.org/3/library/sqlite3.html#module-sqlite3) fournit une description des classes et des méthodes disponibles. Suivez le guide... 

Le squelette typique d'un tel programme s'écrit : 

```python

import sqlite3

if __name__ == '__main__':

	conn = sqlite3.connect('hotellerie.db') # connexion à la bdd

	# travail sur la bdd à partir du connecteur

	...

	conn.commit()                           # pour enregistrer les éventuels changements 

	conn.close()                            # pour fermer proprement l'accès à la base

```

Voici le code _Python_ permettant d'obtenir la réponse à la requête précédente :

```python

import sqlite3

if __name__ == '__main__':

	conn = sqlite3.connect('hotellerie.db')

	curseur = conn.cursor()                          # objet permettant de faire des requêtes

	curseur.execute("SELECT nom, ville FROM hotel;") # requête SQL

	ligne1 = curseur.fetchone()                      # récupère la 1ère ligne du résultat de la requête

	print('ligne1 =', ligne1)