Cititorii ca tine ajută la sprijinirea MUO. Când efectuați o achiziție folosind link-uri de pe site-ul nostru, este posibil să câștigăm un comision de afiliat.

Proiectele cu sursă deschisă sunt din ce în ce mai solicitate și există un număr foarte mare în care să vă scufundați. Pentru a începe să lucrați la un proiect open-source, este de ajutor dacă puteți clona cu ușurință codul sursă și configurați proiectul local.

Deși clonarea poate părea ușoară, poate fi o provocare cu proiectele construite cu Django. Django are multe dependențe și pachete care provoacă conflicte atunci când nu sunt instalate.

Trebuie să remediați conflictele înainte ca proiectul să poată rula pe mașina dvs. locală. Ei bine, nu trebuie să mai suferi.

În următorii pași, veți învăța cum să clonați, să configurați și să rulați proiectul Django cu conflicte minime.

Ce vei avea nevoie

Pentru a beneficia la maximum de acest ghid, ar trebui să aveți următoarele:

  • Python (Python3 și mai sus)
  • O cunoaștere de lucru a Bibliotecii Python-Django
  • Pip3
  • Familiaritate cu mediile virtuale Python
  • Cunoștințe de bază despre Git și GitHub
  • Un cont GitHub
  • Git instalat pe mașina dvs. locală
  • Familiaritate cu linia de comandă

Cu aceste cerințe îndeplinite, sunteți gata să clonați un proiect.

1. Clonează proiectul din GitHub

Puteți clona un exemplu de proiect din GitHub și configurați-l pe mașina dvs. locală.

Pentru a clona proiectul, faceți clic pe butonul verde etichetat Cod. În meniul drop-down, selectați și copiați fie legăturile HTTP, fie SSH. Aceste link-uri sunt adresele URL GitHub pentru proiect. Oricare dintre ei va face.

Când vrei să contribuiți la un proiect open-source folosind Git, mai întâi va trebui furculiţă proiectul din depozitul proiectului pentru a face o copie înainte de clonare.

Înapoi la aparat, configurați un folder numit clone_boma. Nu uitați să navigați în folderul cu cd clone_boma comanda.

Apoi, executați următoarea comandă pentru a clona proiectul în folder.

clona git <repository-url>

Deci, pentru a clona exemplul de proiect prin HTTP, utilizați această comandă:

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

2. Inspectați fișierele de proiect

După clonare, utilizați comanda ls pentru a verifica fișierele din proiectul Boma-watch sunt prezente. Tip ls pentru a lista tot conținutul din folder.

Puteți utiliza un editor de text la alegere pentru a inspecta conținutul fiecărui fișier sau pentru a le vizualiza pe site-ul GitHub.

3. Configurați un mediu virtual

Trebuie să configurați un mediu virtual pentru proiect. Proiectul eșantion vine cu un mediu Pipenv care specifică dependențele proiectului în două fișiere: Pipfile și Pipfile.lock.

Veți întâlni această eroare dacă rulați proiectul cu vechiul Pipfile:

ModuleNotFoundError: Niciun modul numit „distutils.core”

Trebuie să ștergeți mediul virtual și să îl instalați din nou. Pentru a șterge mediul virtual și dependențele acestuia, executați următoarele comenzi consecutiv.

Pentru a elimina vechiul mediu:

pipenv --rm

Pentru a elimina ambele fișiere Pipfile:

rm Pipfile*

Pentru a instala dependențele dvs. Pipenv pe versiunea dvs. python:

pipenv instalare--python 3.10

Apoi, rulați următoarea comandă pentru a instala toate pachetele Pipfiles:

pipenv instalare cereri

Apoi activați mediul virtual:

pipenv coajă

Veți vedea mediul virtual activat în partea dreaptă a ferestrei terminalului.

Dacă utilizați Venv pentru a vă crea mediul virtual, rulați următoarele pentru a instala dependențe:

pipinstalare-rcerințe.TXT

Pentru a enumera toate dependențele instalate:

sâmburi înghețați > cerințe.txt

4. Creați o bază de date

Trebuie să instalați o bază de date pentru a gestiona datele proiectului. Puteți alege orice tip de bază de date care se potrivește nevoilor dvs. Pentru proiectul exemplu, ar trebui să utilizați PostgresSQL.

Învață cum să instalați PostgreSQL pe Ubuntu sau instalați PostgreSQL pe Windows.

Odată ce totul este setat, porniți shell-ul Postgres folosind următoarele comenzi:

sudo -i -u postgres
psql

Apoi creați o bază de date numită new_boma pe server:

postgres=# creați baza de date new_boma;

Serverul returnează cuvântul CREATE DATABASE atunci când creează o bază de date. Confirmați că baza de date există listând toate bazele de date din sistem cu comanda \l:

În setări.py, trebuie să conectați baza de date la aplicație. Faceți acest lucru înlocuind utilizatorul, numele și parola bazei de date cu propriile valori locale:

#...
BAZE DE DATE = {
'Mod implicit': {
'MOTOR':'django.db.backends.postgresql',
'NUME':'new_boma',
'UTILIZATOR':'postgres',
'PAROLA':'parola',
 }
}

De asemenea, amintiți-vă să vă schimbați FUS ORAR în fișierul settings.py pentru a se potrivi locației dvs. Acest lucru va menține aplicația dvs. actualizată.

Asigurați-vă că ați instalat Psycopg2 pentru a găzdui orice imagini disponibile:

$ pipenv instalare psicopg2

5. Generați o cheie secretă

Fiecare proiect Django are un unic cheie secreta. De obicei, cheia secretă nu este expusă online. Ar trebui să fie într-un înv fișier în care ar trebui să îl includeți un fișier .gitignore pentru a exclude din depozit.

Trebuie să generați unul nou pentru ca proiectul dvs. să ruleze. Creați o nouă cheie secretă cu un generator de chei secrete, cum ar fi Djecretie.

# AVERTISMENT DE SECURITATE: păstrați secretă cheia folosită în producție!
SECRET_KEY = 'cheia-secretă-vine-aici'

6. Migrați proiectul la baza de date

Rulați următoarea comandă pentru a crea tabele pentru aplicație în noua bază de date:

pitonadministra.pyface migrațiiaplicația

Apoi rulați următoarele pentru a migra:

pitonadministra.pymigra

Când rulați python manage.py migrate comandă, întâmpinați erori. Erorile vă anunță modulele lipsă. Asigurați-vă că instalați toate modulele înainte de a migra.

Când aveți toate dependențele instalate, rulați migrarea. Dacă migrările se termină, este timpul să rulați proiectul.

Când aveți toate dependențele instalate, rulați migrarea. Dacă migrațiile rulează, este timpul să rulați proiectul.

7. Rulați proiectul

Rulați proiectul pentru a vă asigura că totul este în regulă înainte de a adăuga contribuția. Rulați aplicația cu următoarea comandă:

pitonadministra.pyrunserver

Dacă nu există erori, deschideți http://127.0.0.1:8000/ într-un browser web. Veți vedea pagina de destinație a proiectului, așa cum se arată mai jos:

Secretul clonării unui proiect Django

Clonarea proiectelor Django vă ajută să vă optimizați timpul. Vă puteți concentra pe dezvoltarea de noi funcții în loc să începeți un proiect de la zero.

Secretul clonării și rulării unui proiect Django pe o mașină locală este să știi cum să gestionezi dependențele. După clonare, asigurați-vă că creați un nou mediu virtual, instalați dependențe și vă conectați la un sistem de baze de date de încredere.

Django este o bibliotecă Python puternică. Aflați cum să clonați și să utilizați proiectele sale pentru a crea aplicații uimitoare care au impact asupra comunității tehnologice.