virtualenv-sh

virtualenv-sh est un substitut pour le vénérable virtualenvwrapper & nbsp; (un ensemble de fonctions de shell pour faciliter l'utilisation de virtualenv).
commentaires de développeurs
Comme beaucoup, je ai utilisé virtualenvwrapper des années, mais ce est devenu un peu lourd au fil du temps. Je ai finalement trouvé me attendre trop longtemps pour les nouveaux obus de démarrer, même si je avais tendance à ne utiliser que les fonctions de base.
Ce projet est une tentative pour résoudre ce problème. Je ai emprunté les bits astucieux de virtualenvwrapper, rejeté tout ce que je considère comme coûteux ou tout simplement pas intéressant, et a ajouté une fonction ou deux de ma propre. La priorité numéro un de ce projet est la vitesse. Le code script shell est presque pur, bien qu'il puisse y avoir un ou deux invocations d'outils standard tels que grep ou sed.
Soyez averti que cette mise en œuvre ne peut pas être pour vous. Je ai réussi à se débarrasser d'une fonctionnalité que vous aimez, soit parce que ce était cher ou parce que je ne avais pas en soucie. Je ai accidentellement jeté un correctif ou solution de contournement pour un certain environnement que je ne ai pas rencontré. Je viens de présenter de nouveaux bogues (coquille est une langue facile de se tromper de manière subtile). Procéder à vos propres risques.
Installation
virtualenv-sh peut être installé avec pip ou easy_install. Pour l'utiliser, vous devez la source d'un script shell simple dans votre environnement shell. Par défaut, PIP ou easy_install devrait l'installer dans / usr / local / bin. Si vous utilisez bash ou zsh, vous devez importer le script spécifique au shell; Sinon, vous pouvez essayer le générique. Ajouter une des actions suivantes au script d'initialisation de votre shell (.bashrc, .zshrc, etc.):
. /usr/local/bin/virtualenv-sh.bash
. /usr/local/bin/virtualenv-sh.zsh
. /usr/local/bin/virtualenv-sh.sh
Rien d'autre ne est nécessaire. Il ya seulement une variable d'environnement que vous pouvez utiliser pour la configuration, qui est WORKON_HOME. Ce est un chemin à votre collection de virutalenvs; vous pouvez laisser le champ vide pour accepter la valeur par défaut de $ {HOME} /. virtualenvs. Il est supposé que virtualenv lui-même est dans votre chemin.
WORKON_HOME = $ {HOME} /. Virtualenvs
zsh

Si vous utilisez zsh, vous pouvez utiliser à la place l'archive de fonction précompilé pour des performances optimales, même si cela doit être compilé à partir des sources sur votre machine. Vous pouvez télécharger le code source directement ou essayer:
 pip installer --upgrade --no-install-sh virtualenv
cd build / virtualenv-sh
sudo make install
Cette trouverez zsh dans votre chemin, l'utiliser pour compiler virtualenv-sh.zwc, et l'installer dans / usr / local / bin. Vous pouvez maintenant autoLoad ces fonctions et initialiser virtualenv-sh. Vous pouvez vous référer à la section sur la fonction chargement automatique dans le manuel zsh si vous n'êtes pas familier avec ce processus:
# Configurer toutes les fonctions virtualenv-SH pour le chargement automatique
fpath = (/ usr / bin / sh-virtualenv / local $ fpath)
autoload -w / usr / local / bin / sh-virtualenv locale
# Appelez la fonction principale d'initialisation
virtualenv_sh_init
Utilisation
Les commandes de base de virtualenv-sh sont essentiellement les mêmes que virtualenvwrapper. Voici un bref récapitulatif:
& Nbsp; mkvirtualenv
& Nbsp; Crée un nouveau virtual_env en $ WORKON_HOME. Tous les arguments sont passés directement à virtualenv. Le nouveau virtual_env devient actif. Contrairement virtualenvwrapper, ce ne prend aucun argument supplémentaires.
& Nbsp; rmvirtualenv
& Nbsp; Supprime un virtual_env existant. Si ce virtual_env est actuellement actif, il est désactivé premier titre de courtoisie.
& Nbsp; workon []
& Nbsp; Active le virtual_env nommé. Si un autre virtual_env est actuellement active, elle sera désactivée premier. Sans arguments, il liste les virtual_envs disponibles.
& Nbsp; autoworkon
& Nbsp; définit automatiquement la virtual_env basée sur des fichiers spéciaux. Voir ci-dessous.
& Nbsp; désactiver
& Nbsp; désactive l'virtual_env actuelle (comme lors de l'utilisation virtualenv directement).
& nbsp; lsvirtualenvs
& Nbsp; Imprime une liste des virtual_envs que vous avez créés.
& Nbsp; cdvirtualenv [subdir]
& Nbsp; Modifie le répertoire courant à la racine de la virtual_env actif, ou un sous-répertoire de celui-ci.
& nbsp; lssitepackages
& Nbsp; Affiche le contenu de site-packages le répertoire du virtual_env active.
& Nbsp; cdsitepackages [subdir]
& Nbsp; Change le répertoire currect dans le répertoire site-packages de la virtual_env actif, ou un sous-répertoire de celui-ci.
Crochets
virtualenv-sh prend en charge les mêmes global et local (par-env) crochets que virtualenvwrapper. Crochets mondiaux sont des fichiers dans WORKON_HOME $; crochets locales sont des fichiers dans $ WORKON_HOME / {} virtual_env / bin. Crochets sont exécutées par les approvisionner dans le contexte de shell courant.
& Nbsp; initialiser (global)
& Nbsp; Appelé à la fin de virtualenv_sh_init.
& Nbsp; premkvirtualenv, postmkvirtualv, prermvirtualenv, postmkvirtualenv (global)
& Nbsp; Appelé au début et à la fin de mkvirtualenv et rmvirtualenv.
& Nbsp; Préactivation, postactivate (global et local); predeactivate, postdeactivate (locale, globale)
& Nbsp; Appelé dans l'ordre indiqué dans l'activation et la désactivation d'un virtual_env.
En outre, virtualenv-sh vous permet d'enregistrer dynamiquement les fonctions d'être appelé lors de l'exécution des crochets:
virtualenv_sh_add_hook
virtualenv_sh_remove_hook
e.g .:
my_virtualenv_cleanup ()
{
& Nbsp; # faire des choses ici
}
virtualenv_sh_add_hook postdeactivate my_virtualenv_cleanup
Fonctions de crochet enregistrés sont toujours exécutées après tous les scripts globaux et locaux crochet.
autoworkon
autoworkon est une nouvelle commande qui est conçu pour mettre à jour automatiquement votre virtual_env en fonction de votre répertoire courant. Notez qu'il n'y a pas de mécanisme de shell standard pour exécuter une fonction lorsque les modifications du répertoire courant - et de nombreux obus ne ont pas un tel mécanisme - afin d'installer ce est à vous. Si vous utilisez zsh, vous devez utiliser:
autoload -U add-zsh-crochet
ajoutez-zsh-crochet chpwd autoworkon
La fonction de autoworkon va remonter le système de fichiers du répertoire courant jusqu'à ce qu'il soit atteint la racine ou trouve une option nommée ".workon". Si ce est un fichier lisible, elle sera traitée la première ligne que le nom d'un virtual_env et activez-le. Il ya un couple de règles spéciales pour garder à l'esprit:
- Autoworkon se arrête toujours à la première .workon qu'il trouve. Il est parfaitement raisonnable d'avoir des fichiers .workon à de multiples points dans une arborescence de répertoires à utiliser différents virtual_envs à différents niveaux.
- Un fichier .workon vide ou illisible est interprété comme "pas virtual_env". Ce est utile si vous souhaitez désactiver le virtual_env automatique dans un sous-arbre particulier.
- Si vous activez un virtual_env manuellement, autoworkon ne sera jamais la remplacer. . autoworkon ne changer votre virtual_env actif se il est inexistant ou a déjà été fixé par autoworkon

Exigences :

• Python