====== Les modèles avec Django ======

===== Syntaxe =====
<code python>
class NomClasse(models.Model):
    variable = models.Type(options)
</code>
==== exemple ====
issu de la [[https://docs.djangoproject.com/en/1.5/intro/tutorial01/|documentation officielle]]
<code python>
class Poll(models.Model):
    question = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')
</code>
===== Visualiser le code SQL d'une application =====
<code bash>
python manage.py sql monApplication
</code>
===== Valider les modèles d'un projet =====
<code bash>
python manage.py validate
</code>
===== Afficher les directives de suppression de tables =====
permet de connaitre les ordres //DROP TABLE// appliqué par un modèle
<code bash>
python manage.py sqlclear polls
</code>
===== Combinaison de commandes SQL =====
Combine les commandes //sql//, //sqlcustom// et //sqlindexes//
<code bash>
python manage.py sqlall polls 
</code>
===== Obtenir une représentation lisible d'un modèle =====
Ajouter une méthode //__unicode__// au modèle
<code python>
class NomClasse(models.Model):
    variable = models.Type(options)
    //...
    def __unicode__(self):
        return self.variable
</code>
==== exemple ====
<code python>
class Poll(models.Model):
    question = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')
    //...
    def __unicode__(self):
        return self.question
</code>
===== Personnaliser l'affichage d'un modèle dans l'interface d'admin =====
Par défaut une méthode utilisée dans l'interface d'administration utilise le nom de la méthode. il est possible de personnaliser cet affichage. 
Soit une méthode
<code python>
def uneMethodeQuiRenvoieUnBooleen(self):
    return resultatCalculBooleen
</code>
Il suffit d'ajouter quelques lignes dans la classe de la méthode
<code python>
uneMethodeQuiRenvoieUnBooleen.boolean = True // Affichage d'un picto au lieu de True/False
uneMethodeQuiRenvoieUnBooleen.short_description = 'Ma belle description courte'
</code>
==== Affichage d'un intitulé de champ personnalisé ====
L'interface d'administration s'appuie sur le [[https://docs.djangoproject.com/en/dev/topics/db/models/#verbose-field-names|verbose name d'un field]]. 
===== filter vs get =====
//filter// renvoie un objet de type [[https://docs.djangoproject.com/en/dev/ref/models/querysets/|QuerySet]], get renvoie un objet tout court. Pour accéder aux attributs d'un objet, get est souvent la bonne manière
<code python>
p = Class.objects.get(FILTRE_A_APPLIQUER)
p.attribut
</code>