eric6/Documentation/Source/eric6.Plugins.VcsPlugins.vcsGit.git.html

changeset 6942
2602857055c5
parent 6324
b11c36cba2a1
child 7168
c1f97706c905
equal deleted inserted replaced
6941:f99d60d6b59b 6942:2602857055c5
1 <!DOCTYPE html>
2 <html><head>
3 <title>eric6.Plugins.VcsPlugins.vcsGit.git</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.Plugins.VcsPlugins.vcsGit.git</h1>
23 <p>
24 Module implementing the version control systems interface to Git.
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="#Git">Git</a></td>
34 <td>Class implementing the version control systems interface to Git.</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="Git" ID="Git"></a>
43 <h2>Git</h2>
44 <p>
45 Class implementing the version control systems interface to Git.
46 </p><h3>Signals</h3>
47 <dl>
48 <dt>committed()</dt>
49 <dd>
50 emitted after the commit action has completed
51 </dd>
52 </dl>
53 <h3>Derived from</h3>
54 VersionControl
55 <h3>Class Attributes</h3>
56 <table>
57 <tr><td>IgnoreFileName</td></tr>
58 </table>
59 <h3>Class Methods</h3>
60 <table>
61 <tr><td>None</td></tr>
62 </table>
63 <h3>Methods</h3>
64 <table>
65 <tr>
66 <td><a href="#Git.__init__">Git</a></td>
67 <td>Constructor</td>
68 </tr><tr>
69 <td><a href="#Git.__gitGetFileForRevision">__gitGetFileForRevision</a></td>
70 <td>Private method to get a file for a specific revision from the repository.</td>
71 </tr><tr>
72 <td><a href="#Git.__gitGetStashesList">__gitGetStashesList</a></td>
73 <td>Private method to get a list of stash names.</td>
74 </tr><tr>
75 <td><a href="#Git.__gitSubmodulesList">__gitSubmodulesList</a></td>
76 <td>Private method to get the data of defined submodules.</td>
77 </tr><tr>
78 <td><a href="#Git.__selectSubmodulePath">__selectSubmodulePath</a></td>
79 <td>Private method to select a submodule path.</td>
80 </tr><tr>
81 <td><a href="#Git.__selectSubmodulePaths">__selectSubmodulePaths</a></td>
82 <td>Private method to select a list of submodule paths.</td>
83 </tr><tr>
84 <td><a href="#Git.__vcsCommit_Step2">__vcsCommit_Step2</a></td>
85 <td>Private slot performing the second step of the commit action.</td>
86 </tr><tr>
87 <td><a href="#Git._createStatusMonitorThread">_createStatusMonitorThread</a></td>
88 <td>Protected method to create an instance of the VCS status monitor thread.</td>
89 </tr><tr>
90 <td><a href="#Git.clearStatusCache">clearStatusCache</a></td>
91 <td>Public method to clear the status cache.</td>
92 </tr><tr>
93 <td><a href="#Git.getPlugin">getPlugin</a></td>
94 <td>Public method to get a reference to the plugin object.</td>
95 </tr><tr>
96 <td><a href="#Git.gitAddRemote">gitAddRemote</a></td>
97 <td>Public method to add a remote repository.</td>
98 </tr><tr>
99 <td><a href="#Git.gitApply">gitApply</a></td>
100 <td>Public method to apply a patch stored in a given file.</td>
101 </tr><tr>
102 <td><a href="#Git.gitApplyCheckPatches">gitApplyCheckPatches</a></td>
103 <td>Public method to apply a list of patch files or check, if they would apply cleanly.</td>
104 </tr><tr>
105 <td><a href="#Git.gitBisect">gitBisect</a></td>
106 <td>Public method to perform bisect commands.</td>
107 </tr><tr>
108 <td><a href="#Git.gitBisectCreateReplayFile">gitBisectCreateReplayFile</a></td>
109 <td>Public method used to create a bisect replay file for the project.</td>
110 </tr><tr>
111 <td><a href="#Git.gitBisectEditReplayFile">gitBisectEditReplayFile</a></td>
112 <td>Public method used to edit a bisect replay file.</td>
113 </tr><tr>
114 <td><a href="#Git.gitBisectLogBrowser">gitBisectLogBrowser</a></td>
115 <td>Public method used to browse the bisect log of the project.</td>
116 </tr><tr>
117 <td><a href="#Git.gitBisectReplay">gitBisectReplay</a></td>
118 <td>Public method to replay a bisect session.</td>
119 </tr><tr>
120 <td><a href="#Git.gitBlame">gitBlame</a></td>
121 <td>Public method to show the output of the git blame command.</td>
122 </tr><tr>
123 <td><a href="#Git.gitBranch">gitBranch</a></td>
124 <td>Public method used to create, delete or move a branch in the Git repository.</td>
125 </tr><tr>
126 <td><a href="#Git.gitBundle">gitBundle</a></td>
127 <td>Public method to create a bundle file.</td>
128 </tr><tr>
129 <td><a href="#Git.gitBundleFetch">gitBundleFetch</a></td>
130 <td>Public method to fetch a head of a bundle file into the local repository.</td>
131 </tr><tr>
132 <td><a href="#Git.gitBundleListHeads">gitBundleListHeads</a></td>
133 <td>Public method to list the heads contained in a bundle file.</td>
134 </tr><tr>
135 <td><a href="#Git.gitBundlePull">gitBundlePull</a></td>
136 <td>Public method to pull a head of a bundle file into the local repository and working area.</td>
137 </tr><tr>
138 <td><a href="#Git.gitCancelMerge">gitCancelMerge</a></td>
139 <td>Public method to cancel an uncommitted or failed merge.</td>
140 </tr><tr>
141 <td><a href="#Git.gitChangeRemoteCredentials">gitChangeRemoteCredentials</a></td>
142 <td>Public method to change the user credentials of a remote repository.</td>
143 </tr><tr>
144 <td><a href="#Git.gitChangeRemoteUrl">gitChangeRemoteUrl</a></td>
145 <td>Public method to change the URL of a remote repository.</td>
146 </tr><tr>
147 <td><a href="#Git.gitCherryPick">gitCherryPick</a></td>
148 <td>Public method to cherry pick commits and apply them to the current branch.</td>
149 </tr><tr>
150 <td><a href="#Git.gitCherryPickAbort">gitCherryPickAbort</a></td>
151 <td>Public method to cancel the last copying session and return to the previous state.</td>
152 </tr><tr>
153 <td><a href="#Git.gitCherryPickContinue">gitCherryPickContinue</a></td>
154 <td>Public method to continue the last copying session after conflicts were resolved.</td>
155 </tr><tr>
156 <td><a href="#Git.gitCherryPickQuit">gitCherryPickQuit</a></td>
157 <td>Public method to quit the current copying operation.</td>
158 </tr><tr>
159 <td><a href="#Git.gitCommitMerge">gitCommitMerge</a></td>
160 <td>Public method to commit a failed merge.</td>
161 </tr><tr>
162 <td><a href="#Git.gitCopy">gitCopy</a></td>
163 <td>Public method used to copy a file/directory.</td>
164 </tr><tr>
165 <td><a href="#Git.gitCreateArchive">gitCreateArchive</a></td>
166 <td>Public method to show some statistics of the local repository.</td>
167 </tr><tr>
168 <td><a href="#Git.gitCreateIgnoreFile">gitCreateIgnoreFile</a></td>
169 <td>Public method to create the ignore file.</td>
170 </tr><tr>
171 <td><a href="#Git.gitDeleteRemoteBranch">gitDeleteRemoteBranch</a></td>
172 <td>Public method to delete a branch from a remote repository.</td>
173 </tr><tr>
174 <td><a href="#Git.gitDescribe">gitDescribe</a></td>
175 <td>Public method to find the most recent tag reachable from each commit.</td>
176 </tr><tr>
177 <td><a href="#Git.gitEditConfig">gitEditConfig</a></td>
178 <td>Public method used to edit the repository configuration file.</td>
179 </tr><tr>
180 <td><a href="#Git.gitEditUserConfig">gitEditUserConfig</a></td>
181 <td>Public method used to edit the user configuration file.</td>
182 </tr><tr>
183 <td><a href="#Git.gitExtendedDiff">gitExtendedDiff</a></td>
184 <td>Public method used to view the difference of a file/directory to the Git repository.</td>
185 </tr><tr>
186 <td><a href="#Git.gitFetch">gitFetch</a></td>
187 <td>Public method to fetch changes from a remote repository.</td>
188 </tr><tr>
189 <td><a href="#Git.gitGetArchiveFormats">gitGetArchiveFormats</a></td>
190 <td>Public method to get a list of supported archive formats.</td>
191 </tr><tr>
192 <td><a href="#Git.gitGetBranchesList">gitGetBranchesList</a></td>
193 <td>Public method to get the list of branches.</td>
194 </tr><tr>
195 <td><a href="#Git.gitGetBundleHeads">gitGetBundleHeads</a></td>
196 <td>Public method to get a list of heads contained in a bundle file.</td>
197 </tr><tr>
198 <td><a href="#Git.gitGetCurrentBranch">gitGetCurrentBranch</a></td>
199 <td>Public method used to show the current branch of the working directory.</td>
200 </tr><tr>
201 <td><a href="#Git.gitGetRemoteBranchesList">gitGetRemoteBranchesList</a></td>
202 <td>Public method to get the list of a remote repository branches.</td>
203 </tr><tr>
204 <td><a href="#Git.gitGetRemoteUrl">gitGetRemoteUrl</a></td>
205 <td>Public method to get the URL of a remote repository.</td>
206 </tr><tr>
207 <td><a href="#Git.gitGetRemoteUrlsList">gitGetRemoteUrlsList</a></td>
208 <td>Public method to get the list of remote repos and their URLs.</td>
209 </tr><tr>
210 <td><a href="#Git.gitGetRemotesList">gitGetRemotesList</a></td>
211 <td>Public method to get the list of remote repos.</td>
212 </tr><tr>
213 <td><a href="#Git.gitGetTagsList">gitGetTagsList</a></td>
214 <td>Public method to get the list of tags.</td>
215 </tr><tr>
216 <td><a href="#Git.gitHouseKeeping">gitHouseKeeping</a></td>
217 <td>Public method to cleanup and optimize the local repository.</td>
218 </tr><tr>
219 <td><a href="#Git.gitListTagBranch">gitListTagBranch</a></td>
220 <td>Public method used to list the available tags or branches.</td>
221 </tr><tr>
222 <td><a href="#Git.gitNormalizeURL">gitNormalizeURL</a></td>
223 <td>Public method to normalize a url for Git.</td>
224 </tr><tr>
225 <td><a href="#Git.gitPruneRemote">gitPruneRemote</a></td>
226 <td>Public method to prune stale remote-tracking branches.</td>
227 </tr><tr>
228 <td><a href="#Git.gitPull">gitPull</a></td>
229 <td>Public method used to pull changes from a remote Git repository.</td>
230 </tr><tr>
231 <td><a href="#Git.gitPush">gitPush</a></td>
232 <td>Public method used to push changes to a remote Git repository.</td>
233 </tr><tr>
234 <td><a href="#Git.gitReflogBrowser">gitReflogBrowser</a></td>
235 <td>Public method used to browse the reflog of the project.</td>
236 </tr><tr>
237 <td><a href="#Git.gitRemoveRemote">gitRemoveRemote</a></td>
238 <td>Public method to remove a remote repository.</td>
239 </tr><tr>
240 <td><a href="#Git.gitRenameRemote">gitRenameRemote</a></td>
241 <td>Public method to rename a remote repository.</td>
242 </tr><tr>
243 <td><a href="#Git.gitRevert">gitRevert</a></td>
244 <td>Public method used to revert changes made to a file/directory.</td>
245 </tr><tr>
246 <td><a href="#Git.gitSbsDiff">gitSbsDiff</a></td>
247 <td>Public method used to view the difference of a file to the Git repository side-by-side.</td>
248 </tr><tr>
249 <td><a href="#Git.gitShortlog">gitShortlog</a></td>
250 <td>Public method to show a short log suitable for inclusion in release announcements.</td>
251 </tr><tr>
252 <td><a href="#Git.gitShowBranch">gitShowBranch</a></td>
253 <td>Public method used to show the current branch of the working directory.</td>
254 </tr><tr>
255 <td><a href="#Git.gitShowConfig">gitShowConfig</a></td>
256 <td>Public method to show the combined configuration.</td>
257 </tr><tr>
258 <td><a href="#Git.gitShowPatchesStatistics">gitShowPatchesStatistics</a></td>
259 <td>Public method to show statistics for a set of patch files.</td>
260 </tr><tr>
261 <td><a href="#Git.gitShowRemote">gitShowRemote</a></td>
262 <td>Public method to show information about a remote repository.</td>
263 </tr><tr>
264 <td><a href="#Git.gitShowRemotes">gitShowRemotes</a></td>
265 <td>Public method to show available remote repositories.</td>
266 </tr><tr>
267 <td><a href="#Git.gitStashApply">gitStashApply</a></td>
268 <td>Public method to apply a stash but keep it.</td>
269 </tr><tr>
270 <td><a href="#Git.gitStashBranch">gitStashBranch</a></td>
271 <td>Public method to create a branch from a stash.</td>
272 </tr><tr>
273 <td><a href="#Git.gitStashBrowser">gitStashBrowser</a></td>
274 <td>Public method used to browse the stashed changes.</td>
275 </tr><tr>
276 <td><a href="#Git.gitStashClear">gitStashClear</a></td>
277 <td>Public method to delete all stashes.</td>
278 </tr><tr>
279 <td><a href="#Git.gitStashDrop">gitStashDrop</a></td>
280 <td>Public method to delete a stash.</td>
281 </tr><tr>
282 <td><a href="#Git.gitStashPop">gitStashPop</a></td>
283 <td>Public method to apply a stash and delete it.</td>
284 </tr><tr>
285 <td><a href="#Git.gitStashSave">gitStashSave</a></td>
286 <td>Public method to save the current changes to a new stash.</td>
287 </tr><tr>
288 <td><a href="#Git.gitStashShowPatch">gitStashShowPatch</a></td>
289 <td>Public method to show the contents of a stash.</td>
290 </tr><tr>
291 <td><a href="#Git.gitStatistics">gitStatistics</a></td>
292 <td>Public method to show some statistics of the local repository.</td>
293 </tr><tr>
294 <td><a href="#Git.gitSubmoduleAdd">gitSubmoduleAdd</a></td>
295 <td>Public method to add a submodule to the project.</td>
296 </tr><tr>
297 <td><a href="#Git.gitSubmoduleDeinit">gitSubmoduleDeinit</a></td>
298 <td>Public method to unregister submodules.</td>
299 </tr><tr>
300 <td><a href="#Git.gitSubmoduleInit">gitSubmoduleInit</a></td>
301 <td>Public method to initialize one or all submodules.</td>
302 </tr><tr>
303 <td><a href="#Git.gitSubmoduleList">gitSubmoduleList</a></td>
304 <td>Public method to show a list of all submodules of the project.</td>
305 </tr><tr>
306 <td><a href="#Git.gitSubmoduleStatus">gitSubmoduleStatus</a></td>
307 <td>Public method to show the status of the submodules.</td>
308 </tr><tr>
309 <td><a href="#Git.gitSubmoduleSummary">gitSubmoduleSummary</a></td>
310 <td>Public method to show the status of the submodules.</td>
311 </tr><tr>
312 <td><a href="#Git.gitSubmoduleSync">gitSubmoduleSync</a></td>
313 <td>Public method to synchronize submodules.</td>
314 </tr><tr>
315 <td><a href="#Git.gitSubmoduleUpdate">gitSubmoduleUpdate</a></td>
316 <td>Public method to update submodules.</td>
317 </tr><tr>
318 <td><a href="#Git.gitSubmoduleUpdateWithOptions">gitSubmoduleUpdateWithOptions</a></td>
319 <td>Public method to update submodules offering a dialog to select the update options.</td>
320 </tr><tr>
321 <td><a href="#Git.gitUnstage">gitUnstage</a></td>
322 <td>Public method used to unstage a file/directory.</td>
323 </tr><tr>
324 <td><a href="#Git.gitVerify">gitVerify</a></td>
325 <td>Public method to verify the connectivity and validity of objects of the database.</td>
326 </tr><tr>
327 <td><a href="#Git.gitVerifyBundle">gitVerifyBundle</a></td>
328 <td>Public method to verify a bundle file.</td>
329 </tr><tr>
330 <td><a href="#Git.initCommand">initCommand</a></td>
331 <td>Public method to initialize a command arguments list.</td>
332 </tr><tr>
333 <td><a href="#Git.vcsAdd">vcsAdd</a></td>
334 <td>Public method used to add a file/directory to the Git repository.</td>
335 </tr><tr>
336 <td><a href="#Git.vcsAddBinary">vcsAddBinary</a></td>
337 <td>Public method used to add a file/directory in binary mode to the Git repository.</td>
338 </tr><tr>
339 <td><a href="#Git.vcsAddTree">vcsAddTree</a></td>
340 <td>Public method to add a directory tree rooted at path to the Git repository.</td>
341 </tr><tr>
342 <td><a href="#Git.vcsAllRegisteredStates">vcsAllRegisteredStates</a></td>
343 <td>Public method used to get the registered states of a number of files in the vcs.</td>
344 </tr><tr>
345 <td><a href="#Git.vcsCheckout">vcsCheckout</a></td>
346 <td>Public method used to check the project out of a Git repository (clone).</td>
347 </tr><tr>
348 <td><a href="#Git.vcsCleanup">vcsCleanup</a></td>
349 <td>Public method used to cleanup the working directory.</td>
350 </tr><tr>
351 <td><a href="#Git.vcsCommandLine">vcsCommandLine</a></td>
352 <td>Public method used to execute arbitrary Git commands.</td>
353 </tr><tr>
354 <td><a href="#Git.vcsCommit">vcsCommit</a></td>
355 <td>Public method used to make the change of a file/directory permanent in the Git repository.</td>
356 </tr><tr>
357 <td><a href="#Git.vcsConvertProject">vcsConvertProject</a></td>
358 <td>Public method to convert an uncontrolled project to a version controlled project.</td>
359 </tr><tr>
360 <td><a href="#Git.vcsDiff">vcsDiff</a></td>
361 <td>Public method used to view the difference of a file/directory to the Git repository.</td>
362 </tr><tr>
363 <td><a href="#Git.vcsExists">vcsExists</a></td>
364 <td>Public method used to test for the presence of the git executable.</td>
365 </tr><tr>
366 <td><a href="#Git.vcsExport">vcsExport</a></td>
367 <td>Public method used to export a directory from the Git repository.</td>
368 </tr><tr>
369 <td><a href="#Git.vcsGetProjectBrowserHelper">vcsGetProjectBrowserHelper</a></td>
370 <td>Public method to instantiate a helper object for the different project browsers.</td>
371 </tr><tr>
372 <td><a href="#Git.vcsGetProjectHelper">vcsGetProjectHelper</a></td>
373 <td>Public method to instantiate a helper object for the project.</td>
374 </tr><tr>
375 <td><a href="#Git.vcsImport">vcsImport</a></td>
376 <td>Public method used to import the project into the Git repository.</td>
377 </tr><tr>
378 <td><a href="#Git.vcsInit">vcsInit</a></td>
379 <td>Public method used to initialize the Git repository.</td>
380 </tr><tr>
381 <td><a href="#Git.vcsInitConfig">vcsInitConfig</a></td>
382 <td>Public method to initialize the VCS configuration.</td>
383 </tr><tr>
384 <td><a href="#Git.vcsLogBrowser">vcsLogBrowser</a></td>
385 <td>Public method used to browse the log of a file/directory from the Git repository.</td>
386 </tr><tr>
387 <td><a href="#Git.vcsMerge">vcsMerge</a></td>
388 <td>Public method used to merge a URL/revision into the local project.</td>
389 </tr><tr>
390 <td><a href="#Git.vcsMove">vcsMove</a></td>
391 <td>Public method used to move a file/directory.</td>
392 </tr><tr>
393 <td><a href="#Git.vcsName">vcsName</a></td>
394 <td>Public method returning the name of the vcs.</td>
395 </tr><tr>
396 <td><a href="#Git.vcsNewProjectOptionsDialog">vcsNewProjectOptionsDialog</a></td>
397 <td>Public method to get a dialog to enter repository info for getting a new project.</td>
398 </tr><tr>
399 <td><a href="#Git.vcsOptionsDialog">vcsOptionsDialog</a></td>
400 <td>Public method to get a dialog to enter repository info.</td>
401 </tr><tr>
402 <td><a href="#Git.vcsRegisteredState">vcsRegisteredState</a></td>
403 <td>Public method used to get the registered state of a file in the vcs.</td>
404 </tr><tr>
405 <td><a href="#Git.vcsRemove">vcsRemove</a></td>
406 <td>Public method used to remove a file/directory from the Git repository.</td>
407 </tr><tr>
408 <td><a href="#Git.vcsRepositoryInfos">vcsRepositoryInfos</a></td>
409 <td>Public method to retrieve information about the repository.</td>
410 </tr><tr>
411 <td><a href="#Git.vcsShutdown">vcsShutdown</a></td>
412 <td>Public method used to shutdown the Git interface.</td>
413 </tr><tr>
414 <td><a href="#Git.vcsStatus">vcsStatus</a></td>
415 <td>Public method used to view the status of files/directories in the Git repository.</td>
416 </tr><tr>
417 <td><a href="#Git.vcsSupportCommandOptions">vcsSupportCommandOptions</a></td>
418 <td>Public method to signal the support of user settable command options.</td>
419 </tr><tr>
420 <td><a href="#Git.vcsSwitch">vcsSwitch</a></td>
421 <td>Public method used to switch a working directory to a different revision.</td>
422 </tr><tr>
423 <td><a href="#Git.vcsTag">vcsTag</a></td>
424 <td>Public method used to set/remove a tag in the Git repository.</td>
425 </tr><tr>
426 <td><a href="#Git.vcsUpdate">vcsUpdate</a></td>
427 <td>Public method used to update a file/directory with the Git repository.</td>
428 </tr>
429 </table>
430 <h3>Static Methods</h3>
431 <table>
432 <tr><td>None</td></tr>
433 </table>
434 <a NAME="Git.__init__" ID="Git.__init__"></a>
435 <h4>Git (Constructor)</h4>
436 <b>Git</b>(<i>plugin, parent=None, name=None</i>)
437 <p>
438 Constructor
439 </p><dl>
440 <dt><i>plugin</i></dt>
441 <dd>
442 reference to the plugin object
443 </dd><dt><i>parent</i></dt>
444 <dd>
445 parent widget (QWidget)
446 </dd><dt><i>name</i></dt>
447 <dd>
448 name of this object (string)
449 </dd>
450 </dl><a NAME="Git.__gitGetFileForRevision" ID="Git.__gitGetFileForRevision"></a>
451 <h4>Git.__gitGetFileForRevision</h4>
452 <b>__gitGetFileForRevision</b>(<i>name, rev=""</i>)
453 <p>
454 Private method to get a file for a specific revision from the
455 repository.
456 </p><dl>
457 <dt><i>name</i></dt>
458 <dd>
459 file name to get from the repository (string)
460 </dd><dt><i>rev=</i></dt>
461 <dd>
462 revision to retrieve (string)
463 </dd>
464 </dl><dl>
465 <dt>Returns:</dt>
466 <dd>
467 contents of the file (string) and an error message (string)
468 </dd>
469 </dl><a NAME="Git.__gitGetStashesList" ID="Git.__gitGetStashesList"></a>
470 <h4>Git.__gitGetStashesList</h4>
471 <b>__gitGetStashesList</b>(<i>projectDir</i>)
472 <p>
473 Private method to get a list of stash names.
474 </p><dl>
475 <dt><i>projectDir</i></dt>
476 <dd>
477 name of the project directory (string)
478 </dd>
479 </dl><dl>
480 <dt>Returns:</dt>
481 <dd>
482 list of available stashes (list of string)
483 </dd>
484 </dl><a NAME="Git.__gitSubmodulesList" ID="Git.__gitSubmodulesList"></a>
485 <h4>Git.__gitSubmodulesList</h4>
486 <b>__gitSubmodulesList</b>(<i>repodir</i>)
487 <p>
488 Private method to get the data of defined submodules.
489 </p><dl>
490 <dt><i>repodir</i> (str)</dt>
491 <dd>
492 name of the directory containing the repo subdirectory
493 </dd>
494 </dl><dl>
495 <dt>Returns:</dt>
496 <dd>
497 list of dictionaries with submodule name, path, URL and branch
498 </dd>
499 </dl><dl>
500 <dt>Return Type:</dt>
501 <dd>
502 list of dict
503 </dd>
504 </dl><a NAME="Git.__selectSubmodulePath" ID="Git.__selectSubmodulePath"></a>
505 <h4>Git.__selectSubmodulePath</h4>
506 <b>__selectSubmodulePath</b>(<i>repodir</i>)
507 <p>
508 Private method to select a submodule path.
509 </p><dl>
510 <dt><i>repodir</i> (str)</dt>
511 <dd>
512 name of the directory containing the repo subdirectory
513 </dd>
514 </dl><dl>
515 <dt>Returns:</dt>
516 <dd>
517 tuple of selected submodule path and flag indicating
518 a cancellation
519 </dd>
520 </dl><dl>
521 <dt>Return Type:</dt>
522 <dd>
523 tuple of (str, bool)
524 </dd>
525 </dl><a NAME="Git.__selectSubmodulePaths" ID="Git.__selectSubmodulePaths"></a>
526 <h4>Git.__selectSubmodulePaths</h4>
527 <b>__selectSubmodulePaths</b>(<i>repodir</i>)
528 <p>
529 Private method to select a list of submodule paths.
530 </p><dl>
531 <dt><i>repodir</i> (str)</dt>
532 <dd>
533 name of the directory containing the repo subdirectory
534 </dd>
535 </dl><dl>
536 <dt>Returns:</dt>
537 <dd>
538 tuple of selected submodule paths and flag indicating
539 a cancellation
540 </dd>
541 </dl><dl>
542 <dt>Return Type:</dt>
543 <dd>
544 tuple of (list of str, bool)
545 </dd>
546 </dl><a NAME="Git.__vcsCommit_Step2" ID="Git.__vcsCommit_Step2"></a>
547 <h4>Git.__vcsCommit_Step2</h4>
548 <b>__vcsCommit_Step2</b>(<i></i>)
549 <p>
550 Private slot performing the second step of the commit action.
551 </p><a NAME="Git._createStatusMonitorThread" ID="Git._createStatusMonitorThread"></a>
552 <h4>Git._createStatusMonitorThread</h4>
553 <b>_createStatusMonitorThread</b>(<i>interval, project</i>)
554 <p>
555 Protected method to create an instance of the VCS status monitor
556 thread.
557 </p><dl>
558 <dt><i>interval</i></dt>
559 <dd>
560 check interval for the monitor thread in seconds
561 (integer)
562 </dd><dt><i>project</i></dt>
563 <dd>
564 reference to the project object (Project)
565 </dd>
566 </dl><dl>
567 <dt>Returns:</dt>
568 <dd>
569 reference to the monitor thread (QThread)
570 </dd>
571 </dl><a NAME="Git.clearStatusCache" ID="Git.clearStatusCache"></a>
572 <h4>Git.clearStatusCache</h4>
573 <b>clearStatusCache</b>(<i></i>)
574 <p>
575 Public method to clear the status cache.
576 </p><a NAME="Git.getPlugin" ID="Git.getPlugin"></a>
577 <h4>Git.getPlugin</h4>
578 <b>getPlugin</b>(<i></i>)
579 <p>
580 Public method to get a reference to the plugin object.
581 </p><dl>
582 <dt>Returns:</dt>
583 <dd>
584 reference to the plugin object (VcsGitPlugin)
585 </dd>
586 </dl><a NAME="Git.gitAddRemote" ID="Git.gitAddRemote"></a>
587 <h4>Git.gitAddRemote</h4>
588 <b>gitAddRemote</b>(<i>projectDir</i>)
589 <p>
590 Public method to add a remote repository.
591 </p><dl>
592 <dt><i>projectDir</i></dt>
593 <dd>
594 name of the project directory (string)
595 </dd>
596 </dl><a NAME="Git.gitApply" ID="Git.gitApply"></a>
597 <h4>Git.gitApply</h4>
598 <b>gitApply</b>(<i>repodir, patchFile, cached=False, reverse=False, noDialog=False</i>)
599 <p>
600 Public method to apply a patch stored in a given file.
601 </p><dl>
602 <dt><i>repodir</i></dt>
603 <dd>
604 directory name of the repository (string)
605 </dd><dt><i>patchFile</i></dt>
606 <dd>
607 name of the patch file (string)
608 </dd><dt><i>cached</i></dt>
609 <dd>
610 flag indicating to apply the patch to the staging area
611 (boolean)
612 </dd><dt><i>reverse</i></dt>
613 <dd>
614 flag indicating to apply the patch in reverse (boolean)
615 </dd><dt><i>noDialog</i></dt>
616 <dd>
617 flag indicating quiet operations (boolean)
618 </dd>
619 </dl><a NAME="Git.gitApplyCheckPatches" ID="Git.gitApplyCheckPatches"></a>
620 <h4>Git.gitApplyCheckPatches</h4>
621 <b>gitApplyCheckPatches</b>(<i>projectDir, check=False</i>)
622 <p>
623 Public method to apply a list of patch files or check, if they would
624 apply cleanly.
625 </p><dl>
626 <dt><i>projectDir</i></dt>
627 <dd>
628 directory name of the project (string)
629 </dd><dt><i>check</i></dt>
630 <dd>
631 flag indicating to perform a check operation (boolean)
632 </dd>
633 </dl><a NAME="Git.gitBisect" ID="Git.gitBisect"></a>
634 <h4>Git.gitBisect</h4>
635 <b>gitBisect</b>(<i>projectDir, subcommand</i>)
636 <p>
637 Public method to perform bisect commands.
638 </p><dl>
639 <dt><i>projectDir</i></dt>
640 <dd>
641 name of the project directory (string)
642 </dd><dt><i>subcommand</i></dt>
643 <dd>
644 name of the subcommand (string, one of 'start',
645 'start_extended', 'good', 'bad', 'skip' or 'reset')
646 </dd>
647 </dl><dl>
648 <dt>Returns:</dt>
649 <dd>
650 flag indicating, that the update contained an add
651 or delete (boolean)
652 </dd>
653 </dl><dl>
654 <dt>Raises <b>ValueError</b>:</dt>
655 <dd>
656 raised to indicate an invalid bisect subcommand
657 </dd>
658 </dl><a NAME="Git.gitBisectCreateReplayFile" ID="Git.gitBisectCreateReplayFile"></a>
659 <h4>Git.gitBisectCreateReplayFile</h4>
660 <b>gitBisectCreateReplayFile</b>(<i>projectDir</i>)
661 <p>
662 Public method used to create a bisect replay file for the project.
663 </p><dl>
664 <dt><i>projectDir</i></dt>
665 <dd>
666 name of the project directory (string)
667 </dd>
668 </dl><a NAME="Git.gitBisectEditReplayFile" ID="Git.gitBisectEditReplayFile"></a>
669 <h4>Git.gitBisectEditReplayFile</h4>
670 <b>gitBisectEditReplayFile</b>(<i>projectDir</i>)
671 <p>
672 Public method used to edit a bisect replay file.
673 </p><dl>
674 <dt><i>projectDir</i></dt>
675 <dd>
676 name of the project directory (string)
677 </dd>
678 </dl><a NAME="Git.gitBisectLogBrowser" ID="Git.gitBisectLogBrowser"></a>
679 <h4>Git.gitBisectLogBrowser</h4>
680 <b>gitBisectLogBrowser</b>(<i>projectDir</i>)
681 <p>
682 Public method used to browse the bisect log of the project.
683 </p><dl>
684 <dt><i>projectDir</i></dt>
685 <dd>
686 name of the project directory (string)
687 </dd>
688 </dl><a NAME="Git.gitBisectReplay" ID="Git.gitBisectReplay"></a>
689 <h4>Git.gitBisectReplay</h4>
690 <b>gitBisectReplay</b>(<i>projectDir</i>)
691 <p>
692 Public method to replay a bisect session.
693 </p><dl>
694 <dt><i>projectDir</i></dt>
695 <dd>
696 name of the project directory (string)
697 </dd>
698 </dl><dl>
699 <dt>Returns:</dt>
700 <dd>
701 flag indicating, that the update contained an add
702 or delete (boolean)
703 </dd>
704 </dl><a NAME="Git.gitBlame" ID="Git.gitBlame"></a>
705 <h4>Git.gitBlame</h4>
706 <b>gitBlame</b>(<i>name</i>)
707 <p>
708 Public method to show the output of the git blame command.
709 </p><dl>
710 <dt><i>name</i></dt>
711 <dd>
712 file name to show the annotations for (string)
713 </dd>
714 </dl><a NAME="Git.gitBranch" ID="Git.gitBranch"></a>
715 <h4>Git.gitBranch</h4>
716 <b>gitBranch</b>(<i>name, revision=None, branchName=None, branchOp=None</i>)
717 <p>
718 Public method used to create, delete or move a branch in the Git
719 repository.
720 </p><dl>
721 <dt><i>name</i></dt>
722 <dd>
723 file/directory name to be branched (string)
724 </dd><dt><i>revision</i></dt>
725 <dd>
726 revision to set tag for (string)
727 </dd><dt><i>branchName</i></dt>
728 <dd>
729 name of the branch (string)
730 </dd><dt><i>branchOp</i></dt>
731 <dd>
732 desired branch operation (integer)
733 </dd>
734 </dl><dl>
735 <dt>Returns:</dt>
736 <dd>
737 flag indicating a performed branch action (boolean) and
738 a flag indicating, that the branch operation contained an add
739 or delete (boolean)
740 </dd>
741 </dl><a NAME="Git.gitBundle" ID="Git.gitBundle"></a>
742 <h4>Git.gitBundle</h4>
743 <b>gitBundle</b>(<i>projectDir</i>)
744 <p>
745 Public method to create a bundle file.
746 </p><dl>
747 <dt><i>projectDir</i></dt>
748 <dd>
749 name of the project directory (string)
750 </dd>
751 </dl><a NAME="Git.gitBundleFetch" ID="Git.gitBundleFetch"></a>
752 <h4>Git.gitBundleFetch</h4>
753 <b>gitBundleFetch</b>(<i>projectDir</i>)
754 <p>
755 Public method to fetch a head of a bundle file into the local
756 repository.
757 </p><dl>
758 <dt><i>projectDir</i></dt>
759 <dd>
760 name of the project directory (string)
761 </dd>
762 </dl><a NAME="Git.gitBundleListHeads" ID="Git.gitBundleListHeads"></a>
763 <h4>Git.gitBundleListHeads</h4>
764 <b>gitBundleListHeads</b>(<i>projectDir</i>)
765 <p>
766 Public method to list the heads contained in a bundle file.
767 </p><dl>
768 <dt><i>projectDir</i></dt>
769 <dd>
770 name of the project directory (string)
771 </dd>
772 </dl><a NAME="Git.gitBundlePull" ID="Git.gitBundlePull"></a>
773 <h4>Git.gitBundlePull</h4>
774 <b>gitBundlePull</b>(<i>projectDir</i>)
775 <p>
776 Public method to pull a head of a bundle file into the local
777 repository and working area.
778 </p><dl>
779 <dt><i>projectDir</i></dt>
780 <dd>
781 name of the project directory (string)
782 </dd>
783 </dl><dl>
784 <dt>Returns:</dt>
785 <dd>
786 flag indicating, that the update contained an add
787 or delete (boolean)
788 </dd>
789 </dl><a NAME="Git.gitCancelMerge" ID="Git.gitCancelMerge"></a>
790 <h4>Git.gitCancelMerge</h4>
791 <b>gitCancelMerge</b>(<i>name</i>)
792 <p>
793 Public method to cancel an uncommitted or failed merge.
794 </p><dl>
795 <dt><i>name</i></dt>
796 <dd>
797 file/directory name (string)
798 </dd>
799 </dl><dl>
800 <dt>Returns:</dt>
801 <dd>
802 flag indicating, that the cancellation contained an add
803 or delete (boolean)
804 </dd>
805 </dl><a NAME="Git.gitChangeRemoteCredentials" ID="Git.gitChangeRemoteCredentials"></a>
806 <h4>Git.gitChangeRemoteCredentials</h4>
807 <b>gitChangeRemoteCredentials</b>(<i>projectDir, remoteName, remoteUrl=""</i>)
808 <p>
809 Public method to change the user credentials of a remote repository.
810 </p><dl>
811 <dt><i>projectDir</i> (str)</dt>
812 <dd>
813 name of the project directory
814 </dd><dt><i>remoteName</i> (str)</dt>
815 <dd>
816 name of the remote repository
817 </dd><dt><i>remoteUrl</i> (str)</dt>
818 <dd>
819 URL of the remote repository
820 </dd>
821 </dl><a NAME="Git.gitChangeRemoteUrl" ID="Git.gitChangeRemoteUrl"></a>
822 <h4>Git.gitChangeRemoteUrl</h4>
823 <b>gitChangeRemoteUrl</b>(<i>projectDir, remoteName, remoteUrl=""</i>)
824 <p>
825 Public method to change the URL of a remote repository.
826 </p><dl>
827 <dt><i>projectDir</i> (str)</dt>
828 <dd>
829 name of the project directory
830 </dd><dt><i>remoteName</i> (str)</dt>
831 <dd>
832 name of the remote repository
833 </dd><dt><i>remoteUrl</i> (str)</dt>
834 <dd>
835 URL of the remote repository
836 </dd>
837 </dl><a NAME="Git.gitCherryPick" ID="Git.gitCherryPick"></a>
838 <h4>Git.gitCherryPick</h4>
839 <b>gitCherryPick</b>(<i>projectDir, commits=None</i>)
840 <p>
841 Public method to cherry pick commits and apply them to the current
842 branch.
843 </p><dl>
844 <dt><i>projectDir</i></dt>
845 <dd>
846 name of the project directory (string)
847 </dd><dt><i>commits</i></dt>
848 <dd>
849 list of commits to be applied (list of strings)
850 </dd>
851 </dl><dl>
852 <dt>Returns:</dt>
853 <dd>
854 flag indicating that the project should be reread (boolean)
855 </dd>
856 </dl><a NAME="Git.gitCherryPickAbort" ID="Git.gitCherryPickAbort"></a>
857 <h4>Git.gitCherryPickAbort</h4>
858 <b>gitCherryPickAbort</b>(<i>projectDir</i>)
859 <p>
860 Public method to cancel the last copying session and return to
861 the previous state.
862 </p><dl>
863 <dt><i>projectDir</i></dt>
864 <dd>
865 name of the project directory (string)
866 </dd>
867 </dl><dl>
868 <dt>Returns:</dt>
869 <dd>
870 flag indicating that the project should be reread (boolean)
871 </dd>
872 </dl><a NAME="Git.gitCherryPickContinue" ID="Git.gitCherryPickContinue"></a>
873 <h4>Git.gitCherryPickContinue</h4>
874 <b>gitCherryPickContinue</b>(<i>projectDir</i>)
875 <p>
876 Public method to continue the last copying session after conflicts
877 were resolved.
878 </p><dl>
879 <dt><i>projectDir</i></dt>
880 <dd>
881 name of the project directory (string)
882 </dd>
883 </dl><dl>
884 <dt>Returns:</dt>
885 <dd>
886 flag indicating that the project should be reread (boolean)
887 </dd>
888 </dl><a NAME="Git.gitCherryPickQuit" ID="Git.gitCherryPickQuit"></a>
889 <h4>Git.gitCherryPickQuit</h4>
890 <b>gitCherryPickQuit</b>(<i>projectDir</i>)
891 <p>
892 Public method to quit the current copying operation.
893 </p><dl>
894 <dt><i>projectDir</i></dt>
895 <dd>
896 name of the project directory (string)
897 </dd>
898 </dl><dl>
899 <dt>Returns:</dt>
900 <dd>
901 flag indicating that the project should be reread (boolean)
902 </dd>
903 </dl><a NAME="Git.gitCommitMerge" ID="Git.gitCommitMerge"></a>
904 <h4>Git.gitCommitMerge</h4>
905 <b>gitCommitMerge</b>(<i>name</i>)
906 <p>
907 Public method to commit a failed merge.
908 </p><dl>
909 <dt><i>name</i></dt>
910 <dd>
911 file/directory name (string)
912 </dd>
913 </dl><a NAME="Git.gitCopy" ID="Git.gitCopy"></a>
914 <h4>Git.gitCopy</h4>
915 <b>gitCopy</b>(<i>name, project</i>)
916 <p>
917 Public method used to copy a file/directory.
918 </p><dl>
919 <dt><i>name</i></dt>
920 <dd>
921 file/directory name to be copied (string)
922 </dd><dt><i>project</i></dt>
923 <dd>
924 reference to the project object
925 </dd>
926 </dl><dl>
927 <dt>Returns:</dt>
928 <dd>
929 flag indicating successful operation (boolean)
930 </dd>
931 </dl><a NAME="Git.gitCreateArchive" ID="Git.gitCreateArchive"></a>
932 <h4>Git.gitCreateArchive</h4>
933 <b>gitCreateArchive</b>(<i>projectDir</i>)
934 <p>
935 Public method to show some statistics of the local repository.
936 </p><dl>
937 <dt><i>projectDir</i></dt>
938 <dd>
939 name of the project directory (string)
940 </dd>
941 </dl><a NAME="Git.gitCreateIgnoreFile" ID="Git.gitCreateIgnoreFile"></a>
942 <h4>Git.gitCreateIgnoreFile</h4>
943 <b>gitCreateIgnoreFile</b>(<i>name, autoAdd=False</i>)
944 <p>
945 Public method to create the ignore file.
946 </p><dl>
947 <dt><i>name</i></dt>
948 <dd>
949 directory name to create the ignore file in (string)
950 </dd><dt><i>autoAdd</i></dt>
951 <dd>
952 flag indicating to add it automatically (boolean)
953 </dd>
954 </dl><dl>
955 <dt>Returns:</dt>
956 <dd>
957 flag indicating success
958 </dd>
959 </dl><a NAME="Git.gitDeleteRemoteBranch" ID="Git.gitDeleteRemoteBranch"></a>
960 <h4>Git.gitDeleteRemoteBranch</h4>
961 <b>gitDeleteRemoteBranch</b>(<i>name</i>)
962 <p>
963 Public method to delete a branch from a remote repository.
964 </p><dl>
965 <dt><i>name</i></dt>
966 <dd>
967 file/directory name (string)
968 </dd>
969 </dl><a NAME="Git.gitDescribe" ID="Git.gitDescribe"></a>
970 <h4>Git.gitDescribe</h4>
971 <b>gitDescribe</b>(<i>projectDir, commits</i>)
972 <p>
973 Public method to find the most recent tag reachable from each commit.
974 </p><dl>
975 <dt><i>projectDir</i></dt>
976 <dd>
977 name of the project directory (string)
978 </dd><dt><i>commits</i></dt>
979 <dd>
980 list of commits to start the search from
981 (list of strings)
982 </dd>
983 </dl><a NAME="Git.gitEditConfig" ID="Git.gitEditConfig"></a>
984 <h4>Git.gitEditConfig</h4>
985 <b>gitEditConfig</b>(<i>projectDir</i>)
986 <p>
987 Public method used to edit the repository configuration file.
988 </p><dl>
989 <dt><i>projectDir</i></dt>
990 <dd>
991 name of the project directory (string)
992 </dd>
993 </dl><a NAME="Git.gitEditUserConfig" ID="Git.gitEditUserConfig"></a>
994 <h4>Git.gitEditUserConfig</h4>
995 <b>gitEditUserConfig</b>(<i></i>)
996 <p>
997 Public method used to edit the user configuration file.
998 </p><a NAME="Git.gitExtendedDiff" ID="Git.gitExtendedDiff"></a>
999 <h4>Git.gitExtendedDiff</h4>
1000 <b>gitExtendedDiff</b>(<i>name</i>)
1001 <p>
1002 Public method used to view the difference of a file/directory to the
1003 Git repository.
1004 </p><p>
1005 If name is a directory and is the project directory, all project files
1006 are saved first. If name is a file (or list of files), which is/are
1007 being edited and has unsaved modification, they can be saved or the
1008 operation may be aborted.
1009 </p><p>
1010 This method gives the chance to enter the revisions to be compared.
1011 </p><dl>
1012 <dt><i>name</i></dt>
1013 <dd>
1014 file/directory name to be diffed (string)
1015 </dd>
1016 </dl><a NAME="Git.gitFetch" ID="Git.gitFetch"></a>
1017 <h4>Git.gitFetch</h4>
1018 <b>gitFetch</b>(<i>name</i>)
1019 <p>
1020 Public method to fetch changes from a remote repository.
1021 </p><dl>
1022 <dt><i>name</i></dt>
1023 <dd>
1024 directory name (string)
1025 </dd>
1026 </dl><a NAME="Git.gitGetArchiveFormats" ID="Git.gitGetArchiveFormats"></a>
1027 <h4>Git.gitGetArchiveFormats</h4>
1028 <b>gitGetArchiveFormats</b>(<i>repodir</i>)
1029 <p>
1030 Public method to get a list of supported archive formats.
1031 </p><dl>
1032 <dt><i>repodir</i></dt>
1033 <dd>
1034 directory name of the repository (string)
1035 </dd>
1036 </dl><dl>
1037 <dt>Returns:</dt>
1038 <dd>
1039 list of supported archive formats (list of strings)
1040 </dd>
1041 </dl><a NAME="Git.gitGetBranchesList" ID="Git.gitGetBranchesList"></a>
1042 <h4>Git.gitGetBranchesList</h4>
1043 <b>gitGetBranchesList</b>(<i>repodir, withMaster=False, allBranches=False, remotes=False</i>)
1044 <p>
1045 Public method to get the list of branches.
1046 </p><dl>
1047 <dt><i>repodir</i></dt>
1048 <dd>
1049 directory name of the repository (string)
1050 </dd><dt><i>withMaster</i></dt>
1051 <dd>
1052 flag indicating to get 'master' as well (boolean)
1053 </dd><dt><i>allBranches</i></dt>
1054 <dd>
1055 flag indicating to return all branches (boolean)
1056 </dd><dt><i>remotes</i></dt>
1057 <dd>
1058 flag indicating to return remote branches only (boolean)
1059 </dd>
1060 </dl><dl>
1061 <dt>Returns:</dt>
1062 <dd>
1063 list of branches (list of string)
1064 </dd>
1065 </dl><a NAME="Git.gitGetBundleHeads" ID="Git.gitGetBundleHeads"></a>
1066 <h4>Git.gitGetBundleHeads</h4>
1067 <b>gitGetBundleHeads</b>(<i>repodir, bundleFile</i>)
1068 <p>
1069 Public method to get a list of heads contained in a bundle file.
1070 </p><dl>
1071 <dt><i>repodir</i></dt>
1072 <dd>
1073 directory name of the repository (string)
1074 </dd><dt><i>bundleFile</i></dt>
1075 <dd>
1076 file name of a git bundle file (string)
1077 </dd>
1078 </dl><dl>
1079 <dt>Returns:</dt>
1080 <dd>
1081 list of heads (list of strings)
1082 </dd>
1083 </dl><a NAME="Git.gitGetCurrentBranch" ID="Git.gitGetCurrentBranch"></a>
1084 <h4>Git.gitGetCurrentBranch</h4>
1085 <b>gitGetCurrentBranch</b>(<i>repodir</i>)
1086 <p>
1087 Public method used to show the current branch of the working directory.
1088 </p><dl>
1089 <dt><i>repodir</i></dt>
1090 <dd>
1091 directory name of the repository (string)
1092 </dd>
1093 </dl><dl>
1094 <dt>Returns:</dt>
1095 <dd>
1096 name of the current branch (string)
1097 </dd>
1098 </dl><a NAME="Git.gitGetRemoteBranchesList" ID="Git.gitGetRemoteBranchesList"></a>
1099 <h4>Git.gitGetRemoteBranchesList</h4>
1100 <b>gitGetRemoteBranchesList</b>(<i>repodir, remote</i>)
1101 <p>
1102 Public method to get the list of a remote repository branches.
1103 </p><dl>
1104 <dt><i>repodir</i></dt>
1105 <dd>
1106 directory name of the repository (string)
1107 </dd><dt><i>remote</i></dt>
1108 <dd>
1109 remote repository name (string)
1110 </dd>
1111 </dl><dl>
1112 <dt>Returns:</dt>
1113 <dd>
1114 list of remote repository branches (list of string)
1115 </dd>
1116 </dl><a NAME="Git.gitGetRemoteUrl" ID="Git.gitGetRemoteUrl"></a>
1117 <h4>Git.gitGetRemoteUrl</h4>
1118 <b>gitGetRemoteUrl</b>(<i>repodir, remoteName</i>)
1119 <p>
1120 Public method to get the URL of a remote repository.
1121 </p><dl>
1122 <dt><i>repodir</i> (str)</dt>
1123 <dd>
1124 directory name of the repository
1125 </dd><dt><i>remoteName</i> (str)</dt>
1126 <dd>
1127 name of the remote repository
1128 </dd>
1129 </dl><dl>
1130 <dt>Returns:</dt>
1131 <dd>
1132 URL of the remote repository
1133 </dd>
1134 </dl><dl>
1135 <dt>Return Type:</dt>
1136 <dd>
1137 str
1138 </dd>
1139 </dl><a NAME="Git.gitGetRemoteUrlsList" ID="Git.gitGetRemoteUrlsList"></a>
1140 <h4>Git.gitGetRemoteUrlsList</h4>
1141 <b>gitGetRemoteUrlsList</b>(<i>repodir, forFetch=True</i>)
1142 <p>
1143 Public method to get the list of remote repos and their URLs.
1144 </p><dl>
1145 <dt><i>repodir</i></dt>
1146 <dd>
1147 directory name of the repository (string)
1148 </dd><dt><i>forFetch</i></dt>
1149 <dd>
1150 flag indicating to get Fetch info (string)
1151 </dd>
1152 </dl><dl>
1153 <dt>Returns:</dt>
1154 <dd>
1155 list of tuples of remote repo name and repo URL (list of
1156 tuple of two strings)
1157 </dd>
1158 </dl><a NAME="Git.gitGetRemotesList" ID="Git.gitGetRemotesList"></a>
1159 <h4>Git.gitGetRemotesList</h4>
1160 <b>gitGetRemotesList</b>(<i>repodir</i>)
1161 <p>
1162 Public method to get the list of remote repos.
1163 </p><dl>
1164 <dt><i>repodir</i></dt>
1165 <dd>
1166 directory name of the repository (string)
1167 </dd>
1168 </dl><dl>
1169 <dt>Returns:</dt>
1170 <dd>
1171 list of remote repos (list of string)
1172 </dd>
1173 </dl><a NAME="Git.gitGetTagsList" ID="Git.gitGetTagsList"></a>
1174 <h4>Git.gitGetTagsList</h4>
1175 <b>gitGetTagsList</b>(<i>repodir, withType=False</i>)
1176 <p>
1177 Public method to get the list of tags.
1178 </p><dl>
1179 <dt><i>repodir</i></dt>
1180 <dd>
1181 directory name of the repository (string)
1182 </dd><dt><i>withType</i></dt>
1183 <dd>
1184 flag indicating to get the tag type as well (boolean)
1185 </dd>
1186 </dl><dl>
1187 <dt>Returns:</dt>
1188 <dd>
1189 list of tags (list of string) or list of tuples of
1190 tag name and flag indicating a local tag (list of tuple of string
1191 and boolean), if withType is True
1192 </dd>
1193 </dl><a NAME="Git.gitHouseKeeping" ID="Git.gitHouseKeeping"></a>
1194 <h4>Git.gitHouseKeeping</h4>
1195 <b>gitHouseKeeping</b>(<i>projectDir</i>)
1196 <p>
1197 Public method to cleanup and optimize the local repository.
1198 </p><dl>
1199 <dt><i>projectDir</i></dt>
1200 <dd>
1201 name of the project directory (string)
1202 </dd>
1203 </dl><a NAME="Git.gitListTagBranch" ID="Git.gitListTagBranch"></a>
1204 <h4>Git.gitListTagBranch</h4>
1205 <b>gitListTagBranch</b>(<i>path, tags=True, listAll=True, merged=True</i>)
1206 <p>
1207 Public method used to list the available tags or branches.
1208 </p><dl>
1209 <dt><i>path</i></dt>
1210 <dd>
1211 directory name of the project (string)
1212 </dd><dt><i>tags</i></dt>
1213 <dd>
1214 flag indicating listing of branches or tags
1215 (False = branches, True = tags)
1216 </dd><dt><i>listAll</i></dt>
1217 <dd>
1218 flag indicating to show all tags or branches (boolean)
1219 </dd><dt><i>merged</i></dt>
1220 <dd>
1221 flag indicating to show only merged or non-merged
1222 branches (boolean)
1223 </dd>
1224 </dl><a NAME="Git.gitNormalizeURL" ID="Git.gitNormalizeURL"></a>
1225 <h4>Git.gitNormalizeURL</h4>
1226 <b>gitNormalizeURL</b>(<i>url</i>)
1227 <p>
1228 Public method to normalize a url for Git.
1229 </p><dl>
1230 <dt><i>url</i></dt>
1231 <dd>
1232 url string (string)
1233 </dd>
1234 </dl><dl>
1235 <dt>Returns:</dt>
1236 <dd>
1237 properly normalized url for git (string)
1238 </dd>
1239 </dl><a NAME="Git.gitPruneRemote" ID="Git.gitPruneRemote"></a>
1240 <h4>Git.gitPruneRemote</h4>
1241 <b>gitPruneRemote</b>(<i>projectDir, remoteName</i>)
1242 <p>
1243 Public method to prune stale remote-tracking branches.
1244 </p><dl>
1245 <dt><i>projectDir</i></dt>
1246 <dd>
1247 name of the project directory (string)
1248 </dd><dt><i>remoteName</i></dt>
1249 <dd>
1250 name of the remote repository (string)
1251 </dd>
1252 </dl><a NAME="Git.gitPull" ID="Git.gitPull"></a>
1253 <h4>Git.gitPull</h4>
1254 <b>gitPull</b>(<i>name</i>)
1255 <p>
1256 Public method used to pull changes from a remote Git repository.
1257 </p><dl>
1258 <dt><i>name</i></dt>
1259 <dd>
1260 directory name of the project to be pulled to (string)
1261 </dd>
1262 </dl><dl>
1263 <dt>Returns:</dt>
1264 <dd>
1265 flag indicating, that the update contained an add
1266 or delete (boolean)
1267 </dd>
1268 </dl><a NAME="Git.gitPush" ID="Git.gitPush"></a>
1269 <h4>Git.gitPush</h4>
1270 <b>gitPush</b>(<i>name</i>)
1271 <p>
1272 Public method used to push changes to a remote Git repository.
1273 </p><dl>
1274 <dt><i>name</i></dt>
1275 <dd>
1276 directory name of the project to be pushed from (string)
1277 </dd>
1278 </dl><a NAME="Git.gitReflogBrowser" ID="Git.gitReflogBrowser"></a>
1279 <h4>Git.gitReflogBrowser</h4>
1280 <b>gitReflogBrowser</b>(<i>projectDir</i>)
1281 <p>
1282 Public method used to browse the reflog of the project.
1283 </p><dl>
1284 <dt><i>projectDir</i></dt>
1285 <dd>
1286 name of the project directory (string)
1287 </dd>
1288 </dl><a NAME="Git.gitRemoveRemote" ID="Git.gitRemoveRemote"></a>
1289 <h4>Git.gitRemoveRemote</h4>
1290 <b>gitRemoveRemote</b>(<i>projectDir, remoteName</i>)
1291 <p>
1292 Public method to remove a remote repository.
1293 </p><dl>
1294 <dt><i>projectDir</i></dt>
1295 <dd>
1296 name of the project directory (string)
1297 </dd><dt><i>remoteName</i></dt>
1298 <dd>
1299 name of the remote repository (string)
1300 </dd>
1301 </dl><a NAME="Git.gitRenameRemote" ID="Git.gitRenameRemote"></a>
1302 <h4>Git.gitRenameRemote</h4>
1303 <b>gitRenameRemote</b>(<i>projectDir, remoteName</i>)
1304 <p>
1305 Public method to rename a remote repository.
1306 </p><dl>
1307 <dt><i>projectDir</i></dt>
1308 <dd>
1309 name of the project directory (string)
1310 </dd><dt><i>remoteName</i></dt>
1311 <dd>
1312 name of the remote repository (string)
1313 </dd>
1314 </dl><a NAME="Git.gitRevert" ID="Git.gitRevert"></a>
1315 <h4>Git.gitRevert</h4>
1316 <b>gitRevert</b>(<i>name</i>)
1317 <p>
1318 Public method used to revert changes made to a file/directory.
1319 </p><dl>
1320 <dt><i>name</i></dt>
1321 <dd>
1322 file/directory name to be reverted (string)
1323 </dd>
1324 </dl><dl>
1325 <dt>Returns:</dt>
1326 <dd>
1327 flag indicating, that the update contained an add
1328 or delete (boolean)
1329 </dd>
1330 </dl><a NAME="Git.gitSbsDiff" ID="Git.gitSbsDiff"></a>
1331 <h4>Git.gitSbsDiff</h4>
1332 <b>gitSbsDiff</b>(<i>name, extended=False, revisions=None</i>)
1333 <p>
1334 Public method used to view the difference of a file to the Git
1335 repository side-by-side.
1336 </p><dl>
1337 <dt><i>name</i></dt>
1338 <dd>
1339 file name to be diffed (string)
1340 </dd><dt><i>extended=</i></dt>
1341 <dd>
1342 flag indicating the extended variant (boolean)
1343 </dd><dt><i>revisions=</i></dt>
1344 <dd>
1345 tuple of two revisions (tuple of strings)
1346 </dd>
1347 </dl><dl>
1348 <dt>Raises <b>ValueError</b>:</dt>
1349 <dd>
1350 raised to indicate an invalid name parameter
1351 </dd>
1352 </dl><a NAME="Git.gitShortlog" ID="Git.gitShortlog"></a>
1353 <h4>Git.gitShortlog</h4>
1354 <b>gitShortlog</b>(<i>projectDir, commit</i>)
1355 <p>
1356 Public method to show a short log suitable for inclusion in release
1357 announcements.
1358 </p><dl>
1359 <dt><i>projectDir</i></dt>
1360 <dd>
1361 name of the project directory (string)
1362 </dd><dt><i>commit</i></dt>
1363 <dd>
1364 commit to start the log at (strings)
1365 </dd>
1366 </dl><a NAME="Git.gitShowBranch" ID="Git.gitShowBranch"></a>
1367 <h4>Git.gitShowBranch</h4>
1368 <b>gitShowBranch</b>(<i>name</i>)
1369 <p>
1370 Public method used to show the current branch of the working directory.
1371 </p><dl>
1372 <dt><i>name</i></dt>
1373 <dd>
1374 file/directory name (string)
1375 </dd>
1376 </dl><a NAME="Git.gitShowConfig" ID="Git.gitShowConfig"></a>
1377 <h4>Git.gitShowConfig</h4>
1378 <b>gitShowConfig</b>(<i>projectDir</i>)
1379 <p>
1380 Public method to show the combined configuration.
1381 </p><dl>
1382 <dt><i>projectDir</i></dt>
1383 <dd>
1384 name of the project directory (string)
1385 </dd>
1386 </dl><a NAME="Git.gitShowPatchesStatistics" ID="Git.gitShowPatchesStatistics"></a>
1387 <h4>Git.gitShowPatchesStatistics</h4>
1388 <b>gitShowPatchesStatistics</b>(<i>projectDir</i>)
1389 <p>
1390 Public method to show statistics for a set of patch files.
1391 </p><dl>
1392 <dt><i>projectDir</i></dt>
1393 <dd>
1394 directory name of the project (string)
1395 </dd>
1396 </dl><a NAME="Git.gitShowRemote" ID="Git.gitShowRemote"></a>
1397 <h4>Git.gitShowRemote</h4>
1398 <b>gitShowRemote</b>(<i>projectDir, remoteName</i>)
1399 <p>
1400 Public method to show information about a remote repository.
1401 </p><dl>
1402 <dt><i>projectDir</i></dt>
1403 <dd>
1404 name of the project directory (string)
1405 </dd><dt><i>remoteName</i></dt>
1406 <dd>
1407 name of the remote repository (string)
1408 </dd>
1409 </dl><a NAME="Git.gitShowRemotes" ID="Git.gitShowRemotes"></a>
1410 <h4>Git.gitShowRemotes</h4>
1411 <b>gitShowRemotes</b>(<i>projectDir</i>)
1412 <p>
1413 Public method to show available remote repositories.
1414 </p><dl>
1415 <dt><i>projectDir</i></dt>
1416 <dd>
1417 name of the project directory (string)
1418 </dd>
1419 </dl><a NAME="Git.gitStashApply" ID="Git.gitStashApply"></a>
1420 <h4>Git.gitStashApply</h4>
1421 <b>gitStashApply</b>(<i>projectDir, stashName=""</i>)
1422 <p>
1423 Public method to apply a stash but keep it.
1424 </p><dl>
1425 <dt><i>projectDir</i></dt>
1426 <dd>
1427 name of the project directory (string)
1428 </dd><dt><i>stashName</i></dt>
1429 <dd>
1430 name of a stash (string)
1431 </dd>
1432 </dl><dl>
1433 <dt>Returns:</dt>
1434 <dd>
1435 flag indicating, that the restore contained an add
1436 or delete (boolean)
1437 </dd>
1438 </dl><a NAME="Git.gitStashBranch" ID="Git.gitStashBranch"></a>
1439 <h4>Git.gitStashBranch</h4>
1440 <b>gitStashBranch</b>(<i>projectDir, stashName=""</i>)
1441 <p>
1442 Public method to create a branch from a stash.
1443 </p><dl>
1444 <dt><i>projectDir</i></dt>
1445 <dd>
1446 name of the project directory (string)
1447 </dd><dt><i>stashName</i></dt>
1448 <dd>
1449 name of a stash (string)
1450 </dd>
1451 </dl><dl>
1452 <dt>Returns:</dt>
1453 <dd>
1454 flag indicating, that the restore contained an add
1455 or delete (boolean)
1456 </dd>
1457 </dl><a NAME="Git.gitStashBrowser" ID="Git.gitStashBrowser"></a>
1458 <h4>Git.gitStashBrowser</h4>
1459 <b>gitStashBrowser</b>(<i>projectDir</i>)
1460 <p>
1461 Public method used to browse the stashed changes.
1462 </p><dl>
1463 <dt><i>projectDir</i></dt>
1464 <dd>
1465 name of the project directory (string)
1466 </dd>
1467 </dl><a NAME="Git.gitStashClear" ID="Git.gitStashClear"></a>
1468 <h4>Git.gitStashClear</h4>
1469 <b>gitStashClear</b>(<i>projectDir</i>)
1470 <p>
1471 Public method to delete all stashes.
1472 </p><dl>
1473 <dt><i>projectDir</i></dt>
1474 <dd>
1475 name of the project directory (string)
1476 </dd>
1477 </dl><dl>
1478 <dt>Returns:</dt>
1479 <dd>
1480 flag indicating a successful deletion (boolean)
1481 </dd>
1482 </dl><a NAME="Git.gitStashDrop" ID="Git.gitStashDrop"></a>
1483 <h4>Git.gitStashDrop</h4>
1484 <b>gitStashDrop</b>(<i>projectDir, stashName=""</i>)
1485 <p>
1486 Public method to delete a stash.
1487 </p><dl>
1488 <dt><i>projectDir</i></dt>
1489 <dd>
1490 name of the project directory (string)
1491 </dd><dt><i>stashName</i></dt>
1492 <dd>
1493 name of a stash (string)
1494 </dd>
1495 </dl><dl>
1496 <dt>Returns:</dt>
1497 <dd>
1498 flag indicating a successful deletion (boolean)
1499 </dd>
1500 </dl><a NAME="Git.gitStashPop" ID="Git.gitStashPop"></a>
1501 <h4>Git.gitStashPop</h4>
1502 <b>gitStashPop</b>(<i>projectDir, stashName=""</i>)
1503 <p>
1504 Public method to apply a stash and delete it.
1505 </p><dl>
1506 <dt><i>projectDir</i></dt>
1507 <dd>
1508 name of the project directory (string)
1509 </dd><dt><i>stashName</i></dt>
1510 <dd>
1511 name of a stash (string)
1512 </dd>
1513 </dl><dl>
1514 <dt>Returns:</dt>
1515 <dd>
1516 flag indicating, that the restore contained an add
1517 or delete (boolean)
1518 </dd>
1519 </dl><a NAME="Git.gitStashSave" ID="Git.gitStashSave"></a>
1520 <h4>Git.gitStashSave</h4>
1521 <b>gitStashSave</b>(<i>projectDir</i>)
1522 <p>
1523 Public method to save the current changes to a new stash.
1524 </p><dl>
1525 <dt><i>projectDir</i></dt>
1526 <dd>
1527 name of the project directory (string)
1528 </dd>
1529 </dl><dl>
1530 <dt>Returns:</dt>
1531 <dd>
1532 flag indicating, that the save contained an add
1533 or delete (boolean)
1534 </dd>
1535 </dl><a NAME="Git.gitStashShowPatch" ID="Git.gitStashShowPatch"></a>
1536 <h4>Git.gitStashShowPatch</h4>
1537 <b>gitStashShowPatch</b>(<i>projectDir, stashName=""</i>)
1538 <p>
1539 Public method to show the contents of a stash.
1540 </p><dl>
1541 <dt><i>projectDir</i></dt>
1542 <dd>
1543 name of the project directory (string)
1544 </dd><dt><i>stashName</i></dt>
1545 <dd>
1546 name of a stash (string)
1547 </dd>
1548 </dl><a NAME="Git.gitStatistics" ID="Git.gitStatistics"></a>
1549 <h4>Git.gitStatistics</h4>
1550 <b>gitStatistics</b>(<i>projectDir</i>)
1551 <p>
1552 Public method to show some statistics of the local repository.
1553 </p><dl>
1554 <dt><i>projectDir</i></dt>
1555 <dd>
1556 name of the project directory (string)
1557 </dd>
1558 </dl><a NAME="Git.gitSubmoduleAdd" ID="Git.gitSubmoduleAdd"></a>
1559 <h4>Git.gitSubmoduleAdd</h4>
1560 <b>gitSubmoduleAdd</b>(<i>projectDir</i>)
1561 <p>
1562 Public method to add a submodule to the project.
1563 </p><dl>
1564 <dt><i>projectDir</i> (str)</dt>
1565 <dd>
1566 name of the project directory
1567 </dd>
1568 </dl><a NAME="Git.gitSubmoduleDeinit" ID="Git.gitSubmoduleDeinit"></a>
1569 <h4>Git.gitSubmoduleDeinit</h4>
1570 <b>gitSubmoduleDeinit</b>(<i>projectDir</i>)
1571 <p>
1572 Public method to unregister submodules.
1573 </p><dl>
1574 <dt><i>projectDir</i> (str)</dt>
1575 <dd>
1576 name of the project directory
1577 </dd>
1578 </dl><a NAME="Git.gitSubmoduleInit" ID="Git.gitSubmoduleInit"></a>
1579 <h4>Git.gitSubmoduleInit</h4>
1580 <b>gitSubmoduleInit</b>(<i>projectDir</i>)
1581 <p>
1582 Public method to initialize one or all submodules.
1583 </p><dl>
1584 <dt><i>projectDir</i> (str)</dt>
1585 <dd>
1586 name of the project directory
1587 </dd>
1588 </dl><a NAME="Git.gitSubmoduleList" ID="Git.gitSubmoduleList"></a>
1589 <h4>Git.gitSubmoduleList</h4>
1590 <b>gitSubmoduleList</b>(<i>projectDir</i>)
1591 <p>
1592 Public method to show a list of all submodules of the project.
1593 </p><dl>
1594 <dt><i>projectDir</i> (str)</dt>
1595 <dd>
1596 name of the project directory
1597 </dd>
1598 </dl><a NAME="Git.gitSubmoduleStatus" ID="Git.gitSubmoduleStatus"></a>
1599 <h4>Git.gitSubmoduleStatus</h4>
1600 <b>gitSubmoduleStatus</b>(<i>projectDir</i>)
1601 <p>
1602 Public method to show the status of the submodules.
1603 </p><dl>
1604 <dt><i>projectDir</i> (str)</dt>
1605 <dd>
1606 name of the project directory
1607 </dd>
1608 </dl><a NAME="Git.gitSubmoduleSummary" ID="Git.gitSubmoduleSummary"></a>
1609 <h4>Git.gitSubmoduleSummary</h4>
1610 <b>gitSubmoduleSummary</b>(<i>projectDir</i>)
1611 <p>
1612 Public method to show the status of the submodules.
1613 </p><dl>
1614 <dt><i>projectDir</i> (str)</dt>
1615 <dd>
1616 name of the project directory
1617 </dd>
1618 </dl><a NAME="Git.gitSubmoduleSync" ID="Git.gitSubmoduleSync"></a>
1619 <h4>Git.gitSubmoduleSync</h4>
1620 <b>gitSubmoduleSync</b>(<i>projectDir</i>)
1621 <p>
1622 Public method to synchronize submodules.
1623 </p><dl>
1624 <dt><i>projectDir</i> (str)</dt>
1625 <dd>
1626 name of the project directory
1627 </dd>
1628 </dl><a NAME="Git.gitSubmoduleUpdate" ID="Git.gitSubmoduleUpdate"></a>
1629 <h4>Git.gitSubmoduleUpdate</h4>
1630 <b>gitSubmoduleUpdate</b>(<i>projectDir, initialize=False, remote=False</i>)
1631 <p>
1632 Public method to update submodules.
1633 </p><dl>
1634 <dt><i>projectDir</i> (str)</dt>
1635 <dd>
1636 name of the project directory
1637 </dd><dt><i>initialize</i> (bool)</dt>
1638 <dd>
1639 flag indicating an initialize and update operation
1640 </dd><dt><i>remote</i> (bool)</dt>
1641 <dd>
1642 flag indicating a fetch and update operation
1643 </dd>
1644 </dl><a NAME="Git.gitSubmoduleUpdateWithOptions" ID="Git.gitSubmoduleUpdateWithOptions"></a>
1645 <h4>Git.gitSubmoduleUpdateWithOptions</h4>
1646 <b>gitSubmoduleUpdateWithOptions</b>(<i>projectDir</i>)
1647 <p>
1648 Public method to update submodules offering a dialog to select the
1649 update options.
1650 </p><dl>
1651 <dt><i>projectDir</i> (str)</dt>
1652 <dd>
1653 name of the project directory
1654 </dd>
1655 </dl><a NAME="Git.gitUnstage" ID="Git.gitUnstage"></a>
1656 <h4>Git.gitUnstage</h4>
1657 <b>gitUnstage</b>(<i>name</i>)
1658 <p>
1659 Public method used to unstage a file/directory.
1660 </p><dl>
1661 <dt><i>name</i></dt>
1662 <dd>
1663 file/directory name to be reverted (string)
1664 </dd>
1665 </dl><dl>
1666 <dt>Returns:</dt>
1667 <dd>
1668 flag indicating, that the update contained an add
1669 or delete (boolean)
1670 </dd>
1671 </dl><a NAME="Git.gitVerify" ID="Git.gitVerify"></a>
1672 <h4>Git.gitVerify</h4>
1673 <b>gitVerify</b>(<i>projectDir</i>)
1674 <p>
1675 Public method to verify the connectivity and validity of objects
1676 of the database.
1677 </p><dl>
1678 <dt><i>projectDir</i></dt>
1679 <dd>
1680 name of the project directory (string)
1681 </dd>
1682 </dl><a NAME="Git.gitVerifyBundle" ID="Git.gitVerifyBundle"></a>
1683 <h4>Git.gitVerifyBundle</h4>
1684 <b>gitVerifyBundle</b>(<i>projectDir</i>)
1685 <p>
1686 Public method to verify a bundle file.
1687 </p><dl>
1688 <dt><i>projectDir</i></dt>
1689 <dd>
1690 name of the project directory (string)
1691 </dd>
1692 </dl><a NAME="Git.initCommand" ID="Git.initCommand"></a>
1693 <h4>Git.initCommand</h4>
1694 <b>initCommand</b>(<i>command</i>)
1695 <p>
1696 Public method to initialize a command arguments list.
1697 </p><dl>
1698 <dt><i>command</i></dt>
1699 <dd>
1700 command name (string)
1701 </dd>
1702 </dl><dl>
1703 <dt>Returns:</dt>
1704 <dd>
1705 list of command options (list of string)
1706 </dd>
1707 </dl><a NAME="Git.vcsAdd" ID="Git.vcsAdd"></a>
1708 <h4>Git.vcsAdd</h4>
1709 <b>vcsAdd</b>(<i>name, isDir=False, noDialog=False</i>)
1710 <p>
1711 Public method used to add a file/directory to the Git repository.
1712 </p><dl>
1713 <dt><i>name</i></dt>
1714 <dd>
1715 file/directory name to be added (string)
1716 </dd><dt><i>isDir</i></dt>
1717 <dd>
1718 flag indicating name is a directory (boolean)
1719 </dd><dt><i>noDialog</i></dt>
1720 <dd>
1721 flag indicating quiet operations
1722 </dd>
1723 </dl><a NAME="Git.vcsAddBinary" ID="Git.vcsAddBinary"></a>
1724 <h4>Git.vcsAddBinary</h4>
1725 <b>vcsAddBinary</b>(<i>name, isDir=False</i>)
1726 <p>
1727 Public method used to add a file/directory in binary mode to the
1728 Git repository.
1729 </p><dl>
1730 <dt><i>name</i></dt>
1731 <dd>
1732 file/directory name to be added (string)
1733 </dd><dt><i>isDir</i></dt>
1734 <dd>
1735 flag indicating name is a directory (boolean)
1736 </dd>
1737 </dl><a NAME="Git.vcsAddTree" ID="Git.vcsAddTree"></a>
1738 <h4>Git.vcsAddTree</h4>
1739 <b>vcsAddTree</b>(<i>path</i>)
1740 <p>
1741 Public method to add a directory tree rooted at path to the Git
1742 repository.
1743 </p><dl>
1744 <dt><i>path</i></dt>
1745 <dd>
1746 root directory of the tree to be added (string or list of
1747 strings))
1748 </dd>
1749 </dl><a NAME="Git.vcsAllRegisteredStates" ID="Git.vcsAllRegisteredStates"></a>
1750 <h4>Git.vcsAllRegisteredStates</h4>
1751 <b>vcsAllRegisteredStates</b>(<i>names, dname, shortcut=True</i>)
1752 <p>
1753 Public method used to get the registered states of a number of files
1754 in the vcs.
1755 </p><p>
1756 <b>Note:</b> If a shortcut is to be taken, the code will only check,
1757 if the named directory has been scanned already. If so, it is assumed,
1758 that the states for all files have been populated by the previous run.
1759 </p><dl>
1760 <dt><i>names</i></dt>
1761 <dd>
1762 dictionary with all filenames to be checked as keys
1763 </dd><dt><i>dname</i></dt>
1764 <dd>
1765 directory to check in (string)
1766 </dd><dt><i>shortcut</i></dt>
1767 <dd>
1768 flag indicating a shortcut should be taken (boolean)
1769 </dd>
1770 </dl><dl>
1771 <dt>Returns:</dt>
1772 <dd>
1773 the received dictionary completed with a combination of
1774 canBeCommited and canBeAdded or None in order to signal an error
1775 </dd>
1776 </dl><a NAME="Git.vcsCheckout" ID="Git.vcsCheckout"></a>
1777 <h4>Git.vcsCheckout</h4>
1778 <b>vcsCheckout</b>(<i>vcsDataDict, projectDir, noDialog=False</i>)
1779 <p>
1780 Public method used to check the project out of a Git repository
1781 (clone).
1782 </p><dl>
1783 <dt><i>vcsDataDict</i></dt>
1784 <dd>
1785 dictionary of data required for the checkout
1786 </dd><dt><i>projectDir</i></dt>
1787 <dd>
1788 project directory to create (string)
1789 </dd><dt><i>noDialog</i></dt>
1790 <dd>
1791 flag indicating quiet operations
1792 </dd>
1793 </dl><dl>
1794 <dt>Returns:</dt>
1795 <dd>
1796 flag indicating an execution without errors (boolean)
1797 </dd>
1798 </dl><a NAME="Git.vcsCleanup" ID="Git.vcsCleanup"></a>
1799 <h4>Git.vcsCleanup</h4>
1800 <b>vcsCleanup</b>(<i>name</i>)
1801 <p>
1802 Public method used to cleanup the working directory.
1803 </p><dl>
1804 <dt><i>name</i></dt>
1805 <dd>
1806 directory name to be cleaned up (string)
1807 </dd>
1808 </dl><a NAME="Git.vcsCommandLine" ID="Git.vcsCommandLine"></a>
1809 <h4>Git.vcsCommandLine</h4>
1810 <b>vcsCommandLine</b>(<i>name</i>)
1811 <p>
1812 Public method used to execute arbitrary Git commands.
1813 </p><dl>
1814 <dt><i>name</i></dt>
1815 <dd>
1816 directory name of the working directory (string)
1817 </dd>
1818 </dl><a NAME="Git.vcsCommit" ID="Git.vcsCommit"></a>
1819 <h4>Git.vcsCommit</h4>
1820 <b>vcsCommit</b>(<i>name, message="", noDialog=False, commitAll=True, amend=False</i>)
1821 <p>
1822 Public method used to make the change of a file/directory permanent
1823 in the Git repository.
1824 </p><dl>
1825 <dt><i>name</i></dt>
1826 <dd>
1827 file/directory name to be committed (string or list of
1828 strings)
1829 </dd><dt><i>message</i></dt>
1830 <dd>
1831 message for this operation (string)
1832 </dd><dt><i>noDialog</i></dt>
1833 <dd>
1834 flag indicating quiet operations (boolean)
1835 </dd><dt><i>commitAll</i></dt>
1836 <dd>
1837 flag indicating to commit all local changes (boolean)
1838 </dd><dt><i>amend</i></dt>
1839 <dd>
1840 flag indicating to amend the HEAD commit (boolean)
1841 </dd>
1842 </dl><a NAME="Git.vcsConvertProject" ID="Git.vcsConvertProject"></a>
1843 <h4>Git.vcsConvertProject</h4>
1844 <b>vcsConvertProject</b>(<i>vcsDataDict, project</i>)
1845 <p>
1846 Public method to convert an uncontrolled project to a version
1847 controlled project.
1848 </p><dl>
1849 <dt><i>vcsDataDict</i></dt>
1850 <dd>
1851 dictionary of data required for the conversion
1852 </dd><dt><i>project</i></dt>
1853 <dd>
1854 reference to the project object
1855 </dd>
1856 </dl><a NAME="Git.vcsDiff" ID="Git.vcsDiff"></a>
1857 <h4>Git.vcsDiff</h4>
1858 <b>vcsDiff</b>(<i>name</i>)
1859 <p>
1860 Public method used to view the difference of a file/directory to the
1861 Git repository.
1862 </p><p>
1863 If name is a directory and is the project directory, all project files
1864 are saved first. If name is a file (or list of files), which is/are
1865 being edited and has unsaved modification, they can be saved or the
1866 operation may be aborted.
1867 </p><dl>
1868 <dt><i>name</i></dt>
1869 <dd>
1870 file/directory name to be diffed (string)
1871 </dd>
1872 </dl><a NAME="Git.vcsExists" ID="Git.vcsExists"></a>
1873 <h4>Git.vcsExists</h4>
1874 <b>vcsExists</b>(<i></i>)
1875 <p>
1876 Public method used to test for the presence of the git executable.
1877 </p><dl>
1878 <dt>Returns:</dt>
1879 <dd>
1880 flag indicating the existance (boolean) and an error message
1881 (string)
1882 </dd>
1883 </dl><a NAME="Git.vcsExport" ID="Git.vcsExport"></a>
1884 <h4>Git.vcsExport</h4>
1885 <b>vcsExport</b>(<i>vcsDataDict, projectDir</i>)
1886 <p>
1887 Public method used to export a directory from the Git repository.
1888 </p><dl>
1889 <dt><i>vcsDataDict</i></dt>
1890 <dd>
1891 dictionary of data required for the checkout
1892 </dd><dt><i>projectDir</i></dt>
1893 <dd>
1894 project directory to create (string)
1895 </dd>
1896 </dl><dl>
1897 <dt>Returns:</dt>
1898 <dd>
1899 flag indicating an execution without errors (boolean)
1900 </dd>
1901 </dl><a NAME="Git.vcsGetProjectBrowserHelper" ID="Git.vcsGetProjectBrowserHelper"></a>
1902 <h4>Git.vcsGetProjectBrowserHelper</h4>
1903 <b>vcsGetProjectBrowserHelper</b>(<i>browser, project, isTranslationsBrowser=False</i>)
1904 <p>
1905 Public method to instantiate a helper object for the different
1906 project browsers.
1907 </p><dl>
1908 <dt><i>browser</i></dt>
1909 <dd>
1910 reference to the project browser object
1911 </dd><dt><i>project</i></dt>
1912 <dd>
1913 reference to the project object
1914 </dd><dt><i>isTranslationsBrowser</i></dt>
1915 <dd>
1916 flag indicating, the helper is requested
1917 for the translations browser (this needs some special treatment)
1918 </dd>
1919 </dl><dl>
1920 <dt>Returns:</dt>
1921 <dd>
1922 the project browser helper object
1923 </dd>
1924 </dl><a NAME="Git.vcsGetProjectHelper" ID="Git.vcsGetProjectHelper"></a>
1925 <h4>Git.vcsGetProjectHelper</h4>
1926 <b>vcsGetProjectHelper</b>(<i>project</i>)
1927 <p>
1928 Public method to instantiate a helper object for the project.
1929 </p><dl>
1930 <dt><i>project</i></dt>
1931 <dd>
1932 reference to the project object
1933 </dd>
1934 </dl><dl>
1935 <dt>Returns:</dt>
1936 <dd>
1937 the project helper object
1938 </dd>
1939 </dl><a NAME="Git.vcsImport" ID="Git.vcsImport"></a>
1940 <h4>Git.vcsImport</h4>
1941 <b>vcsImport</b>(<i>vcsDataDict, projectDir, noDialog=False</i>)
1942 <p>
1943 Public method used to import the project into the Git repository.
1944 </p><dl>
1945 <dt><i>vcsDataDict</i></dt>
1946 <dd>
1947 dictionary of data required for the import
1948 </dd><dt><i>projectDir</i></dt>
1949 <dd>
1950 project directory (string)
1951 </dd><dt><i>noDialog</i></dt>
1952 <dd>
1953 flag indicating quiet operations
1954 </dd>
1955 </dl><dl>
1956 <dt>Returns:</dt>
1957 <dd>
1958 flag indicating an execution without errors (boolean)
1959 and a flag indicating the version controll status (boolean)
1960 </dd>
1961 </dl><a NAME="Git.vcsInit" ID="Git.vcsInit"></a>
1962 <h4>Git.vcsInit</h4>
1963 <b>vcsInit</b>(<i>vcsDir, noDialog=False</i>)
1964 <p>
1965 Public method used to initialize the Git repository.
1966 </p><p>
1967 The initialization is done, when a project is converted into a
1968 Git controlled project. Therefore we always return TRUE without
1969 doing anything.
1970 </p><dl>
1971 <dt><i>vcsDir</i></dt>
1972 <dd>
1973 name of the VCS directory (string)
1974 </dd><dt><i>noDialog</i></dt>
1975 <dd>
1976 flag indicating quiet operations (boolean)
1977 </dd>
1978 </dl><dl>
1979 <dt>Returns:</dt>
1980 <dd>
1981 always TRUE
1982 </dd>
1983 </dl><a NAME="Git.vcsInitConfig" ID="Git.vcsInitConfig"></a>
1984 <h4>Git.vcsInitConfig</h4>
1985 <b>vcsInitConfig</b>(<i>project</i>)
1986 <p>
1987 Public method to initialize the VCS configuration.
1988 </p><p>
1989 This method ensures, that an ignore file exists.
1990 </p><dl>
1991 <dt><i>project</i></dt>
1992 <dd>
1993 reference to the project (Project)
1994 </dd>
1995 </dl><a NAME="Git.vcsLogBrowser" ID="Git.vcsLogBrowser"></a>
1996 <h4>Git.vcsLogBrowser</h4>
1997 <b>vcsLogBrowser</b>(<i>name, isFile=False</i>)
1998 <p>
1999 Public method used to browse the log of a file/directory from the
2000 Git repository.
2001 </p><dl>
2002 <dt><i>name</i></dt>
2003 <dd>
2004 file/directory name to show the log of (string)
2005 </dd><dt><i>isFile=</i></dt>
2006 <dd>
2007 flag indicating log for a file is to be shown
2008 (boolean)
2009 </dd>
2010 </dl><a NAME="Git.vcsMerge" ID="Git.vcsMerge"></a>
2011 <h4>Git.vcsMerge</h4>
2012 <b>vcsMerge</b>(<i>name</i>)
2013 <p>
2014 Public method used to merge a URL/revision into the local project.
2015 </p><dl>
2016 <dt><i>name</i></dt>
2017 <dd>
2018 file/directory name to be merged (string)
2019 </dd>
2020 </dl><a NAME="Git.vcsMove" ID="Git.vcsMove"></a>
2021 <h4>Git.vcsMove</h4>
2022 <b>vcsMove</b>(<i>name, project, target=None, noDialog=False</i>)
2023 <p>
2024 Public method used to move a file/directory.
2025 </p><dl>
2026 <dt><i>name</i></dt>
2027 <dd>
2028 file/directory name to be moved (string)
2029 </dd><dt><i>project</i></dt>
2030 <dd>
2031 reference to the project object
2032 </dd><dt><i>target</i></dt>
2033 <dd>
2034 new name of the file/directory (string)
2035 </dd><dt><i>noDialog</i></dt>
2036 <dd>
2037 flag indicating quiet operations
2038 </dd>
2039 </dl><dl>
2040 <dt>Returns:</dt>
2041 <dd>
2042 flag indicating successful operation (boolean)
2043 </dd>
2044 </dl><a NAME="Git.vcsName" ID="Git.vcsName"></a>
2045 <h4>Git.vcsName</h4>
2046 <b>vcsName</b>(<i></i>)
2047 <p>
2048 Public method returning the name of the vcs.
2049 </p><dl>
2050 <dt>Returns:</dt>
2051 <dd>
2052 always 'Git' (string)
2053 </dd>
2054 </dl><a NAME="Git.vcsNewProjectOptionsDialog" ID="Git.vcsNewProjectOptionsDialog"></a>
2055 <h4>Git.vcsNewProjectOptionsDialog</h4>
2056 <b>vcsNewProjectOptionsDialog</b>(<i>parent=None</i>)
2057 <p>
2058 Public method to get a dialog to enter repository info for getting a
2059 new project.
2060 </p><dl>
2061 <dt><i>parent</i></dt>
2062 <dd>
2063 parent widget (QWidget)
2064 </dd>
2065 </dl><dl>
2066 <dt>Returns:</dt>
2067 <dd>
2068 reference to the instantiated options dialog
2069 (GitNewProjectOptionsDialog)
2070 </dd>
2071 </dl><a NAME="Git.vcsOptionsDialog" ID="Git.vcsOptionsDialog"></a>
2072 <h4>Git.vcsOptionsDialog</h4>
2073 <b>vcsOptionsDialog</b>(<i>project, archive, editable=False, parent=None</i>)
2074 <p>
2075 Public method to get a dialog to enter repository info.
2076 </p><dl>
2077 <dt><i>project</i></dt>
2078 <dd>
2079 reference to the project object
2080 </dd><dt><i>archive</i></dt>
2081 <dd>
2082 name of the project in the repository (string)
2083 </dd><dt><i>editable</i></dt>
2084 <dd>
2085 flag indicating that the project name is editable
2086 (boolean)
2087 </dd><dt><i>parent</i></dt>
2088 <dd>
2089 parent widget (QWidget)
2090 </dd>
2091 </dl><dl>
2092 <dt>Returns:</dt>
2093 <dd>
2094 reference to the instantiated options dialog (GitOptionsDialog)
2095 </dd>
2096 </dl><a NAME="Git.vcsRegisteredState" ID="Git.vcsRegisteredState"></a>
2097 <h4>Git.vcsRegisteredState</h4>
2098 <b>vcsRegisteredState</b>(<i>name</i>)
2099 <p>
2100 Public method used to get the registered state of a file in the vcs.
2101 </p><dl>
2102 <dt><i>name</i></dt>
2103 <dd>
2104 filename to check (string)
2105 </dd>
2106 </dl><dl>
2107 <dt>Returns:</dt>
2108 <dd>
2109 a combination of canBeCommited and canBeAdded
2110 </dd>
2111 </dl><a NAME="Git.vcsRemove" ID="Git.vcsRemove"></a>
2112 <h4>Git.vcsRemove</h4>
2113 <b>vcsRemove</b>(<i>name, project=False, noDialog=False, stageOnly=False</i>)
2114 <p>
2115 Public method used to remove a file/directory from the Git
2116 repository.
2117 </p><p>
2118 The default operation is to remove the local copy as well.
2119 </p><dl>
2120 <dt><i>name</i></dt>
2121 <dd>
2122 file/directory name to be removed (string or list of
2123 strings))
2124 </dd><dt><i>project</i></dt>
2125 <dd>
2126 flag indicating deletion of a project tree (boolean)
2127 (not needed)
2128 </dd><dt><i>noDialog</i></dt>
2129 <dd>
2130 flag indicating quiet operations (boolean)
2131 </dd><dt><i>stageOnly</i></dt>
2132 <dd>
2133 flag indicating to just remove the file from the
2134 staging area (boolean)
2135 </dd>
2136 </dl><dl>
2137 <dt>Returns:</dt>
2138 <dd>
2139 flag indicating successful operation (boolean)
2140 </dd>
2141 </dl><a NAME="Git.vcsRepositoryInfos" ID="Git.vcsRepositoryInfos"></a>
2142 <h4>Git.vcsRepositoryInfos</h4>
2143 <b>vcsRepositoryInfos</b>(<i>ppath</i>)
2144 <p>
2145 Public method to retrieve information about the repository.
2146 </p><dl>
2147 <dt><i>ppath</i></dt>
2148 <dd>
2149 local path to get the repository infos (string)
2150 </dd>
2151 </dl><dl>
2152 <dt>Returns:</dt>
2153 <dd>
2154 string with ready formated info for display (string)
2155 </dd>
2156 </dl><a NAME="Git.vcsShutdown" ID="Git.vcsShutdown"></a>
2157 <h4>Git.vcsShutdown</h4>
2158 <b>vcsShutdown</b>(<i></i>)
2159 <p>
2160 Public method used to shutdown the Git interface.
2161 </p><a NAME="Git.vcsStatus" ID="Git.vcsStatus"></a>
2162 <h4>Git.vcsStatus</h4>
2163 <b>vcsStatus</b>(<i>name</i>)
2164 <p>
2165 Public method used to view the status of files/directories in the
2166 Git repository.
2167 </p><dl>
2168 <dt><i>name</i></dt>
2169 <dd>
2170 file/directory name(s) to show the status of
2171 (string or list of strings)
2172 </dd>
2173 </dl><a NAME="Git.vcsSupportCommandOptions" ID="Git.vcsSupportCommandOptions"></a>
2174 <h4>Git.vcsSupportCommandOptions</h4>
2175 <b>vcsSupportCommandOptions</b>(<i></i>)
2176 <p>
2177 Public method to signal the support of user settable command options.
2178 </p><dl>
2179 <dt>Returns:</dt>
2180 <dd>
2181 flag indicating the support of user settable command options
2182 (boolean)
2183 </dd>
2184 </dl><a NAME="Git.vcsSwitch" ID="Git.vcsSwitch"></a>
2185 <h4>Git.vcsSwitch</h4>
2186 <b>vcsSwitch</b>(<i>name</i>)
2187 <p>
2188 Public method used to switch a working directory to a different
2189 revision.
2190 </p><dl>
2191 <dt><i>name</i></dt>
2192 <dd>
2193 directory name to be switched (string)
2194 </dd>
2195 </dl><dl>
2196 <dt>Returns:</dt>
2197 <dd>
2198 flag indicating, that the switch contained an add
2199 or delete (boolean)
2200 </dd>
2201 </dl><a NAME="Git.vcsTag" ID="Git.vcsTag"></a>
2202 <h4>Git.vcsTag</h4>
2203 <b>vcsTag</b>(<i>name, revision=None, tagName=None</i>)
2204 <p>
2205 Public method used to set/remove a tag in the Git repository.
2206 </p><dl>
2207 <dt><i>name</i></dt>
2208 <dd>
2209 file/directory name to determine the repo root from
2210 (string)
2211 </dd><dt><i>revision</i></dt>
2212 <dd>
2213 revision to set tag for (string)
2214 </dd><dt><i>tagName</i></dt>
2215 <dd>
2216 name of the tag (string)
2217 </dd>
2218 </dl><dl>
2219 <dt>Returns:</dt>
2220 <dd>
2221 flag indicating a performed tag action (boolean)
2222 </dd>
2223 </dl><a NAME="Git.vcsUpdate" ID="Git.vcsUpdate"></a>
2224 <h4>Git.vcsUpdate</h4>
2225 <b>vcsUpdate</b>(<i>name, noDialog=False, revision=None</i>)
2226 <p>
2227 Public method used to update a file/directory with the Git
2228 repository.
2229 </p><dl>
2230 <dt><i>name</i></dt>
2231 <dd>
2232 file/directory name to be updated (string or list of
2233 strings)
2234 </dd><dt><i>noDialog</i></dt>
2235 <dd>
2236 flag indicating quiet operations (boolean)
2237 </dd><dt><i>revision=</i></dt>
2238 <dd>
2239 revision to update to (string)
2240 </dd>
2241 </dl><dl>
2242 <dt>Returns:</dt>
2243 <dd>
2244 flag indicating, that the update contained an add
2245 or delete (boolean)
2246 </dd>
2247 </dl>
2248 <div align="right"><a href="#top">Up</a></div>
2249 <hr />
2250 </body></html>

eric ide

mercurial