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.