virtualenv-sh

virtualenv-sh är ett substitut för den ärevördiga virtualenvwrapper & nbsp; (en uppsättning skalfunktioner för att underlätta användningen av virtualenv).
Utvecklare kommentarer
Liksom många, har jag använt virtualenvwrapper åratal, men det har blivit lite tungt över tiden. Jag hittade till slut mig själv väntar alltför länge för nya tankar att starta upp, trots att jag tenderade att bara använda de grundläggande funktionerna.
Detta projekt är ett försök att lösa det problemet. Jag lånade de smarta bitar av virtualenvwrapper, kasse allt jag ansåg dyra eller bara inte intressant, och lagt till en funktion eller två av mina egna. Den främsta prioriteringen för detta projekt är hastigheten. Koden är nästan rent skalskript, även om det kan finnas en eller två anrop av standardverktyg som grep eller sed.
Varnas att denna tillämpning inte kan vara för dig. Jag kan ha gjort sig av en funktion som du gillade, antingen för att det var dyrt eller för att jag bara inte bryr sig om det. Jag kanske har av misstag kastas en fix eller lösning för vissa miljö som jag inte har stött på. Jag kanske har just infört nya buggar (skal är ett enkelt språk för att göra fel på ett subtilt sätt). Fortsätt på egen risk.
Installera
virtualenv-sh kan installeras med pip eller easy_install. För att använda den, måste du köpa en enda skalskript i din skalmiljö. Som standard pip eller easy_install bör installera den till / usr / local / bin. Om du använder bash eller zsh, bör du importera skalet specifika manus; annars kan du prova den generiska ett. Lägg till en av följande för att ditt skal init script (.bashrc, .zshrc, etc.):
. /usr/local/bin/virtualenv-sh.bash
. /usr/local/bin/virtualenv-sh.zsh
. /usr/local/bin/virtualenv-sh.sh
Inget annat krävs. Det finns bara en miljövariabel som du kan använda för konfiguration, vilket är WORKON_HOME. Detta är en väg till din samling av virutalenvs; Du kan lämna det tomt för att acceptera standard på $ {HOME} /. virtualenvs. Det antas att virtualenv själv är i din väg.
WORKON_HOME = $ {HOME} /. Virtualenvs
zsh

Om du använder zsh, kan du istället använda funktionen arkivet förkompilerade för optimal prestanda, även om detta måste sammanställas från källan på din maskin. Du kan ladda ner källkoden direkt eller prova:
 PIP installera --upgrade --no-install virtualenv-sh
CD build / virtualenv-sh
sudo make install
Detta kommer att finna zsh i din väg, använda den för att sammanställa virtualenv-sh.zwc och installera det på / usr / local / bin. Nu kan du autoload dessa funktioner och initiera virtualenv-sh. Du kanske vill se avsnittet om funktions automatisk laddning i zsh manualen om du inte är bekant med denna process:
# Konfigurera alla virtualenv-sh funktioner för automatisk laddning
fpath = (/ usr / local / bin / virtualenv-sh $ fpath)
autoload -w / usr / local / bin / virtualenv-sh
# Ring huvud initiering funktionen
virtualenv_sh_init
Använda
De grundläggande kommandon för virtualenv-sh är i princip samma som virtualenvwrapper. Här är en kort resumé:
& Nbsp; mkvirtualenv
& Nbsp; Skapar en ny virtual_env i $ WORKON_HOME. Alla argument skickas direkt till virtualenv. Den nya virtual_env blir aktiv. Till skillnad virtualenvwrapper, tar detta inga ytterligare argument.
& Nbsp; rmvirtualenv
& Nbsp; Raderar en befintlig virtual_env. Om detta virtual_env är aktiv, är det avaktiveras först som en artighet.
& Nbsp; workon []
& Nbsp; Aktiverar namngivna virtual_env. Om en annan virtual_env är aktiv, inaktiveras den första. Utan argument, kommer det att lista de tillgängliga virtual_envs.
& Nbsp; autoworkon
& Nbsp; Ställer automatiskt virtual_env utifrån speciella filer. Se nedan.
& Nbsp; inaktivera
& Nbsp; Stänger aktuell virtual_env (som när du använder virtualenv direkt).
& nbsp; lsvirtualenvs
& Nbsp; Skriver ut en lista över de virtual_envs du har skapat.
& Nbsp; cdvirtualenv [subdir]
& Nbsp; Ändrar den aktuella katalogen till roten av det aktiva virtual_env, eller en underkatalog därav.
& nbsp; lssitepackages
& Nbsp; Listar innehållet i den aktiva virtual_env s platsförpackningar katalog.
& Nbsp; cdsitepackages [subdir]
& Nbsp; Ändrar tillfället aktuella katalogen till den platsförpackningar katalog av den aktiva virtual_env, eller en underkatalog därav.
Krokar
virtualenv-sh stöder samma globala och lokala (per-env) krokar som virtualenvwrapper. Globala krokar är filer i $ WORKON_HOME; lokala krokar är filer i $ WORKON_HOME / {virtual_env} / bin. Krokar utförs av sourcing dem i det aktuella skalet sammanhanget.
& Nbsp; initiera (global)
& Nbsp; Ringde i slutet av virtualenv_sh_init.
& Nbsp; premkvirtualenv, postmkvirtualv, prermvirtualenv, postmkvirtualenv (global)
& Nbsp; Ringde i början och slutet av mkvirtualenv och rmvirtualenv.
& Nbsp; Föraktivera, postactivate (global, lokal); predeactivate, postdeactivate (lokalt, globalt)
& Nbsp; Kallas i den ordning som anges kring aktivering och avaktivering av en virtual_env.
Dessutom kan virtualenv-sh dig att dynamiskt registrera funktioner som skall kallas vid utförande krokar:
virtualenv_sh_add_hook
virtualenv_sh_remove_hook
t.ex .:
my_virtualenv_cleanup ()
{
& Nbsp; # Göra en del grejer här
}
virtualenv_sh_add_hook postdeactivate my_virtualenv_cleanup
Registrerade krokfunktioner förs alltid efter alla globala och lokala krok skript.
autoworkon
autoworkon är ett nytt kommando som är utformad för att automatiskt uppdatera din virtual_env baserat på din nuvarande katalog. Observera att det inte finns någon standard skal mekanism för att köra en funktion när de nuvarande katalog förändringar - och många skal inte har en sådan mekanism - så installerar detta är upp till dig. Om du använder zsh, skulle du använda:
autoload -U add-zsh-hook
add-zsh-hook chpwd autoworkon
Den autoworkon Funktionen kommer att gå upp filsystemet från den aktuella katalogen tills den antingen når roten eller finner ett objekt som heter ".workon". Om detta är en läsbar fil, kommer den att behandla den första raden som namnet på en virtual_env och aktivera den. Det finns ett par speciella regler att tänka på:
- Autoworkon alltid stannar vid första .workon den hittar. Det är helt rimligt att ha .workon filer på flera punkter i ett katalogträd att använda olika virtual_envs på olika nivåer.
- En tom eller oläsbar .workon filen tolkas som "ingen virtual_env". Detta är användbart om du vill avaktivera den automatiska virtual_env i en viss underträd.
- Om du aktiverar en virtual_env manuellt kommer autoworkon aldrig åsidosätta det. . autoworkon kommer bara ändra din aktiva virtual_env om det är urkopplat eller var tidigare genom autoworkon

Krav :

• Python