define wishlist class

book/gwift/01-models.md

@@ -11,6 +11,8 @@ Nous proposons dans un premier temps d'éluder la gestion des utilisateurs, et d
 Cela nous donne ceci: 
 
 ```python
+# wish/models.py
+
 from django.db import models
 
 
@@ -26,6 +28,8 @@ class Part(models.Model):
     pass
 ```
 
+Les classes sont créées, mais vides. Entrons dans les détails.
+
 ## Listes de souhaits
 
 Comme déjà décrit précédemment, les listes de souhaits peuvent s'apparenter simplement à un objet ayant un nom et une description. Pour rappel, voici ce qui avait été défini dans les spécifications:
@@ -34,8 +38,54 @@ Comme déjà décrit précédemment, les listes de souhaits peuvent s'apparenter
  * un identifiant externe
  * un nom
  * une description
- * le propriétaire
  * une date de création
  * une date de modification
 
-Ouvrez le fichier `wish/models.py` pour y définir ces différents champs.
+Notre classe `Wishlist` peut être étoffée de la manière suivante:
+
+```python
+# wish/models.py
+
+class Wishlist(models.Model):
+ 
+    name = models.CharField(max_length=255)
+    description = models.TextField()
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+    external_id = models.UUIDField(unique=True, default=uuid.uuid4, editable=False)    
+```
+
+Que peut-on constater? 
+
+ 1. Que s'il n'est pas spécifié, un identifiant `id` sera automatiquement généré et accessible dans le modèle.
+ 1. Que chaque type de champs (`DateTimeField`, `CharField`, `UUIDField`, ...) a ses propres paramètres d'initialisation. Il est intéressant de les apprendre ou de se référer à la documentation en cas de doute:
+    * La propriété `created_at` est gérée automatiquement par Django grâce à l'attribut `auto_now_add`: de cette manière, lors d'un **ajout**, une valeur par défaut ("*maintenant*") sera attribuée à cette propriété
+    * La propriété `updated_at` est également gérée automatique, cette fois grâce à l'attribut `auto_now` initialisé à `True`: lors d'une **mise à jour**, la propriété se verra automatiquement assigner la valeur du moment présent. Cela ne permet évidemment pas de gérer un historique complet et ne nous dira pas **quels champs** ont été modifiés, mais cela nous conviendra dans un premier temps.
+    * La propriété `external_id` est de type `UUIDField`. Lorsqu'une nouvelle instance sera instanciée, cette propriété prendra la valeur générée par la fonction `uuid.uuid4()`. *A priori*, chacun des types de champs possède une propriété `default`, qui permet d'initialiser une valeur sur une nouvelle instance.
+
+A présent, notre classe 
+
+## Elements
+
+## Parties
+
+## Refactoring
+
+On constate que chaque classe possède les propriétés `created_at` et `updated_at`, initialisées aux mêmes valeurs. Pour gagner en cohérence, nous allons créer une classe dans laquelle nous définirons ces deux champs, et nous ferons en sorte que les classes `Wishlist`, `Item` et `Part` en héritent. Django gère trois sortes d'héritage: 
+
+ 1. L'héritage par classe abstraite
+ 1. L'héritage classique
+ 1. L'héritage par classe proxy.
+ 
+### Classe abstraite
+
+### Héritage classique
+
+### Classe proxy
+
+Lorsqu'on définit une classe de type **proxy**, on fait en sorte que cette nouvelle classe ne définisse aucun nouveau champ sur la classe mère. Cela ne change dès lors rien à la traduction du modèle de données en SQL.
+
+## Gestion des utilisateurs
+
+Dans les spécifications, nous souhaitions pouvoir associer un utilisateur à une liste (*le propriétaire*) et un utilisateur à une part (*le donateur*). Par défaut, Django offre une gestion simplifiée des utilisateurs (pas de connexion LDAP, pas de double authentification, ...): juste un utilisateur et un mot de passe. Pour y accéder, un paramètre par défaut est défini dans votre fichier de settings: `AUTH_USER_MODEL`.
+

book/step-01-prerequisites.md

@@ -5,7 +5,7 @@ Avant de démarrer le développement, il est nécessaire de passer un peu de tem
 
 Nous allons utiliser [Python](https://www.python.org/), disponible sur la majorité des distributions Linux, ainsi que sur MacOS, dans des versions parfois différentes. Pour les utilisateurs de Windows, il sera sans doute nécessaire d'installer une version de l'interpréteur et de configurer la variable *PATH* pour votre utilisateur. Ajoutez-y `virtualenv` afin de créer un [environnement virtuel](http://sametmax.com/les-environnement-virtuels-python-virtualenv-et-virtualenvwrapper/), puis `virtualenvwrapper` pour en faciliter la gestion, et les prérequis seront remplis. 
 
-Les morceaux de code seront développés pour Python3.4+ et nécessiteront peut-être quelques adaptations pour fonctionner sur une version antérieure.
+Les morceaux de code seront développés pour Python3.4+ et Django 1.8+. Ils nécessiteront peut-être quelques adaptations pour fonctionner sur une version antérieure.
 
 Remarque : les commandes qui seront exécutés dans ce livre le seront depuis un shell sous linux. Certaines devrons donc être adaptés si vous êtes dans un autre environnemnet.