poo_parametres_attributs_v3.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Paramètres et attributs"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## I. méthode `init` n'ayant qu'un seul paramètre : `self`"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self):\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = 0"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "La méthode n'a qu'**un seul paramètre** qui est `self`.  \n",
    "Un objet instance de la classe `Joueur` a **quatre attributs** qui sont `score`, `est_actif`, `nbre_parties_jouees` et `handicap`.  \n",
    "Ces attributs sont tous **initialisés** : `score` initialisé à 0, `est_actif` initialisé à `True` etc..."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Créations de deux instances de la classe Joueur : "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "joueur_1 = Joueur()\n",
    "joueur_2 = Joueur()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "À leur création, les attributs des deux objets ont les mêmes valeurs. Par exemple :"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "print(joueur_1.score)\n",
    "print(joueur_2.score)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## II. méthode `init` ayant plusieurs paramètres : "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Nous voulons rajouter l'attribut `nom`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self):\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = 0\n",
    "        self.nom = \"DUPONT\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "En procédant ainsi, tous les joueurs sont construits avec le même nom. L'attribut `nom` est **initialisé** à DUPONT.  \n",
    "On pourra évidemment par la suite modifier cet attribut."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "joueur_1 = Joueur()\n",
    "print(joueur_1.nom)\n",
    "joueur_1.nom = \"Martin\"\n",
    "print(joueur_1.nom)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Ce n'est pas pratique ! Nous pouvons ajouter un **paramètre** qui va permettre  d’initialiser l’attribut `nom` avec une valeur choisie au moment de la création de l’instance."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self, nom_joueur):\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = 0\n",
    "        self.nom = nom_joueur"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "On peut maintenant construire des joueurs, directement avec leur nom :"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "joueur_1 = Joueur(\"LAPORTE\")\n",
    "print(joueur_1.nom)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Dans ce dernier exemple, la classe `Joueur` a **cinq attributs**, le constructeur (la méthode `init`) a **deux paramètres**."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "👉 Très souvent, le nom du paramètre, et le nom de l'attribut auquel il va permettre de transmettre une valeur sont identiques.  \n",
    "On voit souvent des classes rédigées comme ci-dessous :"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self, nom):\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = 0\n",
    "        self.nom = nom"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "joueur_1 = Joueur(\"LAPORTE\")\n",
    "print(joueur_1.nom)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 💻 A vous de jouer 1"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Recopier et modifier la classe `Joueur` pour qu'elle dispose de l'attribut `age`. Le constructeur devra avoir un paramètre permettant de transmettre l'âge du joueur."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# A vous"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Correction"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self, nom, age):\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = 0\n",
    "        self.nom = nom\n",
    "        self.age = age"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "joueur_1 = Joueur(\"LAPORTE\", 22)\n",
    "print(joueur_1.nom)\n",
    "print(joueur_1.age)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## III. Paramètre par défaut"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Dans l'exemple précédent, les joueurs sont tous initialisés avec un attribut handicap qui vaut 0. En fait, les joueurs qui sont des \"champions\" ont un handicap de 50. On pourrait procéder ainsi :"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self, nom, age):\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = 0\n",
    "        self.nom = nom\n",
    "        self.age = age\n",
    "\n",
    "Kevin = Joueur(\"DURAND\", 18)\n",
    "Champion_1 = Joueur(\"MAITRE\", 30)\n",
    "Champion_1.handicap = 50"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Il y a une autre possibilité, qui est d'utiliser le paramètre par défaut `handicap = 0`.\n",
    "A la construction d'un objet, si le paramètre n'est pas précisé, il prendra pour valeur 0. Sinon, il prendra la valeur donnée.\n",
    "Voici le code que cela donne :"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self, nom, age, handicap = 0):\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = handicap\n",
    "        self.nom = nom\n",
    "        self.age = age\n",
    "\n",
    "# Programme principal\n",
    "Kevin = Joueur(\"DURAND\", 18)\n",
    "Champion_1 = Joueur(\"MAITRE\", 30, 50)\n",
    "print(Kevin.handicap)\n",
    "print(Champion_1.handicap)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "🌵 Cette pratique d'utilisation des paramètres par défauts est à la limite du programme de NSI. Néanmoins il arrive qu'on la rencontre dans les épreuves du BAC.  \n",
    "⚠️ Que l'on soit en POO ou pas, les paramètres par défauts doivent toujours se trouver **après** les autres.  \n",
    "😢 Ecriture fausse : `def ma_fonction(para_1 = 0, para_2): `  \n",
    "😊 Ecriture juste :  `def ma_fonction(para_1, para_2 = 0): `"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "###  Meilleure pratique"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Dans cet exemple, il vaut mieux ne pas donner de valeur par défaut au paramètre `handicap`"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 💻 A vous de jouer 2"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Recopier et modifier ci-dessous le script que nous venons de voir : \n",
    "* Pas de paramètre par défaut\n",
    "* Modification du programme principal : `Kevin` ne doit pas avoir de handicap, et `Champion_1` doit avoir un handicap de 50."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# A vous"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Correction"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self, nom, age, handicap):\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = handicap\n",
    "        self.nom = nom\n",
    "        self.age = age\n",
    "\n",
    "# Programme principal\n",
    "Kevin = Joueur(\"DURAND\", 18, 0)\n",
    "Champion_1 = Joueur(\"MAITRE\", 30, 50)\n",
    "print(Kevin.handicap)\n",
    "print(Champion_1.handicap)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## IV. Ecueils avec les paramètres par défauts"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "⚠️⚠️ Il vaut mieux qu'un paramètre par défaut **ne soit pas** de type mutable.\n",
    "Pour vous en convaincre, voici un exemple qui montre **ce qu'il ne faut pas faire**.  \n",
    "**Le type `list` de Python est mutable**"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Dans cet exemple, l'attribut `rencontres` est la liste des adversaires rencontrés par le joueur lors des matchs précédents."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self, nom, age, rencontres = []):  # !!! A ne pas faire\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = 0\n",
    "        self.nom = nom\n",
    "        self.age = age\n",
    "        self.rencontres = rencontres\n",
    "        \n",
    "    def ajoute_rencontre(self, personne):\n",
    "        self.rencontres.append(personne)\n",
    "\n",
    "Kevin = Joueur(\"DURAND\", 18)\n",
    "print(\"Rencontres de Kevin : \", Kevin.rencontres)\n",
    "Kevin.ajoute_rencontre(\"MARTIN\")\n",
    "print(\"Rencontres de Kevin : \", Kevin.rencontres)\n",
    "Jules = Joueur(\"DUPOND\", 18)  # A priori l'attribut rencontre  pour Jules est la liste vide\n",
    "print(\"Rencontres de Jules : \", Jules.rencontres)  # Observez le problème"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "😭 On aurait souhaité que `Jules.rencontres` soit la liste vide ..."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 👉 Initialiser plutôt que de prendre un paramètre par défaut.  \n",
    "Ce qu'il aurait fallu faire :"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:\n",
    "    \n",
    "    def __init__(self, nom, age):  \n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = 0\n",
    "        self.nom = nom\n",
    "        self.age = age\n",
    "        self.rencontres = []\n",
    "        \n",
    "    def ajoute_rencontre(self, personne):\n",
    "        self.rencontres.append(personne)\n",
    "\n",
    "Kevin = Joueur(\"DURAND\", 18)\n",
    "print(\"Rencontres de Kevin : \", Kevin.rencontres)\n",
    "Kevin.ajoute_rencontre(\"MARTIN\")\n",
    "print(\"Rencontres de Kevin : \", Kevin.rencontres)\n",
    "Jules = Joueur(\"DUPOND\", 18)  # A priori l'attribut rencontre  pour Jules est la liste vide\n",
    "print(\"Rencontres de Jules : \", Jules.rencontres)  # On voit que c'est bien le cas !"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 💡 Deux exemples sur le caractère mutable des listes en Python"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### 🤔 Un premier exemple"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "liste_1 = [1, 2, 3]\n",
    "liste_2 = liste_1\n",
    "print(\"liste_1 = \", liste_1)\n",
    "print(\"liste_2 = \", liste_2, \"cela semble logique\")\n",
    "liste_1.append(4)\n",
    "print(\"liste_1 = \", liste_1, \"c'est logique\")\n",
    "print(\"liste_2 = \", liste_2, \"liste_2 a aussi été modifiée !!!\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### 🤔 Un deuxième exemple"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "class Joueur:  \n",
    "    def __init__(self, nom, age, rencontres):\n",
    "        self.score = 0\n",
    "        self.est_actif = True\n",
    "        self.nbre_parties_jouees = 0\n",
    "        self.handicap = 0\n",
    "        self.nom = nom\n",
    "        self.age = age\n",
    "        self.rencontres = rencontres\n",
    "        \n",
    "    def ajoute_rencontre(self, personne):\n",
    "        self.rencontres.append(personne)\n",
    "\n",
    "mes_rencontres = [\"PROBLEME\", \"MUTABLE\"]\n",
    "Kevin = Joueur(\"DURAND\", 18, mes_rencontres)\n",
    "Jules = Joueur(\"DUPOND\", 18, mes_rencontres)\n",
    "Kevin.ajoute_rencontre(\"MARTIN\")  # A priori on n'a pas ajouté \"MARTIN\" \n",
    "                                  # à la liste de rencontres de Jules\n",
    "print(\"Rencontres de Kevin : \", Kevin.rencontres)\n",
    "print(\"Rencontres de Jules : \", Jules.rencontres)  # Hélas \"MARTIN\" a été ajouté"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "####  En conclusion sur les types mutables :\n",
    "😂 **Toujours bien réfléchir lorsqu'on les utilise !**"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## V. Utilisation des paramètres par défaut dans le cas des arbres"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "🌴 Lorsque l'on travaille avec des arbres, il est très courant d'utiliser des paramètres par défaut. C'est un cas où leur utilisation est intéressante. Nous le verrons plus précisément lorsque nous les étudierons."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "-------------\n",
    "Auteur : Mireille COILHAC  <br>\n",
    "<a rel=\"license\" href=\"http://creativecommons.org/licenses/by-nc-sa/4.0/\"><img alt=\"Creative Commons License\" style=\"border-width:0\" src=\"https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png\" /></a><br />This work is licensed under a <a rel=\"license\" href=\"http://creativecommons.org/licenses/by-nc-sa/4.0/\">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License</a>.\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}