File: install.txt

package info (click to toggle)
virtualenvwrapper 3.4-2
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 4,140 kB
  • sloc: sh: 3,801; python: 991; makefile: 27
file content (85 lines) | stat: -rw-r--r-- 2,928 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
===========
Instalación
===========

Instalación básica
==================

virtualenvwrapper debe ser instalado usando pip_::

  $ pip install virtualenvwrapper

Querrás instalarlo dentro del site-packages global de Python, junto con
virtualenv. Quizás necesites privilegios de administrador para hacer esto.

WORKON_HOME
===========

La variable ``WORKON_HOME`` le indica a virtualenvwrapper cuál es el lugar de
tus entornos virtuales. El default es ``$HOME/.virtualenvs``.
Este directorio debe ser creado antes de usar cualquier comando de
virtualenvwrapper.

.. _install-shell-config:

Archivo de inicio del shell
===========================

Agrega estas dos líneas a tu archivo de inicio del shell (``.bashrc``, ``.profile``,
etc.) para configurar la ubicación dónde se van a guardar los entornos virtuales
y los scripts instalados con este paquete::

    export WORKON_HOME=$HOME/.virtualenvs
    source /usr/local/bin/virtualenvwrapper.sh

Después de editar este, recarga el archivo de inicio (por ejemplo, ejecuta: ``source
~/.bashrc``).

Intérprete de Python y $PATH
============================

Durante el inicio, ``virtualenvwrapper.sh`` busca el primer ``python`` en la
variable ``$PATH`` y recuerda éste para su posterior uso. Esto elimina cualquier
conflicto con los cambios en ``$PATH``, permitiendo intérpretes dentro de
entornos en los cuales virtualenvwrapper no está instalado. Debido a este
comportamiento, es importante configurar la variable ``$PATH`` **antes** de
hacer la inclusión de ``virtualenvwrapper.sh`` (mediante ``source``). Por
ejemplo::

    export PATH=/usr/local/bin:$PATH
    source /usr/local/bin/virtualenvwrapper.sh

Para reemplazar la búsqueda en ``$PATH``, se puede configurar la variable 
``VIRTUALENVWRAPPER_PYTHON`` hacia la ruta absoluta del intérprete a usar
(también **antes** de incluir ``virtualenvwrapper.sh``). Por ejemplo::

    export VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python
    source /usr/local/bin/virtualenvwrapper.sh

Inicio rápido
=============

1. Ejecuta: ``workon``
2. Una lista de entornos, vacía, es impresa.
3. Ejecuta: ``mkvirtualenv temp``
4. Un nuevo entorno, ``temp`` es creado y activado.
5. Ejecuta: ``workon``
6. Esta vez, el entorno ``temp`` es incluido.

Archivos temporales
===================

virtualenvwrapper crea archivos temporales en ``$TMPDIR``. Si la variable no
está configurada, este usa ``/tmp``. Para cambiar la ubicación de los archivos
temporales sólo para virtualenvwrapper, configura ``VIRTUALENVWRAPPER_TMPDIR``.

Actualizar desde 1.x
====================

El script de shell que contiene las funciones ha sido renombrado en la serie
2.x para reflejar el hecho de que otros shells, además de bash, son soportados. En
tu archivo de inicio del shell, cambia ``source
/usr/local/bin/virtualenvwrapper_bashrc`` por ``source
/usr/local/bin/virtualenvwrapper.sh``.

.. _pip: http://pypi.python.org/pypi/pip