|
| 1 | +.. Quick reference documentation for virtualenvwrapper command line functions |
| 2 | + Originally contributed Thursday, May 28, 2009 by Steve Steiner (ssteinerX@gmail.com) |
| 3 | +
|
| 4 | +.. _command: |
| 5 | + |
| 6 | +###################### |
| 7 | +Referencia de comandos |
| 8 | +###################### |
| 9 | + |
| 10 | +Todos los comandos a continuación son para ser utilizados en una Terminal de |
| 11 | +línea de comandos. |
| 12 | + |
| 13 | +==================== |
| 14 | +Administrar entornos |
| 15 | +==================== |
| 16 | + |
| 17 | +.. _command-mkvirtualenv: |
| 18 | + |
| 19 | +mkvirtualenv |
| 20 | +------------ |
| 21 | + |
| 22 | +Crea un nuevo entorno, dentro de WORKON_HOME. |
| 23 | + |
| 24 | +Sintaxis:: |
| 25 | + |
| 26 | + mkvirtualenv [options] ENVNAME |
| 27 | + |
| 28 | +Todas las opciones de línea de comandos son pasados diréctamente a |
| 29 | +``virtualenv``. El nuevo entorno es automáticamente activado luego de su |
| 30 | +inicialización. |
| 31 | + |
| 32 | +:: |
| 33 | + |
| 34 | + $ workon |
| 35 | + $ mkvirtualenv mynewenv |
| 36 | + New python executable in mynewenv/bin/python |
| 37 | + Installing distribute............................................. |
| 38 | + .................................................................. |
| 39 | + .................................................................. |
| 40 | + done. |
| 41 | + (mynewenv)$ workon |
| 42 | + mynewenv |
| 43 | + (mynewenv)$ |
| 44 | + |
| 45 | +.. seealso:: |
| 46 | + |
| 47 | + * :ref:`scripts-premkvirtualenv` |
| 48 | + * :ref:`scripts-postmkvirtualenv` |
| 49 | + |
| 50 | +rmvirtualenv |
| 51 | +------------ |
| 52 | + |
| 53 | +Elimina un entorno, dentro de WORKON_HOME. |
| 54 | + |
| 55 | +Sintaxis:: |
| 56 | + |
| 57 | + rmvirtualenv ENVNAME |
| 58 | + |
| 59 | +Debes usar :ref:`command-deactivate` antes de eliminar el entorno actual. |
| 60 | + |
| 61 | +:: |
| 62 | + |
| 63 | + (mynewenv)$ deactivate |
| 64 | + $ rmvirtualenv mynewenv |
| 65 | + $ workon |
| 66 | + $ |
| 67 | + |
| 68 | +.. seealso:: |
| 69 | + |
| 70 | + * :ref:`scripts-prermvirtualenv` |
| 71 | + * :ref:`scripts-postrmvirtualenv` |
| 72 | + |
| 73 | +.. _command-cpvirtualenv: |
| 74 | + |
| 75 | +cpvirtualenv |
| 76 | +------------ |
| 77 | + |
| 78 | +Duplica un entorno, dentro de WORKON_HOME. |
| 79 | + |
| 80 | +Syntax:: |
| 81 | + |
| 82 | + cpvirtualenv ENVNAME TARGETENVNAME |
| 83 | + |
| 84 | +.. note:: |
| 85 | + |
| 86 | + El entorno creado por la operación de copia es hecho `reubicable |
| 87 | + <http://virtualenv.openplans.org/#making-environments-relocatable>`__. |
| 88 | + |
| 89 | +:: |
| 90 | + |
| 91 | + $ workon |
| 92 | + $ mkvirtualenv source |
| 93 | + New python executable in source/bin/python |
| 94 | + Installing distribute............................................. |
| 95 | + .................................................................. |
| 96 | + .................................................................. |
| 97 | + done. |
| 98 | + (source)$ cpvirtualenv source dest |
| 99 | + Making script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/easy_install relative |
| 100 | + Making script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/easy_install-2.6 relative |
| 101 | + Making script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/pip relative |
| 102 | + 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) |
| 103 | + 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) |
| 104 | + 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) |
| 105 | + 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) |
| 106 | + (dest)$ workon |
| 107 | + dest |
| 108 | + source |
| 109 | + (dest)$ |
| 110 | + |
| 111 | +.. seealso:: |
| 112 | + |
| 113 | + * :ref:`scripts-precpvirtualenv` |
| 114 | + * :ref:`scripts-postcpvirtualenv` |
| 115 | + * :ref:`scripts-premkvirtualenv` |
| 116 | + * :ref:`scripts-postmkvirtualenv` |
| 117 | + |
| 118 | +============================== |
| 119 | +Controlar los entornos activos |
| 120 | +============================== |
| 121 | + |
| 122 | +workon |
| 123 | +------ |
| 124 | + |
| 125 | +Lista o cambia el entorno de trabajo actual |
| 126 | + |
| 127 | +Sintaxis:: |
| 128 | + |
| 129 | + workon [environment_name] |
| 130 | + |
| 131 | +Si no se especifica el ``environment_name`` la lista de entornos disponibles es |
| 132 | +impresa en la salida estándar. |
| 133 | + |
| 134 | +:: |
| 135 | + |
| 136 | + $ workon |
| 137 | + $ mkvirtualenv env1 |
| 138 | + New python executable in env1/bin/python |
| 139 | + Installing distribute............................................. |
| 140 | + .................................................................. |
| 141 | + .................................................................. |
| 142 | + done. |
| 143 | + (env1)$ mkvirtualenv env2 |
| 144 | + New python executable in env2/bin/python |
| 145 | + Installing distribute............................................. |
| 146 | + .................................................................. |
| 147 | + .................................................................. |
| 148 | + done. |
| 149 | + (env2)$ workon |
| 150 | + env1 |
| 151 | + env2 |
| 152 | + (env2)$ workon env1 |
| 153 | + (env1)$ echo $VIRTUAL_ENV |
| 154 | + /Users/dhellmann/Devel/virtualenvwrapper/tmp/env1 |
| 155 | + (env1)$ workon env2 |
| 156 | + (env2)$ echo $VIRTUAL_ENV |
| 157 | + /Users/dhellmann/Devel/virtualenvwrapper/tmp/env2 |
| 158 | + (env2)$ |
| 159 | + |
| 160 | + |
| 161 | +.. seealso:: |
| 162 | + |
| 163 | + * :ref:`scripts-predeactivate` |
| 164 | + * :ref:`scripts-postdeactivate` |
| 165 | + * :ref:`scripts-preactivate` |
| 166 | + * :ref:`scripts-postactivate` |
| 167 | + |
| 168 | +.. _command-deactivate: |
| 169 | + |
| 170 | +deactivate |
| 171 | +---------- |
| 172 | + |
| 173 | +Cambia de un entorno virtual a la versión instalada de Python en el sistema. |
| 174 | + |
| 175 | +Sintaxis:: |
| 176 | + |
| 177 | + deactivate |
| 178 | + |
| 179 | +.. note:: |
| 180 | + |
| 181 | + Este comando es actualmente parte de virtualenv, pero es encapsulado para |
| 182 | + proveer ganchos antes y después, al igual que workon hace para activate. |
| 183 | + |
| 184 | +:: |
| 185 | + |
| 186 | + $ workon |
| 187 | + $ echo $VIRTUAL_ENV |
| 188 | + |
| 189 | + $ mkvirtualenv env1 |
| 190 | + New python executable in env1/bin/python |
| 191 | + Installing distribute............................................. |
| 192 | + .................................................................. |
| 193 | + .................................................................. |
| 194 | + done. |
| 195 | + (env1)$ echo $VIRTUAL_ENV |
| 196 | + /Users/dhellmann/Devel/virtualenvwrapper/tmp/env1 |
| 197 | + (env1)$ deactivate |
| 198 | + $ echo $VIRTUAL_ENV |
| 199 | + |
| 200 | + $ |
| 201 | + |
| 202 | +.. seealso:: |
| 203 | + |
| 204 | + * :ref:`scripts-predeactivate` |
| 205 | + * :ref:`scripts-postdeactivate` |
| 206 | + |
| 207 | +====================================== |
| 208 | +Rápida navegación dentro de virtualenv |
| 209 | +====================================== |
| 210 | + |
| 211 | +Existen dos funciones que proveen atajos para navegar dentro del virtualenv |
| 212 | +actualmente activado. |
| 213 | + |
| 214 | +cdvirtualenv |
| 215 | +------------ |
| 216 | + |
| 217 | +Cambia el directorio de trabajo actual hacia ``$VIRTUAL_ENV``. |
| 218 | + |
| 219 | +Sintaxis:: |
| 220 | + |
| 221 | + cdvirtualenv [subdir] |
| 222 | + |
| 223 | +Al llamar ``cdvirtualenv`` se cambia el directorio de trabajo actual hacia la |
| 224 | +sima de virtualenv (``$VIRTUAL_ENV``). Un argumento adicional es agregado a la |
| 225 | +ruta, permitiendo navegar diréctamente dentro de un subdirectorio. |
| 226 | + |
| 227 | +:: |
| 228 | + |
| 229 | + $ mkvirtualenv env1 |
| 230 | + New python executable in env1/bin/python |
| 231 | + Installing distribute............................................. |
| 232 | + .................................................................. |
| 233 | + .................................................................. |
| 234 | + done. |
| 235 | + (env1)$ echo $VIRTUAL_ENV |
| 236 | + /Users/dhellmann/Devel/virtualenvwrapper/tmp/env1 |
| 237 | + (env1)$ cdvirtualenv |
| 238 | + (env1)$ pwd |
| 239 | + /Users/dhellmann/Devel/virtualenvwrapper/tmp/env1 |
| 240 | + (env1)$ cdvirtualenv bin |
| 241 | + (env1)$ pwd |
| 242 | + /Users/dhellmann/Devel/virtualenvwrapper/tmp/env1/bin |
| 243 | + |
| 244 | +cdsitepackages |
| 245 | +-------------- |
| 246 | + |
| 247 | +Cambia el directorio de trabajo actual al ``site-packages`` del |
| 248 | +``$VIRTUAL_ENV``. |
| 249 | + |
| 250 | +Sintaxis:: |
| 251 | + |
| 252 | + cdsitepackages [subdir] |
| 253 | + |
| 254 | +Debido a que la ruta exacta hacia el directorio site-packages dentro del |
| 255 | +virtualenv depende de la versión de Python, ``cdsitepackages`` es provisto como |
| 256 | +un atajo para ``cdvirtualenv lib/python${pyvers}/site-packages``. Un argumento |
| 257 | +opcional también está permitido, para especificar un directorio heredado dentro |
| 258 | +del directorio ``site-packages`` y así ingresar a este. |
| 259 | + |
| 260 | +:: |
| 261 | + |
| 262 | + $ mkvirtualenv env1 |
| 263 | + New python executable in env1/bin/python |
| 264 | + Installing distribute............................................. |
| 265 | + .................................................................. |
| 266 | + .................................................................. |
| 267 | + done. |
| 268 | + (env1)$ echo $VIRTUAL_ENV |
| 269 | + /Users/dhellmann/Devel/virtualenvwrapper/tmp/env1 |
| 270 | + (env1)$ cdsitepackages PyMOTW/bisect/ |
| 271 | + (env1)$ pwd |
| 272 | + /Users/dhellmann/Devel/virtualenvwrapper/tmp/env1/lib/python2.6/site-packages/PyMOTW/bisect |
| 273 | + |
| 274 | +lssitepackages |
| 275 | +-------------- |
| 276 | + |
| 277 | +``lssitepackages`` muestra el contenido del directorio ``site-packages`` |
| 278 | +del entorno actualmente activado. |
| 279 | + |
| 280 | +Sintaxis:: |
| 281 | + |
| 282 | + lssitepackages |
| 283 | + |
| 284 | +:: |
| 285 | + |
| 286 | + $ mkvirtualenv env1 |
| 287 | + New python executable in env1/bin/python |
| 288 | + Installing distribute............................................. |
| 289 | + .................................................................. |
| 290 | + .................................................................. |
| 291 | + done. |
| 292 | + (env1)$ $ workon env1 |
| 293 | + (env1)$ lssitepackages |
| 294 | + distribute-0.6.10-py2.6.egg pip-0.6.3-py2.6.egg |
| 295 | + easy-install.pth setuptools.pth |
| 296 | + |
| 297 | +======================= |
| 298 | +Administración de rutas |
| 299 | +======================= |
| 300 | + |
| 301 | +add2virtualenv |
| 302 | +-------------- |
| 303 | + |
| 304 | +Agrega los directorios especificados al path de Python para el entorno virtual |
| 305 | +actualmente activo. |
| 306 | + |
| 307 | +Sintaxis:: |
| 308 | + |
| 309 | + add2virtualenv directory1 directory2 ... |
| 310 | + |
| 311 | +A veces esto es conveniente compartir paquetes instalados que no están en el |
| 312 | +directorio ``site-pacakges`` del sistema y no deben ser instalados en cada |
| 313 | +entorno virtual. Una posible solución es crear enláces simbólicos (*symlinks*) |
| 314 | +hacia el código dentro del directorio ``site-packages`` del entorno, pero |
| 315 | +también es fácil agregar a la variable PYTHONPATH directorios extras que están |
| 316 | +incluídos en los archivos ``.pth`` dentro de ``site-packages`` usando ``add2virtualenv``. |
| 317 | + |
| 318 | +1. Descarga (*check out*) el código de un proyecto grande, como Django. |
| 319 | +2. Ejecuta: ``add2virtualenv path_to_source``. |
| 320 | +3. Ejecuta: ``add2virtualenv``. |
| 321 | +4. Un mensaje de uso y una lista de las rutas "extras" actuales es impreso. |
| 322 | + |
| 323 | +Los nombres de los directorios son agregados a un archivo llamado |
| 324 | +``virtualenv_path_extensions.pth`` dentro del directorio site-packages de este |
| 325 | +entorno. |
| 326 | + |
| 327 | +*Basado en una contribución de James Bennett y Jannis Leidel.* |
0 commit comments