Tutoriel pour apprendre à utiliser le framework web Django

Essayons tout d'abord d'afficher tous nos articles. Vous pouvez le faire à l'aide de cette commande :

>>> Post.objects.all()
Traceback (most recent call last):
      File "<console>", line 1, in <module>
NameError: name 'Post' is not defined

Ooops ! Voilà que ça nous renvoie une erreur qui nous dit qu'il n'existe pas de Post. En effet, nous avons oublié de commencer par un « import » !

>>> from blog.models import Post

Rien de compliqué : nous importons le modèle Post depuis notre blog.models. Essayons à nouveau la commande précédente :

>>> Post.objects.all()
<QuerySet [<Post: my post title>, <Post: another post title>]>

Cela nous permet d'obtenir une liste des articles que nous avons créés tout à l'heure ! Rappelez-vous : nous avions créé ces articles à l'aide de l'interface d'administration de Django. Cependant, nous aimerions maintenant créer de nouveaux articles à l'aide de Python : comment allons-nous nous y prendre ?

Voici comment créer un nouvel objet Post dans la base de données :

>>> Post.objects.create(author=me, title='Sample title', text='Test')

Cependant, il nous manque un petit quelque chose : me. Nous avons besoin de lui passer une instance du modèle User en guise d'auteur (author). Comment faire ?

Tout d'abord, il nous faut importer le modèle User :

>>> from django.contrib.auth.models import User

Avons-nous des utilisateurs dans notre base de données ? Voyons voir :

>>> User.objects.all()
<QuerySet [<User: ola>]>

C'est le superutilisateur que nous avions créé tout à l'heure ! Essayons maintenant d'obtenir une instance de l'utilisateur :

me = User.objects.get(username='ola')

Comme vous pouvez le voir, nous obtenons (get) un utilisateur (User) avec comme nom d'utilisateur (username) 'ola'. Cool ! Bien sûr, vous pouvez utiliser votre nom si vous le souhaitez.

Nous allons enfin pouvoir créer notre article :

>>> Post.objects.create(author=me, title='Sample title', text='Test')

Youpi ! Et si on vérifiait quand même si ça a marché ?

>>> Post.objects.all()
<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>

Et voilà : un post de plus dans la liste !

Amusez-vous à ajouter d'autres articles pour vous entraîner un peu. Essayez d'ajouter deux ou trois articles en plus puis passez à la partie suivante.

L'intérêt des QuerySets, c'est que l'on peut les filtrer. Disons que nous aimerions retrouver tous les articles écrits par l'utilisateur Ola. Pour cela, nous allons utiliser filter à la place de all dans Post.objects.all(). Les parenthèses vont nous servir à préciser quelles sont les conditions auxquelles un article de blog doit se conformer pour être retenu par notre QuerySet. Dans notre exemple, author est égal à me. La manière de le dire en Django c'est : author=me. Maintenant, votre bout de code doit ressembler à ceci :

>>> Post.objects.filter(author=me)
[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]

Et si nous voulions chercher les posts qui contiennent uniquement le mot « titre » dans le champ title ?

>>> Post.objects.filter(title__contains='title')
[<Post: Sample title>, <Post: 4th title of post>]

Comment obtenir une liste de tous les articles publiés ? Cela se fait facilement en filtrant tous les articles qui ont une date de publication, published_date, dans le passé :

>>> from django.utils import timezone
>>> Post.objects.filter(published_date__lte=timezone.now())

Malheureusement, l'article que nous avons créé dans la console Python n'est pas encore publié. Allons corriger ce problème ! Dans un premier temps, nous aimerions obtenir une instance de l'article que nous voulons publier :

>>> post = Post.objects.get(title="Sample title")

Ensuite, publions-le grâce à notre méthode publish !

>>> post.publish()

Maintenant, essayez d'obtenir à nouveau la liste des articles publiés. Pour cela, appuyez trois fois sur la flèche du haut et appuyez sur entrée :

>>> Post.objects.filter(published_date__lte=timezone.now())
[<Post: Sample title>]

Les QuerySets permettent aussi de trier la liste des objets. Essayons de les trier par le champ created_date :

>>> Post.objects.order_by('created_date')
[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]

On peut aussi inverser l'ordre de tri en ajoutant - au début :

>>> Post.objects.order_by('-created_date')
[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]

Vous pouvez aussi combiner les QuerySets en les chainant les unes aux autres :

>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')

C'est un outil très puissant qui va vous permettre d'écrire des requêtes complexes.

Génial ! Vous êtes maintenant prête à passer à l'étape suivante ! Pour fermer le shell, tapez ceci :

>>> exit()
$