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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Extender Virtualenvwrapper — virtualenvwrapper v3.4 documentation</title>
<link rel="stylesheet" href="_static/nature.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '3.4',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="virtualenvwrapper v3.4 documentation" href="index.html" />
<link rel="up" title="Personalizar Virtualenvwrapper" href="hooks.html" />
<link rel="next" title="Consejos y Trucos" href="tips.html" />
<link rel="prev" title="Personalizaciones por usuario" href="scripts.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="tips.html" title="Consejos y Trucos"
accesskey="N">next</a></li>
<li class="right" >
<a href="scripts.html" title="Personalizaciones por usuario"
accesskey="P">previous</a> |</li>
<li><a href="index.html">virtualenvwrapper v3.4 documentation</a> »</li>
<li><a href="hooks.html" accesskey="U">Personalizar Virtualenvwrapper</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="extender-virtualenvwrapper">
<span id="plugins"></span><h1>Extender Virtualenvwrapper<a class="headerlink" href="#extender-virtualenvwrapper" title="Permalink to this headline">¶</a></h1>
<p>Una gran experiencia con soluciones caseras para personalizar un entorno de
desarrollo ha demostrado cuán valioso puede ser tener la capacidad de
automatizar tareas comunes y eliminar molestias persistentes. Carpinteros
construyen plantillas de guía, desarrolladores de software escriben scripts de
shell. virtualenvwrapper continúa la tradición de animar a un artesano a
modificar sus herramientas para trabajar de la manera que ellos quieran, en vez
de al revés.</p>
<p>Usa los ganchos provistos para eliminar operaciones manuales repetitivas y hacer
más simple tu flujo de desarrollo. Por ejemplo, configura los ganchos
<a class="reference internal" href="#plugins-pre-activate"><em>pre_activate</em></a> y <a class="reference internal" href="#plugins-post-activate"><em>post_activate</em></a> para provocar que un
IDE cargue un proyecto o recargue los archivos desde la última sesión de
edición, administra el logueo de horas, o inicia y detiene versiones de
desarrollo de un servidor de aplicaciones. Usa el gancho
<a class="reference internal" href="#plugins-initialize"><em>initialize</em></a> para agregar nuevos comandos y ganchos a
virtualenvwrapper. Los ganchos <a class="reference internal" href="#plugins-pre-mkvirtualenv"><em>pre_mkvirtualenv</em></a> y
<a class="reference internal" href="#plugins-post-mkvirtualenv"><em>post_mkvirtualenv</em></a> te brindan la oportunidad de instalar
requerimientos básicos dentro de cada nuevo entorno de desarrollo, inicializar
el repositorio de control de versiones para el código, o por otro lado
configurar un nuevo proyecto.</p>
<p>Existen dos maneras para adjuntar tu código para que virtualenvwrapper lo
ejecute: los usuarios finales pueden usar scripts de shell o otros programas
para la personalización personal (ver <a class="reference internal" href="scripts.html#scripts"><em>Personalizaciones por usuario</em></a>). Las extensiones también
pueden ser implementadas en Python usando <em>puntos de entrada</em> con <a class="reference external" href="http://packages.python.org/distribute/">Distribute</a> ,</p>
<div class="section" id="definir-una-extension">
<h2>Definir una extensión<a class="headerlink" href="#definir-una-extension" title="Permalink to this headline">¶</a></h2>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Virtualenvwrapper es distribuido con un plugin para la creación y ejecución de
los scripts de personalización de los usuarios (<a class="reference internal" href="extensions.html#extensions-user-scripts"><em>project</em></a>).
Los ejemplos siguientes han sido tomados de la implementación de ese plugin.</p>
</div>
<div class="section" id="organizacion-del-codigo">
<h3>Organización del código<a class="headerlink" href="#organizacion-del-codigo" title="Permalink to this headline">¶</a></h3>
<p>El paquete Python para <tt class="docutils literal"><span class="pre">virtualenvwrapper</span></tt> es un <em>namespace package</em>.
Eso significa que múltiples librerías pueden instalar código dentro del paquete,
incluso si ellas no son distribuidas juntas o instaladas dentro del mismo
directorio. Las extensiones pueden (opcionalmente) usar el namespace de
<tt class="docutils literal"><span class="pre">virtualenvwrapper</span></tt> configurando su estructura de directorios así:</p>
<ul class="simple">
<li>virtualenvwrapper/<ul>
<li>__init__.py</li>
<li>user_scripts.py</li>
</ul>
</li>
</ul>
<p>Y agregando el siguiente código dentro de <tt class="docutils literal"><span class="pre">__init__.py</span></tt>:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="sd">"""virtualenvwrapper module</span>
<span class="sd">"""</span>
<span class="nb">__import__</span><span class="p">(</span><span class="s">'pkg_resources'</span><span class="p">)</span><span class="o">.</span><span class="n">declare_namespace</span><span class="p">(</span><span class="n">__name__</span><span class="p">)</span>
</pre></div>
</div>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Las extensiones pueden ser cargadas desde cualquier paquete, así que usar el
espacio de nombres de <tt class="docutils literal"><span class="pre">virtualenvwrapper</span></tt> no es requerido.</p>
</div>
</div>
<div class="section" id="extension-api">
<h3>Extensión API<a class="headerlink" href="#extension-api" title="Permalink to this headline">¶</a></h3>
<p>Después de que el paquete está establecido, el siguiente paso es crear un módulo
para alojar el código de la extensión. Por ejemplo,
<tt class="docutils literal"><span class="pre">virtualenvwrapper/user_scripts.py</span></tt>. El módulo debe contener la extensión
actual a los <em>entry points</em>. Soporte de código puede ser incluido, o importado
desde algún lugar usando la técnica de organización de código estándar de
Python.</p>
<p>FIXME: I don’t like the last paragraph</p>
<p>La API es la misma para todos los puntos de extensión. Cada uno usa una función
de Python que toma un sólo argumento, una lista de strings pasada al script que
carga los ganchos en la línea de comandos.</p>
<div class="highlight-python"><pre>def function_name(args):
# args is a list of strings passed to the hook loader</pre>
</div>
<p>El contenido de la lista de argumentos está definida para cada punto de
extensión a continuación (ver <a class="reference internal" href="#plugins-extension-points"><em>Puntos de extensión</em></a>).</p>
</div>
<div class="section" id="invocacion-de-la-extension">
<h3>Invocación de la extensión<a class="headerlink" href="#invocacion-de-la-extension" title="Permalink to this headline">¶</a></h3>
<div class="section" id="accion-directa">
<h4>Acción directa<a class="headerlink" href="#accion-directa" title="Permalink to this headline">¶</a></h4>
<p>Los plugins pueden ser colgados a cada uno de los ganchos de dos formas
diferentes. La estándar es tener una función y hacer algún trabajo directamente.
Por ejemplo, la función <tt class="docutils literal"><span class="pre">initialize()</span></tt> para el plugin de los scripts de
usuarios crea scripts de usuarios por default cuando <tt class="docutils literal"><span class="pre">virtualenvwrapper.sh</span></tt> es
cargada.</p>
<div class="highlight-python"><div class="highlight"><pre><span class="k">def</span> <span class="nf">initialize</span><span class="p">(</span><span class="n">args</span><span class="p">):</span>
<span class="k">for</span> <span class="n">filename</span><span class="p">,</span> <span class="n">comment</span> <span class="ow">in</span> <span class="n">GLOBAL_HOOKS</span><span class="p">:</span>
<span class="n">make_hook</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s">'$WORKON_HOME'</span><span class="p">,</span> <span class="n">filename</span><span class="p">),</span> <span class="n">comment</span><span class="p">)</span>
<span class="k">return</span>
</pre></div>
</div>
</div>
<div class="section" id="modificar-el-entorno-de-usuario">
<span id="plugins-user-env"></span><h4>Modificar el entorno de usuario<a class="headerlink" href="#modificar-el-entorno-de-usuario" title="Permalink to this headline">¶</a></h4>
<p>Hay casos en dónde la extensión necesita actualizar el entorno del usuario (por
ejemplo, cambiar el directorio de trabajo actual o configurar variables de
entorno). Las modificaciones al entorno del usuario deben ser hechas dentro del
shell actual del usuario, y no pueden ser ejecutadas en un proceso separado.
Para tener código ejecutado en un proceso shell del usuario, las extensiones
pueden definir funciones gancho y retornar el texto de los comandos de shell
a ser ejecutados. Estos ganchos <em>fuente</em> son ejecutados después de los ganchos
comunes con el mismo nombre, y no deben hacer ningún trabajo por ellos mismos.</p>
<p>El gancho <tt class="docutils literal"><span class="pre">initialize_source()</span></tt> para el plugin de scripts de usuarios busca
un script <tt class="docutils literal"><span class="pre">initializa</span></tt> global y causa que este sea ejecutado en el proceso de
shell actual.</p>
<div class="highlight-python"><div class="highlight"><pre><span class="k">def</span> <span class="nf">initialize_source</span><span class="p">(</span><span class="n">args</span><span class="p">):</span>
<span class="k">return</span> <span class="s">"""</span>
<span class="s">#</span>
<span class="s"># Run user-provided scripts</span>
<span class="s">#</span>
<span class="s">[ -f "$WORKON_HOME/initialize" ] && source "$WORKON_HOME/initialize"</span>
<span class="s">"""</span>
</pre></div>
</div>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">Como las extensiones están modificando el shell de trabajo del usuario, se
debe tener mucho cuidado de corromper el entorno sobreescribiendo variables
con valores inesperados. Evita crear variables temporales cuando sea
posible. Poner prefijos a las variables con el nombre de la extensión es una
buena forma de manejar espacios de nombres. Por ejemplo, en vez de
<tt class="docutils literal"><span class="pre">temp_file</span></tt> usa <tt class="docutils literal"><span class="pre">user_scripts_temp_file</span></tt>. Usa <tt class="docutils literal"><span class="pre">unset</span></tt> para liberar
nombres de variables temporales cuando no sean más necesarias.</p>
</div>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">virtualenvwrapper funciona en varios shells con una sintaxis ligeramente
diferente (bash, sh, zsh, ksh). Ten en cuenta esta portabilidad cuando
definas ganchos incluidos (<em>sourced hooks</em>). Mantener la sintaxis lo más simple
posible evitará problemas comunes, pero quizás haya casos donde
examinar la variable de entorno <tt class="docutils literal"><span class="pre">SHELL</span></tt> y generar diferente sintaxis
para cada caso sea la única manera de alcanzar el resultado deseado.</p>
</div>
</div>
</div>
<div class="section" id="registrar-puntos-de-entrada">
<h3>Registrar puntos de entrada<a class="headerlink" href="#registrar-puntos-de-entrada" title="Permalink to this headline">¶</a></h3>
<p>Las funciones definidas en el plugin necesitan ser registradas como <em>puntos de
entrada</em> para que el cargador de ganchos de virtualenvwrapper los encuentre.
Los puntos de entrada de <a class="reference external" href="http://packages.python.org/distribute/">Distribute</a> se configuran en el <tt class="docutils literal"><span class="pre">setup.py</span></tt> de tu
paquete coincidiendo el nombre del punto de entrada con la función en el paquete
que lo implementa.</p>
<p>Una copia parcial del <tt class="docutils literal"><span class="pre">setup.py</span></tt> de virtualenvwrapper ilustra cómo los puntos
de entrada <tt class="docutils literal"><span class="pre">initialize()</span></tt> y <tt class="docutils literal"><span class="pre">initialize_source()</span></tt> son configurados.</p>
<div class="highlight-python"><div class="highlight"><pre><span class="c"># Bootstrap installation of Distribute</span>
<span class="kn">import</span> <span class="nn">distribute_setup</span>
<span class="n">distribute_setup</span><span class="o">.</span><span class="n">use_setuptools</span><span class="p">()</span>
<span class="kn">from</span> <span class="nn">setuptools</span> <span class="kn">import</span> <span class="n">setup</span>
<span class="n">setup</span><span class="p">(</span>
<span class="n">name</span> <span class="o">=</span> <span class="s">'virtualenvwrapper'</span><span class="p">,</span>
<span class="n">version</span> <span class="o">=</span> <span class="s">'2.0'</span><span class="p">,</span>
<span class="n">description</span> <span class="o">=</span> <span class="s">'Enhancements to virtualenv'</span><span class="p">,</span>
<span class="c"># ... details omitted ...</span>
<span class="n">namespace_packages</span> <span class="o">=</span> <span class="p">[</span> <span class="s">'virtualenvwrapper'</span> <span class="p">],</span>
<span class="n">entry_points</span> <span class="o">=</span> <span class="p">{</span>
<span class="s">'virtualenvwrapper.initialize'</span><span class="p">:</span> <span class="p">[</span>
<span class="s">'user_scripts = virtualenvwrapper.user_scripts:initialize'</span><span class="p">,</span>
<span class="p">],</span>
<span class="s">'virtualenvwrapper.initialize_source'</span><span class="p">:</span> <span class="p">[</span>
<span class="s">'user_scripts = virtualenvwrapper.user_scripts:initialize_source'</span><span class="p">,</span>
<span class="p">],</span>
<span class="c"># ... details omitted ...</span>
<span class="p">},</span>
<span class="p">)</span>
</pre></div>
</div>
<p>El argumento <tt class="docutils literal"><span class="pre">entry_points</span></tt> de <tt class="docutils literal"><span class="pre">setup()</span></tt> es un diccionario que mapea los
<em>grupos de nombre</em> de puntos de entrada a listas de puntos de entrada
específicos. Un nombre de grupo diferente es definido por virtualenvwrapper por
cada punto de extensión (ver <a class="reference internal" href="#plugins-extension-points"><em>Puntos de extensión</em></a>).</p>
<p>Los identificadores de puntos de entrada son strings con la sintaxis <tt class="docutils literal"><span class="pre">name</span> <span class="pre">=</span>
<span class="pre">package.module:function</span></tt>. Por convención, el <em>nombre</em> de cada punto de entrada
es el nombre del plugin, pero esto no es requerido (los nombres no son usados).</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<ul class="last simple">
<li><a class="reference external" href="http://packages.python.org/distribute/setuptools.html#namespace-packages">namespace packages</a></li>
<li><a class="reference external" href="http://packages.python.org/distribute/setuptools.html#extensible-applications-and-frameworks">Extensible Applications and Frameworks</a></li>
</ul>
</div>
</div>
<div class="section" id="el-cargador-de-ganchos">
<h3>El cargador de ganchos<a class="headerlink" href="#el-cargador-de-ganchos" title="Permalink to this headline">¶</a></h3>
<p>Las extensiones son ejecutadas mediante una aplicación de líneas de comando
implementada en <tt class="docutils literal"><span class="pre">virtualenvwrapper.hook_loader</span></tt>. Como <tt class="docutils literal"><span class="pre">virtualenvwrapper.sh</span></tt>
es invocado primero y los usuarios generalmente no necesitan ejecutar la
aplicación directamente, ningún otro script es instalado por separado. En vez,
para ejecutar la aplicación, usa la opción <tt class="docutils literal"><span class="pre">-m</span></tt> del intérprete:</p>
<div class="highlight-python"><pre>$ python -m virtualenvwrapper.hook_loader -h
Usage: virtualenvwrapper.hook_loader [options] <hook> [<arguments>]
Manage hooks for virtualenvwrapper
Options:
-h, --help show this help message and exit
-s, --source Print the shell commands to be run in the current
shell
-l, --list Print a list of the plugins available for the given
hook
-v, --verbose Show more information on the console
-q, --quiet Show less information on the console
-n NAMES, --name=NAMES
Only run the hook from the named plugin</pre>
</div>
<p>Para ejecutar las extensiones para el gancho <em>initialize</em>:</p>
<div class="highlight-python"><pre>$ python -m virtualenvwrapper.hook_loader -v initialize</pre>
</div>
<p>Para obtener los comandos de shell para el gancho <em>initialize</em>:</p>
<div class="highlight-python"><pre>$ python -m virtualenvwrapper.hook_loader --source initialize</pre>
</div>
<p>En la práctica, en vez de invocar al cargador de ganchos directamente es
conveniente usar la función de shell, <tt class="docutils literal"><span class="pre">virtualenvwrapper_run_hook</span></tt> para
ejecutar los ganchos en ambos modos.:</p>
<div class="highlight-python"><pre>$ virtualenvwrapper_run_hook initialize</pre>
</div>
<p>Todos los argumentos pasados a la función de shell son pasados directamente al
cargador de ganchos.</p>
</div>
<div class="section" id="registro-logging">
<h3>Registro (<em>Logging</em>)<a class="headerlink" href="#registro-logging" title="Permalink to this headline">¶</a></h3>
<p>El cargador de ganchos configura el registro para que los mensajes sean escritos
en <tt class="docutils literal"><span class="pre">$WORKON_HOME/hook.log</span></tt>. Los mensajes quizás sean escritos en stderr,
dependiendo de la flash verbose. Por default los mensajes con un nivel mayor o
igual a <em>info</em> se escriben en stderr, y los de nivel <em>debug</em> o mayor van al
archivo de registro. Usar el registro de esta forma provee un mecanismo
conveniente para que los usuarios controlen la verbosidad de las extensiones.</p>
<p>Para usar el registro en tu extensión, simplemente instancia un registro y llama
a sus métodos <tt class="docutils literal"><span class="pre">info()</span></tt>, <tt class="docutils literal"><span class="pre">debug()</span></tt> y otros métodos de mensajería.</p>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">import</span> <span class="nn">logging</span>
<span class="n">log</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="n">__name__</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">pre_mkvirtualenv</span><span class="p">(</span><span class="n">args</span><span class="p">):</span>
<span class="n">log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">'pre_mkvirtualenv </span><span class="si">%s</span><span class="s">'</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="n">args</span><span class="p">))</span>
<span class="c"># ...</span>
</pre></div>
</div>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<ul class="last simple">
<li><a class="reference external" href="http://docs.python.org/library/logging.html">Standard library documentation for logging</a></li>
<li><a class="reference external" href="http://www.doughellmann.com/PyMOTW/logging/">PyMOTW for logging</a></li>
</ul>
</div>
</div>
</div>
<div class="section" id="puntos-de-extension">
<span id="plugins-extension-points"></span><h2>Puntos de extensión<a class="headerlink" href="#puntos-de-extension" title="Permalink to this headline">¶</a></h2>
<p>Los nombres de los puntos de extensión para los plugins nativos siguen una
convención con varias partes:
<tt class="docutils literal"><span class="pre">virtualenvwrapper.(pre|post)_<event>[_source]</span></tt>. <em><event></em> es la acción tomada
por el usuario o virtualenvwrapper que provoca la extensión. <tt class="docutils literal"><span class="pre">(pre|post)</span></tt>
indica si llama a la extensión antes o después de un evento. El sufijo <tt class="docutils literal"><span class="pre">_source</span></tt>
es agregado para las extensiones que retornan código shell en vez de tomar una
acción directamente (ver <a class="reference internal" href="#plugins-user-env"><em>Modificar el entorno de usuario</em></a>).</p>
<div class="section" id="initialize">
<span id="plugins-initialize"></span><h3>initialize<a class="headerlink" href="#initialize" title="Permalink to this headline">¶</a></h3>
<p>Los ganchos <tt class="docutils literal"><span class="pre">virtualenvwrapper.initialize</span></tt> son ejecutados cada vez que
<tt class="docutils literal"><span class="pre">virtualenvwrapper.sh</span></tt> es cargado en el entorno del usuario. El gancho
<em>initialize</em> puede ser usado para instalar plantillas para configurar archivos o
preparar el sistema para una operación correcta del plugin.</p>
</div>
<div class="section" id="pre-mkvirtualenv">
<span id="plugins-pre-mkvirtualenv"></span><h3>pre_mkvirtualenv<a class="headerlink" href="#pre-mkvirtualenv" title="Permalink to this headline">¶</a></h3>
<p>Los ganchos <tt class="docutils literal"><span class="pre">virtualenvwrapper.pre_mkvirtualenv</span></tt> son ejecutados después de que
el entorno es creado, pero antes de que el nuevo entorno sea activado. El
directorio de trabajo actual para cuando el gancho es ejecutado es <tt class="docutils literal"><span class="pre">$WORKON_HOME</span></tt>
y el nombre del nuevo entorno es pasado como un argumento.</p>
</div>
<div class="section" id="post-mkvirtualenv">
<span id="plugins-post-mkvirtualenv"></span><h3>post_mkvirtualenv<a class="headerlink" href="#post-mkvirtualenv" title="Permalink to this headline">¶</a></h3>
<p>Los ganchos <tt class="docutils literal"><span class="pre">virtualenvwrapper.post_mkvirtualenv</span></tt> son ejecutado después de que
un nuevo entorno sea creado y activado. <tt class="docutils literal"><span class="pre">$VIRTUAL_ENV</span></tt> es configurado para
apuntar al nuevo entorno.</p>
</div>
<div class="section" id="pre-activate">
<span id="plugins-pre-activate"></span><h3>pre_activate<a class="headerlink" href="#pre-activate" title="Permalink to this headline">¶</a></h3>
<p>Los ganchos <tt class="docutils literal"><span class="pre">virtualenvwrapper.pre_activate</span></tt> son ejecutados justo antes
de que un entorno sea activado. El nombre del entorno es pasado como
primer argumento.</p>
</div>
<div class="section" id="post-activate">
<span id="plugins-post-activate"></span><h3>post_activate<a class="headerlink" href="#post-activate" title="Permalink to this headline">¶</a></h3>
<p>Los ganchos <tt class="docutils literal"><span class="pre">virtualenvwrapper.post_activate</span></tt> son ejecutados justo después
de que un entorno sea activado. <tt class="docutils literal"><span class="pre">$VIRTUAL_ENV</span></tt> apunta al entorno actual.</p>
</div>
<div class="section" id="pre-deactivate">
<span id="plugins-pre-deactivate"></span><h3>pre_deactivate<a class="headerlink" href="#pre-deactivate" title="Permalink to this headline">¶</a></h3>
<p>Los ganchos <tt class="docutils literal"><span class="pre">virtualenvwrapper.pre_deactivate</span></tt> son ejecutados justo antes de
que un entorno sea desactivado. <tt class="docutils literal"><span class="pre">$VIRTUAL_ENV</span></tt> apunta al entorno actual.</p>
</div>
<div class="section" id="post-deactivate">
<span id="plugins-post-deactivate"></span><h3>post_deactivate<a class="headerlink" href="#post-deactivate" title="Permalink to this headline">¶</a></h3>
<p>Los ganchos <tt class="docutils literal"><span class="pre">virtualenvwrapper.post_deactivate</span></tt> son ejecutados justo después
de que un entorno sea desactivado. El nombre del entorno recién desactivado es
pasado como primer argumento.</p>
</div>
<div class="section" id="pre-rmvirtualenv">
<span id="plugins-pre-rmvirtualenv"></span><h3>pre_rmvirtualenv<a class="headerlink" href="#pre-rmvirtualenv" title="Permalink to this headline">¶</a></h3>
<p>Los ganchos <tt class="docutils literal"><span class="pre">virtualenvwrapper.pre_rmvirtualenv</span></tt> son ejecutados justo antes
de que un entorno sea eliminado. El nombre del entorno eliminado es pasado
como primer argumento.</p>
</div>
<div class="section" id="post-rmvirtualenv">
<span id="plugins-post-rmvirtualenv"></span><h3>post_rmvirtualenv<a class="headerlink" href="#post-rmvirtualenv" title="Permalink to this headline">¶</a></h3>
<p>Los ganchos <tt class="docutils literal"><span class="pre">virtualenvwrapper.post_rmvirtualenv</span></tt> son ejecutados justo después
de que un entorno haya sido eliminado. El nombre del entorno eliminado es pasado
como primer argumento.</p>
</div>
</div>
<div class="section" id="agregar-nuevos-puntos-de-extension">
<h2>Agregar nuevos puntos de extensión<a class="headerlink" href="#agregar-nuevos-puntos-de-extension" title="Permalink to this headline">¶</a></h2>
<p>Los plugins que definen nuevas operaciones pueden también definir nuevos puntos
de extensión. No es necesario hacer ninguna configuración para permitir que el
cargador de ganchos encuentre las extensiones; documentar los nombres y agregar
llamadas a <tt class="docutils literal"><span class="pre">virtualenvwrapper_run_hook</span></tt> es suficiente para causar que ellos se
invoquen.</p>
<p>El cargador de ganchos asume que todos los nombres de puntos de extensión
comienzan con <tt class="docutils literal"><span class="pre">virtualenvwrapper.</span></tt> y los nuevos plugins querrán usar su
propio espacio de nombres para agregar. Por ejemplo, la extensión <a class="reference external" href="http://www.doughellmann.com/projects/virtualenvwrapper.project/">project</a>
define nuevos eventos para crear directorios del proyecto (pre y post). Esas son
llamadas a <tt class="docutils literal"><span class="pre">virtualenvwrapper.project.pre_mkproject</span></tt> y
<tt class="docutils literal"><span class="pre">virtualenvwrapper.project.post_mkproject</span></tt>. Estas son invocadas con:</p>
<div class="highlight-python"><pre>virtualenvwrapper_run_hook project.pre_mkproject $project_name</pre>
</div>
<p>y:</p>
<div class="highlight-python"><pre>virtualenvwrapper_run_hook project.post_mkproject</pre>
</div>
<p>respectivamente.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Extender Virtualenvwrapper</a><ul>
<li><a class="reference internal" href="#definir-una-extension">Definir una extensión</a><ul>
<li><a class="reference internal" href="#organizacion-del-codigo">Organización del código</a></li>
<li><a class="reference internal" href="#extension-api">Extensión API</a></li>
<li><a class="reference internal" href="#invocacion-de-la-extension">Invocación de la extensión</a><ul>
<li><a class="reference internal" href="#accion-directa">Acción directa</a></li>
<li><a class="reference internal" href="#modificar-el-entorno-de-usuario">Modificar el entorno de usuario</a></li>
</ul>
</li>
<li><a class="reference internal" href="#registrar-puntos-de-entrada">Registrar puntos de entrada</a></li>
<li><a class="reference internal" href="#el-cargador-de-ganchos">El cargador de ganchos</a></li>
<li><a class="reference internal" href="#registro-logging">Registro (<em>Logging</em>)</a></li>
</ul>
</li>
<li><a class="reference internal" href="#puntos-de-extension">Puntos de extensión</a><ul>
<li><a class="reference internal" href="#initialize">initialize</a></li>
<li><a class="reference internal" href="#pre-mkvirtualenv">pre_mkvirtualenv</a></li>
<li><a class="reference internal" href="#post-mkvirtualenv">post_mkvirtualenv</a></li>
<li><a class="reference internal" href="#pre-activate">pre_activate</a></li>
<li><a class="reference internal" href="#post-activate">post_activate</a></li>
<li><a class="reference internal" href="#pre-deactivate">pre_deactivate</a></li>
<li><a class="reference internal" href="#post-deactivate">post_deactivate</a></li>
<li><a class="reference internal" href="#pre-rmvirtualenv">pre_rmvirtualenv</a></li>
<li><a class="reference internal" href="#post-rmvirtualenv">post_rmvirtualenv</a></li>
</ul>
</li>
<li><a class="reference internal" href="#agregar-nuevos-puntos-de-extension">Agregar nuevos puntos de extensión</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="scripts.html"
title="previous chapter">Personalizaciones por usuario</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="tips.html"
title="next chapter">Consejos y Trucos</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/plugins.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" size="18" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="tips.html" title="Consejos y Trucos"
>next</a></li>
<li class="right" >
<a href="scripts.html" title="Personalizaciones por usuario"
>previous</a> |</li>
<li><a href="index.html">virtualenvwrapper v3.4 documentation</a> »</li>
<li><a href="hooks.html" >Personalizar Virtualenvwrapper</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009-2011, Doug Hellmann.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.5.
</div>
</body>
</html>
|
