|
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> |