Was ist pyenv und warum brauchen Sie es?

pyenv ist ein einfaches, aber leistungsstarkes Tool, mit dem Sie mehrere Python-Versionen auf Ihrem System verwalten können. Als Python-Entwickler müssen Sie häufig an verschiedenen Projekten arbeiten, die unterschiedliche Python-Versionen erfordern. Die manuelle Verwaltung dieser Versionen kann umständlich und fehleranfällig sein. Hier kommt pyenv ins Spiel, das den Wechsel zwischen Python-Versionen erleichtert und sicherstellt, dass Ihre Projekte immer mit der richtigen Version ausgeführt werden.

Warum pyenv verwenden?

• Versionsverwaltung: Mühelose Installation und Wechsel zwischen verschiedenen Python-Versionen.

• Projektisolation: Stellen Sie sicher, dass jedes Projekt die richtige Python-Version verwendet, um Kompatibilitätsprobleme zu vermeiden.

• Flexibilität: Testen Sie Ihren Code ganz einfach auf mehreren Python-Versionen.

Wenn Sie jemals Probleme mit Versionskonflikten hatten oder sowohl mit Python 2.x als auch mit 3.x auf demselben Computer arbeiten mussten, werden Sie es zu schätzen wissen, wie pyenv Ihren Entwicklungsworkflow vereinfacht.

Pyenv mit Poesie integrieren

pyenv funktioniert hervorragend mit Poetry, einem Tool, das Abhängigkeiten und Python-Umgebungen verwaltet. Wenn Sie bereits mit Poetry vertraut sind (und wenn nicht, lesen Sie meinen Artikel zum Einstieg in Poetry), werden Sie feststellen, dass Sie durch die Kombination mit pyenv noch mehr Kontrolle über Ihre Projekte haben.

Wenn Sie mit Poetry ein neues Projekt erstellen, wird automatisch die Python-Version verwendet, die pyenv für das Verzeichnis festgelegt hat. Dadurch wird sichergestellt, dass Ihre Projektabhängigkeiten in einer Umgebung verwaltet werden, die den Anforderungen Ihres Projekts entspricht.

Pyenv installieren

Beginnen wir mit der Installation von pyenv. Der Installationsvorgang variiert je nach Betriebssystem.

Auf macOS

Homebrew verwenden:

brew update
brew install pyenv

Um zu verhindern, dass sie versehentlich mit einem von Pyenv bereitgestellten Python verknüpft werden, fügen Sie die folgende Zeile in die Konfiguration Ihrer interaktiven Shell ein:

• Bash/Zsh:

alias brew='env PATH="${PATH//$(pyenv root)\/shims:/}" brew'

• Fisch:

alias brew="env PATH=(string replace (pyenv root)/shims '' \"\$PATH\") brew"

Unter Linux

• Curl verwenden:

curl https://pyenv.run | bash

Fügen Sie nach der Installation Folgendes zu Ihrer Shell-Konfigurationsdatei hinzu (z. B. .bashrc, .zshrc):

export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

• Verwenden des Paketmanagers Unter Arch Linux kann es mit Hilfe von Pacman installiert werden

sudo pacman -S pyenv

Fügen Sie die Befehle zu ~/.bashrc hinzu, indem Sie Folgendes in Ihrem Terminal ausführen:

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

Für Zsh:

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

Für Fisch:
Wenn Sie Fish 3.2.0 oder neuer haben, führen Sie dies interaktiv aus:

set -Ux PYENV_ROOT $HOME/.pyenv
fish_add_path $PYENV_ROOT/bin

Andernfalls führen Sie das folgende Snippet aus:

set -Ux PYENV_ROOT $HOME/.pyenv
set -U fish_user_paths $PYENV_ROOT/bin $fish_user_paths

Fügen Sie dies nun zu ~/.config/fish/config.fish hinzu:

pyenv init - | source

Weitere Informationen finden Sie auf GitHub.

Mit Pyenv

1) Überprüfen der Python-Version

So überprüfen Sie die aktuell verwendete Python-Version:

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)

2) Python-Versionen installieren

Mit pyenv können Sie jede Version von Python einfach installieren:

❯ pyenv install 3.11.9

Nach der Installation einer Python-Version kann diese global oder lokal für ein Projekt festgelegt werden

3) Festlegen der globalen Python-Version

Nicht empfohlen, kann Probleme mit Ihrem System verursachen
Sie können eine globale Python-Version festlegen, die standardmäßig in Ihrem System verwendet wird:

pyenv global 3.10.6 

4) Festlegen der lokalen Python-Version

Sie können auch eine lokale Python-Version für ein bestimmtes Projektverzeichnis festlegen. Diese Version überschreibt die globale Version, wenn Sie sich in diesem Verzeichnis befinden:

❯ pyenv local 3.8.10

❯ pyenv versions
  system
* 3.11.9 (set by /home/shanu/test_folder/.python-version)

❯ python -V
Python 3.11.9 (my global version is 3.12.5)

Um es zu deaktivieren, führen Sie einfach Folgendes aus:

❯ pyenv local --unset

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)
  3.11.9

❯ python -V
Python 3.12.5

5) Python-Versionen deinstallieren

So deinstallieren Sie eine Python-Version, die nicht mehr benötigt wird:

pyenv uninstall 3.11.9

Abschluss

Pyenv ist ein unschätzbar wertvolles Werkzeug für Python-Entwickler, insbesondere wenn es in Verbindung mit Poetry verwendet wird. Durch die mühelose Verwaltung von Python-Versionen können Sie sich auf das Schreiben von Code konzentrieren, anstatt sich über Versionskonflikte Gedanken zu machen. Probieren Sie es in Ihrem nächsten Python-Projekt aus!