Dveloppez vos applications web avec Django

Par Cam et Natim

www.siteduzero.com

Licence Creative Commons 6 2.0 Dernire mise jour le 30/04/2012

2/29

Sommaire
Sommaire ........................................................................................................................................... Lire aussi ............................................................................................................................................ Dveloppez vos applications web avec Django ................................................................................. Partie 1 : Pour bien dmarrer... ...........................................................................................................
Kzako ? ..................................................................................................................................................................................................................... Les sites internet statiques .......................................................................................................................................................................................... Les sites internet dynamiques ..................................................................................................................................................................................... La programmation MVC .............................................................................................................................................................................................. Comment a marche ? ................................................................................................................................................................................................ Concrtement, comment a marche ? ........................................................................................................................................................................ Les bases de donnes ................................................................................................................................................................................................

2 1 3 3
4 4 4 5 5 5 6

Le dveloppement web ..................................................................................................................................................... 4

Django, le framework Web-Python ................................................................................................................................... 7

Qu'est-ce que Django ? ............................................................................................................................................................................................... 8 Pourquoi l'utiliser ? ...................................................................................................................................................................................................... 8

Tlchargement et installation ........................................................................................................................................ 10

Debian et drivs ....................................................................................................................................................................................................... 11 Mac OS X .................................................................................................................................................................................................................. 11 Windows .................................................................................................................................................................................................................... 12 Vrification ................................................................................................................................................................................................................ 12

Partie 2 : Premiers pas avec Django ................................................................................................. 14

Dmarrer un premier projet ............................................................................................................................................. 14
L'architecture du projet .............................................................................................................................................................................................. Grons notre application ........................................................................................................................................................................................... Lancer le serveur de dveloppement ........................................................................................................................................................................ Les paramtres ......................................................................................................................................................................................................... Crer votre premire application ............................................................................................................................................................................... Crer sa premire application dans son projet ......................................................................................................................................................... Nos premiers modles ! ............................................................................................................................................................................................ Ajouter l'application au projet .................................................................................................................................................................................... Traitons nos donnes ................................................................................................................................................................................................ Le gestionnaire d'URLs ............................................................................................................................................................................................. Les gabarits ............................................................................................................................................................................................................... La suite ...................................................................................................................................................................................................................... 14 14 15 16 19 19 19 20 23 25 26 27

Ralisation de la base de donnes : les modles .......................................................................................................... 19

Ralisation des views ...................................................................................................................................................... 23

www.siteduzero.com

Sommaire

3/29

Dveloppez vos applications web avec Django

Par

Natim et

Cam

Mise jour : 30/04/2012 Difficult : Intermdiaire

Dure d'tude : 1 mois

920 visites depuis 7 jours, class 142/797

Vous tes attir par le dveloppement internet ? Vous ne savez pas comment crer un site internet ? Vous connaissez Python et aimeriez bien dvelopper vos sites avec ? Django !
Bonjour vous, ami zro. Si vous tes ici par rapport l'une des questions ci-dessus ou bien par simple curiosit, je peux vous promettre que vous ne le regretterez pas. Qu'allons-nous apprendre ? Le dveloppement web dynamique ou bien, en d'autres termes, crer votre site internet complet. Qu'est-ce que Django ? A quoi sert-il ? ... Toutes les rponses sont dans ce cours. Pour bien le comprendre, vous devez au pralable connatre : Les langages (X)HTML et CSS un bon tutoriel est prsent sur le site Python un tutoriel est aussi disponible sur le site Ce cours se portera sur la version 1.2 de Django. Si Django est dj install sur votre machine, vrifiez bien la version (cf: Installation de Django)

www.siteduzero.com

Dveloppez vos applications web avec Django

4/29

Partie 1 : Pour bien dmarrer...

Le dveloppement web
Qu'est-ce que le dveloppement web dynamique ? A quoi sert-il ? Comment et avec quoi se fait-il ? Nous allons voir tout a dans ce chapitre.

Kzako ?
Un site web, c'est avant tout des fichiers (HTML, CSS, javascript, ...) qui sont rcuprs puis traits par un navigateur. Lorsqu'on dveloppe pour le web, on choisit de mettre en ligne du contenu sur Internet. Le rsultat est appel un site internet. On distingue deux types de sites web : Les sites internet statiques Les sites internet dynamiques

Les sites internet statiques

Les sites statiques sont des sites internet dont le contenu n'est pas modifi par les utilisateurs du site. Il faut que le webmestre mette jour les fichiers hbergs pour mettre jour le site. Il n'y a donc aucune interaction possible entre l'utilisateur et le site. Au contraire, les sites dynamiques sont des sites internet dont le contenu est modifi par les utilisateurs. Le Web 2.0 est l'ensemble des sites dynamiques dont les utilisateurs ajoutent le contenu. Les webmestres programment uniquement les logiciels leurs permettant de le faire. C'est le web communautaire. Le Site du Zro pour ses parties News, Tutoriels et Forum, mais aussi Facebook, Twitter et Wikipdia en sont d'autres exemples. Ne vous prenez pas trop la tte, retenez juste qu'il existe des sites internet statiques et des sites internet dynamiques.

Une histoire de balises

Le point commun de ces deux types de sites internet c'est que les navigateurs des utilisateurs comprennent principalement l'HTML, le CSS et le Javascript. Le HTML est en langage de balisage qui permet de mettre le contenu dans des blocs (le structurer) et y raliser une mise en page avec le CSS par la suite. Le Javascript permet quant lui dinteragir en temps rel sur la structure de la page (les balises) et sur le CSS afin de modifier l'affichage en temps rel sans que le navigateur ne recharge la page. Il permet aussi de faire des actions directement sur le navigateur de l'utilisateur. Il existe aussi l'xHTML qui est une standardisation du HTML afin qu'il respecte la syntaxe dfinie par la norme XML.

Les sites internet dynamiques

Le dveloppement de sites internet dynamique s'articule autour de plusieurs services. On parle de programmation n-tiers : La base de donnes, La dfinition du rendu des pages en HTML et CSS Le code de l'application qui va remplir les pages HTML avec les donnes de la base de donnes

La base de donnes
Pour raliser un site internet dynamique, il va falloir stocker les donnes utilisateurs dans une base de donnes. On va donc raliser un modle de donnes qui va accueillir nos donnes. On appelle cela la partie Modle.

www.siteduzero.com

Dveloppez vos applications web avec Django

5/29

Lorsque vous parlez de Bases de donnes n'oubliez pas de mettre un S donnes sans quoi ce n'est plus une base de donnes

L'Interface Homme-Machine
Afin de prsenter l'information de manire efficace, jolie, accueillante et ergonomique, on va crer un design de notre site. Ces fichiers HTML prpars accueillir le contenu du site s'appellent des Templates ou Gabarits .

Le programme
Ensuite, il va falloir un programme qui va rcuprer les informations de la base de donnes ainsi qu'en ajouter de nouvelles et les prsenter dans les gabarits dfinis.

La programmation MVC
Ce type de programmation (design pattern en anglais) s'appelle la programmation MVC : Modle, Vue, Contrleur. Le modle explique la manire dont nos donnes sont reprsentes. La vue explique comment les donnes sont affiches. Le contrleur explique comment les donnes sont rcupres dans les modles pour tre affiches.

Comment a marche ?
Le dveloppement web, ce n'est pas automatique, vous devez taper des lignes de code pour avoir ce que vous souhaitez (ou bien utiliser des codes dj prts). Python n'est pas dvelopp uniquement pour raliser de programmes web. Il ne suffit pas d'crire du Python au milieu d'un fichier HTML comme c'est le cas avec PHP ou JSP. Pour connecter notre code Python un serveur web qui va rpondre aux requtes des navigateurs, on devrait utiliser la norme CGI qui permet tout programme de retourner des pages web. V oici quoi ressemblent les standards CGI. Code : Python - Listing 1.1 Exemple de code proposant les standards CGI #!/usr/bin/python import MySQLdb print print print print print print "Content-Type: text/html" "<html><head><title>Livres</title></head>" "<body>" "<h1>Livres</h1>" "<ul>"

connection = MySQLdb.connect(user='moi', passwd='laissezmoientrer', db='ma_base') cursor = connection.cursor() cursor.execute("SELECT nom FROM livres ORDER BY pub_date DESC LIMIT 10") for row in cursor.fetchall(): print "<li>%s</li>" % row[0] print "</ul>" print "</body></html>" connection.close()

Concrtement, comment a marche ?

www.siteduzero.com

Dveloppez vos applications web avec Django

6/29

Le Web c'est une simple application de type client/serveur. V oici un petit schma simple pour expliquer autrement que par les mots.

Il y a donc un client (le navigateur install sur votre ordinateur) qui demande une ressource (fichier) un serveur. Dans le cas du listing 1.1, on rcupre dans une base de donnes une liste de livres tris par date de publication et on gnre un fichier HTML qui est ensuite retourn au navigateur de l'utilisateur.

Les bases de donnes

Depuis tout l'heure, je vous parle de contenu rcuprs depuis une base de donnes ... Mais finalement o sont stockes concrtement ces donnes ? Qu'est-ce qu'une base de donnes ? Comment fonctionne-t-elle ?

Les bases de donnes

Une base de donnes est un ensemble de fichiers qui vont stocker toutes vos donnes de faon organise. Afin de manipuler ces donnes, il existe un programme qu'on appelle un SGBD. Ainsi lorsque notre logiciel souhaite rcuprer ou stocker des donnes de la base, il va envoyer une requte au SGBD qui va lui retourner les informations demandes. Dans votre base de donnes, vous allez pouvoir stocker : Les Les Les Les fiches des membres de votre site articles de votre blog commentaires des articles de votre blog questions de votre sondage ainsi que les rponses de vos membres ...

On voit donc que l'on va crer des relations entre nos donnes les commentaires de tel article ... On va donc utiliser des Base de Donnes Relationnelles. Une BDD relationnelle est compose de tables et de donnes . Les tables sont un ensemble d'information caractrisant un objet. Un utilisateur ou un article par exemple, ou bien les catgories de votre blog, les news de votre site. La table regroupe la liste exhaustive de toutes les informations que l'on souhaite conserver propos d'un objet. On peut s'imaginer un formulaire d'inscription, on va nous demander notre nom, prnom, adresse ... toutes ces informations sont des champs de notre table qui caractrisent une personne. Les donnes viennent se ranger dans ces les champs de la table pour les conserver de manire ordonne (vous imaginiez srieusement si toutes vos donnes taient ranges en vrac dans une seule grosse bote ? Elles seraient inutilisable !). V oici un petit exemple simple d'une table contenant ses propres donnes (faon BDD) : ID USERNAME INSTRUMENT 1 2 3 Cam Natim Cyril Batteur Saxophone Basse

www.siteduzero.com

Dveloppez vos applications web avec Django

7/29

C'est beau de rver, non ? Bref. En plus clair : nous avons notre table membre qui va contenir toutes nos donnes en rapport avec les membres. Ici, Cam, Natim et Cyril sont les noms d'utilisateurs : ce sont les donnes d'un champ qu'on peut appeler username. Batteur, Saxophone et Basse sont les instruments que pratiquent les trois membres prsents dans la base de donnes. Organis de telle sorte, Natim ne peut pas tre batteur tant donn qu'il est guitariste, etc. Le troisime champ est trs important dans ce schma : c'est l'identifiant unique. Les id permettent de rfrencer un objet plus facilement. C'est--dire qu'ici, Cam a pour id 1, Natim 2 et Cyril 3. Si nous ne les avions pas, nous ne pourrions pas les modifier. Imaginons que Cam joue de la Batterie et de la Guitare. Si nous souhaitions modifier son instrument sans identifiant unique nous ne pourrions pas dire de quelle fiche nous souhaitons modifier l'instrument. En gros une table est un tableau dont les colonnes sont dfinies et chaque ligne correspond un objet dont les colonnes sont les caractristiques. On peut aussi dire qu'une table dfinit la structure d'une fiche et qu'on cre une fiche chaque fois qu'on parle d'un objet avec les renseignements correspondants sur cette fiche.

Les diffrents types de bases de donnes

Nous allons toucher quelque chose d'assez complexe ici. On pourrait trs bien imaginer stocker ces tableaux dans des tableurs ou des fichiers CSV . Cependant il serait trs difficile de faire des recherches dans ces fichiers pour n'afficher que les guitaristes par exemple. En utilisant des bases de donnes relationnelles, on va pouvoir crire des requtes un serveur de base de donnes qui va nous retourner uniquement les objets correspondants. Les requtes sont crites en SQL : Structured Query Language. Il existe diffrents types de SGBDR comme MySQL, PostGreSQL, Oracle, MSSQL, Access, SQLite ... Ils sont tous compatibles avec Django mais nous allons utiliser principalement MySQL qui est libre, rapide et simple utiliser et configurer.

www.siteduzero.com

Dveloppez vos applications web avec Django

8/29

Django, le framework Web-Python

Qu'est-ce que Django ?
Depuis le dbut du cours, je ne ne fais que vous parler de dveloppement, mais qu'est-ce que Django ? Ne l'oublions pas, il est quand mme le sujet de ce cours, et vous pouvez me croire, il y a une raison a. Django est un framework dvelopp en Python, initialement pour un journal local dans le Kansas : World Online.

Django, son histoire

En 2003, deux dveloppeurs (Adrian Holovaty et Simon Willison) ont dcid d'abandonner le langage PHP pour se mettre au Python afin de dvelopper leur site ddi aux faits actuels. Pour amliorer le temps de dveloppement, ils ont dcid de mettre en place un framework, une structure simple permettant de rduire considrablement le temps de dveloppement d'un site. En deux ans, ce moteur a beaucoup chang, et change encore aujourd'hui, avec des ajouts et corrections. C'est en 2005 que World Online dcide d'ouvrir les portes de son framework : Django. Depuis ce framework a rencontr un franc succs. Il est utilis par de nombreux dveloppeurs ayant besoin de dvelopper des sites de grande qualit, trs rapidement.

Pourquoi Django ?
Le nom Django a t donn en souvenir de Django Reinhardt, guitariste jazz ayant vcu de 1910 1953. Il est considr comme le meilleur guitariste manouche de tous les temps. Cet homme a beaucoup chang notre vision du jazz, et nous ne pouvons que l'en remercier. Pour plus d'informations sur Django et ses origines, je vous redirige sur la FAQ officielle du projet.

Pourquoi l'utiliser ?
Remarque Si vous n'arrivez pas vraiment suivre ce sous-chapitre, ce n'est pas trs grave : imprgnez-vous simplement du vocabulaire qui vous sera expliqu et dvelopp en temps voulu.

Pourquoi utiliser un framework ?

Lorsque l'on ralise un site Internet, on en revient toujours aux mme tapes : ralisation et codage du design ; ralisation des modules : ralisation du modle de donnes concernant le module, ralisation des formulaires d'ajout, modification et suppression des donnes : vrification des donnes des formulaires, affichage des erreurs, ralisation et affichage des formulaires, ralisation des pages d'affichage du contenu du site ; ralisation d'une administration pour grer les modules ; ralisation d'un espace utilisateur avec des droits sur l'accs aux donnes ; mise en place de flux RSS/ATOM ; mise en place d'un plan du site ; ... Tout cela est relativement rptitif, et si, la premire fois, a peut paratre trs amusant, on en arrive rapidement faire des copier/coller, assez mauvaise mthode car source de nombreuses erreurs. Finalement on regroupe des morceaux de code en fonctions rutilisables. ce moment, on se rapproche de plus en plus de la notion de framework ci-dessus. L'avantage d'utiliser un framework existant et surtout Open Source tel que Django, c'est que nous ne sommes pas les seuls l'utiliser, et que les bugs sont donc corrigs plus rapidement, les amliorations sont excutes par plusieurs personnes et de manire bien mieux rflchie. C'est d'ailleurs tout l'intrt d'utiliser un framework. En faire moins, pour en faire plus dans le mme temps.

www.siteduzero.com

Dveloppez vos applications web avec Django

9/29

Pourquoi utiliser Django ?

Il existe de nombreux framework web, dans diffrents langages de programmation. Pourquoi utiliser spcifiquement Django et pas un autre ? V oici une question laquelle chacun a sa rponse ; d'ailleurs, tout le monde n'utilise pas Django. V ous tes compltement libre de votre choix. Nous sommes nombreux avoir choisi Django pour plusieurs raisons. La simplicit d'apprentissage. La qualit des applications ralises. La rapidit de dveloppement. La scurit du site Internet final. La facilit de maintenance des applications sur la dure. On bnficie de la clart de Python, qui permet plusieurs dveloppeurs de travailler sur le mme projet. Le style est impos, donc tout le monde suit les mmes rgles, ce qui facilite les travaux en quipe et la clart du code. En comparaison avec le PHP, on se rend compte qu'il existe de nombreuses manires de faire. On peut placer des morceaux de codes PHP au milieu de pages HTML (une solution assez mal organise), ou encore utiliser un moteur de templates pour sparer le code du HTML. En Python/Django, tout est mis en place pour ne pouvoir faire que ce qui est bien, et ce ds le dbut de l'apprentissage.

Mais encore ?
V oyons concrtement ce que Django apporte et profitons-en pour dfinir quelques termes. Pour commencer, reprenons notre code CGI (listing 1.1) : Code : Python - Page internet reposant sur les standards CGI #!/usr/bin/python import MySQLdb print print print print print print "Content-Type: text/html" "<html><head><title>Livres</title></head>" "<body>" "<h1>Livres</h1>" "<ul>"

connection = MySQLdb.connect(user='moi', passwd='laissezmoientrer', db='ma_base') cursor = connection.cursor() cursor.execute("SELECT nom FROM livres ORDER BY pub_date DESC LIMIT 10") for row in cursor.fetchall(): print "<li>%s</li>" % row[0] print "</ul>" print "</body></html>" connection.close()

On dfinit, dans un premier temps, le type de fichier gnr, puis on affiche du code HTML, on rcupre ensuite des informations sur des livres contenus dans une base de donnes, on r-affiche du HTML, et on ferme notre connexion la base de donnes. Pour une page simple comme celle-ci, cette approche aise peut convenir, mais lorsque l'application grossit, il devient de plus en plus compliqu de la maintenir. V oyons comment nous aurions crit cette page en utilisant Django. Il faut noter que nous avons spar notre fichier en trois fichiers Python (models.py, views.py et urls.py) et un gabarit HTML (derniers_livres.html).

www.siteduzero.com

Dveloppez vos applications web avec Django

Code : Python - ~/model.py # models.py (les tables de la base de donnes) from django.db import models class Livre(models.Model): nom = models.CharField(maxlength=50) date_publication = models.DateField()

10/29

Code : Python - ~/views.py # views.py (la logique mtier) from django.shortcuts import render_to_response from models import Livre def derniers_livres(request): liste_livres = Livre.objects.order_by('-date_publication')[:10] return render_to_response('derniers_livres.html', {'liste_livres': liste_livres})

Code : Python - ~/urls.py # urls.py (la configuration de l'URL) from django.conf.urls.defaults import * urlpatterns = patterns('', (r'derniers/$', app.views.derniers_livres), )

Code : HTML - ~/templates/derniers_livres.html <!-- derniers_livres.html (le gabarit) --> <ul> {% for livre in liste_livres %} <li>{{ livre.nom }}</li> {% endfor %} </ul>

Ne vous proccupez pas pour le moment de savoir comment cela fonctionne, je prendrai bien soin de vous l'expliquer. Ce qu'il faut noter ici, c'est la rpartition du code selon son objet : Le fichier models.py dcrit la table pour stocker les donnes sous la forme d'une classe Python. Cette classe est appele modle. Le fichier views.py contient la logique de la page, sous la forme de la fonction Python derniers_livres. Cette fonction est appele vue. Le fichier urls.py dfinit quelle vue sera appele pour un modle d'URL donn. Dans notre cas, derniers/ sera trait par la fonction derniers_livres. Le fichier derniers_livres.html est un gabarit HTML dfinissant l'aspect de la page. On l'appellera un template. On nommera cette organisation de projet le MTV, proche parent du MVC.

www.siteduzero.com

Dveloppez vos applications web avec Django

11/29

Tlchargement et installation
L'installation du framework requiert certains programmes qui seront indispensables son fonctionnement : Python ; Python Imaging Library ; gestionnaire de base(s) de donnes (MySQL, SQLite, PostgreSQL, ...). Pour ce tutoriel, et au niveau de la base de donnes, nous allons nous rfrer une base SQLite qui est la plus facile mettre en place, mais rien ne vous empche d'installer une base MySQL ou Oracle pour votre application.

Debian et drivs
Nous allons installer nos trois programmes cits en introduction ce chapitre. Code : Console $ sudo apt-get install python python-imaging python-pysqlite2 sqlite3

Ensuite, nous allons rcuprer la dernire version de Django. Code : Console $ $ $ $ cd ~/Tlchargements/ tar zxf Django-1.2.5.tar.gz cd Django-1.2.5 sudo python setup.py install

Remarque l'heure actuelle, Django n'est pas disponible en version 1.2.5 dans les paquets Ubuntu. V ous pourrez cependant l'installer via ce biais ds qu'il fera son apparition sur les dpts avec $ sudo apt-get install pythondjango .

Mac OS X
Python et SQLite3 sont dj prsents, vous pouvez utiliser easy_install pour installer pysqlite2 : Code : Console $ sudo easy_install pysqlite

Pour installer PIL, vous aurez besoin du kit de dveloppement Mac OS X qui se trouve sur le DVD d'installation dans le rpertoire Developer Tools. PIL ayant besoin de pouvoir lire les fichiers .jpeg, il vous faudra compiler libjpeg (tlcharger la dernire version). Ensuite, il faut extraire, configurer et compiler : Code : Console $ $ $ $ $ $ tar zxf jpegsrc.v6b.tar.gz cd jpeg-6b cp /usr/share/libtool/config/config.sub . cp /usr/share/libtool/config/config.guess . ./configure --enable-shared --enable-static make

Puis installer : Code : Console

www.siteduzero.com

Dveloppez vos applications web avec Django

12/29

$ $ $ $

sudo sudo sudo sudo

mkdir -p /usr/local/include mkdir -p /usr/local/lib mkdir -p /usr/local/man/man1 make install

V ous pouvez utiliser pip pour installer Imaging. Code : Console $ sudo easy_install pip $ sudo pip install http://effbot.org/downloads/Imaging-1.1.7.tar.gz

Enfin, nous allons rcuprer la dernire version de Django. Code : Console $ $ $ $ cd ~/Downloads/ tar zxf Django-1.2.5.tar.gz cd Django-1.2.5 sudo python setup.py install

Windows
Il existe plusieurs faons d'installer Django sous Windows, mais, la base, cet OS n'est pas fait pour a. Je vais donc vous montrer la mthode la plus simple. Ce n'est pas aussi vident que sous Unix. V ous devez dj installer Python. Tlchargez ensuite Django 1.2.5 et extrayez-le. Un dossier Django-1.2.5 s'est cr. Une fois ceci effectu, nous allons modifier les variables d'environnement systme : Touche Windows + Pause > Paramtres systme avancs -> Variables d'environnement. Ensuite, cherchez la variable systme Path et ajoutez ceci en fin de ligne (faites attention votre version de Python) : Code : Console ;C:\Python27;C:\Python27\Lib\site-packages\django\bin

Utilisons maintenant la bonne vieille console Windows. Ouvrez cette dernire via : cmd , rendez-vous dans votre dossier Django, puis : Code : Console $ cd chemin\vers\django $ python setup.py install

Ne prenez pas peur, il est normal que toutes ces lignes s'affichent. Attention Veillez ce que tous les fichiers .py s'ouvrent avec Python et non pas un autre logiciel, sinon vous ne pourrez rien en faire. Dans le cas contraire, il faut chaque fois ajouter python devant vos commandes. Django est maintenant install. SQLite est par dfaut install avec Python. Je vous laisse installer PIL par vous-mmes.

Vrification
Pour vrifier l'installation, vous pouvez lancer une console Python et tester : Code : Python

www.siteduzero.com

Dveloppez vos applications web avec Django

>>> import django >>> print django.VERSION (1, 2, 5, 'final', 0) >>> import Image >>> print Image.VERSION 1.1.7 >>> from pysqlite2 import dbapi2 >>> print dbapi2.version 2.6.0

13/29

Ce tuto tant destin Django 1.2, vrifiez que vous possdez bien une version 1.2 de Django. Sinon, les numros de version peuvent tre diffrents, le tout est de ne pas avoir d'erreur. V ous tes fin prts pour crer votre premier projet !

www.siteduzero.com

Dveloppez vos applications web avec Django

14/29

Partie 2 : Premiers pas avec Django

Dmarrer un premier projet

Maintenant que vous avez tout install, vous souhaitez srement commencer votre premier projet. Alors, allons-y ! Ouvrez votre terminal prfr et dirigez-vous vers votre rpertoire de travail avec cd .

L'architecture du projet

Rien de bien compliqu ici ; la seule chose connatre est le nom du projet. Nous allons l'appeler tuto_sdz , mais vous pouvez bien sr changer. V oici la ligne de commande permettant de crer notre projet : Les noms de vos projets ne doivent tre compos que de lettres, chiffres et underscores. De plus, vous ne devez pas nommer votre projet comme l'un des dossiers prsents dans le dossier d'excution du fichier django-admin.py. Code : Console django-admin.py startproject tuto_sdz

V ous devriez maintenant voir un rpertoire tuto_sdz contenant quelques fichiers. Code : Console ls tuto_sdz/ __init__.py manage.py settings.py urls.py

__init__.py : Il s'agit d'un fichier juste qui dfinit le rpertoire comme tant un module Python. Tous vos rpertoires contenant du code Python que vous souhaitez charger depuis d'autres fichiers Python, doivent contenir ce fichier mme s'il est vide. manage.py : Ce fichier nous permet de faire des actions dfinies sur notre projet Django. Nous verrons son fonctionnement ci-dessous. settings.py : C'est le fichier de configuration de notre projet. Il est, en grande partie, spcifique une machine. Attention : ce fichier est confidentiel et ne doit pas tre diffus avec votre projet. urls.py : Ce fichier est, comme son nom l'indique, destin recevoir les modles d'URL que nous dfinirons. V ous pouvez y jeter un coup d'il, mais les lignes y sont pour le moment commentes et nous l'tudierons plus en dtail dans un instant.

Grons notre application

Dirigez-vous dans le dossier nouvellement cr. Nous allons commencer tudier Django. Il est l pour nous simplifier de nombreuses tches. V ous pouvez lui demander des informations : Code : Console python manage.py help Usage: manage.py subcommand [options] [args] Options: -v VERBOSITY, --verbosity=VERBOSITY Verbosity level; 0=minimal output, 1=normal output, 2=all output --settings=SETTINGS The Python path to a settings module, e.g. "myproject.settings.main". If this isn't provided, the DJANGO_SETTINGS_MODULE environment variable will be used. --pythonpath=PYTHONPATH A directory to add to the Python path, e.g. "/home/djangoprojects/myproject".

www.siteduzero.com

Partie 2 : Premiers pas avec Django

--traceback --version -h, --help Print traceback on exception show program's version number and exit show this help message and exit

15/29

Type 'manage.py help <subcommand>' for help on a specific subcommand. Available subcommands: changepassword cleanup compilemessages createcachetable createsuperuser dbshell diffsettings dumpdata flush inspectdb loaddata makemessages reset runfcgi runserver shell sql sqlall sqlclear sqlcustom sqlflush sqlindexes sqlinitialdata sqlreset sqlsequencereset startapp syncdb test testserver validate

Si vous souhaitez encore plus d'informations, il vous suffit de mettre le nom de la commande aprs le help. Code : Console $ python manage.py help cleanup Usage: manage.py cleanup [options]

Can be run as a cronjob or directly to clean out old data from the database (only expired [...]

On verra par la suite qu'on peut galement ajouter nous-mmes nos commandes manage.py, ou bien que des modules externes le font pour nous.

Lancer le serveur de dveloppement

Tiens, nous avons une commande runserver Intressant, cela ! Et si on essayait ? V ous en mourez d'envie ! Code : Console $ python manage.py runserver Validating models... 0 errors found Django version 1.2.5, using settings 'tuto_sdz.settings' Development server is running at http://127.0.0.1:8000/ Quit the server with CONTROL-C.

www.siteduzero.com

Partie 2 : Premiers pas avec Django

16/29

V ous pouvez essayer directement : http://127.0.0.1:8000/. Notez que, sans argument, le serveur se lance en mode de dveloppement et n'est accessible, par scurit, que sur la boucle locale (IP 127.0.0.1). En aucun cas, vous ne devez utiliser ce serveur en production. Nous verrons plus loin comment faire pour configurer Django en production. Si vous souhaitez changer le port du serveur (pour lancer plusieurs projets Django, par exemple), vous pouvez faire comme ceci : Code : Console $ python manage.py runserver 8080

Si vous souhaitez accder au serveur de dveloppement depuis votre rseau local : Code : Console $ python manage.py runserver 192.168.0.0:8000

Ou mme comme cela, pour ne pas filtrer les adresses IP autorises : Code : Console $ manage.py runserver 0.0.0.0:8000

Les paramtres
Le fichier settings.py va contenir les informations de connexion la base de donnes, le salt qui permet de scuriser les clefs de hashage MD5 ou SHA1 par exemple. V ous allez galement y entrer votre adresse e-mail. Il y a les tuples ADMINS et MANAGERS. Gnralement, ADMINS est utilis pour les erreurs et MANAGERS pour les fonctionnalits (alerte d'un nouveau message dans le livre d'or par exemple). Je vous propose de remplir le fichier settings comme suit. vous qui, comme tout programmeur tranger, placez des accents partout, il y a deux rgles en Python 2.* que je souhaite vous rappeler. Codez en utf-8 en mettant # -*- coding: utf-8 -*- au dbut de tous vos fichiers. Si vous utilisez les chanes de caractres, mettez-les en Unicode comme cela : chaine = u'Je suis un chane de caractres'. Si vous respectez ces deux rgles, vous ne devriez pas avoir de problmes d'encodage dans vos codes.

Code : Python # -*- coding: utf-8 -*# Django settings for tuto_sdz project. DEBUG = True TEMPLATE_DEBUG = DEBUG ADMINS = ( (u'Cyril Mizzi', '[email protected]'), (u'Natim', '[email protected]'), (u'Cam', '[email protected]') ) MANAGERS = ADMINS DATABASES = {

www.siteduzero.com

Partie 2 : Premiers pas avec Django

'default': { 'ENGINE': 'django.db.backends.sqlite3', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'. 'NAME': 'tuto_sdz.db', # Or path to database file if using sqlite3. 'USER': '', # Not used with sqlite3. 'PASSWORD': '', # Not used with sqlite3. 'HOST': '', # Set to empty string for localhost. Not used with sqlite3. 'PORT': '', # Set to empty string for default. Not used with sqlite3. } } # Vous pouvez trouver la liste complte ici : # http://en.wikipedia.org/wiki/List_of_tz_zones_by_name # Tous les choix ne sont peut-tre pas disponibles sur votre OS. # Sous Windows, ce doit tre le mme que le systme. TIME_ZONE = 'Europe/Paris' # Code de la langue de votre installation. Liste complte ici : # http://www.i18nguy.com/unicode/language-identifiers.html LANGUAGE_CODE = 'fr-fr' SITE_ID = 1 # Votre projet est-il prvu pour tre multilingue ? Sous Django, # il vaut mieux coder systmatiquement pour le multilingue. # Cela ne cote pas grand-chose et simplifie la vie par la suite. USE_I18N = True # Chemin absolu vers les fichiers statiques CSS, IMG, ... # Exemple : "/home/media/media.lawrence.com/" MEDIA_ROOT = '/home/natim/projets-django/tuto_sdz/medias/' # URL that handles the media served from MEDIA_ROOT. Make sure to use a # trailing slash if there is a path component (optional in other cases). # Examples: "http://media.lawrence.com", "http://example.com/media/" MEDIA_URL = '/medias/' # URL prefix for admin media -- CSS, JavaScript and images. Make sure to use a # trailing slash. # Examples: "http://foo.com/media/", "/media/". ADMIN_MEDIA_PREFIX = '/admin-media/' # Elle doit tre unique et n'tre partage avec personne. SECRET_KEY = '7u@2+3jnck=l&a(fwfixa%d+1i8vwf5s14cyj5vyp8hnv5ve=5' # List of callables that know how to import templates from various sources. TEMPLATE_LOADERS = ( 'django.template.loaders.filesystem.Loader', 'django.template.loaders.app_directories.Loader', # 'django.template.loaders.eggs.Loader', ) MIDDLEWARE_CLASSES = ( 'django.middleware.common.CommonMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.middleware.csrf.CsrfViewMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'django.contrib.messages.middleware.MessageMiddleware', ) ROOT_URLCONF = 'tuto_sdz.urls' TEMPLATE_DIRS = ( # Dossiers des templates comme: "/home/html/django_templates" ou

17/29

www.siteduzero.com

Partie 2 : Premiers pas avec Django

"C:/www/django/templates". # Utilisez des slashs mme sous Windows. # Attention de bien utiliser un chemin ABSOLU '/home/natim/projets-django/tuto_sdz/templates' ) INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'django.contrib.messages', # Uncomment the next line to enable the admin: # 'django.contrib.admin', )

18/29

Si vous avez bien suivi, nous devons crer deux rpertoires : l'un, medias, pour les fichiers statiques de notre design : css, images,... l'autre, templates, pour les templates HTML. Si vous ne savez pas ce que sont les templates, nous le verrons trs bientt, pas d'inquitude. Comme vous le voyez, ce fichier contient des informations confidentielles, les informations de connexion, et le salt. Ici, avec sqlite3, ce n'est pas trs dangereux, mais avec une autre base de donnes, on peut laisser traner des mots de passe. Attention Je le rpte, ce fichier est confidentiel , veillez ne pas le distribuer avec vos sources. Gnralement, nous faisons une copie settings.py.example qui, elle, est livre titre d'exemple avec le projet, et dont on supprime les informations confidentielles. De plus, cela vite d'craser le fichier settings.py spcifique d'une installation lors de la mise jour du projet. Gardez votre salt, il a t gnr automatiquement. Si vous souhaitez le gnrer nouveau : Code : Python from random import choice print ''.join([choice('abcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*(_=+)') for i in range(50)])

V ous avez ainsi un salt tout neuf pour votre site en production, par exemple.

Dans un dpt, n'oubliez pas de configurer votre VCS pour viter qu'il prenne en compte votre fichier settings.py

www.siteduzero.com

Partie 2 : Premiers pas avec Django

19/29

Ralisation de la base de donnes : les modles

Entrons dans le vif du sujet : la cration de notre premire application. Dans un premier temps, nous allons devoir crer des modles pour nos diffrentes tables, chose que nous verrons ici. Je sais que vous mourez d'impatience de pouvoir enfin dvelopper une application web, alors il est temps de s'y mettre.

Crer votre premire application

Maintenant que nous avons conu notre projet Web avec Django, il est temps de crer notre premire application. Ce qu'il faut savoir, c'est qu'un projet peut contenir une ou plusieurs applications. Cela vous permettra de bien sparer les parties distinctes de votre site : forums, tutoriels, messagerie prive, membres, etc. Les applications Django ont un avantage important : elles sont portables. Cela signifie concrtement que si vous dveloppez une application livre d'or pour un projet x , elle pourra tre utilise sur un projet y . Cette portabilit permet notamment d'utiliser des applications toutes faites dans vos projets, sans forcment rcrire quelque chose qui a dj t fait. Par exemple, une application peut simplifier l'inscription / connexion ; nous aurons l'occasion d'en tester quelques-unes plus loin dans le cours.

Crer sa premire application dans son projet

Toujours l'aide du fichier manage.py, nous allons crer notre premire application. Pour ce faire, vous allez devoir taper la commande ci-dessous la racine de votre projet : Code : Console $ python manage.py startapp sondages

Le fonctionnement est strictement le mme que la commande startproject (qui nous a permis de crer notre premier projet) : le dernier argument est le nom de votre application. Je vous conseille de choisir un nom d'application au pluriel, vous verrez pourquoi dans les prochains chapitres. C'est une sorte de convention lorsque l'on utilise un framework web comme Django.

Composition de mon application

Si tout s'est bien droul, vous devriez voir un dossier sondages la racine de votre projet. En ouvrant ce dossier frachement cr, vous devriez trouver les fichiers suivants : __init__.py : ce fichier n'est pas important, mais si vous le supprimez, vous rencontrerez des problmes. En effet, il sert signaler que le dossier de l'application est un paquetage Python. V ous remarquerez que ce n'est pas uniquement valable pour les dossiers des applications, mais aussi pour les projets ; models.py : comme son nom l'indique, il s'agit des modles de notre application. Cela nous permettra plus tard de gnrer notamment notre base de donnes ; views.py : encore une fois, le nom est explicite. Ce fichier correspond nos vues, autrement dit, toutes les pages visibles de votre application ; tests.py : ce fichier vous permettra de faire subir une batterie de tests votre application. On aura l'occasion d'aborder ce sujet une fois que vous aurez acquis les bases.

Nos premiers modles !

Passons maintenant aux choses srieuses : les modles de votre application. Ils vous permettront de gnrer la base de donnes de votre projet, avec toutes les tables et champs ncessaires. Dans le cas de notre script de sondage, nous avons besoin de deux modles : un pour les sondages et un autre pour les rponses des sondages. Ouvrons le fichier models.py de notre application pour y voir plus clair ! Pour ceux qui se demandent la signification de la premire ligne du fichier models.py par dfaut, il s'agit d'importer la librairie models pour crer notre base de donnes.

Structurer nos modles

Pour ajouter un modle, rien de plus simple : il suffit d'insrer une class du nom du modle, et cette dernire doit hriter de la class models.Model. Si vous connaissez ne serait-ce qu'un peu la POO en Python, vous devriez y arriver. Si vous n'avez pas trouv, il suffit de faire ceci :

www.siteduzero.com

Partie 2 : Premiers pas avec Django

Code : Python class Sondage(models.Model): pass class Reponse(models.Model): pass

20/29

Maintenant que notre premier modle est dclar, il va falloir le remplir. Chaque modle est constitu de champs et de fonctions. Les champs sont videmment la base des modles, alors que les fonctions permettent de gagner du temps en vitant de rcrire plusieurs fois le mme code. Notre modle Sondage doit contenir les champs question et date de publication . Quant notre modle Reponse , les champs sondage , choix et nombre de votes doivent tre inclus. En langage Django, a donne ceci : Code : Python class Sondage(models.Model): question = models.CharField(max_length=200) date_publication = models.DateTimeField() class Reponse(models.Model): sondage = models.ForeignKey(Sondage) choix = models.CharField(max_length=200) nb_votes = models.IntegerField()

Nous venons de dclarer dans nos deux classes les champs des modles. Chaque champ a un nom, un type et d'ventuelles options. Les types de champs CharField et IntegerField correspondent respectivement un champ de texte et un champ entier. ForeignKey, lui, est une relation avec un modle (c'est lui qui va faire la relation entre le modle Sondage et Reponse ). Mais ne nous ternisons pas l-dessus, nous aborderons la liste complte des champs et relations supports par Django au dbut de la deuxime partie. Quant aux options, max_length=200 dans l'exemple, elles permettent de personnaliser un peu plus nos champs. On pourra par exemple dfinir sa longueur, sa valeur par dfaut, et j'en passe.

Ajouter l'application au projet

Bien que l'on ait cr notre application, elle n'est pas relie notre projet. Pour la joindre, il faut modifier le fichier de configuration settings.py contenant notamment les informations relatives votre base de donnes. Ouvrez ce fichier, rendez-vous tout en bas, et vous devriez apercevoir un tuple intitul INSTALLED_APPS. Il s'agit tout bonnement des applications installes. Il y a toujours celles de Django par dfaut : gestion des utilisateurs, sessions, utilisateurs, etc. Code : Python INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'django.contrib.messages', 'tuto_sdz.sondages', # Uncomment the next line to enable the admin: # 'django.contrib.admin', )

tuto_sdz et sondages dans le code prcdent correspondent respectivement au nom du projet et au nom de l'application. Ce premier n'est pas obligatoire mais signifie que l'application est dans le dossier de notre projet. Si on ne le prcise pas, le programme ira chercher l'application dans notre python path.

www.siteduzero.com

Partie 2 : Premiers pas avec Django

21/29

Afficher la structure SQL de mes modles

Si vous avez bien suivi les tapes jusqu'ici, vous allez pouvoir afficher la structure SQL. Cela va permettre de vrifier si l'application sondages a bien t prise en compte et de voir le code SQL gnr pour nos modles. Code : Console $ python manage.py sql sondages BEGIN; CREATE TABLE "sondages_sondage" ( "id" integer NOT NULL PRIMARY KEY, "question" varchar(200) NOT NULL, "date_publication" datetime NOT NULL ) ; CREATE TABLE "sondages_reponse" ( "id" integer NOT NULL PRIMARY KEY, "sondage_id" integer NOT NULL REFERENCES "sondages_sondage" ("id"), "choix" varchar(200) NOT NULL, "nb_votes" integer NOT NULL ) ; COMMIT;

Gnrer la base de donnes

Tout est correct ? On va donc gnrer la base de donnes de notre application. Pour cela, je vais ( nouveau) utiliser le fichier manage.py : Code : Console $ python manage.py syncdb

On va vous demander si vous souhaitez crer un compte super-admin, dites oui / yes . Cela nous permettra par la suite de grer nos sondages dans l'administration gnre par Django. N'oubliez pas non plus de choisir un pseudo, une adresse e-mail et un mot de passe (ce dernier ne s'affiche pas par raison de scurit). Cela doit donner quelque chose comme a : Code : Console Creating Creating Creating Creating Creating Creating Creating Creating Creating Creating Creating Creating table table table table table table table table table table table table auth_permission auth_group_permissions auth_group auth_user_user_permissions auth_user_groups auth_user auth_message django_content_type django_session django_site sondages_sondage sondages_reponse

You just installed Django's auth system, which means you don't have any superusers define Would you like to create one now? (yes/no): yes Username (Leave blank to use 'camille'): Cam E-mail address: [email protected] Password: Password (again): Superuser created successfully.

www.siteduzero.com

Partie 2 : Premiers pas avec Django

Installing index for Installing index for Installing index for Installing index for Installing index for Installing index for No fixtures found. auth.Permission model auth.Group_permissions model auth.User_user_permissions model auth.User_groups model auth.Message model sondages.Reponse model

22/29

Les tables requises au bon fonctionnement du framework et celles de notre application ont bien t cres !

www.siteduzero.com

Partie 2 : Premiers pas avec Django

23/29

Ralisation des views

Pour le moment, nous n'avons fait que prdfinir les paramtres et donnes de notre application de sondages. Maintenant, que celle-ci a t initie, nous allons traiter la partie traitement de notre application. Nous allons tablir une relation entre le client et le serveur de faon trs simple.

Traitons nos donnes

Nous avons trait le modle de notre application. Maintenant, nous allons voir comment tablir des liens entre le serveur et le client. Nous allons y aller assez doucement, car cette partie est l'une des plus importantes, et il faut vraiment tre trs attentif. Dans le chapitre prcdent, nous vous avons expliqu brivement le contenu du module (avec les fichiers) ainsi que les fonctions principales de chacun d'entre eux. Comme vous le savez (cela a t expliqu au dbut du cours), Django fonctionne sous un modle MTV. Nous avons dj trait la partie modle, et maintenant, nous allons traiter la partie vue.

Qu'est-ce qu'une vue ?

Une vue, sous Django, c'est une fonction en somme. Cette fonction est en fait la relation entre le modle et le template (que nous verrons juste aprs). Cette fonction permet, par exemple, de retourner le nombre de sondages de notre base de donnes dans notre gabarit (= template). Prenons un exemple concret sur son fonctionnement. Nous avons notre application de sondages. Nous avons les sondages qui sont affichs dans nos gabarits, et tout, et tout. Nous souhaitons maintenant que l'utilisateur puisse voter dans son sondage favori. Nous allons faire quelque chose de trs simple : dans notre vue, nous rcuprons notre sondage en question (il y a donc la relation entre le modle et la vue). Ensuite, nous transmettons les donnes rcupres dans notre gabarit pour l'afficher (relation vue et template). Et dans le sens inverse, a fonctionne aussi. L'utilisateur valide son choix, le choix va donc aller la vue, qui va dire au modle d'ajouter un vote, et le modle va envoyer la requte la base de donnes. J'espre que vous arrivez comprendre.

La gestion des vues

Chaque module possde ses propres vues comme par exemples, l'accueil des sondages, un sondage en particulier, l'ajout d'un vote, la suppression d'un sondage... Toutes ces vues se dclarent dans le fichier views.py. Rendez-vous donc dans le dossier tuto_sdz/sondages$ et ouvrez le fichier en question. Nous allons dj, comme notre habitude, ajouter l'encodage de notre fichier et, nous allons dclarer notre premire fonction (notre premire vue) : Code : Python #-*- coding: utf-8 -*def homepage(request): return True

Information savoir La fonction doit toujours avoir comme argument premier request, c'est obligatoire. Ce sont toutes les donnes envoyes la vue. Une fonction doit aussi toujours retourner quelque chose. Dans notre cas, nous allons lui retourner True . Si votre fonction ne retourne rien, vous allez vous retrouver avec une belle erreur Django.

Nous n'allons pas de suite voir comment afficher des informations car nous devons d'abord voir les URLs. Cela tant, nous pouvons toujours apprendre grer le contenu de nos vues.

Traitons nos informations

Comme je vous l'ai dit, il faut toujours qu'une dfinition de vue retourne quelque chose. Faites-donc trs attention si vous devez utiliser des conditions : il faut que chaque possibilit retourne une valeur, des variables ou des objets .

www.siteduzero.com

Partie 2 : Premiers pas avec Django

Citation Mais, mais, mais... c'est quoi un objet ?

24/29

Un objet, c'est un retour de donnes rcupr du modle. En gros, lorsque vous allez faire une requte pour rcuprer les derniers sondages, le retour de cette requte sera ce qu'on appelle : un objet. Bah tiens, pourquoi ne pas effectuer une petite requte pour rcuprer tous les sondages prsents ? Comment a marche tout a ? En Python, vous devez savoir qu'il faut importer des donnes pour pouvoir les utiliser dans notre fichier. Dans notre cas, tant donn que nous souhaitons rcuprer les donnes de nos deux modles (le sondage, et ses rponses), il faut le prciser comme ceci : Code : Python # module = nom du module (sondages, pour nous) # model = dfinition d'un modle (Sondage) # model1 = dfinition d'un modle (Rponses) from module.models import model, model1

Nous aurons donc : Code : Python from sondages.models import Sondage, Reponse

Ces bouts de codes sont trs simple : dans notre application et les modles lis, nous importons dans notre fichier courant les deux modles crs (on peut aussi faire from sondages.models import * , mais c'est moins pratique). Dans notre fonction, nous souhaitons rcuprer tous les sondages. Nous devons donc faire une requte Django : Code : Python def homepage(request): list_sondages = Sondage.objects.all() return True

Ne prenez pas peur de suite, c'est trs simple : dans notre variable list_sondages , nous allons retourner des objets (voil, ce sont nos fameux objets). Ca marche trs simplement. En franais, a veut dire : dans le modle Sondages, retourne moi tous les objets. Pour le moment, rien ne va s'afficher, normalement, nous n'avons rien configur au niveau des templates. De plus, rien ne s'affiche car nous ne retournons qu'une valeur boolenne. Si vous cherchez retourner la variable et que vous affichez le tout, vous allez vous retrouver avec un retour Django et non pas des affichages comme on le voudrait. Nous allons en rester l pour la requte de la fonction. Il va maintenant falloir retourner le tout.

Pelles et pioches : retournons !

Hh. Maintenant que nous avons toutes nos donnes, il va falloir retourner ces informations notre gabarit (normal quoi). Pour faire simple, il existe diverses solutions pour se faire. Nous allons tudier la plus simple (et la plus courte ) maintenant, et nous verrons les autres plus tard. La fonction que nous allons utiliser permet de slectionner un fichier gabarit et lui envoyer des variables. Elle doit obligatoirement tre utilise dans un retour. Il faut importer cette fonction comme cela : Code : Python

www.siteduzero.com

Partie 2 : Premiers pas avec Django

from django.shortcuts import render_to_response

25/29

V oici les diffrents paramtres dont nous allons nous servir : Code : Python render_to_response(template_name, list_variables)

Pour nous, cela va se faire trs simplement : Code : Python def homepage(request): list_sondages = Sondage.objects.all() return render_to_response('sondages/homepage.html', { 'list_sondages': list_sondages })

En gros, cela dit d'utiliser le gabarit se trouvant dans le dossier templates - dfinit dans le fichier de configuration du projet (TEMPLATE_DIRS) - le fichier homepage.html qui se trouve dans le sous-dossier sondages, soit, dans notre cas : /home/natim/projets-django/tuto_sdz/templates/sondages/homepage.html. V ous pouvez faire passer d'autres variables comme a : Code : Python def homepage(request): list_sondages = Sondage.objects.all() return render_to_response('sondages/homepage.html', { 'list_sondages': list_sondages, 'page_title': 'Accueil des sondages' })

Le gestionnaire d'URLs
Les URLs sont trs importantes dans votre projet. C'est vous de les faire de toute pice. Concrtement, elles ne sont pas compliques manipuler mais il faut connatre leur fonctionnement. Si vous ouvrez le fichier urls.py, vous allez avoir quelques exemples du fonctionnement de vos URLs. En ralit, ce que nous allons faire sera quelque peu diffrents : nous allons utiliser les expressions rgulires et manipuler les vues. Pour faire simple : une vue est relie une ou plusieurs URLs, mais une URL ne peut pas tre relie plusieurs vue. Code : Python from django.conf.urls.defaults import * # Uncomment the next two lines to enable the admin: # from django.contrib import admin # admin.autodiscover() urlpatterns = patterns('', # Example: # (r'^tuto_sdz/', include('tuto_sdz.foo.urls')), # Uncomment the admin/doc line below to enable admin documentation: # (r'^admin/doc/', include('django.contrib.admindocs.urls')), # Uncomment the next line to enable the admin: # (r'^admin/', include(admin.site.urls)),

www.siteduzero.com

Partie 2 : Premiers pas avec Django

26/29

Nous verrons plus tard quoi corresponde la plupart des lignes commentes (elles sont en rapport avec l'administration). Pour l'instant, nous allons simplement nous occuper de la variable urlpatterns. Code : Autre urlpatterns = patterns('', )

Cette variable va devoir contenir toutes nos URLs. Nous verrons plus en dtails plus tard que nous pouvons dcouper la variable ainsi que la mettre dans diffrents fichiers mais nous allons rester primaire pour le dbut. Si vous connaissez vos expressions rgulires, vous devriez comprendre ceci (ou partiellement) : Code : Python from django.conf.urls.defaults import * urlpatterns = patterns('', (r'^sondages/$', 'sondages.views.homepage') )

La premier chane de caractres est notre URL sous forme d'expression rgulire. La deuxime, le module et la vue sur lesquels nous souhaitons pointer l'URL. Srieusement, vous trouvez a compliqu ? Chaque ligne correspond une nouvelle URL. Chaque URL pointe vers une seule vue dfinie comme ci-dessus. Simple comme Bonjour !

Les gabarits
Les gabarits... Quelles choses fantastiques ! V ous savez que Django fonctionne avec des templates (je vous le rabche depuis le dbut), et ces templates sont grs par le moteur de templates. Donc, comme dans tout gabarit, il faut savoir afficher et trier les informations au sein-mme de l'affichage. Continuons sur notre lanc pour notre application. Nous avons deux variables envoyes la vue : page_title et list_sondages. Ces deux variables, nous devons les utiliser. Crer un dossier sondages dans votre dossier de templates et, l'intrieur, dfinissez le fichier homepage.html.

Le systme de tags
Comme dans tout moteur de templates, vous avez diffrents tags qui permettent d'avoir des conditions, des dfinitions, et le plus important : afficher le contenu de variables. Pour afficher justement le contenu d'une variable, vous devez utiliser {{ var }}. Dans notre exemple, si vous insrez {{ page_title }}, vous verrez d'affich : Accueil des sondages sur cette url : http://127.0.0.1:8000/sondages. Dans Django, il existe deux syntaxes templates : {{ }} et {% %}. Lesquels utiliser ? C'est trs simple, vous n'avez pas le choix. Lorsque vous devez afficher une variable, ce sera toujours le premier type. Ds que vous allez devoir faire des oprations plus complexes comme les conditions et les boucles, vous devrez utiliser les deuximes. V oici un exemple basique de condition sous Django : Code : HTML Bonjour {% if not username %} visiteurs {% else %} {{ username }} {% endif %}.

En plus dcortiqu et plus pos, vous avez ceci : Code : HTML Bonjour

www.siteduzero.com

Partie 2 : Premiers pas avec Django

{% if not username %} <!-- Si la variable username n'existe pas --> visiteur <!-- On affiche visiteur --> {% else %} <!-- Sinon, si elle existe, on l'affiche --> {{ username }} {% endif %}.

27/29

V oici les deux tags que nous utiliserons le plus et que vous devez imprativement savoir. Condition : ralise des tests sur des variables Code : HTML {% if condition %} Si vraie {% else %} Si faux {% endif %}

Boucle : retourne les valeurs d'un objet ou d'un tableau de donnes. Code : HTML {% for content in profils %} <!-- Ici, le tableau est profils et les valeurs sont stockes dans content --> {{ content.name }} {{ content.lastname }} {{ content.age }} {% empty %} Aucun utilisateur n'est rfrenc. {% endfor %}

Les filtres
Nous en parlons maintenant mais ils ne vous serviront pas tant que a. Sachez simplement qu'un filtre est un attribut qu'on peut ajouter sur une variable pour lui ajouter des effets comme tronquer le contenu 100 mots, ou bien crire le tout en majuscule, en minuscule... Bref, il y a de quoi faire. V ous les dcouvrirez tout au long de ce cours.

La suite
Le cours continue ici : http://django-story.rtfd.org/. Nous recherchons une personne pour maintenir la version sdz de django-story.
En attendant une suite ce cours, nous pouvons vous suggrer certaines lectures cursives :

Sur Django
Attention Lorsque vous lisez un tutoriel sur Django, assurez-vous qu'il s'agisse bien de la version de Django que vous utilisez. Django Project - La documentation officielle Le Django Book.

www.siteduzero.com

Partie 2 : Premiers pas avec Django

Django-fr - Le site de la Communaut francophone Version franaise du Django Book

28/29

Sur Python
Apprendre programmer avec Python Dive into Python

(X)HTML
XHTML/CSS Le site du World Wide Web Consortium

www.siteduzero.com