virtualenvwrapper / docs / es / source / command_ref.rst

The default branch has multiple heads

Referencia de comandos

Todos los comandos a continuación son para ser utilizados en una Terminal de línea de comandos.

Administrar entornos

mkvirtualenv

Crea un nuevo entorno, dentro de WORKON_HOME.

Sintaxis:

mkvirtualenv [options] ENVNAME

Todas las opciones de línea de comandos son pasados diréctamente a virtualenv. El nuevo entorno es automáticamente activado luego de su inicialización.

$ workon
$ mkvirtualenv mynewenv
New python executable in mynewenv/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(mynewenv)$ workon
mynewenv
(mynewenv)$

rmvirtualenv

Elimina un entorno, dentro de WORKON_HOME.

Sintaxis:

rmvirtualenv ENVNAME

Debes usar :ref:`command-deactivate` antes de eliminar el entorno actual.

(mynewenv)$ deactivate
$ rmvirtualenv mynewenv
$ workon
$

cpvirtualenv

Duplica un entorno, dentro de WORKON_HOME.

Syntax:

cpvirtualenv ENVNAME TARGETENVNAME

Note

El entorno creado por la operación de copia es hecho reubicable.

$ workon
$ mkvirtualenv source
New python executable in source/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(source)$ cpvirtualenv source dest
Making script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/easy_install relative
Making script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/easy_install-2.6 relative
Making script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/pip relative
Script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/postactivate cannot be made relative (it's not a normal script that starts with #!/Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/python)
Script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/postdeactivate cannot be made relative (it's not a normal script that starts with #!/Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/python)
Script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/preactivate cannot be made relative (it's not a normal script that starts with #!/Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/python)
Script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/predeactivate cannot be made relative (it's not a normal script that starts with #!/Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/python)
(dest)$ workon
dest
source
(dest)$

Controlar los entornos activos

workon

Lista o cambia el entorno de trabajo actual

Sintaxis:

workon [environment_name]

Si no se especifica el environment_name la lista de entornos disponibles es impresa en la salida estándar.

$ workon
$ mkvirtualenv env1
  New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ mkvirtualenv env2
New python executable in env2/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env2)$ workon
env1
env2
(env2)$ workon env1
(env1)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ workon env2
(env2)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env2
(env2)$

deactivate

Cambia de un entorno virtual a la versión instalada de Python en el sistema.

Sintaxis:

deactivate

Note

Este comando es actualmente parte de virtualenv, pero es encapsulado para proveer ganchos antes y después, al igual que workon hace para activate.

$ workon
$ echo $VIRTUAL_ENV

$ mkvirtualenv env1
New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ deactivate
$ echo $VIRTUAL_ENV

$

Rápida navegación dentro de virtualenv

Existen dos funciones que proveen atajos para navegar dentro del virtualenv actualmente activado.

cdvirtualenv

Cambia el directorio de trabajo actual hacia $VIRTUAL_ENV.

Sintaxis:

cdvirtualenv [subdir]

Al llamar cdvirtualenv se cambia el directorio de trabajo actual hacia la sima de virtualenv ($VIRTUAL_ENV). Un argumento adicional es agregado a la ruta, permitiendo navegar diréctamente dentro de un subdirectorio.

$ mkvirtualenv env1
New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ cdvirtualenv
(env1)$ pwd
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ cdvirtualenv bin
(env1)$ pwd
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1/bin

cdsitepackages

Cambia el directorio de trabajo actual al site-packages del $VIRTUAL_ENV.

Sintaxis:

cdsitepackages [subdir]

Debido a que la ruta exacta hacia el directorio site-packages dentro del virtualenv depende de la versión de Python, cdsitepackages es provisto como un atajo para cdvirtualenv lib/python${pyvers}/site-packages. Un argumento opcional también está permitido, para especificar un directorio heredado dentro del directorio site-packages y así ingresar a este.

$ mkvirtualenv env1
New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ cdsitepackages PyMOTW/bisect/
(env1)$ pwd
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1/lib/python2.6/site-packages/PyMOTW/bisect

lssitepackages

lssitepackages muestra el contenido del directorio site-packages del entorno actualmente activado.

Sintaxis:

lssitepackages
$ mkvirtualenv env1
New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ $ workon env1
(env1)$ lssitepackages
distribute-0.6.10-py2.6.egg     pip-0.6.3-py2.6.egg
easy-install.pth                setuptools.pth

Administración de rutas

add2virtualenv

Agrega los directorios especificados al path de Python para el entorno virtual actualmente activo.

Sintaxis:

add2virtualenv directory1 directory2 ...

A veces esto es conveniente compartir paquetes instalados que no están en el directorio site-pacakges del sistema y no deben ser instalados en cada entorno virtual. Una posible solución es crear enláces simbólicos (symlinks) hacia el código dentro del directorio site-packages del entorno, pero también es fácil agregar a la variable PYTHONPATH directorios extras que están incluídos en los archivos .pth dentro de site-packages usando add2virtualenv.

  1. Descarga (check out) el código de un proyecto grande, como Django.
  2. Ejecuta: add2virtualenv path_to_source.
  3. Ejecuta: add2virtualenv.
  4. Un mensaje de uso y una lista de las rutas "extras" actuales es impreso.

Los nombres de los directorios son agregados a un archivo llamado virtualenv_path_extensions.pth dentro del directorio site-packages de este entorno.

Basado en una contribución de James Bennett y Jannis Leidel.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.