I lettori come te aiutano a sostenere MUO. Quando effettui un acquisto utilizzando i link sul nostro sito, potremmo guadagnare una commissione di affiliazione.

I progetti open source sono sempre più richiesti e c'è un numero enorme in cui affondare i denti. Per iniziare a lavorare su un progetto open source, è utile clonare facilmente il codice sorgente e configurare il progetto in locale.

Sebbene la clonazione possa sembrare facile, può essere impegnativa con i progetti realizzati con Django. Django ha molte dipendenze e pacchetti che causano conflitti quando non sono installati.

È necessario correggere i conflitti prima che il progetto possa essere eseguito sul computer locale. Bene, non devi più soffrire.

Nei passaggi successivi imparerai come clonare, configurare ed eseguire il tuo progetto Django con conflitti minimi.

Di cosa avrai bisogno

Per ottenere il massimo da questa guida, dovresti avere quanto segue:

  • Python (Python3 e versioni successive)
  • Una conoscenza pratica della libreria Python-Django
    • instagram viewer
  • Pip3
  • Familiarità con ambienti virtuali Python
  • Conoscenza base di Git e GitHub
  • Un account GitHub
  • Git installato sul tuo computer locale
  • Familiarità con la riga di comando

Con questi requisiti soddisfatti, sei pronto per clonare un progetto.

1. Clonare il progetto da GitHub

Puoi clonare un progetto di esempio da Git Hub e configuralo sul tuo computer locale.

Per clonare il progetto, fare clic sul pulsante verde etichettato Codice. Nel menu a discesa, seleziona e copia i collegamenti HTTP o SSH. Questi collegamenti sono gli URL GitHub per il progetto. Ognuno di loro andrà bene.

Quando vuoi contribuire a un progetto open source utilizzando Git, dovrai prima farlo forchetta il progetto dal repository del progetto per fare una copia prima della clonazione.

Torna alla tua macchina, imposta una cartella denominata clone_boma. Ricordati di navigare nella cartella con il file cd clone_boma comando.

Successivamente, esegui il seguente comando per clonare il progetto nella cartella.

clone di git <repository-url>

Quindi, per clonare il progetto di esempio su HTTP, usa questo comando:

idiota clone https://github.com/Dindihub/Boma-watch.git

2. Ispeziona i file di progetto

Dopo la clonazione, usa il comando ls per controllare sono presenti i file del progetto Boma-watch. Tipo ls per elencare tutto il contenuto della cartella.

Puoi utilizzare un editor di testo a tua scelta per ispezionare il contenuto di ciascun file o visualizzarlo sul sito Web GitHub.

3. Configurare un ambiente virtuale

È necessario configurare un ambiente virtuale per il progetto. Il progetto di esempio viene fornito con un ambiente Pipenv che specifica le dipendenze del progetto in due file: Pipfile E Pipfile.lock.

Incontrerai questo errore se esegui il progetto con il vecchio Pipfile:

ModuleNotFoundError: nessun modulo denominato 'distutils.core'

È necessario eliminare l'ambiente virtuale e installarlo nuovamente. Per eliminare l'ambiente virtuale e le relative dipendenze, eseguire i seguenti comandi consecutivamente.

Per rimuovere il vecchio ambiente:

pipenv --rm

Per rimuovere entrambi i file Pip:

rm File Pip*

Per installare le tue dipendenze Pipenv sulla tua versione di Python:

pipenv installare--python 3.10

Quindi, esegui il seguente comando per installare tutti i pacchetti Pipfiles:

pipenv installare richieste

Quindi attivare l'ambiente virtuale:

conchiglia pipenv

Vedrai l'ambiente virtuale attivato sul lato destro della finestra del terminale.

Se stai utilizzando Venv per creare il tuo ambiente virtuale, esegui quanto segue per installare le dipendenze:

pippoinstallare-Rrequisiti.TXT

Per elencare tutte le dipendenze installate:

congelamento del pip > requisiti.txt

4. Crea una banca dati

È necessario installare un database per gestire i dati del progetto. Puoi scegliere qualsiasi tipo di database adatto alle tue esigenze. Per il progetto di esempio, dovresti usare PostgresSQL.

Impara come installa PostgreSQL su Ubuntu O installa PostgreSQL su Windows.

Una volta impostato tutto, avvia la shell di Postgres utilizzando i seguenti comandi:

sudo -i -u postgres
psql

Quindi creare un database denominato new_boma sul server:

postgres=# crea database new_boma;

Il server restituisce la parola CREATE DATABASE quando crea un database. Confermare che il database esiste elencando tutti i database nel sistema con il comando \l:

In impostazioni.py, è necessario connettere il database all'applicazione. A tale scopo, sostituisci l'utente, il nome e la password del database con i tuoi valori locali:

#...
DATABASE = {
'predefinito': {
'MOTORE':'django.db.backends.postgresql',
'NOME':'new_boma',
'UTENTE':'postgres',
'PAROLA D'ORDINE':'parola d'ordine',
 }
}

Inoltre, ricordati di cambiare FUSO ORARIO nel file settings.py in base alla tua posizione. Ciò manterrà la tua app aggiornata.

Assicurati di aver installato Psicopg2 per ospitare tutte le immagini disponibili:

$ pipenv installare psycopg2

5. Genera una chiave segreta

Ogni progetto Django ha un file unico chiave segreta. Di solito, la chiave segreta non è esposta online. Dovrebbe essere in un avv file che dovresti includere in un file .gitignore escludere dal repository.

Devi generarne uno nuovo per far funzionare il tuo progetto. Crea una nuova chiave segreta con un generatore di chiavi segrete, come Djecrety.

# ATTENZIONE ALLA SICUREZZA: mantenere segreta la chiave segreta utilizzata in produzione!
SECRET_KEY = 'chiave-segreta-arriva-qui'

6. Migrare il progetto nel database

Eseguire il comando seguente per creare tabelle per l'app nel nuovo database:

pitonemaneggio.pymakemigrationsapp

Quindi eseguire quanto segue per eseguire la migrazione:

pitonemaneggio.pymigrare

Quando esegui il python manage.py migrare comando, si verificano errori. Gli errori ti stanno notificando i moduli mancanti. Assicurati di installare tutti i moduli prima di eseguire la migrazione.

Quando hai installato tutte le dipendenze, esegui la migrazione. Se le migrazioni terminano, è il momento di eseguire il progetto.

Quando hai installato tutte le dipendenze, esegui la migrazione. Se le migrazioni vengono eseguite, è il momento di eseguire il progetto.

7. Eseguire il progetto

Esegui il progetto per assicurarti che tutto vada bene prima di aggiungere il tuo contributo. Eseguire l'applicazione con il seguente comando:

pitonemaneggio.pyrunserver

Se non ci sono errori, apri http://127.0.0.1:8000/ in un browser web. Vedrai la pagina di destinazione del progetto come mostrato di seguito:

Il segreto per clonare un progetto Django

La clonazione dei progetti Django aiuta a ottimizzare il tuo tempo. Puoi concentrarti sullo sviluppo di nuove funzionalità invece di iniziare un progetto da zero.

Il segreto per clonare ed eseguire un progetto Django su una macchina locale è sapere come gestire le dipendenze. Dopo la clonazione, assicurati di creare un nuovo ambiente virtuale, installare le dipendenze e connetterti a un sistema di database affidabile.

Django è una potente libreria Python. Scopri come clonare e utilizzare i suoi progetti per creare fantastiche applicazioni che hanno un impatto sulla comunità tecnologica.