Personalizaciones por usuario¶
Los scripts de personalización de usuarios finales son incluidos uno por uno (permitiéndoles modificar su entorno de shell) o ejecutados como un programa externo en el momento apropiado.
Los scripts aplicados globalmente para todos los entornos deben ser ubicados en el directorio llamado VIRTUALENVWRAPPER_HOOK_DIR. Los scripts locales deben ser ubicados en el directorio bin del virtualenv.
get_env_details¶
Global/Local: ambos Argumento(s): env name Incluido/Ejecutado: ejecutado
$VIRTUALENVWRAPPER_HOOK_DIR/get_env_details es ejecutado cuando workon es ejecutado sin argumentos y una lista de entornos virtuales es impresa en pantalla. El gancho es ejecutado una vez por entorno, luego de que el nombre sea impreso, y puede imprimir información adicional sobre ese entorno.
initialize¶
Global/Local: global Argumento(s): ninguno Incluido/Ejecutado: incluido
$VIRTUALENVWRAPPER_HOOK_DIR/initialize es incluido cuando virtualenvwrapper.sh es cargado dentro de tu entorno. Usa este para ajustar configuraciones globales cuando virtualenvwrapper es habilitado.
premkvirtualenv¶
Global/Local: global Argumento(s): nombre de un nuevo virtualenv Incluido/Ejecutado: ejecutado
$VIRTUALENVWRAPPER_HOOK_DIR/premkvirtualenv es ejecutado como un programa externo luego que de un entorno virtual es creado pero antes de que el entorno actual sea cambiado para apuntar al nuevo entorno. El directorio de trabajo actual para este script es $WORKON_HOME y el nombre del nuevo entorno es pasado como argumento al script.
postmkvirtualenv¶
Global/Local: global Argumento(s): ninguno Incluido/Ejecutado: incluido
$VIRTUALENVWRAPPER_HOOK_DIR/postmkvirtualenv es incluido después de que un nuevo entorno es creado y activado. Si la opción -a <ruta_del_proyecto> es usada, el enlace hacia el directorio del proyecto es hecho antes de que el script sea incluido.
precpvirtualenv¶
Global/Local: global Argumento(s): nombre del entorno original, nombre del nuevo entorno Incluido/Ejecutado: ejecutado
$VIRTUALENVWRAPPER_HOOK_DIR/precpvirtualenv es ejecutado como un programa externo luego de que un entorno es duplicado y hecho reubicable, pero antes de que premkvirtualenv sea ejecutado o se haya cambiado al nuevo entorno creado. El directorio de trabajo actual para este script es $WORKON_HOME y los nombres del entorno original y el nuevo son pasados como argumento al script.
postcpvirtualenv¶
Global/Local: global Argumento(s): ninguno Incluido/Ejecutado: incluido
$VIRTUALENVWRAPPER_HOOK_DIR/postcpvirtualenv es incluido luego de que un nuevo entorno es creado y activado.
preactivate¶
Global/Local: global, local Argumento(s): nombre de entorno Incluido/Ejecutado: ejecutado
El script global $VIRTUALENVWRAPPER_HOOK_DIR/preactivate es ejecutado antes de que el nuevo entorno sea habilitado. El nombre de entorno es pasado como primer argumento.
El gancho $VIRTUAL_ENV/bin/preactivate es ejecutado antes de que el nuevo entorno sea habilitado. El nombre del entorno es pasado como primer argumento.
postactivate¶
Global/Local: global, local Argumento(s): ninguno Incluido/Ejecutado: incluido
El script global $VIRTUALENVWRAPPER_HOOK_DIR/postactivate es incluido luego de que el nuevo entorno sea habilitado. $VIRTUAL_ENV hace referencia al nuevo entorno al momento en el que se ejecuta el script.
Este script de ejemplo añade un espacio entre el nombre del entorno virtual y la tu variable PS1 haciendo uso de _OLD_VIRTUAL_PS1.
PS1="(`basename \"$VIRTUAL_ENV\"`) $_OLD_VIRTUAL_PS1"
El script local $VIRTUAL_ENV/bin/postactivate es incluido luego de que el nuevo entorno es habilitado. $VIRTUAL_ENV hace referencia al nuevo entorno al momento en el que el script es ejecutado.
Este script de ejemplo para el entorno PyMOTW cambia el directorio de trabajo actual y la referencia de la variable PATH hacia el árbol que contiene el código de PyMOTW.
pymotw_root=/Users/dhellmann/Documents/PyMOTW
cd $pymotw_root
PATH=$pymotw_root/bin:$PATH
predeactivate¶
Global/Local: local, global Argumento(s): ninguno Incluido/Ejecutado: incluido
El script local $VIRTUAL_ENV/bin/predeactivate es incluido antes de que el entorno actual sea desactivado, y puede ser usado para deshabilitar o limpiar configuraciones en tu entorno. $VIRTUAL_ENV hace referencia al entorno viejo al momento de ejecutar este script.
El script global $VIRTUALENVWRAPPER_HOOK_DIR/predeactivate es incluido antes de que el entorno actual sea desactivado. $VIRTUAL_ENV hace referencia al entorno viejo al momento de ejecutar este script.
postdeactivate¶
Global/Local: local, global Argumento(s): ninguno Incluido/Ejecutado: incluido
El script $VIRTUAL_ENV/bin/postdeactivate es incluido luego de que el entorno actual sea desactivado, y puede ser usado para deshabilitar o limpiar configuraciones en tu entorno. El path hacia el entorno que recientemente se ha desactivado está disponible en $VIRTUALENVWRAPPER_LAST_VIRTUALENV.
prermvirtualenv¶
Global/Local: global Argumento(s): nombre de entorno Incluido/Ejecutado: ejecutado
EL script $VIRTUALENVWRAPPER_HOOK_DIR/prermvirtualenv es ejecutado como un programa externo antes de que el entorno sea eliminado. El path absoluto hacia el entorno es pasado como argumento al script.
postrmvirtualenv¶
Global/Local: global Argumento(s): nombre de entorno Incluido/Ejecutado: ejecutado
El script $VIRTUALENVWRAPPER_HOOK_DIR/postrmvirtualenv es ejecutado como un programa externo luego de que el entorno sea eliminado. El path absoluto hacia el directorio del entorno es pasado como argumento al script.
premkproject¶
Global/Local: global Argumento(s): nombre del nuevo proyecto Incluido/Ejecutado: ejecutado
$WORKON_HOME/premkproject es ejecutado como un programa externo luego de que el entorno virtual es creado y luego de que el entorno actual es cambiado al nuevo entorno, pero antes de que el nuevo directorio de proyecto sea creado. El directorio de trabajo actual para el script es $PROJECT_HOME y el nombre del nuevo proyecto es pasado como argumento al script.
postmkproject¶
Global/Local: global Argumento(s): ninguno Incluido/Ejecutado: incluido
$WORKON_HOME/postmkproject es incluido luego de que el nuevo entorno y directorio de proyecto son creados y el virtualenv es activado. El directorio de trabajo es el directorio del proyecto.