Lesere som deg er med på å støtte MUO. Når du foretar et kjøp ved å bruke lenker på nettstedet vårt, kan vi tjene en tilknyttet provisjon.

Åpen kildekode-prosjekter blir stadig mer etterspurt, og det er et stort antall å sette tennene i. For å begynne å jobbe med et åpen kildekode-prosjekt hjelper det hvis du enkelt kan klone kildekoden og sette opp prosjektet lokalt.

Selv om kloning kan virke enkelt, kan det være utfordrende med prosjekter bygget med Django. Django har mange avhengigheter og pakker som forårsaker konflikter når de ikke er installert.

Du må fikse konfliktene før prosjektet kan kjøres på din lokale maskin. Vel, du trenger ikke lide lenger.

I de neste trinnene vil du lære hvordan du kloner, konfigurerer og kjører Django-prosjektet ditt med minimale konflikter.

Hva du trenger

For å få mest mulig ut av denne veiledningen, bør du ha følgende:

  • Python (Python3 og nyere)
  • En praktisk kunnskap om Python-Django-biblioteket
  • Pip3
  • Kjennskap til virtuelle Python-miljøer
  • Grunnleggende kunnskap om Git og GitHub
    • instagram viewer
  • En GitHub-konto
  • Git installert på din lokale maskin
  • Kjennskap til kommandolinjen

Når disse kravene er oppfylt, er du klar til å klone et prosjekt.

1. Klon prosjektet fra GitHub

Du kan klone et eksempelprosjekt fra GitHub og konfigurer den på din lokale maskin.

For å klone prosjektet, klikk på den grønne knappen merket Kode. På rullegardinmenyen velger og kopierer du enten HTTP- eller SSH-koblinger. Disse koblingene er GitHub-URLene for prosjektet. Enhver av dem vil gjøre det.

Når du vil bidra til et åpen kildekode-prosjekt ved hjelp av Git, må du først gaffel prosjektet fra prosjektets depot for å lage en kopi før kloning.

Tilbake til maskinen din, sett opp en mappe med navnet clone_boma. Husk å navigere inn i mappen med cd clone_boma kommando.

Kjør deretter følgende kommando for å klone prosjektet inn i mappen.

git klone <repository-url>

Så for å klone prøveprosjektet over HTTP, bruk denne kommandoen:

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

2. Inspiser prosjektfilene

Etter kloning, bruk ls-kommandoen for å sjekke at filene fra Boma-watch-prosjektet er tilstede. Type ls for å liste opp alt innholdet i mappen.

Du kan bruke et tekstredigeringsprogram etter eget valg for å inspisere innholdet i hver fil eller se dem på GitHub-nettstedet.

3. Sett opp et virtuelt miljø

Du må sette opp et virtuelt miljø for prosjektet. Eksempelprosjektet kommer med et Pipenv-miljø som spesifiserer prosjektets avhengigheter i to filer: Pipfil og Pipfile.lock.

Du vil støte på denne feilen hvis du kjører prosjektet med den gamle Pipfilen:

ModuleNotFoundError: Ingen modul kalt 'distutils.core'

Du må slette det virtuelle miljøet og installere det på nytt. For å slette det virtuelle miljøet og dets avhengigheter, kjør følgende kommandoer fortløpende.

Slik fjerner du det gamle miljøet:

pipenv --rm

Slik fjerner du begge Pip-filene:

rm Pipfile*

For å installere dine Pipenv-avhengigheter på python-versjonen din:

pipenv installere--python 3.10

Kjør deretter følgende kommando for å installere alle Pipfiles-pakker:

pipenv installere forespørsler

Aktiver deretter det virtuelle miljøet:

pipenv skall

Du vil se det virtuelle miljøet aktivert på høyre side av terminalvinduet.

Hvis du bruker Venv til å lage ditt virtuelle miljø, kjør følgende for å installere avhengigheter:

pipinstallere-rkrav.tekst

For å liste opp alle installerte avhengigheter:

pip fryse > krav.txt

4. Opprett en database

Du må installere en database for å håndtere prosjektdataene. Du kan velge hvilken som helst type database som passer dine behov. For eksempelprosjektet bør du bruke PostgresSQL.

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

Når alt er satt, start Postgres-skallet ved å bruke følgende kommandoer:

sudo -i -u postgres
psql

Deretter oppretter du en database med navnet new_boma på serveren:

postgres=# opprette database new_boma;

Serveren returnerer ordet CREATE DATABASE når den oppretter en database. Bekreft at databasen eksisterer ved å liste alle databaser i systemet med kommandoen \l:

I settings.py, må du koble databasen til applikasjonen. Gjør dette ved å erstatte databasebrukeren, navnet og passordet med dine egne lokale verdier:

#...
DATABASER = {
'misligholde': {
'MOTOR':'django.db.backends.postgresql',
'NAVN':'new_boma',
'BRUKER':'postgres',
'PASSORD':'passord',
 }
}

Husk også å endre TIDSSONE i filen settings.py for å passe til din plassering. Dette vil holde appen din oppdatert.

Sørg for at du har installert Psychopg2 for å imøtekomme alle tilgjengelige bilder:

$ pipenv installere psychopg2

5. Generer en hemmelig nøkkel

Hvert Django-prosjekt har en unik hemmelig nøkkel. Vanligvis er den hemmelige nøkkelen ikke avslørt på nettet. Det skal være i en env fil som du bør inkludere i en .gitignore-fil å ekskludere fra depotet.

Du må generere en ny for at prosjektet skal kjøre. Lag en ny hemmelig nøkkel med en hemmelig nøkkelgenerator, som Djecrety.

# SIKKERHETSADVARSEL: hold den hemmelige nøkkelen som brukes i produksjonen hemmelig!
SECRET_KEY = 'hemmelig-nøkkel-kommer-her'

6. Migrer prosjekt til databasen

Kjør følgende kommando for å lage tabeller for appen i den nye databasen:

pythonfå til.pymakemigrasjonerapp

Kjør deretter følgende for å migrere:

pythonfå til.pymigrere

Når du kjører python manage.py migrere kommando, opplever du feil. Feilene varsler deg om manglende moduler. Sørg for å installere alle moduler før du migrerer.

Når du har installert alle avhengighetene, kjører du migreringen. Hvis migreringene fullføres, er det på tide å kjøre prosjektet.

Når du har installert alle avhengighetene, kjører du migreringen. Hvis migreringene kjører, er det på tide å kjøre prosjektet.

7. Kjør prosjektet

Kjør prosjektet for å sikre at alt er i orden før du legger til bidraget ditt. Kjør programmet med følgende kommando:

pythonfå til.pykjøreserver

Hvis det ikke er noen feil, åpne http://127.0.0.1:8000/ i en nettleser. Du vil se destinasjonssiden til prosjektet som vist nedenfor:

Hemmeligheten bak kloning av et Django-prosjekt

Kloning av Django-prosjekter bidrar til å optimalisere tiden din. Du kan konsentrere deg om å utvikle nye funksjoner i stedet for å starte et prosjekt fra bunnen av.

Hemmeligheten bak kloning og drift av et Django-prosjekt på en lokal maskin er å vite hvordan man håndterer avhengighetene. Etter kloning, sørg for at du oppretter et nytt virtuelt miljø, installerer avhengigheter og kobler til et pålitelig databasesystem.

Django er et kraftig Python-bibliotek. Lær hvordan du kan klone og bruke prosjektene til å lage fantastiske applikasjoner som påvirker teknologisamfunnet.