Einrichten einer Django-Entwicklungsumgebung

Überblick über die Django-Entwicklungsumgebung

Django macht es sehr einfach, Ihren eigenen Computer so einzurichten, dass Sie beginnen können, Webanwendungen zu entwickeln. Dieser Abschnitt erklärt, was Sie mit der Entwicklungsumgebung erhalten und bietet einen Überblick über einige Ihrer Einrichtungs- und Konfigurationsoptionen. Der Rest des Artikels erklärt die empfohlene Methode zur Installation der Django-Entwicklungsumgebung auf Ubuntu, macOS und Windows und wie Sie diese testen können.

Was ist die Django-Entwicklungsumgebung?

Die Entwicklungsumgebung ist eine Installation von Django auf Ihrem lokalen Computer, die Sie für die Entwicklung und das Testen von Django-Apps verwenden können, bevor Sie diese in einer Produktionsumgebung bereitstellen.

Die Hauptwerkzeuge, die Django selbst bereitstellt, sind eine Reihe von Python-Skripten zum Erstellen und Bearbeiten von Django-Projekten sowie ein einfacher Entwicklungs-Webserver, den Sie verwenden können, um lokale (d.h. auf Ihrem Computer, nicht auf einem externen Webserver) Django-Webanwendungen in Ihrem Webbrowser zu testen.

Es gibt weitere Peripheriewerkzeuge, die oft Teil der Entwicklungsumgebung sind, die wir hier nicht behandeln. Dazu gehören Dinge wie ein Texteditor oder eine IDE zum Bearbeiten von Code, Linters zur automatischen Formatierung und so weiter. Wir gehen davon aus, dass Sie bereits einen Texteditor installiert haben.

Welche Django-Setup-Optionen gibt es?

Django ist äußerst flexibel in Bezug darauf, wie und wo es installiert und konfiguriert werden kann. Django kann:

• Auf verschiedenen Betriebssystemen installiert werden.
• Aus dem Quelltext, aus dem Python Package Index (PyPi) und in vielen Fällen aus der Paketverwaltung des Host-Rechners installiert werden.
• Konfiguriert werden, um eine von mehreren Datenbanken zu verwenden, die möglicherweise ebenfalls separat installiert und konfiguriert werden müssen.
• Im Hauptsystem-Python-Umfeld oder in separaten Python-Virtual-Umfeldern ausgeführt werden.

Jede dieser Optionen erfordert eine leicht unterschiedliche Konfiguration und Einrichtung. Die folgenden Unterabschnitte erklären einige Ihrer Auswahlmöglichkeiten. Im Rest des Artikels zeigen wir Ihnen, wie Sie Django auf einer kleinen Anzahl von Betriebssystemen einrichten können, und diese Einrichtung wird im gesamten Rest dieses Moduls vorausgesetzt.

Welche Betriebssysteme werden unterstützt?

Django-Webanwendungen können auf nahezu jedem Rechner ausgeführt werden, der die Programmiersprache Python 3 ausführen kann: Windows, macOS, Linux/Unix, Solaris, um nur einige zu nennen. Fast jeder Computer sollte die notwendige Leistung haben, um Django während der Entwicklung auszuführen.

In diesem Artikel geben wir Anweisungen für Windows, macOS und Linux/Unix.

Welche Python-Version sollte verwendet werden?

Sie können jede Python-Version verwenden, die von Ihrer Ziel-Django-Version unterstützt wird. Für Django 5.0 sind die erlaubten Versionen Python 3.10 bis 3.12 (siehe FAQ:Installation).

Das Django-Projekt empfiehlt (und unterstützt "offiziell") die Verwendung der neuesten verfügbaren Version der unterstützten Python-Version.

Wo kann man Django herunterladen?

Es gibt drei Orte, um Django herunterzuladen:

• Das Python-Paket-Repository (PyPi) mit dem pip-Werkzeug. Dies ist der beste Weg, um die neueste stabile Version von Django zu erhalten.
• Verwenden Sie eine Version aus der Paketverwaltung Ihres Computers. Distributionen von Django, die mit Betriebssystemen gebündelt sind, bieten einen vertrauten Installationsmechanismus. Beachten Sie jedoch, dass die Paketversion möglicherweise ziemlich alt ist und nur in der System-Python-Umgebung installiert werden kann (was möglicherweise nicht das ist, was Sie möchten).
• Aus dem Quelltext installieren. Sie können die neueste Cutting-Edge-Version von Django aus dem Quelltext beziehen und installieren. Dies wird Anfängern nicht empfohlen, aber es ist notwendig, wenn Sie bereit sind, selbst zu Django beizutragen.

Dieser Artikel zeigt, wie man Django aus PyPi installiert, um die neueste stabile Version zu erhalten.

Welche Datenbank?

Django unterstützt offiziell die PostgreSQL-, MariaDB-, MySQL-, Oracle- und SQLite-Datenbanken, und es gibt Community-Bibliotheken, die unterschiedliche Unterstützung für andere beliebte SQL- und NoSQL-Datenbanken bieten. Wir empfehlen, dass Sie dieselbe Datenbank sowohl für Produktion als auch Entwicklung auswählen (obwohl Django viele der Datenbankunterschiede mit seinem Object-Relational Mapper (ORM) abstrahiert, gibt es immer noch potentielle Probleme, die besser vermieden werden sollten).

Für diesen Artikel (und den größten Teil dieses Moduls) verwenden wir die SQLite-Datenbank, die ihre Daten in einer Datei speichert. SQLite ist für den Einsatz als leichtgewichtige Datenbank gedacht und kann kein hohes Maß an Parallelität unterstützen. Es ist jedoch eine ausgezeichnete Wahl für Anwendungen, die hauptsächlich schreibgeschützt sind.

Systemweit oder in einer Python Virtual Environment installieren?

Wenn Sie Python3 installieren, erhalten Sie eine einzelne globale Umgebung, die von allen Python3-Codes gemeinsam genutzt wird. Während Sie beliebige Python-Pakete in der Umgebung installieren können, können Sie jeweils nur eine bestimmte Version jedes Pakets installieren.

Wenn Sie Django in der Standard-/globalen Umgebung installieren, können Sie auf dem Computer nur eine Version von Django anvisieren. Dies kann ein Problem sein, wenn Sie neue Websites erstellen möchten (mit der neuesten Version von Django) und gleichzeitig Websites pflegen möchten, die von älteren Versionen abhängen.

Daher führen erfahrene Python-/Django-Entwickler Python-Apps typischerweise in unabhängigen Python-Virtual-Umgebungen aus. Dies ermöglicht mehrere verschiedene Django-Umgebungen auf einem einzigen Computer. Das Django-Entwicklerteam selbst empfiehlt die Verwendung von Python-Virtual-Umgebungen!

Dieses Modul geht davon aus, dass Sie Django in einer virtuellen Umgebung installiert haben, und wir zeigen Ihnen weiter unten, wie das geht.

Installation von Python 3

Um Django verwenden zu können, müssen Sie Python 3 auf Ihrem Betriebssystem installiert haben. Sie benötigen auch das Python Package Index-Werkzeug — pip3 — welches zum Verwalten (Installieren, Aktualisieren und Entfernen) von Python-Paketen/Bibliotheken verwendet wird, die von Django und Ihren anderen Python-Apps genutzt werden.

Dieser Abschnitt erklärt kurz, wie Sie überprüfen können, welche Python-Versionen vorhanden sind, und neue Versionen bei Bedarf für Ubuntu Linux 20.04, macOS und Windows 10 installieren.

Ubuntu 22.04

Ubuntu Linux 22.04 LTS enthält standardmäßig Python 3.10.12. Sie können dies bestätigen, indem Sie den folgenden Befehl im Bash-Terminal ausführen:

python3 -V
# Output: Python 3.10.12

Das Python Package Index Werkzeug (pip3), das Sie zum Installieren von Paketen für Python 3 (einschließlich Django) benötigen, ist jedoch nicht standardmäßig verfügbar. Sie können pip3 im Bash-Terminal installieren mit:

sudo apt install python3-pip

macOS

macOS enthält standardmäßig kein Python 3 (Python 2 ist auf älteren Versionen enthalten). Sie können dies überprüfen, indem Sie den folgenden Befehl im Terminal ausführen:

python3 -V

Dies zeigt entweder die Python-Versionsnummer an, was darauf hinweist, dass Python 3 installiert ist, oder python3: command not found, was darauf hinweist, dass Python 3 nicht gefunden wurde.

Sie können Python 3 (zusammen mit dem pip3-Werkzeug) ganz einfach von python.org installieren:

1. Laden Sie das erforderliche Installationsprogramm herunter:

   1. Gehen Sie zu https://www.python.org/downloads/macos/
   2. Laden Sie den stabilen Release der neuesten unterstützten Version herunter, die mit Django 5.0 funktioniert. (zum Zeitpunkt des Schreibens ist dies Python 3.11.8).

2. Lokalisieren Sie die Datei mit dem Finder und doppelklicken Sie auf die Paketdatei. Folgen Sie den Installationsanweisungen.

Sie können die erfolgreiche Installation jetzt bestätigen, indem Sie python3 -V erneut ausführen und nach der Python-Versionsnummer suchen.

Sie können ähnlich überprüfen, ob pip3 installiert ist, indem Sie die verfügbaren Pakete auflisten:

pip3 list

Windows 10 oder 11

Windows enthält standardmäßig kein Python, aber Sie können es einfach (zusammen mit dem pip3-Werkzeug) von python.org installieren:

1. Laden Sie das erforderliche Installationsprogramm herunter:

   1. Gehen Sie zu https://www.python.org/downloads/windows/
   2. Laden Sie den stabilen Release der neuesten unterstützten Version herunter, die mit Django 5.0 funktioniert. (zum Zeitpunkt des Schreibens ist dies Python 3.11.8).

2. Installieren Sie Python, indem Sie auf die heruntergeladene Datei doppelklicken und den Installationsanweisungen folgen.

3. Achten Sie darauf, das Kästchen "Add Python to PATH" zu markieren.

Sie können dann überprüfen, ob Python 3 installiert wurde, indem Sie den folgenden Text in die Eingabeaufforderung eingeben:

py -3 -V

Der Windows-Installer enthält pip3 (den Python-Paketmanager) standardmäßig. Sie können die installierten Pakete wie folgt auflisten:

py -3 -m pip list

Aufrufen von Python 3 und pip3

Sie werden feststellen, dass wir in den vorherigen Abschnitten unterschiedliche Befehle verwenden, um Python 3 und pip auf verschiedenen Betriebssystemen aufzurufen.

Wenn Sie nur Python 3 (und nicht Python 2) installiert haben, können die einfachen Befehle python und pip im Allgemeinen verwendet werden, um Python und pip auf jedem Betriebssystem auszuführen. Wenn dies auf Ihrem System erlaubt ist, erhalten Sie eine "Version 3"-Zeichenfolge, wenn Sie -V mit den einfachen Befehlen ausführen, wie gezeigt:

python -V
pip -V

Wenn Python 2 installiert ist, sollten Sie, um Version 3 zu verwenden, die Befehle mit python3 und pip3 unter Linux/macOS und py -3 und py -3 -m pip unter Windows prefixen:

# Linux/macOS
python3 -V
pip3 -V

# Windows
py -3 -V
py -3 -m pip list

Die untenstehenden Anweisungen zeigen die plattformspezifischen Befehle, wie sie auf mehr Systemen funktionieren.

Verwendung von Django in einer Python Virtual Environment

Die Bibliotheken, die wir verwenden werden, um unsere virtuellen Umgebungen zu erstellen, sind virtualenvwrapper (Linux und macOS) und virtualenvwrapper-win (Windows), die wiederum beide das virtualenv-Werkzeug verwenden. Die Wrapper-Werkzeuge schaffen eine einheitliche Schnittstelle zur Verwaltung von Umgebungen auf allen Plattformen.

Installation der Virtual Environment-Software

Ubuntu Virtual Environment-Einrichtung

Nach der Installation von Python und pip können Sie virtualenvwrapper (das virtualenv enthält) installieren. Sie können die offizielle Installationsanleitung überprüfen oder den untenstehenden Anleitungen folgen.

Installieren Sie das Werkzeug mit pip3:

sudo pip3 install virtualenvwrapper

Fügen Sie dann die folgenden Zeilen am Ende Ihrer Shell-Startdatei hinzu (dies ist eine versteckte Datei namens .bashrc in Ihrem Home-Verzeichnis). Diese legen den Speicherort fest, an dem die virtuellen Umgebungen leben sollen, den Speicherort Ihrer Entwicklungsprojektverzeichnisse und den Speicherort des mit diesem Paket installierten Skripts:

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS=' -p /usr/bin/python3 '
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

Laden Sie dann die Startdatei durch Ausführen des folgenden Befehls im Terminal neu:

source ~/.bashrc

An diesem Punkt sollten Sie eine Reihe von Skripten sehen, die ausgeführt werden, wie unten gezeigt:

virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/premkproject
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postmkproject
# …
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/preactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/get_env_details

Jetzt können Sie eine neue virtuelle Umgebung mit dem Befehl mkvirtualenv erstellen.

macOS Virtual Environment-Einrichtung

Die Einrichtung von virtualenvwrapper auf macOS ist fast genau wie bei Ubuntu (auch hier können Sie die Anweisungen aus der offiziellen Installationsanleitung oder den untenstehenden Anweisungen folgen).

Installieren Sie virtualenvwrapper (und das Bündelungs- virtualenv) mit pip, wie gezeigt.

sudo pip3 install virtualenvwrapper

Fügen Sie dann die folgenden Zeilen am Ende Ihrer Shell-Startdatei hinzu (dies sind die gleichen Zeilen wie bei Ubuntu). Wenn Sie die zsh-Shell verwenden, befindet sich die Startdatei in einer versteckten Datei namens .zshrc in Ihrem Home-Verzeichnis. Wenn Sie die bash-Shell verwenden, befindet sie sich in einer versteckten Datei namens .bash_profile. Möglicherweise müssen Sie die Datei erstellen, wenn sie noch nicht existiert.

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/Library/Frameworks/Python.framework/Versions/3.7/bin/python3
export PROJECT_HOME=$HOME/Devel
source /Library/Frameworks/Python.framework/Versions/3.7/bin/virtualenvwrapper.sh

Laden Sie dann die Startdatei durch Ausführen des folgenden Befehls im Terminal neu:

source ~/.bash_profile

An diesem Punkt sehen Sie möglicherweise eine Reihe von Skripten, die ausgeführt werden (die gleichen Skripte wie bei der Ubuntu-Installation). Sie sollten nun in der Lage sein, eine neue virtuelle Umgebung mit dem Befehl mkvirtualenv zu erstellen.

cd ~  # In mein Home-Verzeichnis navigieren
ls -la #Den Inhalt des Verzeichnisses auflisten. Sie sollten .bash_profile sehen
nano .bash_profile # Die Datei im Nano-Texteditor innerhalb des Terminals öffnen
# Scrollen Sie zum Ende der Datei und kopieren Sie die obenstehenden Zeilen hinein
# Verwenden Sie Strg+X, um nano zu beenden, und wählen Sie Y, um die Datei zu speichern.

Windows Virtual Environment-Einrichtung

Die Installation von virtualenvwrapper-win ist noch einfacher als das Einrichten von virtualenvwrapper, da Sie nicht konfigurieren müssen, wo das Werkzeug Informationen über virtuelle Umgebungen speichert (es gibt einen Standardwert). Alles, was Sie tun müssen, ist, den folgenden Befehl in der Eingabeaufforderung auszuführen:

py -3 -m pip install virtualenvwrapper-win

Jetzt können Sie eine neue virtuelle Umgebung mit dem Befehl mkvirtualenv erstellen.

Erstellen einer virtuellen Umgebung

Sobald Sie virtualenvwrapper oder virtualenvwrapper-win installiert haben, ist die Arbeit mit virtuellen Umgebungen auf allen Plattformen sehr ähnlich.

Jetzt können Sie eine neue virtuelle Umgebung mit dem Befehl mkvirtualenv erstellen. Während dieser Befehl ausgeführt wird, sehen Sie, dass die Umgebung eingerichtet wird (was Sie sehen, ist leicht plattformspezifisch). Wenn der Befehl abgeschlossen ist, wird die neue virtuelle Umgebung aktiv sein — Sie können dies daran erkennen, dass der Anfang der Eingabeaufforderung der Name der Umgebung in Klammern sein wird (wir zeigen dies unten für Ubuntu, aber die letzte Zeile ist für Windows/macOS ähnlich).

mkvirtualenv my_django_environment

Sie sollten eine ähnliche Ausgabe wie die folgende sehen:

Running virtualenv with interpreter /usr/bin/python3
# …
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/t_env7/bin/get_env_details
(my_django_environment) ubuntu@ubuntu:~$

Sobald Sie sich in der virtuellen Umgebung befinden, können Sie Django installieren und mit der Entwicklung beginnen.

Verwendung einer virtuellen Umgebung

Es gibt nur wenige andere nützliche Befehle, die Sie kennen sollten (es gibt mehr in der Dokumentation des Werkzeugs, aber dies sind die, die Sie regelmäßig verwenden werden):

• deactivate — Beenden der aktuellen Python Virtual Environment.
• workon — Verfügbare virtuelle Umgebungen auflisten.
• workon name_of_environment — Die angegebene Python-Virtual-Umgebung aktivieren.
• rmvirtualenv name_of_environment — Die angegebene Umgebung entfernen.

Installation von Django

Sobald Sie eine virtuelle Umgebung erstellt und workon aufgerufen haben, um sie zu betreten, können Sie pip3 verwenden, um Django zu installieren.

# Linux/macOS
python3 -m pip install django~=4.2

# Windows
py -3 -m pip install django~=4.2

Sie können testen, ob Django installiert ist, indem Sie den folgenden Befehl ausführen (dies testet nur, ob Python das Django-Modul finden kann):

# Linux/macOS
python3 -m django --version

# Windows
py -3 -m django --version

py -m django --version

Quellcode-Verwaltung mit Git und GitHub

Quellcode-Verwaltungs- (SCM) und Versionierungstools ermöglichen es Ihnen, Versionen Ihres Quellcodes zuverlässig zu speichern und wiederherzustellen, Änderungen auszuprobieren und Code zwischen Ihren Experimenten und "bekannt gutem Code" zu teilen, wenn nötig.

Es gibt viele verschiedene SCM-Tools, einschließlich Git, Mercurial, Perforce, SVN (Subversion), CVS (Concurrent Versions System) usw., und Cloud-SCM-Hosting-Quellen wie Bitbucket, GitHub und GitLab. Für dieses Tutorial werden wir unseren Code auf GitHub hosten, einem der beliebtesten cloudbasierten Quellcode-Hosting-Dienste, und das git-Werkzeug verwenden, um unseren Quellcode lokal zu verwalten und ihn bei Bedarf an GitHub zu senden.

Schlüsselkonzepte

Git (und GitHub) verwenden Repositories ("Repo") als obersten "Behälter" zum Speichern von Code, wobei jedes Repo normalerweise den Quellcode für nur eine Anwendung oder ein Modul enthält. Repositories können öffentlich sein, in diesem Fall ist der Code für jeden im Internet sichtbar, oder privat, in diesem Fall sind sie auf das besitzende Unternehmen oder Benutzerkonto beschränkt.

Alle Arbeiten werden auf einem bestimmten "Zweig" des Codes in Ihrem Repo durchgeführt. Wenn Sie einige Änderungen an einem Zweig sichern möchten, können Sie einen "Commit" erstellen, der alle Änderungen seit Ihrem letzten Commit an den aktuellen Zweig speichert.

Das Repo wird mit einem Standardzweig namens "main" erstellt. Sie können mit git andere Zweige davon abzweigen, die anfangs alle Commits des ursprünglichen Zweigs enthalten. Sie können Zweige getrennt weiterentwickeln, indem Sie Commits hinzufügen, und dann später einen "Pull Request" (PR) auf GitHub verwenden, um Änderungen von einem Zweig in einen anderen zu zusammenzuführen. Sie können auch mit git zwischen Zweigen auf Ihrem lokalen Computer wechseln, um zum Beispiel verschiedene Dinge auszuprobieren.

Zusätzlich zu den Zweigen ist es möglich, Tags auf jedem Zweig zu erstellen und diesen Zweig später an diesem Punkt wiederherzustellen.

Erstellen eines Kontos und Repositories auf GitHub

Zuerst werden wir ein Konto auf GitHub erstellen (dies ist kostenlos). Dann erstellen und konfigurieren wir ein Repository namens "django_local_library", um die Local Library-Website zu speichern, während wir sie im Rest dieses Tutorials weiterentwickeln.

Die Schritte sind:

1. Besuchen Sie https://github.com/ und erstellen Sie ein Konto.

2. Sobald Sie angemeldet sind, klicken Sie auf den +-Link in der oberen Werkzeugleiste und wählen Sie Neues Repository.

3. Füllen Sie alle Felder auf diesem Formular aus. Obwohl diese nicht zwingend sind, werden sie dringend empfohlen.

   • Geben Sie einen Repository-Namen ein: "django_local_library".

   • Geben Sie eine neue Repository-Beschreibung ein: "Local Library-Website in Django geschrieben".

   • Wählen Sie "Öffentlich" für das Repository (Standard).

     Warnung: Dies macht alle Quellcodes sichtbar. Denken Sie daran, keine Anmeldeinformationen oder andere sensible Materialien in Ihrem Repo zu speichern, es sei denn, es ist privat.

   • Wählen Sie Python in der Add .gitignore Liste aus.

   • Wählen Sie Ihre bevorzugte Lizenz in der Add license Liste aus. MDN verwendet "Creative Commons Zero v1.0 Universal" für dieses Beispiel.

   • Markieren Sie Initialisieren Sie dieses Repository mit einem README.

4. Drücken Sie Repository erstellen.

   Das Repository wird erstellt und enthält nur die Dateien README.txt und .gitignore.

Klonen des Repos auf Ihren lokalen Computer

Jetzt, da das Repository ("Repo") auf GitHub erstellt wurde, möchten wir es auf unseren lokalen Computer klonen (kopieren):

1. Klicken Sie auf GitHub auf den grünen Code-Button. Wählen Sie im Abschnitt "Klonen" die Registerkarte "HTTPS" aus und kopieren Sie die URL. Wenn Sie den Repository-Namen "django_local_library" verwendet haben, sollte die URL in etwa so aussehen: https://github.com/<your_git_user_id>/django_local_library.git.

2. Installieren Sie git für Ihren lokalen Computer (offizieller Git-Download-Leitfaden).

3. Öffnen Sie eine Eingabeaufforderung/Terminal und klonen Sie Ihr Repo mit der oben kopierten URL:

   bash

   git clone https://github.com/<your_git_user_id>/django_local_library.git
   

   Dadurch wird das Repository im aktuellen Verzeichnis erstellt.

4. Navigieren Sie in den Repo-Ordner.

   bash

   cd django_local_library
   

Änderungen modifizieren und synchronisieren

Jetzt werden wir die Datei .gitignore auf dem lokalen Computer ändern, die Änderung commiten und das Repository auf GitHub aktualisieren. Dies ist eine nützliche Änderung, aber hauptsächlich machen wir es, um Ihnen zu zeigen, wie man Änderungen von GitHub herunterlädt, lokal Änderungen vornimmt und sie dann an GitHub überträgt.

1. In der Eingabeaufforderung/dem Terminal holen wir zuerst die neueste Version des Quellcodes von GitHub ab (fetch) und ziehen sie dann (pull), um sie in den aktuellen Zweig zu integrieren:

   Hinweis: Dieser Schritt ist nicht unbedingt erforderlich, da wir den Quellcode gerade geklont haben und wissen, dass er auf dem neuesten Stand ist. Im Allgemeinen sollten Sie jedoch Ihre Quellen von GitHub aktualisieren, bevor Sie Änderungen vornehmen.

   bash

   git fetch origin main
   git pull origin main
   

   Das "origin" ist ein Remote, das den Standort des Repos repräsentiert, an dem sich der Quellcode befindet, und "main" ist der Zweig. Sie können überprüfen, ob "origin" unser Repo auf GitHub ist, indem Sie den Befehl: git remote -v verwenden.

2. Als Nächstes checken wir einen neuen Zweig aus, um unsere Änderungen zu speichern:

   bash

   git checkout -b update_gitignore
   

   Der checkout-Befehl wird verwendet, um einen bestimmten Zweig als aktuellen Zweig auszuwählen, an dem Sie arbeiten. Das -b-Flag zeigt an, dass wir beabsichtigen, einen neuen Zweig mit dem Namen "update_gitignore" zu erstellen, anstatt einen vorhandenen Zweig mit diesem Namen auszuwählen.

3. Öffnen Sie die .gitignore-Datei, kopieren Sie die folgenden Zeilen an das Ende und speichern Sie sie anschließend:

   # Text backup files
   *.bak
   
   # Database
   *.sqlite3
   

   Beachten Sie, dass .gitignore verwendet wird, um Dateien anzugeben, die von git nicht automatisch gesichert werden sollen, wie z.B. temporäre Dateien und andere Build-Artefakte.

4. Verwenden Sie den add-Befehl, um alle geänderten Dateien (die von der .gitignore-Datei nicht ignoriert werden) in den "staging area" für den aktuellen Zweig hinzuzufügen.

   bash

   git add -A
   

5. Verwenden Sie den status-Befehl, um zu überprüfen, ob alle Dateien, die Sie commiten möchten, korrekt sind (Sie möchten Quellcodendateien einfügen, keine Binärdateien, temporäre Dateien etc.). Es sollte ähnlich der untenstehenden Auflistung aussehen.

   bash

   > git status
   On branch main
   Your branch is up-to-date with 'origin/update_gitignore'.
   Changes to be committed:
     (use "git reset HEAD <file>..." to unstage)
   
           modified:   .gitignore
   

6. Wenn Sie zufrieden sind, commiten Sie die Dateien in Ihrem lokalen Repo, indem Sie das -m-Flag verwenden, um eine prägnante, aber klare Commit-Nachricht anzugeben. Dies entspricht einer Signatur bei den Änderungen und macht sie zu einem offiziellen Teil des lokalen Repos.

   bash

   git commit -m ".gitignore: add .bak and .sqlite3"
   

7. Zu diesem Zeitpunkt wurde das Remote-Repo nicht geändert. Wir können den update_gitignore-Zweig mit dem folgenden Befehl an das "origin" Repo (GitHub) pushen:

   bash

   git push origin update_gitignore
   

8. Gehen Sie zurück zur Seite auf GitHub, auf der Sie Ihr Repo erstellt haben, und aktualisieren Sie die Seite.

   Es sollte ein Banner erscheinen, mit einem Button, den Sie drücken können, wenn Sie den von Ihnen gerade hochgeladenen Zweig "Vergleichen und pull requesten" möchten. Wählen Sie den Button aus und folgen Sie dann den Anweisungen, um einen Pull-Request zu erstellen und dann zusammenzuführen.

   

   Nach dem Zusammenführen enthält der "main"-Zweig des Repos auf GitHub Ihre Änderungen an .gitignore.

9. Sie können Ihr lokales Repo weiterhin aktualisieren, während sich Dateien ändern, indem Sie diesen Zyklus von Hinzufügen/Committen/Pushen verwenden.

Im nächsten Thema verwenden wir dieses Repo, um unseren Quellcode der lokalen Bibliotheks-Website zu speichern.

Andere Python-Werkzeuge

Erfahrene Python-Entwickler installieren möglicherweise zusätzliche Werkzeuge wie Linters (die helfen, häufige Fehler im Code zu erkennen).

Beachten Sie, dass Sie einen Django-kompatiblen Linter wie pylint-django verwenden sollten, da einige gängige Python-Linters (wie pylint) fälschlicherweise Fehler in den von Django generierten Standarddateien melden.

Testen Ihrer Installation

Der obige Test funktioniert, aber es macht nicht sehr viel Spaß. Ein interessanterer Test besteht darin, ein Skeleton-Projekt zu erstellen und es funktionsfähig zu sehen. Um dies zu tun, navigieren Sie zuerst in Ihrer Eingabeaufforderungs/Terminal zu der Stelle, an der Sie Ihre Django-Apps speichern möchten. Erstellen Sie einen Ordner für Ihre Testseite und navigieren Sie in diesen Ordner.

mkdir django_test
cd django_test

Sie können dann eine neue Skeletton-Website namens "mytestsite" mit dem django-admin-Werkzeug wie gezeigt erstellen. Nachdem Sie die Seite erstellt haben, können Sie in den Ordner navigieren, wo Sie das Hauptskript zur Verwaltung von Projekten, namens manage.py, finden.

django-admin startproject mytestsite
cd mytestsite

Wir können den Entwicklungs-Webserver aus diesem Ordner mit manage.py und dem runserver-Befehl ausführen, wie gezeigt.

# Linux/macOS
python3 manage.py runserver

# Windows
py -3 manage.py runserver

Sobald der Server läuft, können Sie die Seite anzeigen, indem Sie die folgende URL in Ihrem lokalen Webbrowser aufrufen: http://127.0.0.1:8000/. Sie sollten eine Seite sehen, die so aussieht:

Zusammenfassung

Sie haben jetzt eine Django-Entwicklungsumgebung auf Ihrem Computer eingerichtet.

Im Abschnitt Testen haben Sie auch kurz gesehen, wie wir eine neue Django-Website mit django-admin startproject erstellen und sie in Ihrem Browser mit dem Entwicklungs-Webserver (python3 manage.py runserver) ausführen können. Im nächsten Artikel vertiefen wir diesen Prozess, indem wir eine einfache, aber vollständige Webanwendung erstellen.

Siehe auch

• Schneller Installationsleitfaden (Django-Dokumentation)
• Wie man Django installiert — Kompletter Leitfaden (Django-Dokumentation) — behandelt auch, wie Django entfernt werden kann
• Wie man Django unter Windows installiert (Django-Dokumentation)

• Zurück
• Übersicht: Django Webframework (Python)
• Weiter