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)

ce _repo_ contient l'ensemble des sujets de BE pour l'enseignement `INF-TC2` de l'École centrale de Lyon. Pour consulter le sujet, il vous suffit de cliquer sur le fichier markdown (d'extension _.md_) dans le répertoire correspondant à la séance.

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.

**Remarques**

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

 - 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 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 guider le développement logiciel et améliorer sa qualité.

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 par écrire les tests unitaires de votre module, et terminerez par l'implémentation des méthodes.

## 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>

__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 ?

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

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 :

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

* 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.

__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).

__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é).

* `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.

## Tests unitaires (1h)

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__`).

Il convient à présent de rédiger des tests, qui échoueront tant que chaque fonction ne sera pas implémentée et correcte. Dans la méthodologie _Test Driven Development_, on les écrit toujours avant le code, au début ils échouent tous, et à mesure de l'avancement du projet le nombre de tests passés avec succès augmente. Nous utiliserons le module _pytest_ présenté en cours.

__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é).

### Installation de _pytest_

Nous allons d'abord installer _pytest_, ainsi qu'un module permettant de lancer les tests depuis l'interface de Spyder. Ouvrez le terminal d'Anaconda (sous Windows, Menu Démarrer -> Anaconda -> Anaconda Prompt, sous Linux/Mac le terminal de base suffit). Exécutez-y la commande suivante :

---

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

```sh

conda install -c spyder-ide spyder-unittest pytest

```

❗ 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.

Une fois les modules installés, __redémarrez Spyder__ et créez un fichier _test_formes.py_ avec l'exemple de code suivant :

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

```python

from formes import *

def test_heritage():

	assert issubclass(Rectangle, Forme)

	assert issubclass(Ellipse, Forme)

def test_Rectangle():

    r = Rectangle(10, 20, 100, 50)

    str(r)

    assert r.contient_point(50, 50)

    assert not r.contient_point(0, 0)

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

    assert r.contient_point(500, 500)

    assert not r.contient_point(50, 50)

def test_Ellipse():

    e = Ellipse(60, 45, 50, 25)

    str(e)

    assert e.contient_point(50, 50)

    assert not e.contient_point(11, 21)

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

    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()

```

__Exécutez ce fichier__ dans Spyder (même s'il ne fait rien), ce qui a pour effet d'initialiser le répertoire courant de Spyder à votre répertoire de travail. Allez ensuite dans le menu Run -> Run unit tests, pour configurer le module _spyder-unittest_.

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 :

<center><img src="figures/spyder-unittest.png" style="width:100%"/></center>

* 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 plus aucune erreur !

Sélectionnez _pytest_, vérifiez que le dossier indiqué correspond à votre dossier de travail (celui contenant les fichiers _formes.py_ et _test_formes.py_), et validez. Un nouvel onglet _Unit testing_ apparaît dans l'espace en haut à droite, avec un bouton _Run tests_. Lorsque vous cliquez dessus :

__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_.

* _pytest_ cherche (dans le dossier que vous venez de configurer) tous les fichiers de la forme _test\_\*.py_ et _\*\_test.py_.

* Dans chacun de ces fichiers, _pytest_ exécute toutes les fonctions préfixées par `test`.

* Chaque test qui s'exécute sans déclencher d'exception est considéré valide.

* La fonction `test_heritage` dans le fichier _test_formes.py_ correspond à ces critères, donc elle est exécutée et son résultat contribue à un test "passé" (avec succès).

__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` :

<center><img src="figures/spyder-tests.png" style="width:100%"/></center>

```python

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

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

```

### Définition des tests

__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 5 -__ Dans le fichier _test_formes.py_, ajoutez une fonction `test_Rectangle_contient_point()` qui instancie un __Rectangle__ avec des coordonnées de votre choix, et vérifie avec `assert` que la méthode `contient_point` renvoie le bon résultat pour différentes coordonnées. L'exécution du test doit échouer puisque votre code est encore vide.

__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.

Pour l'exercice suivant, on vous donne un exemple d'implémentation de la méthode `contient_point` pour la classe __Rectangle__. La classe __Forme__ a été omise pour réduire la taille du code (mais dans votre fichier elle devra bien être présente).

```python

class Rectangle:

	def __init__(self, x, y, l, h):

		self.x = x

		self.y = y

		self.__l = l

		self.__h = h

	def contient_point(self, x, y):

		return self.x < x < self.__l or \

		       self.y < y < self.__h

```

__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 ?

__Exercice 6 -__ Cette méthode est buggée. Comment la corriger ? Vos tests l'avaient-ils repéré ? Si ce n'est pas le cas, trouvez les coordonnées qui donnent un mauvais résultat et ajoutez-les en tests dans la fonction `test_Rectangle_contient_point`.

__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 -__ 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.

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

__Exercice 7 -__ Implémentez les méthodes d'affichage (`__str__`) de chacune des classes. Il ne sera pas nécessaire d'écrire des tests pour ces méthodes.

---

## Schéma UML

__Exercice 8 -__ Implémentez les méthodes d'accès getter/setter pour les champs privés de chacune des classes. À l'aide de [pytest.raises](https://docs.pytest.org/en/stable/assert.html#assertions-about-expected-exceptions), vous testerez le déclenchement d'erreurs si on essaie d'accéder directement aux attributs.

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

__Exercice 9 -__ Implémentez les méthodes `contient_point` des deux sous-classes restantes. Vous fournirez pour chacune une fonction de tests avec des jeux de coordonnées pertinents.

> 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 10 -__ Implémentez les méthodes `redimension_par_points` de chacune des sous-classes. Vous fournirez également des tests validant leur fonctionnement quels que soient les points en entrée.

> 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)

	ligneAll = curseur.fetchall()                    # récupère toutes les lignes suivantes

	print('ligneAll =', ligneAll)

	conn.close() 

```

_Remarques_ 

 - La commande `conn.commit()` n'est pas nécessaire ici puisque le script est une requête en lecture ; elle ne modifie donc pas la bdd.     

 - Notez que la méthode `fetchone()` retire le résultat de la liste des résultats. Pour preuve: ce résultat n'est pas présent suite à l’affichage du `fetchall()`.

Copiez et exécutez ce programme ; le résultat se présente sous forme d'un tuple, ou sous forme d'une liste de tuples. Ainsi la commande suivante imprime le nom du premier hôtel qui apparaît dans la liste des résultats de la requête :

```python

print(ligneAll[0][0])

```

Voici un usage intéressant à tester :

```python

import sqlite3

if __name__ == '__main__':

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

	curseur = conn.cursor()  

	for ligne in curseur.execute("SELECT * FROM hotel WHERE etoiles=3"):

		print('ligne=', ligne)

	conn.close() 

```

### 1.3 La gestion des exceptions (15 min.)

Les quelques lignes de code précédentes peuvent être à l'origine de nombreux problèmes lors de l'exécution :

 - la base de données est introuvable;    

 - les noms des tables et/ou des champs dans la requête sont erronés;    

 - ...

Voyons maintenant comment intercepter les exceptions lancées dans ces cas de figure par les méthodes de la librairie `sqlite3`. Pour cela, veuillez d'abord copier et exécuter le programme suivant :

```python

import sqlite3

if __name__ == '__main__':

	try:

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

		curseur = conn.cursor()

		curseur.execute("SELECT nom, ville FROM hotel;")

		print(curseur.fetchall())

	except Exception as err:                                # interception d'une exception quelconque

		print('err:', str(err))

		print('type exception:', type(err).__name__)

	finally:                                                # fermeture de la base dans tous les cas

		conn.close()

```

A priori, ce programme ne lance pas d'exception. Modifiez-le pour faire apparaître les 2 problèmes énoncés ci-dessus. Pour cela :

- Changez le nom de la bdd dans le programme, p. ex. _impossible.db_. Comment interprétez-vous le message d'erreur en observant le contenu de votre répertoire de travail ?

- Revenez au nom correct du fichier : _hotellerie.db_. Testez alors des noms erronés pour les tables, puis pour les champs. 

On constate, dans chaque situation, que l'exception `sqlite3.OperationalError` est lancée, avec des messages d'information différents qui précisent le type d'erreur. Remplacez alors le code `except Exception as err:` par le code `except sqlite3.OperationalError as err:`, et vérifiez que cela fonctionne de la même manière que précédemment.

La liste des exceptions lancées par l'usage de commandes `sqlite3` est disponible en suivant [ce lien](https://docs.python.org/3/library/sqlite3.html#exceptions). Prenez le temps de lire la description des différentes exceptions. Toutes les exceptions de ce module héritent d'une classe appelée __sqlite3.Error__ (elle-même héritant de la classe de base de gestion des exceptions de _Python_ : __Exception__).

---

## 2. Classe HotelDB (75 min.)

Dans cette partie, nous allons créer un classe **HotelDB** permettant de réaliser des requêtes de lecture et de mises à jour de la base *Hotellerie.db*.

### 2.1 Requête en lecture (30 min.)

Dans un fichier *HotelDB.py*, commencez à développer la classe permettant de répondre au programme principal suivant, dont l'objectif est d'afficher le nom des hôtels 2 étoiles (notez que le nombre d'étoiles est passé en argument) :

```python

if __name__ == '__main__':

	aHotelDB = HotelDB('hotellerie.db')

	nbEtoiles = 2

	resultat = aHotelDB.get_name_hotel_etoile(nbEtoiles)

	print("Liste des noms d'hotel", nbEtoiles, "étoiles : ", resultat)

```

Le constructeur (méthode *\_\_init\_\_(...)*) se chargera d'ouvrir une connexion vers la bdd, alors que le destructeur (méthode *\_\_del\_\_(...)*, _cf_ remarque ci-dessous) se chargera de la fermer. 

_Remarques_ : 

- Pour fermer correctement l'accès à la base de donnée, pensez à implémenter la méthode *\_\_del\_\_(...)* (vue en cours), qui est appelée automatiquement (et de manière implicite) par _Python_ lors de la destruction des objets de la classe. Typiquement :

```python

def __del__ (self):

	self.__conn.close() 

```

- La méthode `get_name_hotel_etoile(...)` se charge de retourner le résultat de la requête, mais ne se charge pas d'en afficher le résultat. L'affichage est laissé au programme principal, ici essentiellement pour contrôler le résultat.