virtualenv-sh

virtualenv-sh é um substituto para o venerável virtualenvwrapper & nbsp; (um conjunto de funções de shell para facilitar a utilização de virtualenv).
Comentários de Desenvolvedor
Como muitos, eu usei virtualenvwrapper há anos, mas que ficou um pouco pesado ao longo do tempo. Eu finalmente encontrei-me esperando muito tempo para novos escudos para o arranque, mesmo que eu tendia a usar apenas os recursos básicos.
Este projeto é uma tentativa de resolver esse problema. Peguei emprestado os bits inteligentes de virtualenvwrapper, descartado tudo o que eu considerado caro ou simplesmente não é interessante, e adicionou um recurso ou dois dos meus próprios. A prioridade número um deste projeto é a velocidade. O código é script shell quase puro, embora possa haver uma ou duas invocações de ferramentas padrão, como grep ou sed.
Esteja avisado que esta aplicação pode não ser para você. I pode ter se livrado de um recurso que você gostou, ou porque era caro ou porque eu simplesmente não se preocupam com isso. I pode ter acidentalmente descartada uma correção ou solução alternativa para algum ambiente que eu não encontrei. Talvez eu tenha apenas introduziu novos bugs (shell é uma língua fácil de errar de forma sutil). Prossiga por sua conta e risco.
Instalação
virtualenv-sh pode ser instalado com pip ou easy_install. Para usá-lo, você precisa de fonte de um único script shell em seu ambiente shell. Por padrão, pip ou easy_install deve instalá-lo em / usr / local / bin. Se você estiver usando bash ou zsh, você deve importar o script específico do reservatório; caso contrário, você pode tentar um genérico. Adicionar um dos seguintes procedimentos para script de inicialização do seu shell (.bashrc, .zshrc, etc.):
. /usr/local/bin/virtualenv-sh.bash
. /usr/local/bin/virtualenv-sh.zsh
. /usr/local/bin/virtualenv-sh.sh
Nada mais é necessário. Há apenas uma variável de ambiente que você pode usar para a configuração, que é WORKON_HOME. Este é um caminho para a sua coleção de virutalenvs; você pode deixá-lo em branco para aceitar o padrão de $ {HOME} /. virtualenvs. Supõe-se que VIRTUALENV está em seu caminho.
WORKON_HOME = $ {HOME} /. Virtualenvs
zsh

Se você estiver usando zsh, você pode passar a usar o arquivo de função pré-compilada para um ótimo desempenho, embora isso precisa ser compilado a partir do código em sua máquina. Você pode baixar a fonte direta ou tentar:
 pip instalar --upgrade --no-install virtualenv-sh
cd build / virtualenv-sh
sudo make install
Isso irá encontrar zsh em seu caminho, usá-lo para compilar virtualenv-sh.zwc, e instalá-lo em / usr / local / bin. Agora você pode autoLoad essas funções e inicializar virtualenv-sh. Você pode querer consultar a seção sobre a função carregamento automático no manual zsh se você não está familiarizado com este processo:
# Configurar todas as funções virtualenv-sh para carregamento automático
fpath = (/ usr / / bin / sh-virtualenv locais $ fpath)
autoload w / usr / local / bin / sh-virtualenv
# Chama a principal função de inicialização
virtualenv_sh_init
Usando
Os comandos básicos de virtualenv-sh são essencialmente os mesmos como virtualenvwrapper. Aqui está um breve resumo:
& Nbsp; mkvirtualenv
& Nbsp; Cria um novo virtual_env em $ WORKON_HOME. Todos os argumentos são passados ​​diretamente para VIRTUALENV. O novo virtual_env ficará ativo. Ao contrário virtualenvwrapper, este não tem argumentos adicionais.
& Nbsp; rmvirtualenv
& Nbsp; Exclui um virtual_env existente. Se este virtual_env está ativo no momento, ele é desativado pela primeira vez como uma cortesia.
& Nbsp; workon []
& Nbsp; Ativa o virtual_env nomeado. Se outro virtual_env está ativo no momento, ela será desativada em primeiro lugar. Sem argumentos, ele irá listar os virtual_envs disponíveis.
& Nbsp; autoworkon
& Nbsp; configura automaticamente a virtual_env baseado em arquivos especiais. Veja abaixo.
& Nbsp; desativar
& Nbsp; Desativa o virtual_env atual (como ao usar virtualenv diretamente).
& nbsp; lsvirtualenvs
& Nbsp; Imprime uma lista dos virtual_envs que você criou.
& Nbsp; cdvirtualenv [subdir]
& Nbsp; Muda o diretório atual para a raiz do virtual_env ativa, ou em um subdiretório do mesmo.
& nbsp; lssitepackages
& Nbsp; Lista o conteúdo do diretório site-packages da virtual_env ativa.
& Nbsp; cdsitepackages [subdir]
& Nbsp; Muda o diretório currect para o diretório site-packages da virtual_env ativa, ou em um subdiretório do mesmo.
Hooks
virtualenv-sh suporta os mesmos global e local (per-env) ganchos como virtualenvwrapper. Ganchos globais são arquivos em $ WORKON_HOME; ganchos locais são arquivos em $ WORKON_HOME / {virtual_env} / bin. Hooks são executados com a terceirização-los no contexto shell atual.
& Nbsp; inicializar (global)
& Nbsp; Chamado no final de virtualenv_sh_init.
& Nbsp; premkvirtualenv, postmkvirtualv, prermvirtualenv, postmkvirtualenv (global)
& Nbsp; Chamado no início e no final de mkvirtualenv e rmvirtualenv.
& Nbsp; preactivate, postactivate (global e local); predeactivate, postdeactivate (local e global)
& Nbsp; Chamado pela ordem indicada em torno de ativação e desativação de uma virtual_env.
Além disso, virtualenv-sh permite registrar dinamicamente funções a ser chamado quando a execução de ganchos:
virtualenv_sh_add_hook
virtualenv_sh_remove_hook
g .:
my_virtualenv_cleanup ()
{
& Nbsp; # faz alguma coisa aqui
}
virtualenv_sh_add_hook postdeactivate my_virtualenv_cleanup
Funções de gancho registrados são sempre executadas depois de todos os scripts globais e locais de gancho.
autoworkon
autoworkon é um novo comando que é projetado para automaticamente atualizar o seu virtual_env com base no seu diretório atual. Note-se que não há nenhum mecanismo shell padrão para a execução de uma função quando as atuais mudanças no diretório - e muitas conchas não têm esse mecanismo - para instalar este é com você. Se você estiver usando zsh, você usaria:
autoload -U add-zsh-hook
add-zsh-hook chpwd autoworkon
A função autoworkon vai a pé até o sistema de arquivos do diretório atual até que ele quer atingir a raiz, ou encontrar um item chamado ".workon". Se este é um arquivo legível, ele vai tratar a primeira linha como o nome de um virtual_env e ativá-lo. Há um par de regras especiais para se manter em mente:
- Autoworkon sempre pára no primeiro .workon que encontra. É perfeitamente razoável ter arquivos .workon em múltiplos pontos em uma árvore de diretórios de usar diferentes virtual_envs em diferentes níveis.
- Um arquivo .workon vazio ou ilegível é interpretado como "não virtual_env". Isso é útil se você quiser desativar o virtual_env automática em uma sub-árvore particular.
- Se você ativar um virtual_env manualmente, autoworkon nunca vai substituí-lo. . autoworkon só vai mudar a sua virtual_env ativa se ela não for desativada ou se foi previamente definido por autoworkon

Requisitos :

• Python