Läsare som du hjälper till att stödja MUO. När du gör ett köp med hjälp av länkar på vår webbplats kan vi tjäna en affiliate-provision.

Öppen källkodsprojekt efterfrågas allt mer, och det finns ett stort antal att sätta tänderna i. För att börja arbeta med ett projekt med öppen källkod hjälper det om du enkelt kan klona källkoden och ställa in projektet lokalt.

Även om kloning kan tyckas lätt, kan det vara utmanande med projekt byggda med Django. Django har många beroenden och paket som orsakar konflikter när de inte är installerade.

Du måste åtgärda konflikterna innan projektet kan köras på din lokala dator. Tja, du behöver inte lida längre.

I nästa steg kommer du att lära dig hur du klona, ​​konfigurera och köra ditt Django-projekt med minimala konflikter.

Vad du kommer att behöva

För att få ut det mesta av den här guiden bör du ha följande:

  • Python (Python3 och högre)
  • En praktisk kunskap om Python-Django-biblioteket
  • Pip3
  • Kännedom om Python virtuella miljöer
  • Grundläggande kunskap om Git och GitHub
  • Ett GitHub-konto
  • Git installerat på din lokala dator
  • Bekantskap med kommandoraden
instagram viewer

Med dessa krav uppfyllda är du redo att klona ett projekt.

1. Klona projektet från GitHub

Du kan klona ett exempelprojekt från GitHub och konfigurera den på din lokala dator.

För att klona projektet, klicka på den gröna knappen märkt Koda. På rullgardinsmenyn, välj och kopiera antingen HTTP- eller SSH-länkar. Dessa länkar är GitHub-URL: erna för projektet. Någon av dem kommer att göra.

När du vill bidra till ett öppen källkodsprojekt med Git, måste du först gaffel projektet från projektets arkiv för att göra en kopia före kloning.

Tillbaka till din maskin, ställ in en mapp med namnet clone_boma. Kom ihåg att navigera in i mappen med cd clone_boma kommando.

Kör sedan följande kommando för att klona projektet till mappen.

git klon <repository-url>

Så för att klona provprojektet över HTTP, använd det här kommandot:

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

2. Inspektera projektfilerna

Efter kloning, använd kommandot ls för att kontrollera att filerna från Boma-watch-projektet finns. Typ ls för att lista allt innehåll i mappen.

Du kan använda en valfri textredigerare för att inspektera innehållet i varje fil eller visa dem på GitHub-webbplatsen.

3. Konfigurera en virtuell miljö

Du måste skapa en virtuell miljö för projektet. Exempelprojektet kommer med en Pipenv-miljö som specificerar projektets beroenden i två filer: Pipfil och Pipfile.lock.

Du kommer att stöta på detta fel om du kör projektet med den gamla Pipfilen:

ModuleNotFoundError: Ingen modul med namnet 'distutils.core'

Du måste ta bort den virtuella miljön och installera den på nytt. För att ta bort den virtuella miljön och dess beroenden, kör följande kommandon i följd.

Så här tar du bort den gamla miljön:

pipenv --rm

Så här tar du bort båda Pip-filerna:

rm Pipfile*

Så här installerar du dina Pipenv-beroenden på din pythonversion:

pipenv Installera--python 3.10

Kör sedan följande kommando för att installera alla Pipfiles-paket:

pipenv Installera förfrågningar

Aktivera sedan den virtuella miljön:

pipenv skal

Du kommer att se den virtuella miljön aktiverad på höger sida av ditt terminalfönster.

Om du använder Venv för att skapa din virtuella miljö, kör följande för att installera beroenden:

pipInstallera-rkrav.Text

Så här listar du alla installerade beroenden:

pip frysa > krav.txt

4. Skapa en databas

Du måste installera en databas för att hantera projektdata. Du kan välja vilken typ av databas som helst som passar dina behov. För exempelprojektet bör du använda PostgresSQL.

Lära sig hur installera PostgreSQL på Ubuntu eller installera PostgreSQL på Windows.

När allt är klart, starta Postgres-skalet med följande kommandon:

sudo -i -u postgres
psql

Skapa sedan en databas med namnet new_boma på servern:

postgres=# skapa databas new_boma;

Servern returnerar ordet CREATE DATABASE när den skapar en databas. Bekräfta att databasen finns genom att lista alla databaser i systemet med kommandot \l:

I settings.pymåste du ansluta databasen till applikationen. Gör detta genom att ersätta databasens användare, namn och lösenord med dina egna lokala värden:

#...
DATABASER = {
'standard': {
'MOTOR':'django.db.backends.postgresql',
'NAMN':'new_boma',
'ANVÄNDARE':'postgres',
'LÖSENORD':'Lösenord',
 }
}

Kom också ihåg att byta TIDSZON i filen settings.py för att passa din plats. Detta kommer att hålla din app uppdaterad.

Se till att du har installerat Psychopg2 för att få plats med alla tillgängliga bilder:

$ pipenv Installera psychopg2

5. Skapa en hemlig nyckel

Varje Django-projekt har en unik hemlig nyckel. Vanligtvis är den hemliga nyckeln inte avslöjad online. Det ska vara i en env fil som du bör inkludera i en .gitignore-fil att utesluta från förvaret.

Du måste skapa en ny för att ditt projekt ska köras. Skapa en ny hemlig nyckel med en hemlig nyckelgenerator, som Djekret.

# SÄKERHETSVARNING: håll den hemliga nyckeln som används i produktionen hemlig!
SECRET_KEY = 'hemlig-nyckel-kommer-här'

6. Migrera projekt till databasen

Kör följande kommando för att skapa tabeller för appen i den nya databasen:

pytonormhantera.pymakemigrationerapp

Kör sedan följande för att migrera:

pytonormhantera.pyflytta

När du kör python manage.py migrera kommando upplever du fel. Felen meddelar dig om saknade moduler. Se till att installera alla moduler innan du migrerar.

När du har alla beroenden installerade kör du migreringen. Om migreringarna är klara är det dags att köra projektet.

När du har alla beroenden installerade kör du migreringen. Om migreringarna körs är det dags att köra projektet.

7. Kör projektet

Kör projektet för att säkerställa att allt är okej innan du lägger till ditt bidrag. Kör programmet med följande kommando:

pytonormhantera.pyrunserver

Om det inte finns några fel, öppna http://127.0.0.1:8000/ i en webbläsare. Du kommer att se projektets målsida som visas nedan:

Hemligheten med att klona ett Django-projekt

Att klona Django-projekt hjälper till att optimera din tid. Du kan koncentrera dig på att utveckla nya funktioner istället för att starta ett projekt från början.

Hemligheten med att klona och köra ett Django-projekt på en lokal maskin är att veta hur man hanterar beroenden. Efter kloningen, se till att du skapar en ny virtuell miljö, installerar beroenden och ansluter till ett pålitligt databassystem.

Django är ett kraftfullt Python-bibliotek. Lär dig hur du klona och använda dess projekt för att skapa fantastiska applikationer som påverkar teknikgemenskapen.