|
| 1 | +=========== |
| 2 | +Instalación |
| 3 | +=========== |
| 4 | + |
| 5 | +Instalación básica |
| 6 | +================== |
| 7 | + |
| 8 | +virtualenvwrapper debe se instalado usando pip_:: |
| 9 | + |
| 10 | + $ pip install virtualenvwrapper |
| 11 | + |
| 12 | +Querrás instalarlo dentro del site-packages global de Python, junto con |
| 13 | +virtualenv. Quizás necesites privilegios de administrador para hacer esto. |
| 14 | + |
| 15 | +WORKON_HOME |
| 16 | +=========== |
| 17 | + |
| 18 | +La variable ``WORKON_HOME`` le indica a virtualenvwrapper cuál es el lugar de |
| 19 | +tus entornos virtuales. El default es ``$HOME/.virtualenvs``. |
| 20 | +Este directorio debe ser creado antes de usar cualquier comando de |
| 21 | +virtualenvwrapper. |
| 22 | + |
| 23 | +.. _install-shell-config: |
| 24 | + |
| 25 | +Archivo de inicio del shell |
| 26 | +=========================== |
| 27 | + |
| 28 | +Agrega estas dos líneas a tu archivo de inicio del shell (``.bashrc``, ``.profile``, |
| 29 | +etc.) para configurar la ubicación dónde se van a guardar los entornos virtuales |
| 30 | +y los scripts instalados con este paquete:: |
| 31 | + |
| 32 | + export WORKON_HOME=$HOME/.virtualenvs |
| 33 | + source /usr/local/bin/virtualenvwrapper.sh |
| 34 | + |
| 35 | +Despues de editar este, recarga el archivo de inicio (e.g., ejecuta: ``source |
| 36 | +~/.bashrc``). |
| 37 | + |
| 38 | +Intérprete de Python y $PATH |
| 39 | +============================ |
| 40 | + |
| 41 | +Durante el inicio, ``virtualenvwrapper.sh`` busca el primer ``python`` en la |
| 42 | +variable ``$PATH`` y recuerda éste para su posterior uso. Esto elimina cualquier |
| 43 | +conflicto con los cambios en ``$PATH``, permitiendo intérpretes dentro de |
| 44 | +entornos en los cuales virtualenvwrapper no está instalado. Debido a este |
| 45 | +comportamiento, es importante configurar la variable ``$PATH`` **antes** de |
| 46 | +hacer la inclusión de ``virtualenvwrapper.sh`` (mediante ``source``). Por |
| 47 | +ejemplo:: |
| 48 | + |
| 49 | + export PATH=/usr/local/bin:$PATH |
| 50 | + source /usr/local/bin/virtualenvwrapper.sh |
| 51 | + |
| 52 | +Para reemplazar la búsqueda en ``$PATH``, se puede configurar la variable |
| 53 | +``VIRTUALENVWRAPPER_PYTHON`` hacia la ruta absoluta del intérprete a usar |
| 54 | +(también **antes** de incluir ``virtualenvwrapper.sh``). Por ejemplo:: |
| 55 | + |
| 56 | + export VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python |
| 57 | + source /usr/local/bin/virtualenvwrapper.sh |
| 58 | + |
| 59 | +Inicio rápido |
| 60 | +============= |
| 61 | + |
| 62 | +1. Ejecuta: ``workon`` |
| 63 | +2. Una lista de entornos, vacía, es impresa. |
| 64 | +3. Ejecuta: ``mkvirtualenv temp`` |
| 65 | +4. Un nuevo entorno, ``temp`` es creado y activado. |
| 66 | +5. Ejecuta: ``workon`` |
| 67 | +6. Esta vez, el entorno ``temp`` es incluido. |
| 68 | + |
| 69 | +Archivos temporales |
| 70 | +=================== |
| 71 | + |
| 72 | +virtualenvwrapper crea archivos temporales en ``$TMPDIR``. Si la variable no |
| 73 | +está configuradad, este usa ``/tmp``. Para cambiar la ubicación de los archivos |
| 74 | +temporales sólo para virtualenvwrapper, configura ``VIRTUALENVWRAPPER_TMPDIR``. |
| 75 | + |
| 76 | +Actualizar desde 1.x |
| 77 | +==================== |
| 78 | + |
| 79 | +El script de shell que contiene las funciones ha sido renombrado en la serie |
| 80 | +2.x para reflejar el hecho de que otros shell además de bash son soportados. En |
| 81 | +tu archivo de inicio del shell, cambia ``source |
| 82 | +/usr/local/bin/virtualenvwrapper_bashrc`` por ``source |
| 83 | +/usr/local/bin/virtualenvwrapper.sh``. |
| 84 | + |
| 85 | +.. _pip: http://pypi.python.org/pypi/pip |
0 commit comments