Um einen Beitrag leisten zu können, müssen Sie sich eine Entwicklungsumgebung einrichten - einen Ort, an dem Sie am Code arbeiten können, wo er sich genauso verhält wie die Umgebung der anderen.

Viele Teile von BeeWare verwenden die gleichen Werkzeuge: eine spezielle Version von Python, und die Steuerung der virtuellen Umgebung.

Python

Python ist eine Skriptsprache, die auf einer Reihe von verschiedenen Betriebssystemen verfügbar ist. Doch je nachdem, welches System Sie wird Ihre Python-Version unterschiedlich sein. Aus diesem Grund geben wir genau an, mit welcher Version von Python der Code funktionieren soll. funktionieren soll.

Bei den folgenden Anweisungen gehen wir davon aus, dass Sie genau wissen genau wissen, welche Version von Python Sie installieren müssen. Normalerweise ist dies in der Datei README.md oder in den Informationen des Tutorials aufgeführt. Unser CI Systeme müssen wissen genau wissen, welche Version von Python benötigt wird. Wenn Sie also wirklich feststecken, schauen Sie in der Datei .github/workflows/ci.yml nach der Version, die Sie benötigen.

Um zu BeeWare beitragen zu können, müssen Sie einen Python Interpreter auf Ihrem Rechner installiert haben. Auf macOS und Windows empfehlen wir empfehlen wir die Verwendung des offiziellen Python.org Installer; unter Linux empfehlen wir die Version von Python zu verwenden, die vom Paketmanager für Ihre Distribution bereitstellt.

Virtuelle Umgebungen

Wenn Python installiert wird, stellt es eine einzige globale Umgebung zur Verfügung. Durch wenn Sie ein Paket installieren, wird es standardmäßig in diese globale Umgebung installiert.

Wenn Sie jedoch an mehr als einem Python-Projekt arbeiten, ist es ist es sehr wahrscheinlich, dass diese verschiedenen Projekte unterschiedliche - und und in manchen Fällen sogar widersprüchliche Anforderungen haben. Was Sie brauchen, ist eine Möglichkeit, um jedes Projekt zu isolieren, so dass die Installation eines Pakets für ein Projekt nicht die Installation desselben Pakets für das zweite Projekt erzwingt.

Dies geschieht mit Hilfe von virtuellen Umgebungen. Eine virtuelle Umgebung, oder ist eine isolierte Umgebung, die leicht erstellt, zerstört oder wiederhergestellt werden kann. oder neu erstellt werden kann. Jedes Paket, das in der virtuellen Umgebung installiert wird, ist nur nur innerhalb dieser virtuellen Umgebung zugänglich. Virtuelle Umgebungen werden manchmal als "Sandkasten" bezeichnet - ein sicherer Ort zum Spielen, wo man, wenn man einen Fehler macht, kann man alles, was man aufgebaut hat, abreißen und von neu beginnen.

Python bietet das Modul venv, um neue virtuelle Umgebungen zu erstellen. Jede virtuelle Umgebung hat einen Namen, der verwendet werden kann, um die Umgebung zu identifizieren. Um eine neue virtuelle Umgebung mit dem Namen "my-venv" zu erstellen, führen Sie aus:

$ python -m venv mein-venv

Die Version von Python, die Sie zur Erstellung der virtuellen Umgebung verwenden verwenden, ist die Version, die standardmäßig innerhalb der virtuellen Umgebung verwendet wird. Umgebung verwendet wird. Wenn Sie mehrere Python-Versionen installiert haben, oder Sie ein Werkzeug wie pyenv zur Verwaltung von Python-Versionen verwenden, stellen Sie sicher, dass die Python-Version, die gerade aktiv ist (oder die Version, auf die Sie wenn Sie den Befehl -m venv aufrufen) die Version ist, die Sie beabsichtigen. Sobald eine virtuelle Umgebung erstellt wurde, können Sie die verwendete Python-Version nicht mehr Version, die sie verwendet, nicht mehr ändern. Um die Python-Version zu ändern, müssen Sie eine neue virtuelle Umgebung erstellen.

Der Aufruf von -m venv wird die virtuelle Umgebung erzeugen, aber die Umgebung ist aber noch nicht aktiv. Die virtuelle Umgebung ist eine Sammlung von Dateien auf der Festplatte, die in einem Verzeichnis gespeichert sind, das dem Namen der Umgebung entspricht. Um die virtuelle Umgebung zu aktivieren, führen Sie eine der Dateien aus, die als Teil der Umgebung erzeugt wurden:

$ source my-venv/bin/activate

Dies führt dazu, dass der Befehlszeilenaufforderung ein Präfix hinzugefügt wird hinzugefügt, das Ihnen mitteilt, dass Sie sich in einer virtuellen Umgebung befinden:

(my-venv) $

Solange die virtuelle Umgebung aktiv ist, wirkt sich jeder pip install-Befehl nur die virtuelle Umgebung beeinflussen. Es spielt keine Rolle, ob Sie die Verzeichnisse wechseln - wenn Ihr Prompt ein Präfix hat, ist die virtuelle Umgebung aktiv.

Wenn Sie ein zweites Terminalfenster öffnen, wird die Umgebung nicht aktiv sein aktiv - Sie müssen die Umgebung in jeder Terminalsitzung, in der Sie die Sitzung, in der Sie die Umgebung verwenden wollen, erneut aktivieren. Wenn Sie Fehler erhalten über Bibliotheken nicht verfügbar sind, von denen Sie sicher sind, dass Sie sie installiert haben - überprüfen Sie, ob Ihre virtuelle Umgebung aktiv ist.

Um die virtuelle Umgebung zu deaktivieren, führen Sie aus:

(mein-venv) $ deaktivieren

Nach der Deaktivierung wird das Präfix aus der Eingabeaufforderung entfernt.