Læsere som dig hjælper med at støtte MUO. Når du foretager et køb ved hjælp af links på vores websted, kan vi optjene en affiliate-kommission.

Open source-projekter efterspørges i stigende grad, og der er et stort antal at sætte tænderne i. For at begynde at arbejde på et open source-projekt hjælper det, hvis du nemt kan klone kildekoden og opsætte projektet lokalt.

Selvom kloning kan virke let, kan det være udfordrende med projekter bygget med Django. Django har mange afhængigheder og pakker, der forårsager konflikter, når de ikke er installeret.

Du skal rette konflikterne, før projektet kan køre på din lokale maskine. Nå, du behøver ikke lide mere.

I de næste trin lærer du, hvordan du kloner, konfigurerer og kører dit Django-projekt med minimale konflikter.

Hvad du skal bruge

For at få mest muligt ud af denne vejledning, bør du have følgende:

  • Python (Python3 og nyere)
  • Et praktisk kendskab til Python-Django-biblioteket
  • Pip 3
  • Kendskab til Python virtuelle miljøer
  • Grundlæggende viden om Git og GitHub
  • En GitHub-konto
  • Git installeret på din lokale maskine
  • Kendskab til kommandolinjen
instagram viewer

Når disse krav er opfyldt, er du klar til at klone et projekt.

1. Klon projektet fra GitHub

Du kan klone et eksempelprojekt fra GitHub og konfigurer det på din lokale maskine.

For at klone projektet skal du klikke på den grønne knap mærket Kode. På rullemenuen skal du vælge og kopiere enten HTTP- eller SSH-links. Disse links er GitHub-URL'erne for projektet. Enhver af dem vil gøre det.

Når du vil bidrage til et open source-projekt ved hjælp af Git, bliver du først nødt til gaffel projektet fra projektets depot for at lave en kopi inden kloning.

Tilbage til din maskine, opsæt en mappe med navnet clone_boma. Husk at navigere ind i mappen med cd clone_boma kommando.

Kør derefter følgende kommando for at klone projektet ind i mappen.

git klon <repository-url>

Så for at klone prøveprojektet over HTTP, brug denne kommando:

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

2. Undersøg projektfilerne

Efter kloning, brug kommandoen ls for at kontrollere, at filerne fra Boma-watch-projektet er til stede. Type ls for at få vist alt indholdet i mappen.

Du kan bruge en teksteditor efter eget valg til at inspicere indholdet af hver fil eller se dem på GitHub-webstedet.

3. Konfigurer et virtuelt miljø

Du skal oprette et virtuelt miljø for projektet. Eksempelprojektet leveres med et Pipenv-miljø, som specificerer projektets afhængigheder i to filer: Pipfil og Pipfile.lock.

Du vil støde på denne fejl, hvis du kører projektet med den gamle Pipfile:

ModuleNotFoundError: Intet modul med navnet 'distutils.core'

Du skal slette det virtuelle miljø og installere det på ny. For at slette det virtuelle miljø og dets afhængigheder skal du køre følgende kommandoer fortløbende.

Sådan fjerner du det gamle miljø:

pipenv --rm

For at fjerne begge Pip-filer:

rm Pipfile*

Sådan installerer du dine Pipenv-afhængigheder på din python-version:

pipenv installere--python 3.10

Kør derefter følgende kommando for at installere alle Pipfiles-pakker:

pipenv installere anmodninger

Aktiver derefter det virtuelle miljø:

pipenv skal

Du vil se det virtuelle miljø aktiveret i højre side af dit terminalvindue.

Hvis du bruger Venv til at skabe dit virtuelle miljø, skal du køre følgende for at installere afhængigheder:

pipinstallere-rkrav.txt

Sådan viser du alle de installerede afhængigheder:

pip fryse > krav.txt

4. Opret en database

Du skal installere en database for at håndtere projektdataene. Du kan vælge enhver form for database, der passer til dine behov. Til eksempelprojektet skal du bruge PostgresSQL.

Lær hvordan installer PostgreSQL på Ubuntu eller installere PostgreSQL på Windows.

Når alt er indstillet, skal du starte Postgres-shell ved hjælp af følgende kommandoer:

sudo -i -u postgres
psql

Opret derefter en database med navnet new_boma på serveren:

postgres=# opret database new_boma;

Serveren returnerer ordet CREATE DATABASE, når den opretter en database. Bekræft, at databasen eksisterer ved at liste alle databaser i systemet med kommandoen \l:

I settings.py, skal du forbinde databasen med applikationen. Gør dette ved at erstatte databasebrugeren, navnet og adgangskoden med dine egne lokale værdier:

#...
DATABASER = {
'Standard': {
'MOTOR':'django.db.backends.postgresql',
'NAVN':'new_boma',
'BRUGER':'postgres',
'ADGANGSKODE':'adgangskode',
 }
}

Husk også at skifte TIDSZONE i filen settings.py, så den passer til din placering. Dette vil holde din app opdateret.

Sørg for at du har installeret Psychopg2 for at imødekomme eventuelle tilgængelige billeder:

$ pipenv installere psychopg2

5. Generer en hemmelig nøgle

Hvert Django-projekt har en unik hemmelig nøgle. Normalt er den hemmelige nøgle ikke afsløret online. Det skal være i en env fil, som du skal inkludere i en .gitignore-fil at udelukke fra depotet.

Du skal generere en ny for at dit projekt kan køre. Opret en ny hemmelig nøgle med en hemmelig nøglegenerator, f.eks Djecrety.

# SIKKERHEDSADVARSEL: hold den hemmelige nøgle, der bruges i produktionen, hemmelig!
SECRET_KEY = 'hemmelig-nøgle-kommer-her'

6. Migrer projekt til databasen

Kør følgende kommando for at oprette tabeller til appen i den nye database:

pythonstyre.pymakemigrationerapp

Kør derefter følgende for at migrere:

pythonstyre.pymigrere

Når du kører python manage.py migrere kommando, oplever du fejl. Fejlene giver dig besked om manglende moduler. Sørg for at installere alle moduler, før du migrerer.

Når du har alle afhængigheder installeret, skal du køre migreringen. Hvis migreringerne afsluttes, er det tid til at køre projektet.

Når du har alle afhængigheder installeret, skal du køre migreringen. Hvis migreringerne kører, er det tid til at køre projektet.

7. Kør projektet

Kør projektet for at sikre, at alt er i orden, før du tilføjer dit bidrag. Kør programmet med følgende kommando:

pythonstyre.pyrunserver

Hvis der ikke er nogen fejl, skal du åbne http://127.0.0.1:8000/ i en webbrowser. Du vil se projektets landingsside som vist nedenfor:

Hemmeligheden bag kloning af et Django-projekt

Kloning af Django-projekter hjælper med at optimere din tid. Du kan koncentrere dig om at udvikle nye funktioner i stedet for at starte et projekt fra bunden.

Hemmeligheden ved at klone og køre et Django-projekt på en lokal maskine er at vide, hvordan man håndterer afhængighederne. Efter kloning skal du sørge for at oprette et nyt virtuelt miljø, installere afhængigheder og oprette forbindelse til et pålideligt databasesystem.

Django er et kraftfuldt Python-bibliotek. Lær, hvordan du kloner og bruger dets projekter til at skabe fantastiske applikationer, der påvirker det teknologiske samfund.