Support bisect terms
[TortoiseGit.git] / src / Git / Git.h
blob98c8d9e67667e0966f7c24d0d8e37931331cc9b8
1 // TortoiseGit - a Windows shell extension for easy version control
3 // Copyright (C) 2008-2016 - TortoiseGit
5 // This program is free software; you can redistribute it and/or
6 // modify it under the terms of the GNU General Public License
7 // as published by the Free Software Foundation; either version 2
8 // of the License, or (at your option) any later version.
10 // This program is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 // GNU General Public License for more details.
15 // You should have received a copy of the GNU General Public License
16 // along with this program; if not, write to the Free Software Foundation,
17 // 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20 #pragma once
21 #include "GitType.h"
22 #include "GitRev.h"
23 #include "GitStatus.h"
24 #include "GitAdminDir.h"
25 #include "gitdll.h"
26 #include <functional>
28 #define REG_MSYSGIT_PATH _T("Software\\TortoiseGit\\MSysGit")
29 #define REG_SYSTEM_GITCONFIGPATH _T("Software\\TortoiseGit\\SystemConfig")
30 #define REG_MSYSGIT_EXTRA_PATH _T("Software\\TortoiseGit\\MSysGitExtra")
32 #define DEFAULT_USE_LIBGIT2_MASK (1 << CGit::GIT_CMD_MERGE_BASE) | (1 << CGit::GIT_CMD_DELETETAGBRANCH) | (1 << CGit::GIT_CMD_GETONEFILE) | (1 << CGit::GIT_CMD_ADD) | (1 << CGit::GIT_CMD_CHECKCONFLICTS) | (1 << CGit::GIT_CMD_GET_COMMIT)
34 struct git_repository;
36 class CFilterData
38 public:
40 enum
42 SHOW_NO_LIMIT, // NOTE: no limitation does not mean "without all limitations", it's just without the following limitations. That say, the log still could be limited by auther, committer, etc.
43 SHOW_LAST_SEL_DATE,
44 SHOW_LAST_N_COMMITS,
45 SHOW_LAST_N_YEARS,
46 SHOW_LAST_N_MONTHS,
47 SHOW_LAST_N_WEEKS,
50 CFilterData()
52 m_From=m_To=-1;
53 m_IsRegex=1;
54 m_NumberOfLogsScale = SHOW_NO_LIMIT;
55 m_NumberOfLogs = 1;
58 DWORD m_NumberOfLogsScale;
59 DWORD m_NumberOfLogs;
60 __time64_t m_From;
61 __time64_t m_To;
62 CString m_Author;
63 CString m_Committer;
64 CString m_MessageFilter;
65 BOOL m_IsRegex;
68 class CGitCall
70 public:
71 CGitCall(){}
72 CGitCall(CString cmd):m_Cmd(cmd){}
74 CString GetCmd()const{return m_Cmd;}
75 void SetCmd(CString cmd){m_Cmd=cmd;}
77 //This function is called when command output data is available.
78 //When this function returns 'true' the git command should be aborted.
79 //This behavior is not implemented yet.
80 virtual bool OnOutputData(const BYTE* data, size_t size)=0;
81 virtual bool OnOutputErrData(const BYTE* data, size_t size)=0;
82 virtual void OnEnd(){}
84 private:
85 CString m_Cmd;
88 typedef std::function<void (const CStringA&)> GitReceiverFunc;
90 class CTGitPath;
91 class CEnvironment : protected std::vector<TCHAR>
93 public:
94 void CopyProcessEnvironment();
95 CString GetEnv(const TCHAR *name);
96 void SetEnv(const TCHAR* name, const TCHAR* value);
97 void AddToPath(CString value);
98 void clear();
99 bool empty();
100 operator LPTSTR();
102 class CGit
104 private:
105 CString gitLastErr;
106 protected:
107 GIT_DIFF m_GitDiff;
108 GIT_DIFF m_GitSimpleListDiff;
109 #ifdef GTEST_INCLUDE_GTEST_GTEST_H_
110 public:
111 #endif
112 bool m_IsGitDllInited;
113 public:
114 CComCriticalSection m_critGitDllSec;
115 bool m_IsUseGitDLL;
116 bool m_IsUseLibGit2;
117 DWORD m_IsUseLibGit2_mask;
119 CEnvironment m_Environment;
121 static BOOL GitPathFileExists(const CString &path)
123 if(path[0] == _T('\\') && path[1] == _T('\\'))
124 //it is netshare \\server\sharefoldername
125 // \\server\.git will create smb error log.
127 int length = path.GetLength();
129 if(length<2)
130 return false;
132 int start = path.Find(_T('\\'),2);
133 if(start<0)
134 return false;
136 start = path.Find(_T('\\'),start+1);
137 if(start<0)
138 return false;
140 return PathFileExists(path);
143 else
144 return PathFileExists(path);
146 void CheckAndInitDll()
148 if(!m_IsGitDllInited)
150 git_init();
151 m_IsGitDllInited=true;
155 GIT_DIFF GetGitDiff()
157 if(m_GitDiff)
158 return m_GitDiff;
159 else
161 git_open_diff(&m_GitDiff,"-C -M -r");
162 return m_GitDiff;
166 GIT_DIFF GetGitSimpleListDiff()
168 if(m_GitSimpleListDiff)
169 return m_GitSimpleListDiff;
170 else
172 git_open_diff(&m_GitSimpleListDiff,"-r -r");
173 return m_GitSimpleListDiff;
177 BOOL CheckMsysGitDir(BOOL bFallback = TRUE);
178 BOOL FindAndSetGitExePath(BOOL bFallback);
179 BOOL m_bInitialized;
181 typedef enum
183 GIT_CMD_CLONE,
184 GIT_CMD_FETCH,
185 GIT_CMD_COMMIT_UPDATE_INDEX,
186 GIT_CMD_DIFF,
187 GIT_CMD_RESET,
188 GIT_CMD_REVERT,
189 GIT_CMD_MERGE_BASE,
190 GIT_CMD_DELETETAGBRANCH,
191 GIT_CMD_GETONEFILE,
192 GIT_CMD_ADD,
193 GIT_CMD_PUSH,
194 GIT_CMD_CHECK_CLEAN_WT,
195 GIT_CMD_CHECKCONFLICTS,
196 GIT_CMD_GET_COMMIT,
197 GIT_CMD_LOGLISTDIFF,
198 } LIBGIT2_CMD;
199 bool UsingLibGit2(LIBGIT2_CMD cmd) const;
201 * callback type should be git_cred_acquire_cb
203 static void SetGit2CredentialCallback(void* callback);
204 static void SetGit2CertificateCheckCertificate(void* callback);
206 CString GetHomeDirectory() const;
207 CString GetGitLocalConfig() const;
208 CString GetGitGlobalConfig() const;
209 CString GetGitGlobalXDGConfigPath() const;
210 CString GetGitGlobalXDGConfig() const;
211 CString GetGitSystemConfig() const;
212 CAutoRepository GetGitRepository() const;
213 static CStringA GetGitPathStringA(const CString &path);
214 static CString ms_LastMsysGitDir; // the last msysgitdir added to the path, blank if none
215 static CString ms_MsysGitRootDir;
216 static int ms_LastMsysGitVersion;
217 static bool ms_bCygwinGit;
218 static bool ms_bMsys2Git;
219 static int m_LogEncode;
220 static bool IsBranchNameValid(const CString& branchname);
221 bool IsBranchTagNameUnique(const CString& name);
223 * Checks if a branch or tag with the given name exists
224 *isBranch is true -> branch, tag otherwise
226 bool BranchTagExists(const CString& name, bool isBranch = true);
227 unsigned int Hash2int(const CGitHash &hash);
229 PROCESS_INFORMATION m_CurrentGitPi;
231 CGit(void);
232 ~CGit(void);
234 int Run(CString cmd, CString* output, int code);
235 int Run(CString cmd, CString* output, CString* outputErr, int code);
236 int Run(CString cmd, BYTE_VECTOR *byte_array, BYTE_VECTOR *byte_arrayErr = NULL);
237 int Run(CGitCall* pcall);
238 int Run(CString cmd, const GitReceiverFunc& recv);
240 private:
241 static DWORD WINAPI AsyncReadStdErrThread(LPVOID lpParam);
242 typedef struct AsyncReadStdErrThreadArguments
244 HANDLE fileHandle;
245 CGitCall* pcall;
246 } ASYNCREADSTDERRTHREADARGS, *PASYNCREADSTDERRTHREADARGS;
247 CString GetUnifiedDiffCmd(const CTGitPath& path, const git_revnum_t& rev1, const git_revnum_t& rev2, bool bMerge, bool bCombine, int diffContext, bool bNoPrefix = false);
249 public:
250 int RunAsync(CString cmd, PROCESS_INFORMATION *pi, HANDLE* hRead, HANDLE *hErrReadOut, CString *StdioFile = NULL);
251 int RunLogFile(CString cmd, const CString &filename, CString *stdErr);
253 int GetDiffPath(CTGitPathList *PathList, CGitHash *hash1, CGitHash *hash2, char *arg=NULL);
255 int GetGitEncode(TCHAR* configkey);
257 bool IsFastForward(const CString &from, const CString &to, CGitHash * commonAncestor = NULL);
258 CString GetConfigValue(const CString& name, const CString& def = CString(), bool wantBool = false);
259 bool GetConfigValueBool(const CString& name, const bool def = false);
260 int GetConfigValueInt32(const CString& name, const int def = 0);
262 int SetConfigValue(const CString& key, const CString& value, CONFIG_TYPE type = CONFIG_LOCAL);
263 int UnsetConfigValue(const CString& key, CONFIG_TYPE type = CONFIG_LOCAL);
265 CString GetUserName(void);
266 CString GetUserEmail(void);
267 CString GetCurrentBranch(bool fallback = false);
268 void GetRemoteTrackedBranch(const CString& localBranch, CString& remote, CString& branch);
269 void GetRemoteTrackedBranchForHEAD(CString& remote, CString& branch);
270 // read current branch name from HEAD file, returns 0 on success, -1 on failure, 1 detached (branch name "HEAD" returned)
271 static int GetCurrentBranchFromFile(const CString &sProjectRoot, CString &sBranchOut, bool fallback = false);
273 Use this method only when the HEAD is exist.
275 BOOL CheckCleanWorkTree(bool stagedOk = false);
276 int Revert(const CString& commit, const CTGitPathList &list, CString& err);
277 int Revert(const CString& commit, const CTGitPath &path, CString& err);
278 int DeleteRef(const CString& reference);
280 Use this method only if m_IsUseLibGit2 is used for fallbacks.
281 If you directly use libgit2 methods, use GetLibGit2LastErr instead.
283 CString GetGitLastErr(const CString& msg);
284 CString GetGitLastErr(const CString& msg, LIBGIT2_CMD cmd);
285 static CString GetLibGit2LastErr();
286 static CString GetLibGit2LastErr(const CString& msg);
287 bool SetCurrentDir(CString path, bool submodule = false)
289 bool b = GitAdminDir::HasAdminDir(path, submodule ? false : !!PathIsDirectory(path), &m_CurrentDir);
290 if (!b && GitAdminDir::IsBareRepo(path))
292 m_CurrentDir = path;
293 b = true;
295 if(m_CurrentDir.GetLength() == 2 && m_CurrentDir[1] == _T(':')) //C: D:
297 m_CurrentDir += _T('\\');
299 return b;
301 CString m_CurrentDir;
303 enum
305 LOG_ORDER_CHRONOLOGIALREVERSED,
306 LOG_ORDER_TOPOORDER,
307 LOG_ORDER_DATEORDER,
310 typedef enum
312 BRANCH_LOCAL = 0x1,
313 BRANCH_REMOTE = 0x2,
314 BRANCH_FETCH_HEAD = 0x4,
315 BRANCH_LOCAL_F = BRANCH_LOCAL | BRANCH_FETCH_HEAD,
316 BRANCH_ALL = BRANCH_LOCAL | BRANCH_REMOTE,
317 BRANCH_ALL_F = BRANCH_ALL | BRANCH_FETCH_HEAD,
318 }BRANCH_TYPE;
320 typedef enum
322 LOG_INFO_STAT=0x1,
323 LOG_INFO_FILESTATE=0x2,
324 LOG_INFO_PATCH=0x4,
325 LOG_INFO_FULLHISTORY=0x8,
326 LOG_INFO_BOUNDARY=0x10,
327 LOG_INFO_ALL_BRANCH=0x20,
328 LOG_INFO_ONLY_HASH=0x40,
329 LOG_INFO_DETECT_RENAME=0x80,
330 LOG_INFO_DETECT_COPYRENAME=0x100,
331 LOG_INFO_FIRST_PARENT = 0x200,
332 LOG_INFO_NO_MERGE = 0x400,
333 LOG_INFO_FOLLOW = 0x800,
334 LOG_INFO_SHOW_MERGEDFILE=0x1000,
335 LOG_INFO_FULL_DIFF = 0x2000,
336 LOG_INFO_SIMPILFY_BY_DECORATION = 0x4000,
337 LOG_INFO_LOCAL_BRANCHES = 0x8000,
338 LOG_INFO_BASIC_REFS = 0x10000,
339 }LOG_INFO_MASK;
341 typedef enum
343 LOCAL_BRANCH,
344 REMOTE_BRANCH,
345 ANNOTATED_TAG,
346 TAG,
347 STASH,
348 BISECT_GOOD,
349 BISECT_BAD,
350 NOTES,
351 UNKNOWN,
353 }REF_TYPE;
355 int GetRemoteList(STRING_VECTOR &list);
356 int GetBranchList(STRING_VECTOR &list, int *Current,BRANCH_TYPE type=BRANCH_LOCAL);
357 int GetTagList(STRING_VECTOR &list);
358 int GetRemoteTags(const CString& remote, STRING_VECTOR& list);
359 int DeleteRemoteRefs(const CString& remote, const STRING_VECTOR& list);
360 int GetBranchDescriptions(MAP_STRING_STRING& map);
361 int GetMapHashToFriendName(MAP_HASH_NAME &map);
362 static int GetMapHashToFriendName(git_repository* repo, MAP_HASH_NAME &map);
364 CString DerefFetchHead();
366 // FixBranchName():
367 // When branchName == FETCH_HEAD, derefrence it.
368 // A selected branch name got from GetBranchList(), with flag BRANCH_FETCH_HEAD enabled,
369 // should go through this function before it is used.
370 CString FixBranchName_Mod(CString& branchName);
371 CString FixBranchName(const CString& branchName);
373 CString GetLogCmd(const CString& range, const CTGitPath* path = nullptr, int InfoMask = LOG_INFO_FULL_DIFF | LOG_INFO_STAT | LOG_INFO_FILESTATE | LOG_INFO_BOUNDARY | LOG_INFO_DETECT_COPYRENAME | LOG_INFO_SHOW_MERGEDFILE, CFilterData* filter = nullptr);
375 int GetHash(CGitHash &hash, const CString& friendname);
376 static int GetHash(git_repository * repo, CGitHash &hash, const CString& friendname, bool skipFastCheck = false);
378 int BuildOutputFormat(CString &format,bool IsFull=TRUE);
379 static void StringAppend(CString *str, const BYTE *p, int code = CP_UTF8, int length = -1);
381 BOOL CanParseRev(CString ref);
383 Checks if HEAD points to an unborn branch
384 This method assumes, that we already know that we are in a working tree.
386 BOOL IsInitRepos();
387 /** Returns 0 if no conflict, if a conflict was found and -1 in case of a failure */
388 int HasWorkingTreeConflicts();
389 /** Returns 0 if no conflict, if a conflict was found and -1 in case of a failure */
390 int HasWorkingTreeConflicts(git_repository* repo);
391 int IsRebaseRunning();
392 void GetBisectTerms(CString* good, CString* bad);
393 int GetRefList(STRING_VECTOR &list);
395 int RefreshGitIndex();
396 int GetOneFile(const CString &Refname, const CTGitPath &path, const CString &outputfile);
398 //Example: master -> refs/heads/master
399 CString GetFullRefName(const CString& shortRefName);
400 //Removes 'refs/heads/' or just 'refs'. Example: refs/heads/master -> master
401 static CString StripRefName(CString refName);
403 int GetCommitDiffList(const CString &rev1, const CString &rev2, CTGitPathList &outpathlist, bool ignoreSpaceAtEol = false, bool ignoreSpaceChange = false, bool ignoreAllSpace = false, bool ignoreBlankLines = false);
404 int GetInitAddList(CTGitPathList &outpathlist);
405 int GetWorkingTreeChanges(CTGitPathList& result, bool amend = false, CTGitPathList* filterlist = nullptr);
407 static __int64 filetime_to_time_t(const FILETIME *ft)
409 long long winTime = ((long long)ft->dwHighDateTime << 32) + ft->dwLowDateTime;
410 winTime -= 116444736000000000LL; /* Windows to Unix Epoch conversion */
411 winTime /= 10000000; /* Nano to seconds resolution */
412 return (time_t)winTime;
415 static int GetFileModifyTime(LPCTSTR filename, __int64* time, bool* isDir = nullptr, __int64* size = nullptr)
417 WIN32_FILE_ATTRIBUTE_DATA fdata;
418 if (GetFileAttributesEx(filename, GetFileExInfoStandard, &fdata))
420 if(time)
421 *time = filetime_to_time_t(&fdata.ftLastWriteTime);
423 if (size)
424 *size = ((__int64)fdata.nFileSizeHigh << 32) + fdata.nFileSizeLow;
426 if(isDir)
427 *isDir = !!( fdata.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY);
429 return 0;
431 return -1;
434 int GetShortHASHLength() const;
436 static BOOL GetShortName(const CString& ref, CString& shortname, const CString& prefix)
438 //TRACE(_T("%s %s\r\n"),ref,prefix);
439 if (ref.Left(prefix.GetLength()) == prefix)
441 shortname = ref.Right(ref.GetLength() - prefix.GetLength());
442 if (shortname.Right(3) == _T("^{}"))
443 shortname=shortname.Left(shortname.GetLength() - 3);
444 return TRUE;
446 return FALSE;
449 static CString GetShortName(const CString& ref, REF_TYPE *type);
451 static bool LoadTextFile(const CString &filename, CString &msg);
453 int GetUnifiedDiff(const CTGitPath& path, const git_revnum_t& rev1, const git_revnum_t& rev2, CString patchfile, bool bMerge, bool bCombine, int diffContext, bool bNoPrefix = false);
454 int GetUnifiedDiff(const CTGitPath& path, const git_revnum_t& rev1, const git_revnum_t& rev2, CStringA * buffer, bool bMerge, bool bCombine, int diffContext);
456 int GitRevert(int parent, const CGitHash &hash);
458 int GetGitVersion(CString* versiondebug, CString* errStr);
460 CString CombinePath(const CString &path) const
462 if (path.IsEmpty())
463 return m_CurrentDir;
464 if (m_CurrentDir.IsEmpty())
465 return path;
466 return m_CurrentDir + (m_CurrentDir.Right(1) == _T("\\") ? _T("") : _T("\\")) + path;
469 CString CombinePath(const CTGitPath &path) const
471 return CombinePath(path.GetWinPath());
474 CString CombinePath(const CTGitPath *path) const
476 ATLASSERT(path);
477 return CombinePath(path->GetWinPath());
480 extern void GetTempPath(CString &path);
481 extern CString GetTempFile();
482 extern DWORD GetTortoiseGitTempPath(DWORD nBufferLength, LPTSTR lpBuffer);
484 extern CGit g_Git;