Mercurial Repositories > eric / file comparison

comparison: eric6/Documentation/Source/eric6.VirtualEnv.VirtualenvManager.html

eric6/Documentation/Source/eric6.VirtualEnv.VirtualenvManager.html

branch
maintenance
changeset 6989
8b8cadf8d7e9
parent 6976
66913de629f6
child 7273
391d6b7b1eff
equal deleted inserted replaced
6938:7926553b7509 6989:8b8cadf8d7e9
1 <!DOCTYPE html>
2 <html><head>
3 <title>eric6.VirtualEnv.VirtualenvManager</title>
4 <meta charset="UTF-8">
5 <style>
6 body {
7 background: #EDECE6;
8 margin: 0em 1em 10em 1em;
9 color: black;
10 }
11
12 h1 { color: white; background: #85774A; }
13 h2 { color: white; background: #85774A; }
14 h3 { color: white; background: #9D936E; }
15 h4 { color: white; background: #9D936E; }
16
17 a { color: #BA6D36; }
18
19 </style>
20 </head>
21 <body><a NAME="top" ID="top"></a>
22 <h1>eric6.VirtualEnv.VirtualenvManager</h1>
23 <p>
24 Module implementing a class to manage Python virtual environments.
25 </p>
26 <h3>Global Attributes</h3>
27 <table>
28 <tr><td>None</td></tr>
29 </table>
30 <h3>Classes</h3>
31 <table>
32 <tr>
33 <td><a href="#VirtualenvManager">VirtualenvManager</a></td>
34 <td>Class implementing an object to manage Python virtual environments.</td>
35 </tr>
36 </table>
37 <h3>Functions</h3>
38 <table>
39 <tr><td>None</td></tr>
40 </table>
41 <hr /><hr />
42 <a NAME="VirtualenvManager" ID="VirtualenvManager"></a>
43 <h2>VirtualenvManager</h2>
44 <p>
45 Class implementing an object to manage Python virtual environments.
46 </p><h3>Signals</h3>
47 <dl>
48 <dt>virtualEnvironmentAdded()</dt>
49 <dd>
50 emitted to indicate the addition of
51 a virtual environment
52 </dd><dt>virtualEnvironmentChanged(name)</dt>
53 <dd>
54 emitted to indicate a change of
55 a virtual environment
56 </dd><dt>virtualEnvironmentRemoved()</dt>
57 <dd>
58 emitted to indicate the removal and
59 deletion of a virtual environment
60 </dd>
61 </dl>
62 <h3>Derived from</h3>
63 QObject
64 <h3>Class Attributes</h3>
65 <table>
66 <tr><td>DefaultKey</td></tr>
67 </table>
68 <h3>Class Methods</h3>
69 <table>
70 <tr><td>None</td></tr>
71 </table>
72 <h3>Methods</h3>
73 <table>
74 <tr>
75 <td><a href="#VirtualenvManager.__init__">VirtualenvManager</a></td>
76 <td>Constructor</td>
77 </tr><tr>
78 <td><a href="#VirtualenvManager.__isEnvironmentDeleteable">__isEnvironmentDeleteable</a></td>
79 <td>Private method to check, if a virtual environment can be deleted from disk.</td>
80 </tr><tr>
81 <td><a href="#VirtualenvManager.__loadSettings">__loadSettings</a></td>
82 <td>Private slot to load the virtual environments.</td>
83 </tr><tr>
84 <td><a href="#VirtualenvManager.__saveSettings">__saveSettings</a></td>
85 <td>Private slot to save the virtual environments.</td>
86 </tr><tr>
87 <td><a href="#VirtualenvManager.addVirtualEnv">addVirtualEnv</a></td>
88 <td>Public method to add a virtual environment.</td>
89 </tr><tr>
90 <td><a href="#VirtualenvManager.createVirtualEnv">createVirtualEnv</a></td>
91 <td>Public slot to create a new virtual environment.</td>
92 </tr><tr>
93 <td><a href="#VirtualenvManager.deleteVirtualEnvs">deleteVirtualEnvs</a></td>
94 <td>Public method to delete virtual environments from the list and disk.</td>
95 </tr><tr>
96 <td><a href="#VirtualenvManager.getDefaultEnvironment">getDefaultEnvironment</a></td>
97 <td>Public method to get the default virtual environment.</td>
98 </tr><tr>
99 <td><a href="#VirtualenvManager.getEnvironmentEntries">getEnvironmentEntries</a></td>
100 <td>Public method to get a dictionary containing the defined virtual environment entries.</td>
101 </tr><tr>
102 <td><a href="#VirtualenvManager.getVirtualenvDirectory">getVirtualenvDirectory</a></td>
103 <td>Public method to get the directory of a virtual environment.</td>
104 </tr><tr>
105 <td><a href="#VirtualenvManager.getVirtualenvExecPath">getVirtualenvExecPath</a></td>
106 <td>Public method to get the search path prefix of a virtual environment.</td>
107 </tr><tr>
108 <td><a href="#VirtualenvManager.getVirtualenvInterpreter">getVirtualenvInterpreter</a></td>
109 <td>Public method to get the interpreter for a virtual environment.</td>
110 </tr><tr>
111 <td><a href="#VirtualenvManager.getVirtualenvNames">getVirtualenvNames</a></td>
112 <td>Public method to get a list of defined virtual environments.</td>
113 </tr><tr>
114 <td><a href="#VirtualenvManager.getVirtualenvNamesForVariant">getVirtualenvNamesForVariant</a></td>
115 <td>Public method to get a list of virtual environments for a given Python variant.</td>
116 </tr><tr>
117 <td><a href="#VirtualenvManager.getVirtualenvVariant">getVirtualenvVariant</a></td>
118 <td>Public method to get the variant of a virtual environment.</td>
119 </tr><tr>
120 <td><a href="#VirtualenvManager.isCondaEnvironment">isCondaEnvironment</a></td>
121 <td>Public method to test, if a given environment is an Anaconda environment.</td>
122 </tr><tr>
123 <td><a href="#VirtualenvManager.isGlobalEnvironment">isGlobalEnvironment</a></td>
124 <td>Public method to test, if a given environment is a global one.</td>
125 </tr><tr>
126 <td><a href="#VirtualenvManager.isRemoteEnvironment">isRemoteEnvironment</a></td>
127 <td>Public method to test, if a given environment is a remotely accessed environment.</td>
128 </tr><tr>
129 <td><a href="#VirtualenvManager.isUnique">isUnique</a></td>
130 <td>Public method to check, if the give logical name is unique.</td>
131 </tr><tr>
132 <td><a href="#VirtualenvManager.removeVirtualEnvs">removeVirtualEnvs</a></td>
133 <td>Public method to delete virtual environment from the list.</td>
134 </tr><tr>
135 <td><a href="#VirtualenvManager.renameVirtualEnv">renameVirtualEnv</a></td>
136 <td>Public method to substitute a virtual environment entry with a new name.</td>
137 </tr><tr>
138 <td><a href="#VirtualenvManager.setVirtualEnv">setVirtualEnv</a></td>
139 <td>Public method to change a virtual environment.</td>
140 </tr><tr>
141 <td><a href="#VirtualenvManager.showVirtualenvManagerDialog">showVirtualenvManagerDialog</a></td>
142 <td>Public slot to show the virtual environment manager dialog.</td>
143 </tr><tr>
144 <td><a href="#VirtualenvManager.shutdown">shutdown</a></td>
145 <td>Public method to shutdown the manager.</td>
146 </tr>
147 </table>
148 <h3>Static Methods</h3>
149 <table>
150 <tr><td>None</td></tr>
151 </table>
152 <a NAME="VirtualenvManager.__init__" ID="VirtualenvManager.__init__"></a>
153 <h4>VirtualenvManager (Constructor)</h4>
154 <b>VirtualenvManager</b>(<i>parent=None</i>)
155 <p>
156 Constructor
157 </p><dl>
158 <dt><i>parent</i> (QWidget)</dt>
159 <dd>
160 reference to the parent object
161 </dd>
162 </dl><a NAME="VirtualenvManager.__isEnvironmentDeleteable" ID="VirtualenvManager.__isEnvironmentDeleteable"></a>
163 <h4>VirtualenvManager.__isEnvironmentDeleteable</h4>
164 <b>__isEnvironmentDeleteable</b>(<i>venvName</i>)
165 <p>
166 Private method to check, if a virtual environment can be deleted from
167 disk.
168 </p><dl>
169 <dt><i>venvName</i> (str)</dt>
170 <dd>
171 name of the virtual environment
172 </dd>
173 </dl><dl>
174 <dt>Returns:</dt>
175 <dd>
176 flag indicating it can be deleted
177 </dd>
178 </dl><dl>
179 <dt>Return Type:</dt>
180 <dd>
181 bool
182 </dd>
183 </dl><a NAME="VirtualenvManager.__loadSettings" ID="VirtualenvManager.__loadSettings"></a>
184 <h4>VirtualenvManager.__loadSettings</h4>
185 <b>__loadSettings</b>(<i></i>)
186 <p>
187 Private slot to load the virtual environments.
188 </p><a NAME="VirtualenvManager.__saveSettings" ID="VirtualenvManager.__saveSettings"></a>
189 <h4>VirtualenvManager.__saveSettings</h4>
190 <b>__saveSettings</b>(<i></i>)
191 <p>
192 Private slot to save the virtual environments.
193 </p><a NAME="VirtualenvManager.addVirtualEnv" ID="VirtualenvManager.addVirtualEnv"></a>
194 <h4>VirtualenvManager.addVirtualEnv</h4>
195 <b>addVirtualEnv</b>(<i>venvName, venvDirectory, venvInterpreter="", venvVariant=3, isGlobal=False, isConda=False, isRemote=False, execPath=""</i>)
196 <p>
197 Public method to add a virtual environment.
198 </p><dl>
199 <dt><i>venvName</i> (str)</dt>
200 <dd>
201 logical name for the virtual environment
202 </dd><dt><i>venvDirectory</i> (str)</dt>
203 <dd>
204 directory of the virtual environment
205 </dd><dt><i>venvInterpreter</i> (str)</dt>
206 <dd>
207 interpreter of the virtual environment
208 </dd><dt><i>venvVariant</i> (int)</dt>
209 <dd>
210 Python variant of the virtual environment
211 </dd><dt><i>isGlobal</i> (bool)</dt>
212 <dd>
213 flag indicating a global environment
214 </dd><dt><i>isConda</i> (bool)</dt>
215 <dd>
216 flag indicating an Anaconda virtual environment
217 </dd><dt><i>isRemote</i> (bool)</dt>
218 <dd>
219 flag indicating a remotely accessed environment
220 </dd><dt><i>execPath</i> (str)</dt>
221 <dd>
222 search path string to be prepended to the PATH
223 environment variable
224 </dd>
225 </dl><a NAME="VirtualenvManager.createVirtualEnv" ID="VirtualenvManager.createVirtualEnv"></a>
226 <h4>VirtualenvManager.createVirtualEnv</h4>
227 <b>createVirtualEnv</b>(<i></i>)
228 <p>
229 Public slot to create a new virtual environment.
230 </p><a NAME="VirtualenvManager.deleteVirtualEnvs" ID="VirtualenvManager.deleteVirtualEnvs"></a>
231 <h4>VirtualenvManager.deleteVirtualEnvs</h4>
232 <b>deleteVirtualEnvs</b>(<i>venvNames</i>)
233 <p>
234 Public method to delete virtual environments from the list and disk.
235 </p><dl>
236 <dt><i>venvNames</i> (list of str)</dt>
237 <dd>
238 list of logical names for the virtual environments
239 </dd>
240 </dl><a NAME="VirtualenvManager.getDefaultEnvironment" ID="VirtualenvManager.getDefaultEnvironment"></a>
241 <h4>VirtualenvManager.getDefaultEnvironment</h4>
242 <b>getDefaultEnvironment</b>(<i></i>)
243 <p>
244 Public method to get the default virtual environment.
245 </p><p>
246 Default is an environment with the key '<default>' or the first one
247 having an interpreter matching sys.executable (i.e. the one used to
248 execute eric6 with)
249 </p><dl>
250 <dt>Returns:</dt>
251 <dd>
252 tuple containing the environment name and a dictionary
253 containing a copy of the default virtual environment
254 </dd>
255 </dl><dl>
256 <dt>Return Type:</dt>
257 <dd>
258 tuple of (str, dict)
259 </dd>
260 </dl><a NAME="VirtualenvManager.getEnvironmentEntries" ID="VirtualenvManager.getEnvironmentEntries"></a>
261 <h4>VirtualenvManager.getEnvironmentEntries</h4>
262 <b>getEnvironmentEntries</b>(<i></i>)
263 <p>
264 Public method to get a dictionary containing the defined virtual
265 environment entries.
266 </p><dl>
267 <dt>Returns:</dt>
268 <dd>
269 dictionary containing a copy of the defined virtual
270 environments
271 </dd>
272 </dl><dl>
273 <dt>Return Type:</dt>
274 <dd>
275 dict
276 </dd>
277 </dl><a NAME="VirtualenvManager.getVirtualenvDirectory" ID="VirtualenvManager.getVirtualenvDirectory"></a>
278 <h4>VirtualenvManager.getVirtualenvDirectory</h4>
279 <b>getVirtualenvDirectory</b>(<i>venvName</i>)
280 <p>
281 Public method to get the directory of a virtual environment.
282 </p><dl>
283 <dt><i>venvName</i> (str)</dt>
284 <dd>
285 logical name for the virtual environment
286 </dd>
287 </dl><dl>
288 <dt>Returns:</dt>
289 <dd>
290 directory path
291 </dd>
292 </dl><dl>
293 <dt>Return Type:</dt>
294 <dd>
295 str
296 </dd>
297 </dl><a NAME="VirtualenvManager.getVirtualenvExecPath" ID="VirtualenvManager.getVirtualenvExecPath"></a>
298 <h4>VirtualenvManager.getVirtualenvExecPath</h4>
299 <b>getVirtualenvExecPath</b>(<i>venvName</i>)
300 <p>
301 Public method to get the search path prefix of a virtual environment.
302 </p><dl>
303 <dt><i>venvName</i> (str)</dt>
304 <dd>
305 logical name for the virtual environment
306 </dd>
307 </dl><dl>
308 <dt>Returns:</dt>
309 <dd>
310 search path prefix
311 </dd>
312 </dl><dl>
313 <dt>Return Type:</dt>
314 <dd>
315 str
316 </dd>
317 </dl><a NAME="VirtualenvManager.getVirtualenvInterpreter" ID="VirtualenvManager.getVirtualenvInterpreter"></a>
318 <h4>VirtualenvManager.getVirtualenvInterpreter</h4>
319 <b>getVirtualenvInterpreter</b>(<i>venvName</i>)
320 <p>
321 Public method to get the interpreter for a virtual environment.
322 </p><dl>
323 <dt><i>venvName</i> (str)</dt>
324 <dd>
325 logical name for the virtual environment
326 </dd>
327 </dl><dl>
328 <dt>Returns:</dt>
329 <dd>
330 interpreter path
331 </dd>
332 </dl><dl>
333 <dt>Return Type:</dt>
334 <dd>
335 str
336 </dd>
337 </dl><a NAME="VirtualenvManager.getVirtualenvNames" ID="VirtualenvManager.getVirtualenvNames"></a>
338 <h4>VirtualenvManager.getVirtualenvNames</h4>
339 <b>getVirtualenvNames</b>(<i>noRemote=False</i>)
340 <p>
341 Public method to get a list of defined virtual environments.
342 </p><dl>
343 <dt><i>noRemote</i> (bool)</dt>
344 <dd>
345 flag indicating to exclude environments for remote
346 debugging
347 </dd>
348 </dl><dl>
349 <dt>Returns:</dt>
350 <dd>
351 list of defined virtual environments
352 </dd>
353 </dl><dl>
354 <dt>Return Type:</dt>
355 <dd>
356 list of str
357 </dd>
358 </dl><a NAME="VirtualenvManager.getVirtualenvNamesForVariant" ID="VirtualenvManager.getVirtualenvNamesForVariant"></a>
359 <h4>VirtualenvManager.getVirtualenvNamesForVariant</h4>
360 <b>getVirtualenvNamesForVariant</b>(<i>variant</i>)
361 <p>
362 Public method to get a list of virtual environments for a given
363 Python variant.
364 </p><dl>
365 <dt><i>variant</i> (int)</dt>
366 <dd>
367 Python variant (2 or 3)
368 </dd>
369 </dl><dl>
370 <dt>Returns:</dt>
371 <dd>
372 list of defined virtual environments
373 </dd>
374 </dl><dl>
375 <dt>Return Type:</dt>
376 <dd>
377 list of str
378 </dd>
379 </dl><a NAME="VirtualenvManager.getVirtualenvVariant" ID="VirtualenvManager.getVirtualenvVariant"></a>
380 <h4>VirtualenvManager.getVirtualenvVariant</h4>
381 <b>getVirtualenvVariant</b>(<i>venvName</i>)
382 <p>
383 Public method to get the variant of a virtual environment.
384 </p><dl>
385 <dt><i>venvName</i> (str)</dt>
386 <dd>
387 logical name for the virtual environment
388 </dd>
389 </dl><dl>
390 <dt>Returns:</dt>
391 <dd>
392 Python variant of the environment
393 </dd>
394 </dl><dl>
395 <dt>Return Type:</dt>
396 <dd>
397 str
398 </dd>
399 </dl><a NAME="VirtualenvManager.isCondaEnvironment" ID="VirtualenvManager.isCondaEnvironment"></a>
400 <h4>VirtualenvManager.isCondaEnvironment</h4>
401 <b>isCondaEnvironment</b>(<i>venvName</i>)
402 <p>
403 Public method to test, if a given environment is an Anaconda
404 environment.
405 </p><dl>
406 <dt><i>venvName</i> (str)</dt>
407 <dd>
408 logical name of the virtual environment
409 </dd>
410 </dl><dl>
411 <dt>Returns:</dt>
412 <dd>
413 flag indicating an Anaconda environment
414 </dd>
415 </dl><dl>
416 <dt>Return Type:</dt>
417 <dd>
418 bool
419 </dd>
420 </dl><a NAME="VirtualenvManager.isGlobalEnvironment" ID="VirtualenvManager.isGlobalEnvironment"></a>
421 <h4>VirtualenvManager.isGlobalEnvironment</h4>
422 <b>isGlobalEnvironment</b>(<i>venvName</i>)
423 <p>
424 Public method to test, if a given environment is a global one.
425 </p><dl>
426 <dt><i>venvName</i> (str)</dt>
427 <dd>
428 logical name of the virtual environment
429 </dd>
430 </dl><dl>
431 <dt>Returns:</dt>
432 <dd>
433 flag indicating a global environment
434 </dd>
435 </dl><dl>
436 <dt>Return Type:</dt>
437 <dd>
438 bool
439 </dd>
440 </dl><a NAME="VirtualenvManager.isRemoteEnvironment" ID="VirtualenvManager.isRemoteEnvironment"></a>
441 <h4>VirtualenvManager.isRemoteEnvironment</h4>
442 <b>isRemoteEnvironment</b>(<i>venvName</i>)
443 <p>
444 Public method to test, if a given environment is a remotely accessed
445 environment.
446 </p><dl>
447 <dt><i>venvName</i> (str)</dt>
448 <dd>
449 logical name of the virtual environment
450 </dd>
451 </dl><dl>
452 <dt>Returns:</dt>
453 <dd>
454 flag indicating a remotely accessed environment
455 </dd>
456 </dl><dl>
457 <dt>Return Type:</dt>
458 <dd>
459 bool
460 </dd>
461 </dl><a NAME="VirtualenvManager.isUnique" ID="VirtualenvManager.isUnique"></a>
462 <h4>VirtualenvManager.isUnique</h4>
463 <b>isUnique</b>(<i>venvName</i>)
464 <p>
465 Public method to check, if the give logical name is unique.
466 </p><dl>
467 <dt><i>venvName</i> (str)</dt>
468 <dd>
469 logical name for the virtual environment
470 </dd>
471 </dl><dl>
472 <dt>Returns:</dt>
473 <dd>
474 flag indicating uniqueness
475 </dd>
476 </dl><dl>
477 <dt>Return Type:</dt>
478 <dd>
479 bool
480 </dd>
481 </dl><a NAME="VirtualenvManager.removeVirtualEnvs" ID="VirtualenvManager.removeVirtualEnvs"></a>
482 <h4>VirtualenvManager.removeVirtualEnvs</h4>
483 <b>removeVirtualEnvs</b>(<i>venvNames</i>)
484 <p>
485 Public method to delete virtual environment from the list.
486 </p><dl>
487 <dt><i>venvNames</i> (list of str)</dt>
488 <dd>
489 list of logical names for the virtual environments
490 </dd>
491 </dl><a NAME="VirtualenvManager.renameVirtualEnv" ID="VirtualenvManager.renameVirtualEnv"></a>
492 <h4>VirtualenvManager.renameVirtualEnv</h4>
493 <b>renameVirtualEnv</b>(<i>oldVenvName, venvName, venvDirectory, venvInterpreter, venvVariant, isGlobal, isConda, isRemote, execPath</i>)
494 <p>
495 Public method to substitute a virtual environment entry with a new
496 name.
497 </p><dl>
498 <dt><i>oldVenvName</i> (str)</dt>
499 <dd>
500 old name of the virtual environment
501 </dd><dt><i>venvName</i> (str)</dt>
502 <dd>
503 logical name for the virtual environment
504 </dd><dt><i>venvDirectory</i> (str)</dt>
505 <dd>
506 directory of the virtual environment
507 </dd><dt><i>venvInterpreter</i> (str)</dt>
508 <dd>
509 interpreter of the virtual environment
510 </dd><dt><i>venvVariant</i> (int)</dt>
511 <dd>
512 Python variant of the virtual environment
513 </dd><dt><i>isGlobal</i> (bool)</dt>
514 <dd>
515 flag indicating a global environment
516 </dd><dt><i>isConda</i> (bool)</dt>
517 <dd>
518 flag indicating an Anaconda virtual environment
519 </dd><dt><i>isRemote</i> (bool)</dt>
520 <dd>
521 flag indicating a remotely accessed environment
522 </dd><dt><i>execPath</i> (str)</dt>
523 <dd>
524 search path string to be prepended to the PATH
525 environment variable
526 </dd>
527 </dl><a NAME="VirtualenvManager.setVirtualEnv" ID="VirtualenvManager.setVirtualEnv"></a>
528 <h4>VirtualenvManager.setVirtualEnv</h4>
529 <b>setVirtualEnv</b>(<i>venvName, venvDirectory, venvInterpreter, venvVariant, isGlobal, isConda, isRemote, execPath</i>)
530 <p>
531 Public method to change a virtual environment.
532 </p><dl>
533 <dt><i>venvName</i> (str)</dt>
534 <dd>
535 logical name of the virtual environment
536 </dd><dt><i>venvDirectory</i> (str)</dt>
537 <dd>
538 directory of the virtual environment
539 </dd><dt><i>venvInterpreter</i> (str)</dt>
540 <dd>
541 interpreter of the virtual environment
542 </dd><dt><i>venvVariant</i> (int)</dt>
543 <dd>
544 Python variant of the virtual environment
545 </dd><dt><i>isGlobal</i> (bool)</dt>
546 <dd>
547 flag indicating a global environment
548 </dd><dt><i>isConda</i> (bool)</dt>
549 <dd>
550 flag indicating an Anaconda virtual environment
551 </dd><dt><i>isRemote</i> (bool)</dt>
552 <dd>
553 flag indicating a remotely accessed environment
554 </dd><dt><i>execPath</i> (str)</dt>
555 <dd>
556 search path string to be prepended to the PATH
557 environment variable
558 </dd>
559 </dl><a NAME="VirtualenvManager.showVirtualenvManagerDialog" ID="VirtualenvManager.showVirtualenvManagerDialog"></a>
560 <h4>VirtualenvManager.showVirtualenvManagerDialog</h4>
561 <b>showVirtualenvManagerDialog</b>(<i>modal=False</i>)
562 <p>
563 Public slot to show the virtual environment manager dialog.
564 </p><dl>
565 <dt><i>modal</i></dt>
566 <dd>
567 flag indicating that the dialog should be shown in
568 a blocking mode
569 </dd>
570 </dl><a NAME="VirtualenvManager.shutdown" ID="VirtualenvManager.shutdown"></a>
571 <h4>VirtualenvManager.shutdown</h4>
572 <b>shutdown</b>(<i></i>)
573 <p>
574 Public method to shutdown the manager.
575 </p>
576 <div align="right"><a href="#top">Up</a></div>
577 <hr />
578 </body></html>

Mercurial Repository: eric

eric ide

mercurial