Lezers zoals jij steunen MUO. Wanneer u een aankoop doet via links op onze site, kunnen we een aangesloten commissie verdienen.

Er is steeds meer vraag naar open-sourceprojecten, en er is een enorm aantal om je tanden in te zetten. Om aan een open-sourceproject te beginnen, helpt het als u de broncode eenvoudig kunt klonen en het project lokaal kunt opzetten.

Hoewel klonen misschien eenvoudig lijkt, kan het een uitdaging zijn met projecten die met Django zijn gebouwd. Django heeft veel afhankelijkheden en pakketten die conflicten veroorzaken wanneer ze niet zijn geïnstalleerd.

U moet de conflicten oplossen voordat het project op uw lokale computer kan worden uitgevoerd. Nou, je hoeft niet meer te lijden.

In de volgende stappen leer je hoe je je Django-project kunt klonen, instellen en uitvoeren met minimale conflicten.

Wat je nodig zult hebben

Om het meeste uit deze handleiding te halen, moet u over het volgende beschikken:

  • Python (Python3 en hoger)
  • Een praktische kennis van de Python-Django-bibliotheek
    • instagram viewer
  • Pip3
  • Bekendheid met virtuele Python-omgevingen
  • Basiskennis van Git en GitHub
  • Een GitHub-account
  • Git geïnstalleerd op uw lokale computer
  • Bekendheid met de opdrachtregel

Als aan deze vereisten is voldaan, bent u klaar om een ​​project te klonen.

1. Kloon het project vanuit GitHub

U kunt een voorbeeldproject klonen van GitHub en configureer het op uw lokale computer.

Om het project te klonen, klikt u op de groene knop met het label Code. Selecteer en kopieer in de vervolgkeuzelijst HTTP- of SSH-links. Deze links zijn de GitHub-URL's voor het project. Elk van hen zal het doen.

Wanneer je het wil bijdragen aan een open-sourceproject met behulp van Git, zul je eerst moeten vork het project uit de projectrepository om een ​​kopie te maken voordat u gaat klonen.

Terug naar uw computer, stel een map in met de naam clone_boma. Vergeet niet om naar de map te navigeren met de cd clone_boma commando.

Voer vervolgens de volgende opdracht uit om het project naar de map te klonen.

git kloon <repository-url>

Gebruik dus deze opdracht om het voorbeeldproject via HTTP te klonen:

gek kloon https://github.com/Dindihub/Boma-watch.git

2. Inspecteer de projectbestanden

Na het klonen, gebruik het ls-commando om te controleren of de bestanden van het Boma-watch project aanwezig zijn. Type ls om alle inhoud in de map weer te geven.

U kunt een teksteditor naar keuze gebruiken om de inhoud van elk bestand te inspecteren of ze bekijken op de GitHub-website.

3. Zet een virtuele omgeving op

U moet een virtuele omgeving voor het project opzetten. Het voorbeeldproject wordt geleverd met een Pipenv-omgeving die de afhankelijkheden van het project specificeert in twee bestanden: Pipbestand En Pipfile.lock.

U zult deze fout tegenkomen als u het project uitvoert met de oude Pipfile:

ModuleNotFoundError: geen module met de naam 'distutils.core'

U moet de virtuele omgeving verwijderen en opnieuw installeren. Voer achtereenvolgens de volgende opdrachten uit om de virtuele omgeving en de bijbehorende afhankelijkheden te verwijderen.

De oude omgeving verwijderen:

pipenv --rm

Om beide Pipfiles te verwijderen:

rm Pipfile*

Om uw Pipenv-afhankelijkheden op uw python-versie te installeren:

pipenv installeren--python 3.10

Voer vervolgens de volgende opdracht uit om alle Pipfiles-pakketten te installeren:

pipenv installeren aanvragen

Activeer dan de virtuele omgeving:

pipenv-shell

U ziet de virtuele omgeving geactiveerd aan de rechterkant van uw terminalvenster.

Als u Venv gebruikt om uw virtuele omgeving te maken, voert u het volgende uit om afhankelijkheden te installeren:

Pipinstalleren-Rvereisten.tekst

Om alle geïnstalleerde afhankelijkheden op te sommen:

pip bevriezen > vereisten.txt

4. Maak een databank aan

U moet een database installeren om de projectgegevens te verwerken. U kunt elke soort database kiezen die aan uw behoeften voldoet. Voor het voorbeeldproject moet u PostgresSQL gebruiken.

Leren hoe te installeer PostgreSQL op Ubuntu of Installeer PostgreSQL op Windows.

Zodra alles is ingesteld, start u de Postgres-shell met de volgende opdrachten:

sudo -i -u postgres
psql

Maak vervolgens een database met de naam nieuwe_boma op de server:

postgres=# database new_boma maken;

De server retourneert het woord CREATE DATABASE wanneer het een database aanmaakt. Bevestig dat de database bestaat door alle databases in het systeem op te sommen met de opdracht \l:

In instellingen.py, moet u de database met de applicatie verbinden. Doe dit door de databasegebruiker, -naam en -wachtwoord te vervangen door uw eigen lokale waarden:

#...
DATABANKEN = {
'standaard': {
'MOTOR':'django.db.backends.postgresql',
'NAAM':'nieuwe_boma',
'GEBRUIKER':'postgres',
'WACHTWOORD':'wachtwoord',
 }
}

Vergeet ook niet om te wisselen TIJDZONE in het settings.py-bestand op basis van uw locatie. Hierdoor blijft uw app up-to-date.

Zorg ervoor dat u hebt geïnstalleerd Psycopg2 om alle beschikbare afbeeldingen te accommoderen:

$ pijpenv installeren psychopg2

5. Genereer een geheime sleutel

Elk Django-project heeft een uniek geheime sleutel. Gewoonlijk wordt de geheime sleutel niet online weergegeven. Het moet in een env bestand waarin u moet opnemen een .gitignore-bestand uit te sluiten van de repository.

U moet een nieuwe genereren om uw project te laten lopen. Maak een nieuwe geheime sleutel met een geheime sleutelgenerator, zoals Djecretie.

# VEILIGHEIDSWAARSCHUWING: houd de geheime sleutel die bij de productie wordt gebruikt geheim!
SECRET_KEY = 'geheime-sleutel-komt-hier'

6. Project migreren naar de database

Voer de volgende opdracht uit om tabellen voor de app in de nieuwe database te maken:

Pythonbeheren.pymigraties makenapp

Voer vervolgens het volgende uit om te migreren:

Pythonbeheren.pymigreren

Wanneer u de python manage.py migreren commando, krijg je fouten. De fouten stellen u op de hoogte van ontbrekende modules. Zorg ervoor dat u alle modules installeert voordat u migreert.

Wanneer u alle afhankelijkheden hebt geïnstalleerd, voert u de migratie uit. Als de migraties zijn voltooid, is het tijd om het project uit te voeren.

Wanneer u alle afhankelijkheden hebt geïnstalleerd, voert u de migratie uit. Als de migraties worden uitgevoerd, is het tijd om het project uit te voeren.

7. Voer het project uit

Voer het project uit om ervoor te zorgen dat alles in orde is voordat u uw bijdrage toevoegt. Voer de applicatie uit met de volgende opdracht:

Pythonbeheren.pyrunserver

Als er geen fouten zijn, opent u http://127.0.0.1:8000/ in een webbrowser. U ziet de bestemmingspagina van het project zoals hieronder weergegeven:

Het geheim van het klonen van een Django-project

Het klonen van Django-projecten helpt om uw tijd te optimaliseren. U kunt zich concentreren op het ontwikkelen van nieuwe functies in plaats van een project helemaal opnieuw te beginnen.

Het geheim van het klonen en uitvoeren van een Django-project op een lokale computer is weten hoe om te gaan met de afhankelijkheden. Zorg ervoor dat u na het klonen een nieuwe virtuele omgeving maakt, afhankelijkheden installeert en verbinding maakt met een betrouwbaar databasesysteem.

Django is een krachtige Python-bibliotheek. Leer hoe u projecten kunt klonen en gebruiken om verbluffende toepassingen te maken die van invloed zijn op de technische gemeenschap.