Étape 1 : Configuration de l'environnement
Avant de commencer à coder votre API GraphQL, il est crucial de préparer et configurer correctement votre environnement de développement. Cette étape comprend la création d'un environnement virtuel, l'installation des packages nécessaires, et la configuration de votre projet Django. Suivez les étapes ci-dessous pour configurer votre environnement.
1. Créer un Environnement Virtuel
Un environnement virtuel est un espace isolé où vous pouvez installer des packages Python spécifiques à votre projet sans interférer avec les packages installés globalement sur votre système. Cela permet de gérer les dépendances de votre projet de manière propre et organisée.
-
Créer un Environnement Virtuel :
Ouvrez votre terminal et naviguez vers le répertoire où vous souhaitez créer votre projet. Ensuite, exécutez la commande suivante pour créer un nouvel environnement virtuel :
python -m venv env
Ici,
env
est le nom de l'environnement virtuel, mais vous pouvez le nommer comme vous le souhaitez. -
Activer l’Environnement Virtuel :
Pour activer l’environnement virtuel, utilisez la commande suivante :
-
Sur macOS/Linux :
source env/bin/activate
-
Sur Windows :
env\Scripts\activate
Vous verrez le nom de votre environnement virtuel apparaître dans le prompt de votre terminal, indiquant que l’environnement virtuel est actif.
-
2. Installer les Packages Nécessaires
Avec l’environnement virtuel activé, vous pouvez maintenant installer les packages nécessaires pour le projet. Pour notre API GraphQL, nous aurons besoin de Django, de psycopg2 pour la connexion à PostgreSQL, et de Graphene-Django pour l’intégration de GraphQL avec Django.
-
Installer Django :
Django est le framework web que nous utiliserons pour développer notre application. Installez-le en utilisant Pip :
pip install django
-
Installer psycopg2-binary :
psycopg2-binary
est un adaptateur PostgreSQL pour Python. Il est utilisé pour connecter Django à PostgreSQL :pip install psycopg2-binary
-
Installer Graphene-Django :
Graphene-Django est l’extension qui nous permet de créer des APIs GraphQL en utilisant Django :
pip install graphene-django
3. Créer un Nouveau Projet Django
Maintenant que vous avez installé les packages nécessaires, vous pouvez créer un nouveau projet Django. Le projet Django servira de base pour votre application et contiendra toutes les configurations nécessaires.
-
Créer le Projet :
Exécutez la commande suivante pour créer un nouveau projet Django nommé
monsuperprojet
(vous pouvez choisir un autre nom si vous le souhaitez) :django-admin startproject monsuperprojet
-
Naviguer dans le Répertoire du Projet :
Accédez au répertoire de votre projet :
cd monsuperprojet
4. Créer une Nouvelle Application Django
Les applications Django sont des composants modulaires qui composent votre projet. Vous allez créer une application dédiée à la gestion de votre API GraphQL.
-
Créer l’Application :
Utilisez la commande suivante pour créer une nouvelle application Django nommée
myapp
(vous pouvez choisir un autre nom si vous le souhaitez) :python manage.py startapp myapp
-
Ajouter l’Application au Projet :
Ouvrez le fichier
settings.py
dans le répertoiremonsuperprojet/monsuperprojet
et ajoutezmyapp
à la liste des applications installées :INSTALLED_APPS = [
# Autres applications
'graphene_django',
'myapp',
]
5. Configurer PostgreSQL comme Base de Données
Vous devez maintenant configurer Django pour utiliser PostgreSQL comme base de données.
-
Configurer la Base de Données :
Ouvrez le fichier
settings.py
et modifiez la configuration de la base de données pour utiliser PostgreSQL :DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': 'mydatabase',
'USER': 'myuser',
'PASSWORD': 'mypassword',
'HOST': 'localhost',
'PORT': '5432',
}
}Remplacez
'mydatabase'
,'myuser'
, et'mypassword'
par les informations appropriées pour votre configuration PostgreSQL.
Résumé
Vous avez maintenant configuré votre environnement de développement avec un projet Django, une application, et une base de données PostgreSQL. Vous êtes prêt à commencer le développement de votre API GraphQL en intégrant Graphene-Django et en créant les premiers modèles et schémas.
Assurez-vous que votre environnement virtuel est toujours actif lorsque vous travaillez sur votre projet. Vous pouvez maintenant passer à l’étape suivante : la configuration de GraphQL avec Django !