Des lecteurs comme vous aident à soutenir MUO. Lorsque vous effectuez un achat en utilisant des liens sur notre site, nous pouvons gagner une commission d'affiliation.

Les projets open source sont de plus en plus demandés, et il y en a un grand nombre à croquer. Pour commencer à travailler sur un projet open source, il est utile de pouvoir facilement cloner le code source et configurer le projet localement.

Bien que le clonage puisse sembler facile, il peut être difficile avec des projets construits avec Django. Django a de nombreuses dépendances et packages qui provoquent des conflits lorsqu'ils ne sont pas installés.

Vous devez résoudre les conflits avant que le projet puisse s'exécuter sur votre machine locale. Eh bien, vous n'avez plus à souffrir.

Dans les étapes suivantes, vous apprendrez à cloner, configurer et exécuter votre projet Django avec un minimum de conflits.

Ce dont tu auras besoin

Pour tirer le meilleur parti de ce guide, vous devez disposer des éléments suivants :

  • Python (Python3 et supérieur)
    • instagram viewer
  • Une connaissance pratique de la bibliothèque Python-Django
  • Pip3
  • Familiarité avec les environnements virtuels Python
  • Connaissance de base de Git et GitHub
  • Un compte GitHub
  • Git installé sur votre machine locale
  • Familiarité avec la ligne de commande

Une fois ces conditions remplies, vous êtes prêt à cloner un projet.

1. Cloner le projet depuis GitHub

Vous pouvez cloner un exemple de projet à partir de GitHub et configurez-le sur votre machine locale.

Pour cloner le projet, cliquez sur le bouton vert intitulé Code. Dans la liste déroulante, sélectionnez et copiez les liens HTTP ou SSH. Ces liens sont les URL GitHub du projet. N'importe lequel d'entre eux fera l'affaire.

Quand tu veux contribuer à un projet open-source en utilisant Git, vous devrez d'abord fourchette le projet à partir du référentiel du projet pour en faire une copie avant le clonage.

De retour sur votre machine, configurez un dossier nommé clone_boma. N'oubliez pas de naviguer dans le dossier avec le cd clone_boma commande.

Ensuite, exécutez la commande suivante pour cloner le projet dans le dossier.

clone git <URL de dépôt>

Ainsi, pour cloner l'exemple de projet via HTTP, utilisez cette commande :

git cloner https://github.com/Dindihub/Boma-watch.git

2. Inspecter les fichiers du projet

Après clonage, utilisez la commande ls pour vérifier que les fichiers du projet Boma-watch sont présents. Taper ls pour lister tout le contenu du dossier.

Vous pouvez utiliser un éditeur de texte de votre choix pour inspecter le contenu de chaque fichier ou les afficher sur le site Web GitHub.

3. Configurer un environnement virtuel

Vous devez configurer un environnement virtuel pour le projet. L'exemple de projet est fourni avec un environnement Pipenv qui spécifie les dépendances du projet dans deux fichiers: Pipfile et Pipfile.lock.

Vous rencontrerez cette erreur si vous exécutez le projet avec l'ancien Pipfile :

ModuleNotFoundError: aucun module nommé 'distutils.core'

Vous devez supprimer l'environnement virtuel et l'installer à nouveau. Pour supprimer l'environnement virtuel et ses dépendances, exécutez successivement les commandes suivantes.

Pour supprimer l'ancien environnement :

pipenv --rm

Pour supprimer les deux Pipfiles :

rm Pipfile*

Pour installer vos dépendances Pipenv sur votre version de python :

pipenv installer--python 3.10

Ensuite, exécutez la commande suivante pour installer tous les packages Pipfiles :

pipenv installer demandes

Activez ensuite l'environnement virtuel :

coque pipenv

Vous verrez l'environnement virtuel activé sur le côté droit de la fenêtre de votre terminal.

Si vous utilisez Venv pour créer votre environnement virtuel, exécutez ce qui suit pour installer les dépendances :

pépininstaller-rexigences.SMS

Pour lister toutes les dépendances installées :

gel des pépins > exigences.txt

4. Créer une base de données

Vous devez installer une base de données pour gérer les données du projet. Vous pouvez choisir n'importe quel type de base de données qui répond à vos besoins. Pour l'exemple de projet, vous devez utiliser PostgresSQL.

Apprendre à installer PostgreSQL sur Ubuntu ou installer PostgreSQL sur Windows.

Une fois que tout est défini, démarrez le shell Postgres à l'aide des commandes suivantes :

sudo -i -u postgres
psql

Créez ensuite une base de données nommée nouveau_boma sur le serveur :

postgres=# créer la base de données new_boma ;

Le serveur renvoie le mot CREATE DATABASE lorsqu'il crée une base de données. Confirmez que la base de données existe en répertoriant toutes les bases de données du système avec la commande \l:

Dans paramètres.py, vous devez connecter la base de données à l'application. Pour ce faire, remplacez l'utilisateur, le nom et le mot de passe de la base de données par vos propres valeurs locales :

#...
BASES DE DONNEES = {
'défaut': {
'MOTEUR':'django.db.backends.postgresql',
'NOM':'nouveau_boma',
'UTILISATEUR':'postgres',
'MOT DE PASSE':'mot de passe',
 }
}

Pensez également à changer FUSEAU HORAIRE dans le fichier settings.py en fonction de votre emplacement. Cela gardera votre application à jour.

Assurez-vous d'avoir installé Psychopg2 pour accueillir toutes les images disponibles :

$ pipenv installer psycopg2

5. Générer une clé secrète

Chaque projet Django a un caractère unique clef secrète. Habituellement, la clé secrète n'est pas exposée en ligne. Cela devrait être dans un env fichier que vous devez inclure dans un fichier .gitignore à exclure du référentiel.

Vous devez en générer un nouveau pour que votre projet s'exécute. Créez une nouvelle clé secrète avec un générateur de clé secrète, comme Djécret.

# AVERTISSEMENT SECURITE: gardez secrète la clé secrète utilisée en production !
SECRET_KEY = 'clé-secrète-vient-ici'

6. Migrer le projet vers la base de données

Exécutez la commande suivante pour créer des tables pour l'application dans la nouvelle base de données :

pythongérer.pyfaire des migrationsapplication

Exécutez ensuite la commande suivante pour migrer :

pythongérer.pyémigrer

Lorsque vous exécutez le python manage.py migrer commande, vous rencontrez des erreurs. Les erreurs vous informent des modules manquants. Assurez-vous d'installer tous les modules avant de migrer.

Lorsque toutes les dépendances sont installées, exécutez la migration. Si les migrations se terminent, il est temps d'exécuter le projet.

Lorsque toutes les dépendances sont installées, exécutez la migration. Si les migrations s'exécutent, il est temps d'exécuter le projet.

7. Exécuter le projet

Exécutez le projet pour vous assurer que tout va bien avant d'ajouter votre contribution. Exécutez l'application avec la commande suivante :

pythongérer.pyexécuter le serveur

S'il n'y a pas d'erreurs, ouvrez http://127.0.0.1:8000/ dans un navigateur Web. Vous verrez la page de destination du projet comme indiqué ci-dessous :

Le secret du clonage d'un projet Django

Le clonage de projets Django permet d'optimiser votre temps. Vous pouvez vous concentrer sur le développement de nouvelles fonctionnalités au lieu de démarrer un projet à partir de zéro.

Le secret pour cloner et exécuter un projet Django sur une machine locale est de savoir comment gérer les dépendances. Après le clonage, assurez-vous de créer un nouvel environnement virtuel, d'installer les dépendances et de vous connecter à un système de base de données fiable.

Django est une puissante bibliothèque Python. Apprenez à cloner et à utiliser ses projets pour créer des applications étonnantes qui ont un impact sur la communauté technologique.