Installer Django et mettre en place un projet

Il existe en gros deux versions Django : la version stable actuelle et la version de développement. Le tutoriel utilisera la version de développement, la version SVN, qui est à l'heure où je vous parle très utilisable, ce n'est pas parce que c'est une version en développement qu'elle ne marche qu'à moitié. La version stable actuelle de Django est la 0.96.

Je ne parlerai pas de l'installation de Python, pour ça, vous avez les tutoriels donnés dans le précédent chapitre.

Téléchargement et installation de Django SVN

La version de développement de Django est téléchargeable depuis SVN, un logiciel permettant de gérer les versions et mises à jour facilement. Vous pouvez télécharger la version de développement à partir de la commande suivante dans la console :

Code : Console
Ça se télécharge... Une fois que le téléchargement est terminé, rendez-vous dans le dossier Django, logiquement dans votre dossier /home/pseudonyme/, à partir de la commande suivante :

Code : Console
À partir de là, vous avez juste à lancer l'installation avec la commande ci-suit :

Code : Console

Téléchargement et installation de Django 0.96

Télécharger et installer Django sous Ubuntu depuis les paquets

Django est disponible dans les paquets Ubuntu et ce, dans sa dernière version, alors pourquoi s'en priver ! C'est une facilité d'installation que de le faire de cette manière. Le paquet porte le nom python-django et s'installe soit à partir de votre gestionnaire de paquets graphique soit à partir de la commande suivante :

Code : Console

Installation de Django à partir de l'archive

Commencez par vous rendre sur le site officiel du projet, et plus précisément ici. De là, cliquez sur le lien Django-0.96.X.tar.gz : le téléchargement de l'archive débute. Il va maintenant falloir décompresser l'archive, pour se faire deux méthodes, la graphique à partir de votre gestionnaire d'archives favori ou à partir de la commande suivante :

Code : Console
Ça se passe uniquement en console à présent, rendez-vous dans le dossier créé après décompression de l'archive grâce à la commande suivante :

Code : Console
Pour finir, il faut lancer l'installation, toujours dans la console, tapez la commande suivante :

Code : Console

Vérifier l'installation de Django

Django est (normalement) installé sur votre machine ! Mais pour en avoir le coeur net, vous pouvez taper dans la console la commande ci-dessous, qui va essayer d'importer le module Django. Si rien de spécial n'est affiché quand vous tapez cette commande, c'est que c'est ok, dans le cas contraire, Django ne s'est pas installé, ou pas convenablement...

Code : Console

Un système de gestion de base de données

Comme annoncé dans l'introduction, Django stocke les données dans une base de données, il va donc falloir installer un système de gestion de base de données sur votre machine. Django supporte les principaux, c'est-à-dire : MySQL, PostgreSQL et SQLite. À partir de là, soit vous installez tout et vous ferez votre choix plus tard, soit vous en installez qu'un seul. Le tutoriel lui se fera sous MySQL qui est le plus répandu. Ci-dessous, la liste des paquets à installer sur votre machine pour faire fonctionner l'un de ces systèmes :

• MySQL : pour faire fonctionner MySQL, vous aurez besoin de MySQLdb. Le nom du paquet sous Ubuntu est python-mysqldb ;
• PostgreSQL : pour installer PostgreSQL, ça sera psycopg2 qu'il faudra installer. Le nom du paquet sous Ubuntu est python-psycopg2 ;
• SQLite : pour le cas de SQLite, installez pysqlite dans sa dernière version. Le nom du paquet sous Ubuntu est python-pysqlite2.

Avant de s'attaquer à la mise en place d'un projet Django, il serait bon de définir ce que c'est. Pour ce faire, rien de tel qu'un exemple. Prenons l'exemple d'un site internet que nous allons créer avec Django, le site est le projet. Ce projet est ensuite composé d'applications, par exemple : un système de news, un système de sondages, etc.

Un projet est la base, c'est à partir de ça que tout ce qu'il y a à côté va être mis en place. Un exemple avec un sac de pièces d'or : le sac est le projet et les pièces les applications.

Nous reviendrons sur les dites applications qui composent un projet en temps et en heure, dans le prochain chapitre.

Créer un projet Django

Il va nous falloir, pour créer un projet Django, trouver le fichier django-admin.py. Il se trouve logiquement dans votre dossier /usr/bin/. Si oui, c'est parfait, gardez le répertoire en tête, et passez à la suite. Si le dit fichier n'est pas dans ce répertoire, essayez /usr/local/bin/. Si vous ne le trouvez toujours pas, brûlez votre ordinateur et ses composants, c'est qu'ils sont maudits.

Mettez-vous dans le dossier où vous voulez créer votre projet avec la console, par exemple, pour créer votre projet sur le bureau, il vous faudra taper la commande suivante pour aller sur le bureau avec la console :

Code : Console
Adaptez bien entendu suivant votre nom d'utilisateur. Je ne m'embêterai pour ma part pas avec le dossier, ça sera dans /home/skaz/ directement, là où vous vous trouvez par défaut en ouvrant la console. Créons notre projet à présent, ça se fait facilement à partir du répertoire où l'on veut mettre notre projet avec la commande suivante :

Code : Console
Vous vous souvenez du dossier où est le fichier django-admin.py je suppose, hé bien, adaptez le /usr/bin/ en conséquent. Le monprojet sera le nom donné au projet mais aussi le nom du dossier contenant le projet. J'utiliserai ce nom tout au long du tutoriel pour définir ce dossier, c'est plus pratique pour moi, après libre à vous de le nommer comme bon vous semble !

Si tout s'est bien passé, allez faire un tour dans le dossier où vous avez créé votre projet, et que voyez-vous ? Un dossier monprojet ! Voilà, vous avez créé votre premier projet Django, du champagne pour fêter ça !

La structure d'un projet Django, découverte

Ouvrons à présent le dossier monprojet pour regarder ce qu'il contient et voir à quoi sert ce qu'il contient :

• monprojet : le dossier de votre projet Django qui contiendra toutes les applications et les fichiers de configuration ;
  • __init__.py : c'est le fichier qui dit à Python que le dossier monprojet doit être considéré comme un paquetage Python. Le fichier est vide et c'est normal, ne prenez pas peur !
  • manage.py : c'est le fichier qui vous permettra d'interagir depuis la console avec votre projet : pour créer de nouvelles applications, mettre à jour la base de données, lancer le serveur de développement, de Django, etc. Ça peut faire un peu beaucoup d'un coup, mais pas d'inquiétude, ça sera vu en profondeur par la suite tout ça ;
  • settings.py : fichier de configuration du projet, nous verrons de quoi il se compose dans la prochaine partie du chapitre d'ailleurs ;
  • urls.py : ce fichier est le registre du projet généré par Django, c'est lui qui contiendra la structure des URLs qui mèneront aux différentes applications par exemple.

Comme précisé juste avant, le fichier de configuration d'un projet est le fichier settings.py. Nous allons voir ici de quoi il se compose et qu'est-ce qu'il nous offre comme possibilités dans la configuration d'un projet. Ouvrez-le avec votre éditeur de texte favori, et c'est parti.

Configuration générale du projet

Code : Python
Sur ces quelques lignes de code, c'est DEBUG = True qui va nous intéresser. Il est par défaut à True, et dit ainsi à Django que s'il y a une erreur, on veut des informations sur sa source. Vous pouvez passer bien entendu à False mais bon, je le déconseille, s'il y a une erreur, autant la déboguer.

Code : Python
Il faut renseigner ici, dans le tuple, dans un premier temps votre nom / pseudonyme et dans un second temps votre adresse email. Enlevez bien évidemment le # mettant la ligne en commentaire. Vous pouvez ajouter autant d'administrateurs que vous voulez sous le même modèle que l'actuel.

Configuration de la gestion des données

Code : Python
Ici viennent se mettre les informations concernant la base de données et le système de gestion utilisé. Dans la première variable, renseignez quel système de gestion vous utilisez, les choix disponibles sont dans le commentaire juste à coté. Dans la variable suivante, le nom de la base de données, puis le nom d'utilisateur et juste après le mot de passe. On terminera avec l'host de la base de données et le port sur lequel elle écoute.

Configuration de la langue et de l'heure

Code : Python
À mettre ici le fuseau horaire à utiliser. Comme précisé dans le commentaire du code, rendez-vous à cette adresse qui regroupe tous les fuseaux horaires disponibles. Pour mettre le fuseau horaire à celui de la France, il suffira de remplacer TIME_ZONE = 'America/Chicago' par TIME_ZONE = 'Europe/Paris' .

Code : Python
On va ici définir la langue à utiliser dans Django. Il me semble que toutes les langues ne sont pas supportées, mais une bonne partie l'est, le français notamment. Comme précédemment, rendez-vous ici pour voir les lettres correspondantes aux différentes langues. Pour mettre en français, on remplacera LANGUAGE_CODE = 'en-us' par LANGUAGE_CODE = 'fr-fr' .

En ce qui concerne l'upload de fichiers

Code : Python
Mettez ici l'adresse absolue du dossier où seront uploadés les différentes choses que l'on uploadera avec Django : images, fichiers et autres. C'est donc que Django dispose d'un outil d'upload.

Code : Python
À mettre ici l'adresse du site Web gérant les différents fichiers qui seront uploadés. Pas besoin de plus d'explications je pense, les commentaires sont assez explicites.

Code : Python
Ici l'adresse du dossier qui contiendra les différents fichiers pour personnaliser l'interface d'administration de Django, ce n'est pas obligatoire de remplir maintenant, nous y reviendrons en temps voulu.