src/eric7/Documentation/Source/eric7.VCS.VersionControl.html

branch
eric7
changeset 9209
b99e7fd55fd3
parent 8652
8cacde11f4fd
child 10070
9f5758c0fec1
equal deleted inserted replaced
9208:3fc8dfeb6ebe 9209:b99e7fd55fd3
1 <!DOCTYPE html>
2 <html><head>
3 <title>eric7.VCS.VersionControl</title>
4 <meta charset="UTF-8">
5 <link rel="stylesheet" href="styles.css">
6 </head>
7 <body>
8 <a NAME="top" ID="top"></a>
9 <h1>eric7.VCS.VersionControl</h1>
10
11 <p>
12 Module implementing an abstract base class to be subclassed by all specific
13 VCS interfaces.
14 </p>
15 <h3>Global Attributes</h3>
16
17 <table>
18 <tr><td>None</td></tr>
19 </table>
20 <h3>Classes</h3>
21
22 <table>
23
24 <tr>
25 <td><a href="#VersionControl">VersionControl</a></td>
26 <td>Class implementing an abstract base class to be subclassed by all specific VCS interfaces.</td>
27 </tr>
28 </table>
29 <h3>Functions</h3>
30
31 <table>
32 <tr><td>None</td></tr>
33 </table>
34 <hr />
35 <hr />
36 <a NAME="VersionControl" ID="VersionControl"></a>
37 <h2>VersionControl</h2>
38
39 <p>
40 Class implementing an abstract base class to be subclassed by all specific
41 VCS interfaces.
42 </p>
43 <p>
44 It defines the vcs interface to be implemented by subclasses
45 and the common methods.
46 </p>
47 <h3>Signals</h3>
48 <dl>
49
50 <dt>committed()</dt>
51 <dd>
52 emitted after the commit action has completed
53 </dd>
54 <dt>vcsStatusChanged()</dt>
55 <dd>
56 emitted to indicate a change of the overall
57 VCS status
58 </dd>
59 <dt>vcsStatusMonitorAllData(dict)</dt>
60 <dd>
61 emitted to signal all VCS status
62 (key is project relative file name, value is status)
63 </dd>
64 <dt>vcsStatusMonitorData(list of str)</dt>
65 <dd>
66 emitted to update the VCS status
67 </dd>
68 <dt>vcsStatusMonitorInfo(str)</dt>
69 <dd>
70 emitted to signal some info of the
71 monitoring thread
72 </dd>
73 <dt>vcsStatusMonitorStatus(str, str)</dt>
74 <dd>
75 emitted to signal the status of
76 the monitoring thread (ok, nok, op, off) and a status message
77 </dd>
78 </dl>
79 <h3>Derived from</h3>
80 QObject
81 <h3>Class Attributes</h3>
82
83 <table>
84 <tr><td>canBeAdded</td></tr><tr><td>canBeCommitted</td></tr><tr><td>commitHistoryData</td></tr><tr><td>commitHistoryLock</td></tr>
85 </table>
86 <h3>Class Methods</h3>
87
88 <table>
89 <tr><td>None</td></tr>
90 </table>
91 <h3>Methods</h3>
92
93 <table>
94
95 <tr>
96 <td><a href="#VersionControl.__init__">VersionControl</a></td>
97 <td>Constructor</td>
98 </tr>
99 <tr>
100 <td><a href="#VersionControl.__statusMonitorAllData">__statusMonitorAllData</a></td>
101 <td>Private method to receive all status monitor data.</td>
102 </tr>
103 <tr>
104 <td><a href="#VersionControl.__statusMonitorData">__statusMonitorData</a></td>
105 <td>Private method to receive the status monitor data update.</td>
106 </tr>
107 <tr>
108 <td><a href="#VersionControl.__statusMonitorInfo">__statusMonitorInfo</a></td>
109 <td>Private slot to receive the status monitor info message.</td>
110 </tr>
111 <tr>
112 <td><a href="#VersionControl.__statusMonitorStatus">__statusMonitorStatus</a></td>
113 <td>Private slot to receive the status monitor status.</td>
114 </tr>
115 <tr>
116 <td><a href="#VersionControl._createStatusMonitorThread">_createStatusMonitorThread</a></td>
117 <td>Protected method to create an instance of the VCS status monitor thread.</td>
118 </tr>
119 <tr>
120 <td><a href="#VersionControl._vcsAddProjectCommitMessage">_vcsAddProjectCommitMessage</a></td>
121 <td>Protected method to add a commit message to the list of project specific saved messages.</td>
122 </tr>
123 <tr>
124 <td><a href="#VersionControl._vcsClearProjectCommitMessages">_vcsClearProjectCommitMessages</a></td>
125 <td>Protected method to clear the list of project specific saved messages.</td>
126 </tr>
127 <tr>
128 <td><a href="#VersionControl._vcsProjectCommitMessages">_vcsProjectCommitMessages</a></td>
129 <td>Protected method to get the list of saved commit messages.</td>
130 </tr>
131 <tr>
132 <td><a href="#VersionControl.addArguments">addArguments</a></td>
133 <td>Public method to add an argument list to the already present arguments.</td>
134 </tr>
135 <tr>
136 <td><a href="#VersionControl.checkVCSStatus">checkVCSStatus</a></td>
137 <td>Public method to wake up the VCS status monitor thread.</td>
138 </tr>
139 <tr>
140 <td><a href="#VersionControl.clearStatusCache">clearStatusCache</a></td>
141 <td>Public method to clear the status cache.</td>
142 </tr>
143 <tr>
144 <td><a href="#VersionControl.clearStatusMonitorCachedState">clearStatusMonitorCachedState</a></td>
145 <td>Public method to clear the cached VCS state of a file/directory.</td>
146 </tr>
147 <tr>
148 <td><a href="#VersionControl.getStatusMonitorAutoUpdate">getStatusMonitorAutoUpdate</a></td>
149 <td>Public method to retrieve the status of the auto update function.</td>
150 </tr>
151 <tr>
152 <td><a href="#VersionControl.getStatusMonitorInterval">getStatusMonitorInterval</a></td>
153 <td>Public method to get the monitor interval.</td>
154 </tr>
155 <tr>
156 <td><a href="#VersionControl.setStatusMonitorAutoUpdate">setStatusMonitorAutoUpdate</a></td>
157 <td>Public method to enable the auto update function.</td>
158 </tr>
159 <tr>
160 <td><a href="#VersionControl.setStatusMonitorInterval">setStatusMonitorInterval</a></td>
161 <td>Public method to change the monitor interval.</td>
162 </tr>
163 <tr>
164 <td><a href="#VersionControl.splitPath">splitPath</a></td>
165 <td>Public method splitting name into a directory part and a file part.</td>
166 </tr>
167 <tr>
168 <td><a href="#VersionControl.splitPathList">splitPathList</a></td>
169 <td>Public method splitting the list of names into a common directory part and a file list.</td>
170 </tr>
171 <tr>
172 <td><a href="#VersionControl.startStatusMonitor">startStatusMonitor</a></td>
173 <td>Public method to start the VCS status monitor thread.</td>
174 </tr>
175 <tr>
176 <td><a href="#VersionControl.startSynchronizedProcess">startSynchronizedProcess</a></td>
177 <td>Public method to start a synchroneous process.</td>
178 </tr>
179 <tr>
180 <td><a href="#VersionControl.stopStatusMonitor">stopStatusMonitor</a></td>
181 <td>Public method to stop the VCS status monitor thread.</td>
182 </tr>
183 <tr>
184 <td><a href="#VersionControl.vcsAdd">vcsAdd</a></td>
185 <td>Public method used to add a file/directory in the vcs.</td>
186 </tr>
187 <tr>
188 <td><a href="#VersionControl.vcsAddBinary">vcsAddBinary</a></td>
189 <td>Public method used to add a file/directory in binary mode in the vcs.</td>
190 </tr>
191 <tr>
192 <td><a href="#VersionControl.vcsAddCommitMessage">vcsAddCommitMessage</a></td>
193 <td>Public method to add a commit message to the list of saved messages.</td>
194 </tr>
195 <tr>
196 <td><a href="#VersionControl.vcsAddTree">vcsAddTree</a></td>
197 <td>Public method to add a directory tree rooted at path in the vcs.</td>
198 </tr>
199 <tr>
200 <td><a href="#VersionControl.vcsAllRegisteredStates">vcsAllRegisteredStates</a></td>
201 <td>Public method used to get the registered states of a number of files in the vcs.</td>
202 </tr>
203 <tr>
204 <td><a href="#VersionControl.vcsCheckout">vcsCheckout</a></td>
205 <td>Public method used to check the project out of the vcs.</td>
206 </tr>
207 <tr>
208 <td><a href="#VersionControl.vcsCleanup">vcsCleanup</a></td>
209 <td>Public method used to cleanup the local copy.</td>
210 </tr>
211 <tr>
212 <td><a href="#VersionControl.vcsClearCommitMessages">vcsClearCommitMessages</a></td>
213 <td>Public method to clear the list of saved messages.</td>
214 </tr>
215 <tr>
216 <td><a href="#VersionControl.vcsCommandLine">vcsCommandLine</a></td>
217 <td>Public method used to execute arbitrary vcs commands.</td>
218 </tr>
219 <tr>
220 <td><a href="#VersionControl.vcsCommit">vcsCommit</a></td>
221 <td>Public method used to make the change of a file/directory permanent in the vcs.</td>
222 </tr>
223 <tr>
224 <td><a href="#VersionControl.vcsCommitMessages">vcsCommitMessages</a></td>
225 <td>Public method to get the list of saved commit messages.</td>
226 </tr>
227 <tr>
228 <td><a href="#VersionControl.vcsConvertProject">vcsConvertProject</a></td>
229 <td>Public method to convert an uncontrolled project to a version controlled project.</td>
230 </tr>
231 <tr>
232 <td><a href="#VersionControl.vcsDiff">vcsDiff</a></td>
233 <td>Public method used to view the diff of a file/directory in the vcs.</td>
234 </tr>
235 <tr>
236 <td><a href="#VersionControl.vcsExists">vcsExists</a></td>
237 <td>Public method used to test for the presence of the vcs.</td>
238 </tr>
239 <tr>
240 <td><a href="#VersionControl.vcsExport">vcsExport</a></td>
241 <td>Public method used to export a directory from the vcs.</td>
242 </tr>
243 <tr>
244 <td><a href="#VersionControl.vcsForget">vcsForget</a></td>
245 <td>Public method used to remove a file from the repository.</td>
246 </tr>
247 <tr>
248 <td><a href="#VersionControl.vcsGetOptions">vcsGetOptions</a></td>
249 <td>Public method used to retrieve the options of the vcs.</td>
250 </tr>
251 <tr>
252 <td><a href="#VersionControl.vcsGetOtherData">vcsGetOtherData</a></td>
253 <td>Public method used to retrieve vcs specific data.</td>
254 </tr>
255 <tr>
256 <td><a href="#VersionControl.vcsGetProjectBrowserHelper">vcsGetProjectBrowserHelper</a></td>
257 <td>Public method to instanciate a helper object for the different project browsers.</td>
258 </tr>
259 <tr>
260 <td><a href="#VersionControl.vcsGetProjectHelper">vcsGetProjectHelper</a></td>
261 <td>Public method to instanciate a helper object for the project.</td>
262 </tr>
263 <tr>
264 <td><a href="#VersionControl.vcsImport">vcsImport</a></td>
265 <td>Public method used to import the project into the vcs.</td>
266 </tr>
267 <tr>
268 <td><a href="#VersionControl.vcsInit">vcsInit</a></td>
269 <td>Public method used to initialize the vcs.</td>
270 </tr>
271 <tr>
272 <td><a href="#VersionControl.vcsInitConfig">vcsInitConfig</a></td>
273 <td>Public method to initialize the VCS configuration.</td>
274 </tr>
275 <tr>
276 <td><a href="#VersionControl.vcsLogBrowser">vcsLogBrowser</a></td>
277 <td>Public method used to view the log of a file/directory in the vcs with a log browser dialog.</td>
278 </tr>
279 <tr>
280 <td><a href="#VersionControl.vcsMerge">vcsMerge</a></td>
281 <td>Public method used to merge a tag/branch into the local project.</td>
282 </tr>
283 <tr>
284 <td><a href="#VersionControl.vcsMove">vcsMove</a></td>
285 <td>Public method used to move a file/directory.</td>
286 </tr>
287 <tr>
288 <td><a href="#VersionControl.vcsName">vcsName</a></td>
289 <td>Public method returning the name of the vcs.</td>
290 </tr>
291 <tr>
292 <td><a href="#VersionControl.vcsNewProjectOptionsDialog">vcsNewProjectOptionsDialog</a></td>
293 <td>Public method to get a dialog to enter repository info for getting a new project.</td>
294 </tr>
295 <tr>
296 <td><a href="#VersionControl.vcsOptionsDialog">vcsOptionsDialog</a></td>
297 <td>Public method to get a dialog to enter repository info.</td>
298 </tr>
299 <tr>
300 <td><a href="#VersionControl.vcsRegisteredState">vcsRegisteredState</a></td>
301 <td>Public method used to get the registered state of a file in the vcs.</td>
302 </tr>
303 <tr>
304 <td><a href="#VersionControl.vcsRemove">vcsRemove</a></td>
305 <td>Public method used to add a file/directory in the vcs.</td>
306 </tr>
307 <tr>
308 <td><a href="#VersionControl.vcsRepositoryInfos">vcsRepositoryInfos</a></td>
309 <td>Public method to retrieve information about the repository.</td>
310 </tr>
311 <tr>
312 <td><a href="#VersionControl.vcsResolved">vcsResolved</a></td>
313 <td>Public method used to resolve conflicts of a file/directory.</td>
314 </tr>
315 <tr>
316 <td><a href="#VersionControl.vcsRevert">vcsRevert</a></td>
317 <td>Public method used to revert changes made to a file/directory.</td>
318 </tr>
319 <tr>
320 <td><a href="#VersionControl.vcsSbsDiff">vcsSbsDiff</a></td>
321 <td>Public method used to view the difference of a file to the Mercurial repository side-by-side.</td>
322 </tr>
323 <tr>
324 <td><a href="#VersionControl.vcsSetData">vcsSetData</a></td>
325 <td>Public method used to set an entry in the otherData dictionary.</td>
326 </tr>
327 <tr>
328 <td><a href="#VersionControl.vcsSetDataFromDict">vcsSetDataFromDict</a></td>
329 <td>Public method used to set entries in the otherData dictionary.</td>
330 </tr>
331 <tr>
332 <td><a href="#VersionControl.vcsSetOptions">vcsSetOptions</a></td>
333 <td>Public method used to set the options for the vcs.</td>
334 </tr>
335 <tr>
336 <td><a href="#VersionControl.vcsSetOtherData">vcsSetOtherData</a></td>
337 <td>Public method used to set vcs specific data.</td>
338 </tr>
339 <tr>
340 <td><a href="#VersionControl.vcsShutdown">vcsShutdown</a></td>
341 <td>Public method used to shutdown the vcs interface.</td>
342 </tr>
343 <tr>
344 <td><a href="#VersionControl.vcsStatus">vcsStatus</a></td>
345 <td>Public method used to view the status of a file/directory in the vcs.</td>
346 </tr>
347 <tr>
348 <td><a href="#VersionControl.vcsSupportCommandOptions">vcsSupportCommandOptions</a></td>
349 <td>Public method to signal the support of user settable command options.</td>
350 </tr>
351 <tr>
352 <td><a href="#VersionControl.vcsSwitch">vcsSwitch</a></td>
353 <td>Public method used to switch a directory to a different tag/branch.</td>
354 </tr>
355 <tr>
356 <td><a href="#VersionControl.vcsTag">vcsTag</a></td>
357 <td>Public method used to set the tag of a file/directory in the vcs.</td>
358 </tr>
359 <tr>
360 <td><a href="#VersionControl.vcsUpdate">vcsUpdate</a></td>
361 <td>Public method used to update a file/directory in the vcs.</td>
362 </tr>
363 </table>
364 <h3>Static Methods</h3>
365
366 <table>
367 <tr><td>None</td></tr>
368 </table>
369
370 <a NAME="VersionControl.__init__" ID="VersionControl.__init__"></a>
371 <h4>VersionControl (Constructor)</h4>
372 <b>VersionControl</b>(<i>parent=None, name=None</i>)
373
374 <p>
375 Constructor
376 </p>
377 <dl>
378
379 <dt><i>parent</i></dt>
380 <dd>
381 parent widget (QWidget)
382 </dd>
383 <dt><i>name</i></dt>
384 <dd>
385 name of this object (string)
386 </dd>
387 </dl>
388 <a NAME="VersionControl.__statusMonitorAllData" ID="VersionControl.__statusMonitorAllData"></a>
389 <h4>VersionControl.__statusMonitorAllData</h4>
390 <b>__statusMonitorAllData</b>(<i>statusDict</i>)
391
392 <p>
393 Private method to receive all status monitor data.
394 </p>
395 <p>
396 It simply re-emits the received status list.
397 </p>
398 <dl>
399
400 <dt><i>statusDict</i> (dict)</dt>
401 <dd>
402 dictionary of status records
403 </dd>
404 </dl>
405 <a NAME="VersionControl.__statusMonitorData" ID="VersionControl.__statusMonitorData"></a>
406 <h4>VersionControl.__statusMonitorData</h4>
407 <b>__statusMonitorData</b>(<i>statusList</i>)
408
409 <p>
410 Private method to receive the status monitor data update.
411 </p>
412 <p>
413 It simply re-emits the received status list.
414 </p>
415 <dl>
416
417 <dt><i>statusList</i> (list of str)</dt>
418 <dd>
419 list of status records
420 </dd>
421 </dl>
422 <a NAME="VersionControl.__statusMonitorInfo" ID="VersionControl.__statusMonitorInfo"></a>
423 <h4>VersionControl.__statusMonitorInfo</h4>
424 <b>__statusMonitorInfo</b>(<i>info</i>)
425
426 <p>
427 Private slot to receive the status monitor info message.
428 </p>
429 <p>
430 It simply re-emits the received info message.
431 </p>
432 <dl>
433
434 <dt><i>info</i> (str)</dt>
435 <dd>
436 received info message
437 </dd>
438 </dl>
439 <a NAME="VersionControl.__statusMonitorStatus" ID="VersionControl.__statusMonitorStatus"></a>
440 <h4>VersionControl.__statusMonitorStatus</h4>
441 <b>__statusMonitorStatus</b>(<i>status, statusMsg</i>)
442
443 <p>
444 Private slot to receive the status monitor status.
445 </p>
446 <p>
447 It simply re-emits the received status.
448 </p>
449 <dl>
450
451 <dt><i>status</i> (str (one of ok, nok or off))</dt>
452 <dd>
453 status of the monitoring thread
454 </dd>
455 <dt><i>statusMsg</i> (str)</dt>
456 <dd>
457 explanotory text for the signaled status
458 </dd>
459 </dl>
460 <a NAME="VersionControl._createStatusMonitorThread" ID="VersionControl._createStatusMonitorThread"></a>
461 <h4>VersionControl._createStatusMonitorThread</h4>
462 <b>_createStatusMonitorThread</b>(<i>interval, project</i>)
463
464 <p>
465 Protected method to create an instance of the VCS status monitor
466 thread.
467 </p>
468 <p>
469 Note: This method should be overwritten in subclasses in order to
470 support VCS status monitoring.
471 </p>
472 <dl>
473
474 <dt><i>interval</i></dt>
475 <dd>
476 check interval for the monitor thread in seconds
477 (integer)
478 </dd>
479 <dt><i>project</i></dt>
480 <dd>
481 reference to the project object
482 </dd>
483 </dl>
484 <dl>
485 <dt>Return:</dt>
486 <dd>
487 reference to the monitor thread (QThread)
488 </dd>
489 </dl>
490 <a NAME="VersionControl._vcsAddProjectCommitMessage" ID="VersionControl._vcsAddProjectCommitMessage"></a>
491 <h4>VersionControl._vcsAddProjectCommitMessage</h4>
492 <b>_vcsAddProjectCommitMessage</b>(<i>message</i>)
493
494 <p>
495 Protected method to add a commit message to the list of project
496 specific saved messages.
497 </p>
498 <dl>
499
500 <dt><i>message</i> (str)</dt>
501 <dd>
502 message to be added
503 </dd>
504 </dl>
505 <dl>
506 <dt>Return:</dt>
507 <dd>
508 flag indicating success
509 </dd>
510 </dl>
511 <dl>
512 <dt>Return Type:</dt>
513 <dd>
514 bool
515 </dd>
516 </dl>
517 <a NAME="VersionControl._vcsClearProjectCommitMessages" ID="VersionControl._vcsClearProjectCommitMessages"></a>
518 <h4>VersionControl._vcsClearProjectCommitMessages</h4>
519 <b>_vcsClearProjectCommitMessages</b>(<i></i>)
520
521 <p>
522 Protected method to clear the list of project specific saved messages.
523 </p>
524 <dl>
525 <dt>Return:</dt>
526 <dd>
527 flag indicating success
528 </dd>
529 </dl>
530 <dl>
531 <dt>Return Type:</dt>
532 <dd>
533 bool
534 </dd>
535 </dl>
536 <a NAME="VersionControl._vcsProjectCommitMessages" ID="VersionControl._vcsProjectCommitMessages"></a>
537 <h4>VersionControl._vcsProjectCommitMessages</h4>
538 <b>_vcsProjectCommitMessages</b>(<i></i>)
539
540 <p>
541 Protected method to get the list of saved commit messages.
542 </p>
543 <dl>
544 <dt>Return:</dt>
545 <dd>
546 list of saved commit messages
547 </dd>
548 </dl>
549 <dl>
550 <dt>Return Type:</dt>
551 <dd>
552 list of str
553 </dd>
554 </dl>
555 <a NAME="VersionControl.addArguments" ID="VersionControl.addArguments"></a>
556 <h4>VersionControl.addArguments</h4>
557 <b>addArguments</b>(<i>args, argslist</i>)
558
559 <p>
560 Public method to add an argument list to the already present
561 arguments.
562 </p>
563 <dl>
564
565 <dt><i>args</i></dt>
566 <dd>
567 current arguments list (list of strings)
568 </dd>
569 <dt><i>argslist</i></dt>
570 <dd>
571 list of arguments (list of strings)
572 </dd>
573 </dl>
574 <a NAME="VersionControl.checkVCSStatus" ID="VersionControl.checkVCSStatus"></a>
575 <h4>VersionControl.checkVCSStatus</h4>
576 <b>checkVCSStatus</b>(<i></i>)
577
578 <p>
579 Public method to wake up the VCS status monitor thread.
580 </p>
581 <a NAME="VersionControl.clearStatusCache" ID="VersionControl.clearStatusCache"></a>
582 <h4>VersionControl.clearStatusCache</h4>
583 <b>clearStatusCache</b>(<i></i>)
584
585 <p>
586 Public method to clear the status cache.
587 </p>
588 <a NAME="VersionControl.clearStatusMonitorCachedState" ID="VersionControl.clearStatusMonitorCachedState"></a>
589 <h4>VersionControl.clearStatusMonitorCachedState</h4>
590 <b>clearStatusMonitorCachedState</b>(<i>name</i>)
591
592 <p>
593 Public method to clear the cached VCS state of a file/directory.
594 </p>
595 <dl>
596
597 <dt><i>name</i></dt>
598 <dd>
599 name of the entry to be cleared (string)
600 </dd>
601 </dl>
602 <a NAME="VersionControl.getStatusMonitorAutoUpdate" ID="VersionControl.getStatusMonitorAutoUpdate"></a>
603 <h4>VersionControl.getStatusMonitorAutoUpdate</h4>
604 <b>getStatusMonitorAutoUpdate</b>(<i></i>)
605
606 <p>
607 Public method to retrieve the status of the auto update function.
608 </p>
609 <dl>
610 <dt>Return:</dt>
611 <dd>
612 status of the auto update function (boolean)
613 </dd>
614 </dl>
615 <a NAME="VersionControl.getStatusMonitorInterval" ID="VersionControl.getStatusMonitorInterval"></a>
616 <h4>VersionControl.getStatusMonitorInterval</h4>
617 <b>getStatusMonitorInterval</b>(<i></i>)
618
619 <p>
620 Public method to get the monitor interval.
621 </p>
622 <dl>
623 <dt>Return:</dt>
624 <dd>
625 interval in seconds (integer)
626 </dd>
627 </dl>
628 <a NAME="VersionControl.setStatusMonitorAutoUpdate" ID="VersionControl.setStatusMonitorAutoUpdate"></a>
629 <h4>VersionControl.setStatusMonitorAutoUpdate</h4>
630 <b>setStatusMonitorAutoUpdate</b>(<i>auto</i>)
631
632 <p>
633 Public method to enable the auto update function.
634 </p>
635 <dl>
636
637 <dt><i>auto</i></dt>
638 <dd>
639 status of the auto update function (boolean)
640 </dd>
641 </dl>
642 <a NAME="VersionControl.setStatusMonitorInterval" ID="VersionControl.setStatusMonitorInterval"></a>
643 <h4>VersionControl.setStatusMonitorInterval</h4>
644 <b>setStatusMonitorInterval</b>(<i>interval, project</i>)
645
646 <p>
647 Public method to change the monitor interval.
648 </p>
649 <dl>
650
651 <dt><i>interval</i></dt>
652 <dd>
653 new interval in seconds (integer)
654 </dd>
655 <dt><i>project</i></dt>
656 <dd>
657 reference to the project object
658 </dd>
659 </dl>
660 <a NAME="VersionControl.splitPath" ID="VersionControl.splitPath"></a>
661 <h4>VersionControl.splitPath</h4>
662 <b>splitPath</b>(<i>name</i>)
663
664 <p>
665 Public method splitting name into a directory part and a file part.
666 </p>
667 <dl>
668
669 <dt><i>name</i></dt>
670 <dd>
671 path name (string)
672 </dd>
673 </dl>
674 <dl>
675 <dt>Return:</dt>
676 <dd>
677 a tuple of 2 strings (dirname, filename).
678 </dd>
679 </dl>
680 <a NAME="VersionControl.splitPathList" ID="VersionControl.splitPathList"></a>
681 <h4>VersionControl.splitPathList</h4>
682 <b>splitPathList</b>(<i>names</i>)
683
684 <p>
685 Public method splitting the list of names into a common directory part
686 and a file list.
687 </p>
688 <dl>
689
690 <dt><i>names</i></dt>
691 <dd>
692 list of paths (list of strings)
693 </dd>
694 </dl>
695 <dl>
696 <dt>Return:</dt>
697 <dd>
698 a tuple of string and list of strings (dirname, filenamelist)
699 </dd>
700 </dl>
701 <a NAME="VersionControl.startStatusMonitor" ID="VersionControl.startStatusMonitor"></a>
702 <h4>VersionControl.startStatusMonitor</h4>
703 <b>startStatusMonitor</b>(<i>project</i>)
704
705 <p>
706 Public method to start the VCS status monitor thread.
707 </p>
708 <dl>
709
710 <dt><i>project</i></dt>
711 <dd>
712 reference to the project object
713 </dd>
714 </dl>
715 <dl>
716 <dt>Return:</dt>
717 <dd>
718 reference to the monitor thread (QThread)
719 </dd>
720 </dl>
721 <a NAME="VersionControl.startSynchronizedProcess" ID="VersionControl.startSynchronizedProcess"></a>
722 <h4>VersionControl.startSynchronizedProcess</h4>
723 <b>startSynchronizedProcess</b>(<i>proc, program, arguments, workingDir=None</i>)
724
725 <p>
726 Public method to start a synchroneous process.
727 </p>
728 <p>
729 This method starts a process and waits
730 for its end while still serving the Qt event loop.
731 </p>
732 <dl>
733
734 <dt><i>proc</i></dt>
735 <dd>
736 process to start (QProcess)
737 </dd>
738 <dt><i>program</i></dt>
739 <dd>
740 path of the executable to start (string)
741 </dd>
742 <dt><i>arguments</i></dt>
743 <dd>
744 list of arguments for the process (list of strings)
745 </dd>
746 <dt><i>workingDir</i></dt>
747 <dd>
748 working directory for the process (string)
749 </dd>
750 </dl>
751 <dl>
752 <dt>Return:</dt>
753 <dd>
754 flag indicating normal exit (boolean)
755 </dd>
756 </dl>
757 <a NAME="VersionControl.stopStatusMonitor" ID="VersionControl.stopStatusMonitor"></a>
758 <h4>VersionControl.stopStatusMonitor</h4>
759 <b>stopStatusMonitor</b>(<i></i>)
760
761 <p>
762 Public method to stop the VCS status monitor thread.
763 </p>
764 <a NAME="VersionControl.vcsAdd" ID="VersionControl.vcsAdd"></a>
765 <h4>VersionControl.vcsAdd</h4>
766 <b>vcsAdd</b>(<i>name, isDir=False, noDialog=False</i>)
767
768 <p>
769 Public method used to add a file/directory in the vcs.
770 </p>
771 <dl>
772
773 <dt><i>name</i></dt>
774 <dd>
775 file/directory name to be added (string)
776 </dd>
777 <dt><i>isDir</i></dt>
778 <dd>
779 flag indicating name is a directory (boolean)
780 </dd>
781 <dt><i>noDialog</i></dt>
782 <dd>
783 flag indicating quiet operations (boolean)
784 </dd>
785 </dl>
786 <dl>
787
788 <dt>Raises <b>RuntimeError</b>:</dt>
789 <dd>
790 to indicate that this method must be
791 implemented by a subclass
792 </dd>
793 </dl>
794 <a NAME="VersionControl.vcsAddBinary" ID="VersionControl.vcsAddBinary"></a>
795 <h4>VersionControl.vcsAddBinary</h4>
796 <b>vcsAddBinary</b>(<i>name, isDir=False</i>)
797
798 <p>
799 Public method used to add a file/directory in binary mode in the vcs.
800 </p>
801 <dl>
802
803 <dt><i>name</i></dt>
804 <dd>
805 file/directory name to be added (string)
806 </dd>
807 <dt><i>isDir</i></dt>
808 <dd>
809 flag indicating name is a directory (boolean)
810 </dd>
811 </dl>
812 <dl>
813
814 <dt>Raises <b>RuntimeError</b>:</dt>
815 <dd>
816 to indicate that this method must be
817 implemented by a subclass
818 </dd>
819 </dl>
820 <a NAME="VersionControl.vcsAddCommitMessage" ID="VersionControl.vcsAddCommitMessage"></a>
821 <h4>VersionControl.vcsAddCommitMessage</h4>
822 <b>vcsAddCommitMessage</b>(<i>message</i>)
823
824 <p>
825 Public method to add a commit message to the list of saved messages.
826 </p>
827 <dl>
828
829 <dt><i>message</i> (str)</dt>
830 <dd>
831 message to be added
832 </dd>
833 </dl>
834 <dl>
835
836 <dt>Raises <b>RuntimeError</b>:</dt>
837 <dd>
838 to indicate that this method must be
839 implemented by a subclass
840 </dd>
841 </dl>
842 <a NAME="VersionControl.vcsAddTree" ID="VersionControl.vcsAddTree"></a>
843 <h4>VersionControl.vcsAddTree</h4>
844 <b>vcsAddTree</b>(<i>path</i>)
845
846 <p>
847 Public method to add a directory tree rooted at path in the vcs.
848 </p>
849 <dl>
850
851 <dt><i>path</i></dt>
852 <dd>
853 root directory of the tree to be added (string)
854 </dd>
855 </dl>
856 <dl>
857
858 <dt>Raises <b>RuntimeError</b>:</dt>
859 <dd>
860 to indicate that this method must be
861 implemented by a subclass
862 </dd>
863 </dl>
864 <a NAME="VersionControl.vcsAllRegisteredStates" ID="VersionControl.vcsAllRegisteredStates"></a>
865 <h4>VersionControl.vcsAllRegisteredStates</h4>
866 <b>vcsAllRegisteredStates</b>(<i>names, dname</i>)
867
868 <p>
869 Public method used to get the registered states of a number of files
870 in the vcs.
871 </p>
872 <dl>
873
874 <dt><i>names</i></dt>
875 <dd>
876 dictionary with all filenames to be checked as keys
877 </dd>
878 <dt><i>dname</i></dt>
879 <dd>
880 directory to check in (string)
881 </dd>
882 </dl>
883 <dl>
884 <dt>Return:</dt>
885 <dd>
886 the received dictionary completed with a combination of
887 canBeCommited and canBeAdded or None in order to signal an error
888 </dd>
889 </dl>
890 <dl>
891
892 <dt>Raises <b>RuntimeError</b>:</dt>
893 <dd>
894 to indicate that this method must be
895 implemented by a subclass
896 </dd>
897 </dl>
898 <a NAME="VersionControl.vcsCheckout" ID="VersionControl.vcsCheckout"></a>
899 <h4>VersionControl.vcsCheckout</h4>
900 <b>vcsCheckout</b>(<i>vcsDataDict, projectDir, noDialog=False</i>)
901
902 <p>
903 Public method used to check the project out of the vcs.
904 </p>
905 <dl>
906
907 <dt><i>vcsDataDict</i></dt>
908 <dd>
909 dictionary of data required for the checkout
910 </dd>
911 <dt><i>projectDir</i></dt>
912 <dd>
913 project directory to create (string)
914 </dd>
915 <dt><i>noDialog</i></dt>
916 <dd>
917 flag indicating quiet operations
918 </dd>
919 </dl>
920 <dl>
921 <dt>Return:</dt>
922 <dd>
923 flag indicating an execution without errors (boolean)
924 </dd>
925 </dl>
926 <dl>
927
928 <dt>Raises <b>RuntimeError</b>:</dt>
929 <dd>
930 to indicate that this method must be
931 implemented by a subclass
932 </dd>
933 </dl>
934 <a NAME="VersionControl.vcsCleanup" ID="VersionControl.vcsCleanup"></a>
935 <h4>VersionControl.vcsCleanup</h4>
936 <b>vcsCleanup</b>(<i>name</i>)
937
938 <p>
939 Public method used to cleanup the local copy.
940 </p>
941 <dl>
942
943 <dt><i>name</i></dt>
944 <dd>
945 directory name to be cleaned up (string)
946 </dd>
947 </dl>
948 <dl>
949
950 <dt>Raises <b>RuntimeError</b>:</dt>
951 <dd>
952 to indicate that this method must be
953 implemented by a subclass
954 </dd>
955 </dl>
956 <a NAME="VersionControl.vcsClearCommitMessages" ID="VersionControl.vcsClearCommitMessages"></a>
957 <h4>VersionControl.vcsClearCommitMessages</h4>
958 <b>vcsClearCommitMessages</b>(<i></i>)
959
960 <p>
961 Public method to clear the list of saved messages.
962 </p>
963 <dl>
964
965 <dt>Raises <b>RuntimeError</b>:</dt>
966 <dd>
967 to indicate that this method must be
968 implemented by a subclass
969 </dd>
970 </dl>
971 <a NAME="VersionControl.vcsCommandLine" ID="VersionControl.vcsCommandLine"></a>
972 <h4>VersionControl.vcsCommandLine</h4>
973 <b>vcsCommandLine</b>(<i>name</i>)
974
975 <p>
976 Public method used to execute arbitrary vcs commands.
977 </p>
978 <dl>
979
980 <dt><i>name</i></dt>
981 <dd>
982 directory name of the working directory (string)
983 </dd>
984 </dl>
985 <dl>
986
987 <dt>Raises <b>RuntimeError</b>:</dt>
988 <dd>
989 to indicate that this method must be
990 implemented by a subclass
991 </dd>
992 </dl>
993 <a NAME="VersionControl.vcsCommit" ID="VersionControl.vcsCommit"></a>
994 <h4>VersionControl.vcsCommit</h4>
995 <b>vcsCommit</b>(<i>name, message, noDialog=False</i>)
996
997 <p>
998 Public method used to make the change of a file/directory permanent in
999 the vcs.
1000 </p>
1001 <dl>
1002
1003 <dt><i>name</i></dt>
1004 <dd>
1005 file/directory name to be committed (string)
1006 </dd>
1007 <dt><i>message</i></dt>
1008 <dd>
1009 message for this operation (string)
1010 </dd>
1011 <dt><i>noDialog</i></dt>
1012 <dd>
1013 flag indicating quiet operations (boolean)
1014 </dd>
1015 </dl>
1016 <dl>
1017 <dt>Return:</dt>
1018 <dd>
1019 flag indicating success (boolean)
1020 </dd>
1021 </dl>
1022 <dl>
1023
1024 <dt>Raises <b>RuntimeError</b>:</dt>
1025 <dd>
1026 to indicate that this method must be
1027 implemented by a subclass
1028 </dd>
1029 </dl>
1030 <a NAME="VersionControl.vcsCommitMessages" ID="VersionControl.vcsCommitMessages"></a>
1031 <h4>VersionControl.vcsCommitMessages</h4>
1032 <b>vcsCommitMessages</b>(<i></i>)
1033
1034 <p>
1035 Public method to get the list of saved commit messages.
1036 </p>
1037 <dl>
1038 <dt>Return:</dt>
1039 <dd>
1040 list of saved commit messages
1041 </dd>
1042 </dl>
1043 <dl>
1044 <dt>Return Type:</dt>
1045 <dd>
1046 list of str
1047 </dd>
1048 </dl>
1049 <dl>
1050
1051 <dt>Raises <b>RuntimeError</b>:</dt>
1052 <dd>
1053 to indicate that this method must be
1054 implemented by a subclass
1055 </dd>
1056 </dl>
1057 <a NAME="VersionControl.vcsConvertProject" ID="VersionControl.vcsConvertProject"></a>
1058 <h4>VersionControl.vcsConvertProject</h4>
1059 <b>vcsConvertProject</b>(<i>vcsDataDict, project, addAll=True</i>)
1060
1061 <p>
1062 Public method to convert an uncontrolled project to a version
1063 controlled project.
1064 </p>
1065 <dl>
1066
1067 <dt><i>vcsDataDict</i> (dict)</dt>
1068 <dd>
1069 dictionary of data required for the conversion
1070 </dd>
1071 <dt><i>project</i> (Project)</dt>
1072 <dd>
1073 reference to the project object
1074 </dd>
1075 <dt><i>addAll</i> (bool)</dt>
1076 <dd>
1077 flag indicating to add all files to the repository
1078 </dd>
1079 </dl>
1080 <dl>
1081
1082 <dt>Raises <b>RuntimeError</b>:</dt>
1083 <dd>
1084 to indicate that this method must be
1085 implemented by a subclass
1086 </dd>
1087 </dl>
1088 <a NAME="VersionControl.vcsDiff" ID="VersionControl.vcsDiff"></a>
1089 <h4>VersionControl.vcsDiff</h4>
1090 <b>vcsDiff</b>(<i>name</i>)
1091
1092 <p>
1093 Public method used to view the diff of a file/directory in the vcs.
1094 </p>
1095 <dl>
1096
1097 <dt><i>name</i></dt>
1098 <dd>
1099 file/directory name to be diffed (string)
1100 </dd>
1101 </dl>
1102 <dl>
1103
1104 <dt>Raises <b>RuntimeError</b>:</dt>
1105 <dd>
1106 to indicate that this method must be
1107 implemented by a subclass
1108 </dd>
1109 </dl>
1110 <a NAME="VersionControl.vcsExists" ID="VersionControl.vcsExists"></a>
1111 <h4>VersionControl.vcsExists</h4>
1112 <b>vcsExists</b>(<i></i>)
1113
1114 <p>
1115 Public method used to test for the presence of the vcs.
1116 </p>
1117 <dl>
1118 <dt>Return:</dt>
1119 <dd>
1120 tuple of flag indicating the existence and a string
1121 giving an error message in case of failure
1122 </dd>
1123 </dl>
1124 <dl>
1125
1126 <dt>Raises <b>RuntimeError</b>:</dt>
1127 <dd>
1128 to indicate that this method must be
1129 implemented by a subclass
1130 </dd>
1131 </dl>
1132 <a NAME="VersionControl.vcsExport" ID="VersionControl.vcsExport"></a>
1133 <h4>VersionControl.vcsExport</h4>
1134 <b>vcsExport</b>(<i>vcsDataDict, projectDir</i>)
1135
1136 <p>
1137 Public method used to export a directory from the vcs.
1138 </p>
1139 <dl>
1140
1141 <dt><i>vcsDataDict</i></dt>
1142 <dd>
1143 dictionary of data required for the export
1144 </dd>
1145 <dt><i>projectDir</i></dt>
1146 <dd>
1147 project directory to create (string)
1148 </dd>
1149 </dl>
1150 <dl>
1151 <dt>Return:</dt>
1152 <dd>
1153 flag indicating an execution without errors (boolean)
1154 </dd>
1155 </dl>
1156 <dl>
1157
1158 <dt>Raises <b>RuntimeError</b>:</dt>
1159 <dd>
1160 to indicate that this method must be
1161 implemented by a subclass
1162 </dd>
1163 </dl>
1164 <a NAME="VersionControl.vcsForget" ID="VersionControl.vcsForget"></a>
1165 <h4>VersionControl.vcsForget</h4>
1166 <b>vcsForget</b>(<i>name</i>)
1167
1168 <p>
1169 Public method used to remove a file from the repository.
1170 </p>
1171 <dl>
1172
1173 <dt><i>name</i> (str or list of str)</dt>
1174 <dd>
1175 file/directory name to be removed
1176 </dd>
1177 </dl>
1178 <dl>
1179
1180 <dt>Raises <b>RuntimeError</b>:</dt>
1181 <dd>
1182 to indicate that this method must be
1183 implemented by a subclass
1184 </dd>
1185 </dl>
1186 <a NAME="VersionControl.vcsGetOptions" ID="VersionControl.vcsGetOptions"></a>
1187 <h4>VersionControl.vcsGetOptions</h4>
1188 <b>vcsGetOptions</b>(<i></i>)
1189
1190 <p>
1191 Public method used to retrieve the options of the vcs.
1192 </p>
1193 <dl>
1194 <dt>Return:</dt>
1195 <dd>
1196 a dictionary of option strings that can be passed to
1197 vcsSetOptions.
1198 </dd>
1199 </dl>
1200 <a NAME="VersionControl.vcsGetOtherData" ID="VersionControl.vcsGetOtherData"></a>
1201 <h4>VersionControl.vcsGetOtherData</h4>
1202 <b>vcsGetOtherData</b>(<i></i>)
1203
1204 <p>
1205 Public method used to retrieve vcs specific data.
1206 </p>
1207 <dl>
1208 <dt>Return:</dt>
1209 <dd>
1210 a dictionary of vcs specific data
1211 </dd>
1212 </dl>
1213 <a NAME="VersionControl.vcsGetProjectBrowserHelper" ID="VersionControl.vcsGetProjectBrowserHelper"></a>
1214 <h4>VersionControl.vcsGetProjectBrowserHelper</h4>
1215 <b>vcsGetProjectBrowserHelper</b>(<i>browser, project, isTranslationsBrowser=False</i>)
1216
1217 <p>
1218 Public method to instanciate a helper object for the different
1219 project browsers.
1220 </p>
1221 <dl>
1222
1223 <dt><i>browser</i></dt>
1224 <dd>
1225 reference to the project browser object
1226 </dd>
1227 <dt><i>project</i></dt>
1228 <dd>
1229 reference to the project object
1230 </dd>
1231 <dt><i>isTranslationsBrowser</i></dt>
1232 <dd>
1233 flag indicating, the helper is requested
1234 for the translations browser (this needs some special treatment)
1235 </dd>
1236 </dl>
1237 <dl>
1238 <dt>Return:</dt>
1239 <dd>
1240 the project browser helper object
1241 </dd>
1242 </dl>
1243 <dl>
1244
1245 <dt>Raises <b>RuntimeError</b>:</dt>
1246 <dd>
1247 to indicate that this method must be
1248 implemented by a subclass
1249 </dd>
1250 </dl>
1251 <a NAME="VersionControl.vcsGetProjectHelper" ID="VersionControl.vcsGetProjectHelper"></a>
1252 <h4>VersionControl.vcsGetProjectHelper</h4>
1253 <b>vcsGetProjectHelper</b>(<i>project</i>)
1254
1255 <p>
1256 Public method to instanciate a helper object for the project.
1257 </p>
1258 <dl>
1259
1260 <dt><i>project</i></dt>
1261 <dd>
1262 reference to the project object
1263 </dd>
1264 </dl>
1265 <dl>
1266 <dt>Return:</dt>
1267 <dd>
1268 the project helper object
1269 </dd>
1270 </dl>
1271 <dl>
1272
1273 <dt>Raises <b>RuntimeError</b>:</dt>
1274 <dd>
1275 to indicate that this method must be
1276 implemented by a subclass
1277 </dd>
1278 </dl>
1279 <a NAME="VersionControl.vcsImport" ID="VersionControl.vcsImport"></a>
1280 <h4>VersionControl.vcsImport</h4>
1281 <b>vcsImport</b>(<i>vcsDataDict, projectDir, noDialog=False, addAll=True</i>)
1282
1283 <p>
1284 Public method used to import the project into the vcs.
1285 </p>
1286 <dl>
1287
1288 <dt><i>vcsDataDict</i> (dict)</dt>
1289 <dd>
1290 dictionary of data required for the import
1291 </dd>
1292 <dt><i>projectDir</i> (str)</dt>
1293 <dd>
1294 project directory (string)
1295 </dd>
1296 <dt><i>noDialog</i> (bool)</dt>
1297 <dd>
1298 flag indicating quiet operations
1299 </dd>
1300 <dt><i>addAll</i> (bool)</dt>
1301 <dd>
1302 flag indicating to add all files to the repository
1303 </dd>
1304 </dl>
1305 <dl>
1306 <dt>Return:</dt>
1307 <dd>
1308 tuple containing a flag indicating an execution without errors
1309 and a flag indicating the version control status
1310 </dd>
1311 </dl>
1312 <dl>
1313 <dt>Return Type:</dt>
1314 <dd>
1315 tuple of (bool, bool)
1316 </dd>
1317 </dl>
1318 <dl>
1319
1320 <dt>Raises <b>RuntimeError</b>:</dt>
1321 <dd>
1322 to indicate that this method must be
1323 implemented by a subclass
1324 </dd>
1325 </dl>
1326 <a NAME="VersionControl.vcsInit" ID="VersionControl.vcsInit"></a>
1327 <h4>VersionControl.vcsInit</h4>
1328 <b>vcsInit</b>(<i>vcsDir, noDialog=False</i>)
1329
1330 <p>
1331 Public method used to initialize the vcs.
1332 </p>
1333 <dl>
1334
1335 <dt><i>vcsDir</i></dt>
1336 <dd>
1337 name of the VCS directory (string)
1338 </dd>
1339 <dt><i>noDialog</i></dt>
1340 <dd>
1341 flag indicating quiet operations (boolean)
1342 </dd>
1343 </dl>
1344 <dl>
1345 <dt>Return:</dt>
1346 <dd>
1347 flag indicating success (boolean)
1348 </dd>
1349 </dl>
1350 <dl>
1351
1352 <dt>Raises <b>RuntimeError</b>:</dt>
1353 <dd>
1354 to indicate that this method must be
1355 implemented by a subclass
1356 </dd>
1357 </dl>
1358 <a NAME="VersionControl.vcsInitConfig" ID="VersionControl.vcsInitConfig"></a>
1359 <h4>VersionControl.vcsInitConfig</h4>
1360 <b>vcsInitConfig</b>(<i>project</i>)
1361
1362 <p>
1363 Public method to initialize the VCS configuration.
1364 </p>
1365 <p>
1366 This method could ensure, that certain files or directories are
1367 exclude from being version controlled.
1368 </p>
1369 <dl>
1370
1371 <dt><i>project</i></dt>
1372 <dd>
1373 reference to the project (Project)
1374 </dd>
1375 </dl>
1376 <a NAME="VersionControl.vcsLogBrowser" ID="VersionControl.vcsLogBrowser"></a>
1377 <h4>VersionControl.vcsLogBrowser</h4>
1378 <b>vcsLogBrowser</b>(<i>name, isFile=False</i>)
1379
1380 <p>
1381 Public method used to view the log of a file/directory in the vcs
1382 with a log browser dialog.
1383 </p>
1384 <dl>
1385
1386 <dt><i>name</i></dt>
1387 <dd>
1388 file/directory name to show the log for (string)
1389 </dd>
1390 <dt><i>isFile</i></dt>
1391 <dd>
1392 flag indicating log for a file is to be shown
1393 (boolean)
1394 </dd>
1395 </dl>
1396 <dl>
1397
1398 <dt>Raises <b>RuntimeError</b>:</dt>
1399 <dd>
1400 to indicate that this method must be
1401 implemented by a subclass
1402 </dd>
1403 </dl>
1404 <a NAME="VersionControl.vcsMerge" ID="VersionControl.vcsMerge"></a>
1405 <h4>VersionControl.vcsMerge</h4>
1406 <b>vcsMerge</b>(<i>name</i>)
1407
1408 <p>
1409 Public method used to merge a tag/branch into the local project.
1410 </p>
1411 <dl>
1412
1413 <dt><i>name</i></dt>
1414 <dd>
1415 file/directory name to be merged (string)
1416 </dd>
1417 </dl>
1418 <dl>
1419
1420 <dt>Raises <b>RuntimeError</b>:</dt>
1421 <dd>
1422 to indicate that this method must be
1423 implemented by a subclass
1424 </dd>
1425 </dl>
1426 <a NAME="VersionControl.vcsMove" ID="VersionControl.vcsMove"></a>
1427 <h4>VersionControl.vcsMove</h4>
1428 <b>vcsMove</b>(<i>name, project, target=None, noDialog=False</i>)
1429
1430 <p>
1431 Public method used to move a file/directory.
1432 </p>
1433 <dl>
1434
1435 <dt><i>name</i></dt>
1436 <dd>
1437 file/directory name to be moved (string)
1438 </dd>
1439 <dt><i>project</i></dt>
1440 <dd>
1441 reference to the project object
1442 </dd>
1443 <dt><i>target</i></dt>
1444 <dd>
1445 new name of the file/directory (string)
1446 </dd>
1447 <dt><i>noDialog</i></dt>
1448 <dd>
1449 flag indicating quiet operations
1450 </dd>
1451 </dl>
1452 <dl>
1453 <dt>Return:</dt>
1454 <dd>
1455 flag indicating successfull operation (boolean)
1456 </dd>
1457 </dl>
1458 <dl>
1459
1460 <dt>Raises <b>RuntimeError</b>:</dt>
1461 <dd>
1462 to indicate that this method must be
1463 implemented by a subclass
1464 </dd>
1465 </dl>
1466 <a NAME="VersionControl.vcsName" ID="VersionControl.vcsName"></a>
1467 <h4>VersionControl.vcsName</h4>
1468 <b>vcsName</b>(<i></i>)
1469
1470 <p>
1471 Public method returning the name of the vcs.
1472 </p>
1473 <dl>
1474 <dt>Return:</dt>
1475 <dd>
1476 name of the vcs (string)
1477 </dd>
1478 </dl>
1479 <dl>
1480
1481 <dt>Raises <b>RuntimeError</b>:</dt>
1482 <dd>
1483 to indicate that this method must be
1484 implemented by a subclass
1485 </dd>
1486 </dl>
1487 <a NAME="VersionControl.vcsNewProjectOptionsDialog" ID="VersionControl.vcsNewProjectOptionsDialog"></a>
1488 <h4>VersionControl.vcsNewProjectOptionsDialog</h4>
1489 <b>vcsNewProjectOptionsDialog</b>(<i>parent=None</i>)
1490
1491 <p>
1492 Public method to get a dialog to enter repository info for getting a
1493 new project.
1494 </p>
1495 <dl>
1496
1497 <dt><i>parent</i></dt>
1498 <dd>
1499 parent widget (QWidget)
1500 </dd>
1501 </dl>
1502 <dl>
1503
1504 <dt>Raises <b>RuntimeError</b>:</dt>
1505 <dd>
1506 to indicate that this method must be
1507 implemented by a subclass
1508 </dd>
1509 </dl>
1510 <a NAME="VersionControl.vcsOptionsDialog" ID="VersionControl.vcsOptionsDialog"></a>
1511 <h4>VersionControl.vcsOptionsDialog</h4>
1512 <b>vcsOptionsDialog</b>(<i>project, archive, editable=False, parent=None</i>)
1513
1514 <p>
1515 Public method to get a dialog to enter repository info.
1516 </p>
1517 <dl>
1518
1519 <dt><i>project</i></dt>
1520 <dd>
1521 reference to the project object
1522 </dd>
1523 <dt><i>archive</i></dt>
1524 <dd>
1525 name of the project in the repository (string)
1526 </dd>
1527 <dt><i>editable</i></dt>
1528 <dd>
1529 flag indicating that the project name is editable
1530 (boolean)
1531 </dd>
1532 <dt><i>parent</i></dt>
1533 <dd>
1534 parent widget (QWidget)
1535 </dd>
1536 </dl>
1537 <dl>
1538
1539 <dt>Raises <b>RuntimeError</b>:</dt>
1540 <dd>
1541 to indicate that this method must be
1542 implemented by a subclass
1543 </dd>
1544 </dl>
1545 <a NAME="VersionControl.vcsRegisteredState" ID="VersionControl.vcsRegisteredState"></a>
1546 <h4>VersionControl.vcsRegisteredState</h4>
1547 <b>vcsRegisteredState</b>(<i>name</i>)
1548
1549 <p>
1550 Public method used to get the registered state of a file in the vcs.
1551 </p>
1552 <dl>
1553
1554 <dt><i>name</i></dt>
1555 <dd>
1556 filename to check (string)
1557 </dd>
1558 </dl>
1559 <dl>
1560 <dt>Return:</dt>
1561 <dd>
1562 a combination of canBeCommited and canBeAdded or
1563 0 in order to signal an error
1564 </dd>
1565 </dl>
1566 <dl>
1567
1568 <dt>Raises <b>RuntimeError</b>:</dt>
1569 <dd>
1570 to indicate that this method must be
1571 implemented by a subclass
1572 </dd>
1573 </dl>
1574 <a NAME="VersionControl.vcsRemove" ID="VersionControl.vcsRemove"></a>
1575 <h4>VersionControl.vcsRemove</h4>
1576 <b>vcsRemove</b>(<i>name, project=False, noDialog=False</i>)
1577
1578 <p>
1579 Public method used to add a file/directory in the vcs.
1580 </p>
1581 <dl>
1582
1583 <dt><i>name</i></dt>
1584 <dd>
1585 file/directory name to be removed (string)
1586 </dd>
1587 <dt><i>project</i></dt>
1588 <dd>
1589 flag indicating deletion of a project tree (boolean)
1590 </dd>
1591 <dt><i>noDialog</i></dt>
1592 <dd>
1593 flag indicating quiet operations
1594 </dd>
1595 </dl>
1596 <dl>
1597 <dt>Return:</dt>
1598 <dd>
1599 flag indicating success (boolean)
1600 </dd>
1601 </dl>
1602 <dl>
1603
1604 <dt>Raises <b>RuntimeError</b>:</dt>
1605 <dd>
1606 to indicate that this method must be
1607 implemented by a subclass
1608 </dd>
1609 </dl>
1610 <a NAME="VersionControl.vcsRepositoryInfos" ID="VersionControl.vcsRepositoryInfos"></a>
1611 <h4>VersionControl.vcsRepositoryInfos</h4>
1612 <b>vcsRepositoryInfos</b>(<i>ppath</i>)
1613
1614 <p>
1615 Public method to retrieve information about the repository.
1616 </p>
1617 <dl>
1618
1619 <dt><i>ppath</i></dt>
1620 <dd>
1621 local path to get the repository infos (string)
1622 </dd>
1623 </dl>
1624 <dl>
1625 <dt>Return:</dt>
1626 <dd>
1627 string with ready formated info for display (string)
1628 </dd>
1629 </dl>
1630 <dl>
1631
1632 <dt>Raises <b>RuntimeError</b>:</dt>
1633 <dd>
1634 to indicate that this method must be
1635 implemented by a subclass
1636 </dd>
1637 </dl>
1638 <a NAME="VersionControl.vcsResolved" ID="VersionControl.vcsResolved"></a>
1639 <h4>VersionControl.vcsResolved</h4>
1640 <b>vcsResolved</b>(<i>name</i>)
1641
1642 <p>
1643 Public method used to resolve conflicts of a file/directory.
1644 </p>
1645 <dl>
1646
1647 <dt><i>name</i> (str)</dt>
1648 <dd>
1649 file/directory name to be resolved
1650 </dd>
1651 </dl>
1652 <a NAME="VersionControl.vcsRevert" ID="VersionControl.vcsRevert"></a>
1653 <h4>VersionControl.vcsRevert</h4>
1654 <b>vcsRevert</b>(<i>name</i>)
1655
1656 <p>
1657 Public method used to revert changes made to a file/directory.
1658 </p>
1659 <dl>
1660
1661 <dt><i>name</i> (str)</dt>
1662 <dd>
1663 file/directory name to be reverted
1664 </dd>
1665 </dl>
1666 <dl>
1667 <dt>Return:</dt>
1668 <dd>
1669 flag indicating, that the update contained an add
1670 or delete
1671 </dd>
1672 </dl>
1673 <dl>
1674 <dt>Return Type:</dt>
1675 <dd>
1676 bool
1677 </dd>
1678 </dl>
1679 <dl>
1680
1681 <dt>Raises <b>RuntimeError</b>:</dt>
1682 <dd>
1683 to indicate that this method must be
1684 implemented by a subclass
1685 </dd>
1686 </dl>
1687 <a NAME="VersionControl.vcsSbsDiff" ID="VersionControl.vcsSbsDiff"></a>
1688 <h4>VersionControl.vcsSbsDiff</h4>
1689 <b>vcsSbsDiff</b>(<i>name, extended=False, revisions=None</i>)
1690
1691 <p>
1692 Public method used to view the difference of a file to the Mercurial
1693 repository side-by-side.
1694 </p>
1695 <dl>
1696
1697 <dt><i>name</i> (str)</dt>
1698 <dd>
1699 file name to be diffed
1700 </dd>
1701 <dt><i>extended</i> (bool)</dt>
1702 <dd>
1703 flag indicating the extended variant
1704 </dd>
1705 <dt><i>revisions</i> (tuple of two str)</dt>
1706 <dd>
1707 tuple of two revisions
1708 </dd>
1709 </dl>
1710 <dl>
1711
1712 <dt>Raises <b>RuntimeError</b>:</dt>
1713 <dd>
1714 to indicate that this method must be
1715 implemented by a subclass
1716 </dd>
1717 </dl>
1718 <a NAME="VersionControl.vcsSetData" ID="VersionControl.vcsSetData"></a>
1719 <h4>VersionControl.vcsSetData</h4>
1720 <b>vcsSetData</b>(<i>key, value</i>)
1721
1722 <p>
1723 Public method used to set an entry in the otherData dictionary.
1724 </p>
1725 <dl>
1726
1727 <dt><i>key</i></dt>
1728 <dd>
1729 the key of the data (string)
1730 </dd>
1731 <dt><i>value</i></dt>
1732 <dd>
1733 the value of the data
1734 </dd>
1735 </dl>
1736 <a NAME="VersionControl.vcsSetDataFromDict" ID="VersionControl.vcsSetDataFromDict"></a>
1737 <h4>VersionControl.vcsSetDataFromDict</h4>
1738 <b>vcsSetDataFromDict</b>(<i>dictionary</i>)
1739
1740 <p>
1741 Public method used to set entries in the otherData dictionary.
1742 </p>
1743 <dl>
1744
1745 <dt><i>dictionary</i></dt>
1746 <dd>
1747 dictionary to pick entries from
1748 </dd>
1749 </dl>
1750 <a NAME="VersionControl.vcsSetOptions" ID="VersionControl.vcsSetOptions"></a>
1751 <h4>VersionControl.vcsSetOptions</h4>
1752 <b>vcsSetOptions</b>(<i>options</i>)
1753
1754 <p>
1755 Public method used to set the options for the vcs.
1756 </p>
1757 <dl>
1758
1759 <dt><i>options</i></dt>
1760 <dd>
1761 a dictionary of option strings with keys as
1762 defined by the default options
1763 </dd>
1764 </dl>
1765 <a NAME="VersionControl.vcsSetOtherData" ID="VersionControl.vcsSetOtherData"></a>
1766 <h4>VersionControl.vcsSetOtherData</h4>
1767 <b>vcsSetOtherData</b>(<i>data</i>)
1768
1769 <p>
1770 Public method used to set vcs specific data.
1771 </p>
1772 <dl>
1773
1774 <dt><i>data</i></dt>
1775 <dd>
1776 a dictionary of vcs specific data
1777 </dd>
1778 </dl>
1779 <a NAME="VersionControl.vcsShutdown" ID="VersionControl.vcsShutdown"></a>
1780 <h4>VersionControl.vcsShutdown</h4>
1781 <b>vcsShutdown</b>(<i></i>)
1782
1783 <p>
1784 Public method used to shutdown the vcs interface.
1785 </p>
1786 <dl>
1787
1788 <dt>Raises <b>RuntimeError</b>:</dt>
1789 <dd>
1790 to indicate that this method must be
1791 implemented by a subclass
1792 </dd>
1793 </dl>
1794 <a NAME="VersionControl.vcsStatus" ID="VersionControl.vcsStatus"></a>
1795 <h4>VersionControl.vcsStatus</h4>
1796 <b>vcsStatus</b>(<i>name</i>)
1797
1798 <p>
1799 Public method used to view the status of a file/directory in the vcs.
1800 </p>
1801 <dl>
1802
1803 <dt><i>name</i></dt>
1804 <dd>
1805 file/directory name to show the status for (string)
1806 </dd>
1807 </dl>
1808 <dl>
1809
1810 <dt>Raises <b>RuntimeError</b>:</dt>
1811 <dd>
1812 to indicate that this method must be
1813 implemented by a subclass
1814 </dd>
1815 </dl>
1816 <a NAME="VersionControl.vcsSupportCommandOptions" ID="VersionControl.vcsSupportCommandOptions"></a>
1817 <h4>VersionControl.vcsSupportCommandOptions</h4>
1818 <b>vcsSupportCommandOptions</b>(<i></i>)
1819
1820 <p>
1821 Public method to signal the support of user settable command options.
1822 </p>
1823 <dl>
1824 <dt>Return:</dt>
1825 <dd>
1826 flag indicating the support of user settable command options
1827 (boolean)
1828 </dd>
1829 </dl>
1830 <a NAME="VersionControl.vcsSwitch" ID="VersionControl.vcsSwitch"></a>
1831 <h4>VersionControl.vcsSwitch</h4>
1832 <b>vcsSwitch</b>(<i>name</i>)
1833
1834 <p>
1835 Public method used to switch a directory to a different tag/branch.
1836 </p>
1837 <dl>
1838
1839 <dt><i>name</i></dt>
1840 <dd>
1841 directory name to be switched (string)
1842 </dd>
1843 </dl>
1844 <dl>
1845 <dt>Return:</dt>
1846 <dd>
1847 flag indicating, that the switch contained an add
1848 or delete (boolean)
1849 </dd>
1850 </dl>
1851 <dl>
1852
1853 <dt>Raises <b>RuntimeError</b>:</dt>
1854 <dd>
1855 to indicate that this method must be
1856 implemented by a subclass
1857 </dd>
1858 </dl>
1859 <a NAME="VersionControl.vcsTag" ID="VersionControl.vcsTag"></a>
1860 <h4>VersionControl.vcsTag</h4>
1861 <b>vcsTag</b>(<i>name</i>)
1862
1863 <p>
1864 Public method used to set the tag of a file/directory in the vcs.
1865 </p>
1866 <dl>
1867
1868 <dt><i>name</i></dt>
1869 <dd>
1870 file/directory name to be tagged (string)
1871 </dd>
1872 </dl>
1873 <dl>
1874
1875 <dt>Raises <b>RuntimeError</b>:</dt>
1876 <dd>
1877 to indicate that this method must be
1878 implemented by a subclass
1879 </dd>
1880 </dl>
1881 <a NAME="VersionControl.vcsUpdate" ID="VersionControl.vcsUpdate"></a>
1882 <h4>VersionControl.vcsUpdate</h4>
1883 <b>vcsUpdate</b>(<i>name, noDialog=False</i>)
1884
1885 <p>
1886 Public method used to update a file/directory in the vcs.
1887 </p>
1888 <dl>
1889
1890 <dt><i>name</i></dt>
1891 <dd>
1892 file/directory name to be updated (string)
1893 </dd>
1894 <dt><i>noDialog</i></dt>
1895 <dd>
1896 flag indicating quiet operations (boolean)
1897 </dd>
1898 </dl>
1899 <dl>
1900 <dt>Return:</dt>
1901 <dd>
1902 flag indicating, that the update contained an add
1903 or delete (boolean)
1904 </dd>
1905 </dl>
1906 <dl>
1907
1908 <dt>Raises <b>RuntimeError</b>:</dt>
1909 <dd>
1910 to indicate that this method must be
1911 implemented by a subclass
1912 </dd>
1913 </dl>
1914 <div align="right"><a href="#top">Up</a></div>
1915 <hr />
1916 </body></html>

eric ide

mercurial