virtualenv-sh

virtualenv-sh ist ein Ersatz für die ehrwürdige virtualenvwrapper & nbsp; (eine Reihe von Shell-Funktionen, um die Verwendung virtualenv zu erleichtern).
Entwickler-Kommentare
Wie viele andere, ich habe virtualenvwrapper seit Jahren verwendet, aber es ist ein wenig schwerer geworden im Laufe der Zeit. Schließlich fand ich mich zu lange warten für neue Schalen zu starten, auch wenn ich eher nur die Grundfunktionen.
Dieses Projekt ist ein Versuch, dieses Problem zu lösen. Ich lieh mir die clevere Bits virtualenvwrapper, verworfen, was ich als teuer oder einfach nicht interessant, und fügte hinzu, ein Feature oder zwei meiner eigenen. Die oberste Priorität des Projektes ist die Geschwindigkeit. Der Code ist fast reines Shell-Skript, auch wenn es ein oder zwei Aufrufe von Standard-Tools wie grep oder sed sein.
Seien Sie gewarnt, dass diese Umsetzung möglicherweise nicht für Sie sein. Ich kann bekommen eine Funktion, die Sie gerne loswerden können, sei es, weil es teuer war oder weil ich einfach nicht darum kümmern. Ich versehentlich weggeworfen haben eine Update oder eine Abhilfe für einige Umgebung, die ich noch nicht begegnet. Ich kann nur eingeführt haben, neue Fehler (Shell ist eine einfache Sprache zu Unrecht auf subtile Weise zu bekommen). Gehen Sie auf eigene Gefahr.
Installation
virtualenv-sh mit pip oder easy_install installiert werden. Um es zu nutzen, müssen Sie einen einzelnen Shell-Skript auf der Kommando beziehen. Standardmäßig pip oder easy_install sollte es zu installieren, um / usr / local / bin. Wenn Sie mit bash oder zsh, sollten Sie die Shell-spezifische Skript importieren; Andernfalls können Sie das generische Programm ausprobieren. Fügen Sie eine der folgenden Möglichkeiten, um Ihrer Shell Init-Skript (.bashrc, .zshrc, etc.):
. /usr/local/bin/virtualenv-sh.bash
. /usr/local/bin/virtualenv-sh.zsh
. /usr/local/bin/virtualenv-sh.sh
Mehr ist nicht nötig. Es gibt nur eine Umgebungsvariable, die Sie für die Konfiguration, die WORKON_HOME ist verwenden können. Dies ist ein Weg, um Ihre Sammlung von virutalenvs; können Sie leer lassen, um den Standardwert von $ {HOME} /. virtualenvs akzeptieren. Es wird angenommen, dass sich in Ihrem Pfad virtualenv.
WORKON_HOME = $ {HOME} /. Virtualenvs
zsh

Wenn Sie zsh, können Sie stattdessen die vorkompilierte Funktion Archiv für optimale Leistung, auch wenn dies muss von der Quelle auf Ihrem Rechner kompiliert werden. Sie können die Quelle direkt herunterladen oder versuchen Sie:
 pip installieren --upgrade --no-install virtualenv-sh
cd build / virtualenv-sh
sudo make install
Dies wird zsh in den Weg zu finden, verwenden Sie es, um virtualenv-sh.zwc zu kompilieren, und installieren Sie sie nach / usr / local / bin. Sie können nun Autoload diese Funktionen und initialisieren virtualenv-sh. Vielleicht möchten Sie den Abschnitt Funktion automatische Laden in der zsh Handbuch, wenn Sie mit diesem Verfahren nicht vertraut sind:
# Konfigurieren Sie alle virtualenv-sh-Funktionen für das automatische Laden
fBahn = (/ usr / local / bin / virtualenv-sh $ fBahn)
Autoload-w / usr / local / bin / sh virtualenv-
# Aufruf des Haupt Initialisierungsfunktion
virtualenv_sh_init
Mit
Die Grundbefehle virtualenv-sh sind im Wesentlichen die gleichen wie virtualenvwrapper. Hier ist eine kurze Zusammenfassung:
& Nbsp; mkvirtualenv
& Nbsp; Erstellt ein neues virtual_env in $ WORKON_HOME. Alle Argumente werden direkt geführt, um virtualenv. Die neue virtual_env wird aktiviert. Im Gegensatz zu virtualenvwrapper geschieht dies keine zusätzlichen Argumente.
& Nbsp; rmvirtualenv
& Nbsp; Löscht einen vorhandenen virtual_env. Wenn dies virtual_env gerade aktiv ist, wird es zunächst als unverbindlichen deaktiviert.
& Nbsp; WorkON []
& Nbsp; Aktiviert den Namen virtual_env. Wenn ein anderer virtual_env gerade aktiv ist, wird es zunächst deaktiviert werden. Ohne Argumente wird die verfügbaren virtual_envs aufzulisten.
& Nbsp; autoworkon
& Nbsp; wird automatisch die virtual_env basierend auf spezielle Dateien. Siehe unten.
& Nbsp; deaktivieren
& Nbsp; Deaktiviert die aktuelle virtual_env (wie bei der Verwendung virtualenv direkt).
& Nbsp; lsvirtualenvs
& Nbsp; Druckt eine Liste der von Ihnen erstellten virtual_envs.
& Nbsp; cdvirtualenv [Unterverzeichnis]
& Nbsp; Wechselt das aktuelle Verzeichnis in das Stammverzeichnis des aktiven virtual_env oder einem Unterverzeichnis davon.
& Nbsp; lssitepackages
& Nbsp; Listet den Inhalt des site-packages-Verzeichnis des aktiven virtual_env ist.
& Nbsp; cdsitepackages [Unterverzeichnis]
& Nbsp; Ändert die currect Verzeichnis in das site-packages-Verzeichnis des aktiven virtual_env oder einem Unterverzeichnis davon.
Hooks
virtualenv-sh unterstützt die gleichen globalen und lokalen (pro-env) Haken als virtualenvwrapper. Globale Haken sind Dateien in $ WORKON_HOME; lokalen Haken sind Dateien in $ WORKON_HOME / {virtual_env} / bin. Hooks sind Sourcing sie in der aktuellen Shell Kontext ausgeführt.
& Nbsp; initialisieren (global)
& Nbsp; am Ende virtualenv_sh_init aufgerufen.
& Nbsp; premkvirtualenv, postmkvirtualv, prermvirtualenv, postmkvirtualenv (global)
& Nbsp; am Anfang und Ende mkvirtualenv und rmvirtualenv aufgerufen.
& Nbsp; voraktivieren, postactivate (global, lokal); predeactivate, postdeactivate (lokal, global)
& Nbsp; in der rund um die Aktivierung und Deaktivierung eines virtual_env angegebenen Reihenfolge aufgerufen.
Darüber hinaus ermöglicht virtualenv-sh Sie dynamisch registrieren, um bei der Ausführung von Funktionen Haken aufgerufen werden:
virtualenv_sh_add_hook
virtualenv_sh_remove_hook
z.B .:
my_virtualenv_cleanup ()
{
& Nbsp; # Sind hier einige Sachen
}
virtualenv_sh_add_hook postdeactivate my_virtualenv_cleanup
Registrierte Hook-Funktionen werden immer nach allen globalen und lokalen Aktionsskripte ausgeführt.
autoworkon
autoworkon ist ein neuer Befehl, die entworfen ist, um Ihre virtual_env automatisch aktualisiert basierend auf Ihrem aktuellen Verzeichnis. Beachten Sie, dass es keine Standard-Shell-Mechanismus für die Ausführung einer Funktion, wenn die aktuellen Verzeichnisänderungen - und viele Muscheln nicht einen solchen Mechanismus haben - so der Installation ist bis zu Ihnen. Wenn Sie zsh buchen, benutzen Sie:
autoload -U Add-zsh-Haken
Add-zsh-Haken chpwd autoworkon
Die autoworkon Funktion wird aus dem aktuellen Verzeichnis zu Fuß bis das Dateisystem, bis sie entweder erreicht die Wurzel oder findet ein Element mit dem Namen ".workon". Wenn dies eine lesbare Datei, wird es die erste Zeile wie der Name eines virtual_env zu behandeln und zu aktivieren. Es gibt eine Reihe von besonderen Regeln zu beachten:
- Autoworkon Stellen immer an der ersten .workon es findet. Es ist durchaus sinnvoll, .workon Dateien an mehreren Punkten in einem Verzeichnisbaum, verschiedene virtual_envs auf unterschiedlichen Ebenen zu nutzen.
- Eine leere oder nicht lesbar .workon Datei wird als "keine virtual_env" interpretiert. Dies ist nützlich, wenn Sie die automatische virtual_env in einem bestimmten Teilbaum deaktivieren möchten.
- Wenn Sie eine virtual_env manuell zu aktivieren, wird autoworkon nie überschreiben. . autoworkon werden Ihre aktiven virtual_env ändern, wenn es nicht gesetzt ist oder zuvor mit autoworkon gesetzt

Anforderungen :

• Python