Einrichten einer Django-Entwicklungsumgebung

Django macht es sehr einfach, Ihren Computer so einzurichten, dass Sie mit der Entwicklung von Webanwendungen beginnen können. In diesem Abschnitt wird erläutert, was Sie mit der Entwicklungsumgebung erhalten, und es wird ein Überblick über einige Ihrer Einrichtungs- und Konfigurationsoptionen gegeben. Der Rest des Artikels erklärt die empfohlene Methode zur Installation der Django-Entwicklungsumgebung auf Ubuntu, macOS und Windows und wie man diese testen kann.

Die Entwicklungsumgebung ist eine Installation von Django auf Ihrem lokalen Computer, die Sie zur Entwicklung und zum Testen von Django-Apps verwenden können, bevor Sie sie in eine Produktionsumgebung bereitstellen.

Die Hauptwerkzeuge, die Django selbst bereitstellt, sind eine Reihe von Python-Skripten zum Erstellen und Arbeiten mit Django-Projekten, zusammen mit einem einfachen Entwicklungs-Webserver, den Sie zum Testen lokaler (d.h. auf Ihrem Computer, nicht auf einem externen Webserver) Django-Webanwendungen im Webbrowser Ihres Computers verwenden können.

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

Django ist extrem flexibel in Bezug darauf, wie und wo es installiert und konfiguriert werden kann. Django kann:

• Auf verschiedenen Betriebssystemen installiert werden.
• Aus dem Quellcode, vom Python Package Index (PyPi) und in vielen Fällen von der Paketmanager-Anwendung des Host-Computers installiert werden.
• So konfiguriert werden, dass es eine von mehreren Datenbanken verwendet, die möglicherweise auch separat installiert und konfiguriert werden müssen.
• Im Hauptsystem-Python-Umfeld oder innerhalb separater Python-virtueller Umgebungen betrieben werden.

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

Welche Betriebssysteme werden unterstützt?

Django-Webanwendungen können auf nahezu jedem Computer ausgeführt werden, der die Programmiersprache Python 3 ausführen kann: Windows, macOS, Linux/Unix, Solaris, um nur einige zu nennen. Nahezu jeder Computer sollte die erforderliche 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 zugelassenen 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 können wir Django herunterladen?

Es gibt drei Orte, um Django herunterzuladen:

• Das Python Package Repository (PyPi), unter Verwendung des pip Tools. Dies ist der beste Weg, um die neueste stabile Version von Django zu erhalten.
• Verwenden Sie eine Version aus dem Paketmanager Ihres Computers. Verteilungen von Django, die mit Betriebssystemen gebündelt sind, bieten einen vertrauten Installationsmechanismus. Beachten Sie jedoch, dass die gepackte Version recht alt sein kann und nur in die System-Python-Umgebung installiert werden kann (was nicht unbedingt das ist, was Sie wollen).
• Installation aus dem Quellcode. Sie können die neueste Version von Django aus dem Quellcode beziehen und installieren. Dies wird für Anfänger nicht empfohlen, ist jedoch erforderlich, wenn Sie bereit sind, aktiv 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 Datenbanken PostgreSQL, MariaDB, MySQL, Oracle und SQLite, und es gibt Community-Bibliotheken, die unterschiedliche Unterstützung für andere populäre SQL- und NoSQL-Datenbanken bieten. Wir empfehlen, dass Sie für sowohl Produktion als auch Entwicklung dieselbe Datenbank auswählen (obwohl Django viele der Datenbankunterschiede mit seinem Objekt-Relationalen Mapper (ORM) abstrahiert, gibt es dennoch potenzielle Probleme, die besser vermieden werden).

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

Installation systemweit oder in einer Python-virtuellen Umgebung?

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

Wenn Sie Django in die Standard-/globale Umgebung installieren, können Sie auf dem Computer nur eine Version von Django anpeilen. Das kann ein Problem sein, wenn Sie neue Websites (mit der neuesten Version von Django) erstellen möchten, während Sie weiterhin Websites pflegen, die von älteren Versionen abhängig sind.

Daher führen erfahrene Python/Django-Entwickler Python-Apps typischerweise innerhalb unabhängiger Python-virtueller Umgebungen aus. Dies ermöglicht mehrere verschiedene Django-Umgebungen auf einem einzigen Computer. Das Django-Entwicklerteam selbst empfiehlt, dass Sie Python-virtuelle Umgebungen verwenden!

Dieses Modul geht davon aus, dass Sie Django in einer virtuellen Umgebung installiert haben, und wir werden Ihnen im Folgenden zeigen, wie.

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

In diesem Abschnitt wird kurz erläutert, wie Sie überprüfen können, welche Versionen von Python vorhanden sind, und bei Bedarf neue Versionen für Ubuntu Linux 20.04, macOS und Windows 10 installieren.

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 Tool (pip3), das Sie benötigen, um Pakete für Python 3 (einschließlich Django) zu installieren, ist jedoch nicht standardmäßig verfügbar. Sie können pip3 im Bash-Terminal installieren, indem Sie den folgenden Befehl verwenden:

sudo apt install python3-pip

macOS enthält standardmäßig nicht Python 3 (Python 2 ist in älteren Versionen enthalten). Sie können dies bestätigen, 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 Tool) leicht von python.org installieren:

1. Laden Sie das benötigte Installationsprogramm herunter:

   1. Gehen Sie zu https://www.python.org/downloads/macos/
   2. Laden Sie die stabile Version 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 im Finder und doppelklicken Sie auf die Paketdatei. Folgen Sie den Installationsanweisungen.

Sie können nun die erfolgreiche Installation bestätigen, indem Sie erneut python3 -V ausführen und die Python-Versionsnummer überprüfen.

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

pip3 list

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

1. Laden Sie das benötigte Installationsprogramm herunter:

   1. Gehen Sie zu https://www.python.org/downloads/windows/
   2. Laden Sie die stabile Version 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 mit der Bezeichnung "Add Python to PATH" zu aktivieren.

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 integriert pip3 (den Python-Paketmanager) standardmäßig. Sie können die installierten Pakete wie gezeigt auflisten:

py -3 -m pip list

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 installiert haben (und nicht Python 2), können die einfachen Befehle python und pip auf jedem Betriebssystem im Allgemeinen verwendet werden, um Python und pip 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 für die Verwendung von Version 3 Befehle mit python3 und pip3 auf Linux/macOS und py -3 und py -3 -m pip auf Windows voranstellen:

# Linux/macOS
python3 -V
pip3 -V

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

Die folgenden Anweisungen zeigen die plattformspezifischen Befehle, da sie auf mehr Systemen funktionieren.

Die Bibliotheken, die wir zur Erstellung unserer virtuellen Umgebungen verwenden, sind virtualenvwrapper (Linux und macOS) und virtualenvwrapper-win (Windows), die wiederum beide das virtualenv Tool verwenden. Die Wrapper-Tools erstellen eine konsistente Schnittstelle zur Verwaltung von Schnittstellen auf allen Plattformen.

Einrichtung der virtuellen Umgebung unter Ubuntu

Nachdem Sie Python und pip installiert haben, können Sie virtualenvwrapper (das virtualenv enthält) installieren. Der offizielle Installationsleitfaden kann hier gefunden werden, oder folgen Sie den unten stehenden Anweisungen.

Installieren Sie das Tool mit pip3:

sudo pip3 install virtualenvwrapper

Fügen Sie dann die folgenden Zeilen am Ende Ihrer Shell-Startdatei ein (dies ist eine versteckte Datei mit dem Namen .bashrc in Ihrem Home-Verzeichnis). Diese legen den Ort fest, an dem die virtuellen Umgebungen gespeichert werden sollen, den Ort Ihrer Entwicklungsprojektverzeichnisse und den Ort 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 neu, indem Sie den folgenden Befehl im Terminal ausführen:

source ~/.bashrc

An diesem Punkt sollten Sie sehen, dass eine Reihe von Skripten ausgeführt wird, 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 mit dem mkvirtualenv Befehl eine neue virtuelle Umgebung erstellen.

Einrichtung der virtuellen Umgebung unter macOS

Die Einrichtung von virtualenvwrapper auf macOS ist fast genau dieselbe wie unter Ubuntu (wieder können Sie den Anweisungen aus dem offiziellen Installationsleitfaden oder unten folgen).

Installieren Sie virtualenvwrapper (und das Paket virtualenv) mit pip wie gezeigt.

sudo pip3 install virtualenvwrapper

Fügen Sie dann die folgenden Zeilen am Ende Ihrer Shell-Startdatei hinzu (dies sind dieselben Zeilen wie für Ubuntu). Wenn Sie die zsh shell verwenden, dann wird die Startdatei eine versteckte Datei mit dem Namen .zshrc in Ihrem Home-Verzeichnis sein. Wenn Sie die bash shell verwenden, dann wird es eine versteckte Datei mit dem Namen .bash_profile sein. Sie müssen die Datei möglicherweise 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 neu, indem Sie den folgenden Aufruf im Terminal tätigen:

source ~/.bash_profile

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

cd ~  # Navigieren Sie zu meinem Heimatverzeichnis
ls -la # Listet den Inhalt des Verzeichnisses auf. Sie sollten .bash_profile sehen
nano .bash_profile # Öffnet die Datei im nano-Texteditor innerhalb des Terminals
# Blättern Sie zum Ende der Datei und kopieren Sie die obigen Zeilen
# Verwenden Sie Strg + X, um nano zu verlassen, und wählen Sie Y, um die Datei zu speichern.

Einrichtung der virtuellen Umgebung unter Windows

Die Installation von virtualenvwrapper-win ist noch einfacher als die Einrichtung von virtualenvwrapper, da Sie nicht konfigurieren müssen, wo das Tool Informationen zur virtuellen Umgebung 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 mit dem Befehl mkvirtualenv eine neue virtuelle Umgebung erstellen

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

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

mkvirtualenv my_django_environment

Sie sollten eine Ausgabe ähnlich der folgenden 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:~$

Jetzt befinden Sie sich innerhalb der virtuellen Umgebung und können Django installieren und mit der Entwicklung beginnen.

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

• deactivate — Verlassen der aktuellen Python-virtuellen Umgebung
• workon — Listen Sie die verfügbaren virtuellen Umgebungen auf
• workon name_of_environment — Aktivieren Sie die angegebene Python-virtuelle Umgebung
• rmvirtualenv name_of_environment — Entfernen Sie die angegebene Umgebung.

Sobald Sie eine virtuelle Umgebung erstellt und workon aufgerufen haben, um sie zu betreten, können Sie mit pip3 Django 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 prüft nur, ob Python das Django-Modul finden kann):

# Linux/macOS
python3 -m django --version

# Windows
py -3 -m django --version

py -m django --version

Quellcodeverwaltung (SCM) und Versionierungstools ermöglichen es Ihnen, zuverlässig Versionen Ihres Quellcodes zu speichern und wiederherzustellen, Änderungen auszuprobieren, und Code zwischen Ihren Experimenten und "bekannt gutem Code" zu teilen, wenn Sie ihn benötigen.

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

Git (und GitHub) verwenden Repositories ("Repos") als oberste "Eimer" 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 alle im Internet sichtbar, oder privat, in diesem Fall sind sie auf das Besitzunternehmen oder Benutzerkonto beschränkt.

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

Das Repo wird mit einem Standardbranch namens "main" erstellt. Sie können mit git andere Branches davon ableiten, die zunächst alle Commits des ursprünglichen Branches enthalten. Sie können Branches separat entwickeln, indem Sie Commits hinzufügen und später eine "Pull Request" (PR) auf GitHub verwenden, um Änderungen von einem Branch in einen anderen zu mergen. Sie können auch git verwenden, um zwischen Branches auf Ihrem lokalen Computer zu wechseln und beispielsweise verschiedene Dinge auszuprobieren.

Zusätzlich zu den Branches ist es möglich, auf jedem Branch tags zu erstellen und diesen Branch später zu diesem Zeitpunkt wiederherzustellen.

Zunächst erstellen wir ein Konto auf GitHub (dies ist kostenlos). Dann erstellen und konfigurieren wir ein Repository namens "django_local_library" zum Speichern der Local Library Website, während wir es im Verlauf dieses Tutorials weiterentwickeln.

Die Schritte sind:

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

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

3. Füllen Sie alle Felder in diesem Formular aus. Auch wenn diese nicht verpflichtend sind, sind sie stark zu empfehlen.

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

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

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

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

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

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

   • Aktivieren Sie Repository mit einer README initialisieren.

4. Drücken Sie Repository erstellen.

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

Da das Repository ("Repo") auf GitHub erstellt wurde, müssen wir es nun auf unseren lokalen Computer klonen (kopieren):

1. Klicken Sie auf GitHub auf die grüne Schaltfläche Code. 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 ungefähr so aussehen: https://github.com/<your_git_user_id>/django_local_library.git.

2. Installieren Sie git für Ihren lokalen Computer (Versionen für verschiedene Plattformen finden Sie hier).

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

   bashCopy to Clipboard

   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 Ordner des Repos.

   bashCopy to Clipboard

   cd django_local_library
   

Jetzt werden wir die .gitignore Datei auf dem lokalen Computer ändern, die Änderung festschreiben und das Repository auf GitHub aktualisieren. Dies ist eine nützliche Änderung, aber meistens machen wir es, um Ihnen zu zeigen, wie Sie Änderungen von GitHub abrufen, lokal Änderungen vornehmen und sie dann an GitHub senden.

1. In der Eingabeaufforderung/dem Terminal holen wir zuerst (holen) und ziehen dann (holen und in den aktuellen Branch zusammenführen) die neueste Version des Quellcodes von GitHub:

   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.

   bashCopy to Clipboard

   git fetch origin main
   git pull origin main
   

   Der "origin" ist ein Remote, das den Ort des Repos darstellt, an dem sich der Quellcode befindet, und "main" ist der Branch. 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 Branch ein, um unsere Änderungen zu speichern:

   bashCopy to Clipboard

   git checkout -b update_gitignore
   

   Der checkout Befehl wird verwendet, um einen Branch auszuwählen, der der aktuelle Branch ist, an dem Sie arbeiten. Das -b Flag gibt an, dass wir beabsichtigen, einen neuen Branch namens "update_gitignore" zu erstellen, anstatt einen vorhandenen Branch mit diesem Namen auszuwählen.

3. Öffnen Sie die .gitignore Datei, kopieren Sie die folgenden Zeilen ans Ende und speichern Sie die Datei:

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

   Beachten Sie, dass .gitignore verwendet wird, um Dateien anzugeben, die nicht automatisch von git 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 nicht von der .gitignore Datei ignoriert werden) in den "Staging-Bereich" für den aktuellen Branch hinzuzufügen.

   bashCopy to Clipboard

   git add -A
   

5. Verwenden Sie den status Befehl, um zu überprüfen, ob alle Dateien, die Sie commit möchten, korrekt sind (Sie möchten Quellcodedateien einfügen, keine Binärdateien, temporäre Dateien usw.). Es sollte ungefähr so aussehen wie die unten stehende Liste.

   bashCopy to Clipboard

   > 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, commit die Dateien in Ihr lokales Repo, verwenden Sie das -m Flag, um eine prägnante, aber klare Commit-Nachricht anzugeben. Dies entspricht dem Abzeichnen der Änderungen und deren offizieller Teil des lokalen Repos.

   bashCopy to Clipboard

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

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

   bashCopy to Clipboard

   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.

   Ein Banner sollte erscheinen mit einer Schaltfläche, die Sie auffordert, den gerade hochgeladenen Branch "Vergleichen und Pull-Anfrage" zu vergleichen. Wählen Sie die Schaltfläche aus und folgen Sie den Anweisungen, um eine Pull-Anfrage zu erstellen und dann zu mergen.

   

   Nach dem Zusammenführen enthält der "main" Branch im Repo auf GitHub Ihre Änderungen an .gitignore.

9. Sie können Ihr lokales Repo weiterhin aktualisieren, wenn sich Dateien mit diesem add/commit/push Zyklus ändern.

Im nächsten Thema werden wir dieses Repo verwenden, um den Quellcode unserer lokalen Bibliothekswebsite zu speichern.

Erfahrene Python-Entwickler installieren möglicherweise zusätzliche Tools, wie Linter (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-Linter (wie pylint) fälschlicherweise Fehler in den standardmäßigen Dateien melden, die für Django generiert wurden.

Der oben durchgeführte Test funktioniert, macht aber nicht viel Spaß. Ein interessanterer Test ist es, ein Grundgerüstprojekt zu erstellen und zu sehen, wie es funktioniert. Dazu navigieren Sie zunächst in Ihrer Eingabeaufforderung/Ihrem Terminal zu dem Ort, an dem Sie Ihre Django-Apps speichern möchten. Erstellen Sie einen Ordner für Ihre Testseite und navigieren Sie hinein.

mkdir django_test
cd django_test

Sie können dann eine neue standardmäßige Website namens "mytestsite" mit dem django-admin Tool erstellen, wie gezeigt. Nach der Erstellung der Seite können Sie in den Ordner navigieren, in dem Sie das Hauptskript zur Verwaltung von Projekten finden, das manage.py genannt wird.

django-admin startproject mytestsite
cd mytestsite

Wir können den Entwicklungs-Webserver aus diesem Ordner mit dem Befehl 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:

Sie haben jetzt eine Django-Entwicklungsumgebung auf Ihrem Computer eingerichtet und funktionsfähig.

Im Testabschnitt 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 werden wir diesen Prozess erweitern, um eine einfache, aber vollständige Webanwendung zu erstellen.

• Schneller Installationsleitfaden (Django-Dokumentation)
• Wie man Django installiert — Vollständiger Leitfaden (Django-Dokumentation) — beinhaltet auch, wie man Django entfernt
• Wie man Django auf Windows installiert (Django-Dokumentation)

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