Exercice : Créer votre premier projet

6 minutes

Nous avons exploré certains concepts de base de Django, nous allons maintenant commencer à créer le projet.

Créer un projet avec django-admin

Comme nous l’avons souligné précédemment, un projet Django est le conteneur de l’ensemble du projet et des applications que nous créons. Créons notre projet.

Dans la fenêtre de terminal dans Visual Studio Code, exécutez la commande suivante :

django-admin startproject helloproject .

Important

Le point figurant à la fin de la commande est important. Il indique à django-admin d’utiliser le dossier actif. Si vous omettez ce point, la commande créera un autre sous-répertoire.

À la fin de l’exécution de la commande ci-dessus, vous devez voir le nouveau projet dans le répertoire choisi. Ici, vous voyez un nouveau dossier nommé helloproject.

Explorer la structure du projet

Maintenant que le projet Django a été créé, regardons sa structure pour voir ce qui y a été ajouté.

manage.py
helloproject/
    __init__.py
    asgi.py
    settings.py
    urls.py
    wsgi.py

L’utilitaire de ligne de commande manage.py est créé dans chaque projet Django. Il a la même fonction que django-admin. L’exemple suivant montre son utilisation, à partir du dossier du projet actif, pour lister les sous-commandes disponibles.
```
python manage.py help
```
helloproject est considéré comme le package Python de votre projet.
init.py est un fichier vide qui sert à indiquer à Python que ce répertoire doit être considéré comme un package.
settings.py contient l’ensemble de vos paramètres ou configurations.
urls.py contient les URL incluses dans le projet.
asgi.py et wsgi.py servent de point d’entrée pour vos serveurs web en fonction du type de serveur déployé.

Exécuter le projet

Nous avons installé Django, créé un projet et examiné la structure du projet. Il est temps de vérifier que ce projet fonctionne correctement.

Dans la fenêtre de terminal dans Visual Studio Code, entrez le code suivant pour démarrer le serveur.
```
python manage.py runserver
```
Le projet effectue plusieurs vérifications système, puis démarre votre serveur de développement. Copiez et collez l’URL de votre serveur de développement (http://localhost:8000, normalement) dans votre navigateur habituel. Vous devez voir une page Félicitations dans Django, avec l’image d’une fusée qui décolle.
Arrêtez temporairement le serveur, car nous devons reconfigurer notre projet. Dans la fenêtre de terminal, sélectionnez Ctrl+C.

Créer l’application Hello World

Nous avons appris les concepts de base du framework Django et examiné la structure du dossier de notre projet. À présent, il est temps de créer notre première application ! L’application Hello, world!, vous aidera à comprendre le processus de création des applications, et comment ces applications et le projet Django fonctionnent ensemble à l’unisson.

Dans la fenêtre de terminal, exécutez la commande suivante pour créer l’application.

python manage.py startapp hello_world

Avec cette commande, Django crée les dossiers et fichiers requis, pour parvenir à la structure ci-dessous.

hello_world/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

Inscrire l’application auprès du projet

Étant donné que les applications et les projets sont séparés dans Django, vous devez inscrire votre application auprès du projet. Pour ce faire, mettez à jour la variable INSTALLED_APPS à l’intérieur de settings.py pour le projet, en ajoutant une référence à la classe de configuration de l’application. La classe de configuration se trouve dans apps.py et a le même nom que le projet. Dans notre exemple, la classe est nommée HelloWorldConfig.

Dans helloproject, ouvrez Settings.py.
Recherchez la liste INSTALLED_APPS, qui doit être à la ligne 33.
Ajoutez ce qui suit à la fin de la liste, à l’intérieur des crochets ([ ]) :
```
'hello_world.apps.HelloWorldConfig',
```

La liste INSTALLED_APPS mise à jour doit ressembler à l’image suivante :

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'hello_world.apps.HelloWorldConfig',
]

Enregistrez tous les fichiers en sélectionnant Fichier>Enregistrer tout.