Add checkbox to select all tags in Delete Remote Tag Dialog
[TortoiseGit.git] / src / Git / TGitPath.h
blobcfbd3526de02703df14135c2e03601a3f15d7841
1 // TortoiseGit - a Windows shell extension for easy version control
3 // Copyright (C) 2008-2012 - TortoiseGit
4 // Copyright (C) 2003-2008 - TortoiseSVN
6 // This program is free software; you can redistribute it and/or
7 // modify it under the terms of the GNU General Public License
8 // as published by the Free Software Foundation; either version 2
9 // of the License, or (at your option) any later version.
11 // This program is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 // GNU General Public License for more details.
16 // You should have received a copy of the GNU General Public License
17 // along with this program; if not, write to the Free Software Foundation,
18 // 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 #pragma once
22 #include "gittype.h"
24 #define PARENT_MASK 0xFFFFFF
25 #define MERGE_MASK (0x1000000)
27 class CTGitPath
29 public:
30 CTGitPath(void);
31 ~CTGitPath(void);
32 CTGitPath(const CString& sUnknownPath);
33 int m_Stage;
34 int m_ParentNo;
35 public:
36 #pragma warning(push)
37 #pragma warning(disable: 4480) // nonstandard extension used: specifying underlying type for enum 'enum'
38 enum : unsigned int
40 LOGACTIONS_ADDED = 0x00000001,
41 LOGACTIONS_MODIFIED = 0x00000002,
42 LOGACTIONS_REPLACED = 0x00000004,
43 LOGACTIONS_DELETED = 0x00000008,
44 LOGACTIONS_UNMERGED = 0x00000010,
45 LOGACTIONS_CACHE = 0x00000020,
46 LOGACTIONS_COPY = 0x00000040,
47 LOGACTIONS_MERGED = 0x00000080,
48 LOGACTIONS_FORWORD = 0x00000100,
49 LOGACTIONS_UNVER = 0x80000000,
50 LOGACTIONS_IGNORE = 0x40000000,
51 //LOGACTIONS_CONFLICT = 0x20000000,
53 // For log filter only
54 LOGACTIONS_HIDE = 0x20000000,
55 LOGACTIONS_GRAY = 0x10000000,
57 // For Rebase only
58 LOGACTIONS_REBASE_CURRENT = 0x08000000,
59 LOGACTIONS_REBASE_PICK = 0x04000000,
60 LOGACTIONS_REBASE_SQUASH = 0x02000000,
61 LOGACTIONS_REBASE_EDIT = 0x01000000,
62 LOGACTIONS_REBASE_DONE = 0x00800000,
63 LOGACTIONS_REBASE_SKIP = 0x00400000,
64 LOGACTIONS_REBASE_MASK = 0x0FC00000,
65 LOGACTIONS_REBASE_MODE_MASK=0x07C00000,
67 #pragma warning(pop)
69 CString m_StatAdd;
70 CString m_StatDel;
71 unsigned int m_Action;
72 bool m_Checked;
73 int ParserAction(BYTE action);
74 CString GetActionName();
75 static CString GetActionName(int action);
76 /**
77 * Set the path as an UTF8 string with forward slashes
79 void SetFromGit(const char* pPath);
80 void SetFromGit(const char* pPath, bool bIsDirectory);
81 void SetFromGit(const TCHAR* pPath, bool bIsDirectory);
82 void SetFromGit(const CString& sPath,CString *OldPath=NULL);
84 /**
85 * Set the path as UNICODE with backslashes
87 void SetFromWin(LPCTSTR pPath);
88 void SetFromWin(const CString& sPath);
89 void SetFromWin(LPCTSTR pPath, bool bIsDirectory);
90 void SetFromWin(const CString& sPath, bool bIsDirectory);
91 /**
92 * Set the path from an unknown source.
94 void SetFromUnknown(const CString& sPath);
95 /**
96 * Returns the path in Windows format, i.e. with backslashes
98 LPCTSTR GetWinPath() const;
99 /**
100 * Returns the path in Windows format, i.e. with backslashes
102 const CString& GetWinPathString() const;
104 * Returns the path with forward slashes.
106 const CString& GetGitPathString() const;
108 const CString& GetGitOldPathString() const;
110 * Returns the path completely prepared to be fed the the Git APIs
111 * It will be in UTF8, with URLs escaped, if necessary
113 // const char* GetGitApiPath(apr_pool_t *pool) const;
115 * Returns the path for showing in an UI.
117 * URL's are returned with forward slashes, unescaped if necessary
118 * Paths are returned with backward slashes
120 const CString& GetUIPathString() const;
122 * Returns true if the path points to a directory
124 bool IsDirectory() const;
126 CTGitPath GetSubPath(const CTGitPath &root);
129 * Returns the directory. If the path points to a directory, then the path
130 * is returned unchanged. If the path points to a file, the path to the
131 * parent directory is returned.
133 CTGitPath GetDirectory() const;
135 * Returns the the directory which contains the item the path refers to.
136 * If the path is a directory, then this returns the directory above it.
137 * If the path is to a file, then this returns the directory which contains the path
138 * parent directory is returned.
140 CTGitPath GetContainingDirectory() const;
142 * Get the 'root path' (e.g. "c:\") - Used to pass to GetDriveType
144 CString GetRootPathString() const;
146 * Returns the filename part of the full path.
147 * \remark don't call this for directories.
149 CString GetFilename() const;
150 CString GetBaseFilename() const;
152 * Returns the item's name without the full path.
154 CString GetFileOrDirectoryName() const;
156 * Returns the item's name without the full path, unescaped if necessary.
158 CString GetUIFileOrDirectoryName() const;
160 * Returns the file extension, including the dot.
161 * \remark Returns an empty string for directories
163 CString GetFileExtension() const;
165 bool IsEmpty() const;
166 void Reset();
168 * Checks if two paths are equal. The slashes are taken care of.
170 bool IsEquivalentTo(const CTGitPath& rhs) const;
171 bool IsEquivalentToWithoutCase(const CTGitPath& rhs) const;
172 bool operator==(const CTGitPath& x) const {return IsEquivalentTo(x);}
175 * Checks if \c possibleDescendant is a child of this path.
177 bool IsAncestorOf(const CTGitPath& possibleDescendant) const;
179 * Get a string representing the file path, optionally with a base
180 * section stripped off the front
181 * Returns a string with fwdslash paths
183 CString GetDisplayString(const CTGitPath* pOptionalBasePath = NULL) const;
185 * Compares two paths. Slash format is irrelevant.
187 static int Compare(const CTGitPath& left, const CTGitPath& right);
189 /** As PredLeftLessThanRight, but for checking if paths are equivalent
191 static bool PredLeftEquivalentToRight(const CTGitPath& left, const CTGitPath& right);
193 /** Checks if the left path is pointing to the same working copy path as the right.
194 * The same wc path means the paths are equivalent once all the admin dir path parts
195 * are removed. This is used in the TGitCache crawler to filter out all the 'duplicate'
196 * paths to crawl.
198 static bool PredLeftSameWCPathAsRight(const CTGitPath& left, const CTGitPath& right);
200 static bool CheckChild(const CTGitPath &parent, const CTGitPath& child);
203 * appends a string to this path.
204 *\remark - missing slashes are not added - this is just a string concatenation, but with
205 * preservation of the proper caching behavior.
206 * If you want to join a file- or directory-name onto the path, you should use AppendPathString
208 void AppendRawString(const CString& sAppend);
211 * appends a part of a path to this path.
212 *\remark - missing slashes are dealt with properly. Don't use this to append a file extension, for example
215 void AppendPathString(const CString& sAppend);
218 * Get the file modification time - returns zero for files which don't exist
219 * Returns a FILETIME structure cast to an __int64, for easy comparisons
221 __int64 GetLastWriteTime() const;
224 * Get the file size. Returns zero for directories or files that don't exist.
226 __int64 GetFileSize() const;
228 bool IsReadOnly() const;
231 * Checks if the path really exists.
233 bool Exists() const;
236 * Deletes the file/folder
237 * \param bTrash if true, uses the Windows trash bin when deleting.
239 bool Delete(bool bTrash) const;
242 * Checks if a Subversion admin directory is present. For files, the check
243 * is done in the same directory. For folders, it checks if the folder itself
244 * contains an admin directory.
246 bool HasAdminDir() const;
247 bool HasAdminDir(CString *ProjectTopDir) const;
248 bool HasSubmodules() const;
249 bool HasGitSVNDir() const;
250 bool IsBisectActive() const;
251 bool IsMergeActive() const;
252 bool HasStashDir() const;
253 bool HasRebaseApply() const;
255 bool IsWCRoot() const;
257 int GetAdminDirMask() const;
260 * Checks if the path point to or below a Subversion admin directory (.Git).
262 bool IsAdminDir() const;
264 void SetCustomData(LPARAM lp) {m_customData = lp;}
265 LPARAM GetCustomData() {return m_customData;}
268 * Checks if the path or URL is valid on Windows.
269 * A path is valid if conforms to the specs in the windows API.
270 * An URL is valid if the path checked out from it is valid
271 * on windows. That means an URL which is valid according to the WWW specs
272 * isn't necessarily valid as a windows path (e.g. http://myserver.com/repos/file:name
273 * is a valid URL, but the path is illegal on windows ("file:name" is illegal), so
274 * this function would return \c false for that URL).
276 bool IsValidOnWindows() const;
278 private:
279 // All these functions are const, and all the data
280 // is mutable, in order that the hidden caching operations
281 // can be carried out on a const CTGitPath object, which is what's
282 // likely to be passed between functions
283 // The public 'SetFromxxx' functions are not const, and so the proper
284 // const-correctness semantics are preserved
285 void SetFwdslashPath(const CString& sPath) const;
286 void SetBackslashPath(const CString& sPath) const;
287 void SetUTF8FwdslashPath(const CString& sPath) const;
288 void EnsureBackslashPathSet() const;
289 void EnsureFwdslashPathSet() const;
291 * Checks if two path strings are equal. No conversion of slashes is done!
292 * \remark for slash-independent comparison, use IsEquivalentTo()
294 static bool ArePathStringsEqual(const CString& sP1, const CString& sP2);
295 static bool ArePathStringsEqualWithCase(const CString& sP1, const CString& sP2);
298 * Adds the required trailing slash to local root paths such as 'C:'
300 void SanitizeRootPath(CString& sPath, bool bIsForwardPath) const;
302 void UpdateAttributes() const;
306 private:
307 mutable CString m_sBackslashPath;
308 mutable CString m_sLongBackslashPath;
309 mutable CString m_sFwdslashPath;
310 mutable CString m_sUIPath;
311 mutable CStringA m_sUTF8FwdslashPath;
312 mutable CStringA m_sUTF8FwdslashPathEscaped;
313 mutable CString m_sProjectRoot;
315 //used for rename case
316 mutable CString m_sOldBackslashPath;
317 mutable CString m_sOldFwdslashPath;
319 // Have we yet determined if this is a directory or not?
320 mutable bool m_bDirectoryKnown;
321 mutable bool m_bIsDirectory;
322 mutable bool m_bLastWriteTimeKnown;
323 mutable bool m_bURLKnown;
324 mutable __int64 m_lastWriteTime;
325 mutable __int64 m_fileSize;
326 mutable bool m_bIsReadOnly;
327 mutable bool m_bHasAdminDirKnown;
328 mutable bool m_bHasAdminDir;
329 mutable bool m_bIsValidOnWindowsKnown;
330 mutable bool m_bIsValidOnWindows;
331 mutable bool m_bIsAdminDirKnown;
332 mutable bool m_bIsAdminDir;
333 mutable bool m_bIsWCRootKnown;
334 mutable bool m_bIsWCRoot;
335 mutable bool m_bExists;
336 mutable bool m_bExistsKnown;
337 mutable LPARAM m_customData;
338 mutable bool m_bIsSpecialDirectoryKnown;
339 mutable bool m_bIsSpecialDirectory;
341 friend bool operator<(const CTGitPath& left, const CTGitPath& right);
344 * Compares two paths and return true if left is earlier in sort order than right
345 * (Uses CTGitPath::Compare logic, but is suitable for std::sort and similar)
347 bool operator<(const CTGitPath& left, const CTGitPath& right);
350 //////////////////////////////////////////////////////////////////////////
353 * \ingroup Utils
354 * This class represents a list of paths
356 class CTGitPathList
358 public:
359 CTGitPathList();
360 // A constructor which allows a path list to be easily built with one initial entry in
361 explicit CTGitPathList(const CTGitPath& firstEntry);
362 int m_Action;
364 public:
365 void AddPath(const CTGitPath& newPath);
366 bool LoadFromFile(const CTGitPath& filename);
367 bool WriteToFile(const CString& sFilename, bool bANSI = false) const;
368 CTGitPath * LookForGitPath(CString path);
369 int ParserFromLog(BYTE_VECTOR &log, bool parseDeletes = false);
370 int ParserFromLsFile(BYTE_VECTOR &out,bool staged=true);
371 int FillUnRev(unsigned int Action,CTGitPathList *list=NULL);
372 int GetAction();
374 * Load from the path argument string, when the 'path' parameter is used
375 * This is a list of paths, with '*' between them
377 void LoadFromAsteriskSeparatedString(const CString& sPathString);
378 CString CreateAsteriskSeparatedString() const;
380 int GetCount() const;
381 void Clear();
382 const CTGitPath& operator[](INT_PTR index) const;
383 bool AreAllPathsFiles() const;
384 bool AreAllPathsFilesInOneDirectory() const;
385 CTGitPath GetCommonDirectory() const;
386 CTGitPath GetCommonRoot() const;
387 void SortByPathname(bool bReverse = false);
389 * Delete all the files in the list, then clear the list.
390 * \param bTrash if true, the items are deleted using the Windows trash bin
392 void DeleteAllFiles(bool bTrash, bool bFilesOnly = true);
393 static bool DeleteViaShell(LPCTSTR path, bool useTrashbin);
394 /** Remove duplicate entries from the list (sorts the list as a side-effect */
395 void RemoveDuplicates();
396 /** Removes all paths which are on or in a Subversion admin directory */
397 void RemoveAdminPaths();
398 void RemovePath(const CTGitPath& path);
399 void RemoveItem(CTGitPath &path);
401 * Removes all child items and leaves only the top folders. Useful if you
402 * create the list to remove them (i.e. if you remove a parent folder, the
403 * child files and folders don't have to be deleted anymore)
405 void RemoveChildren();
407 /** Checks if two CTGitPathLists are the same */
408 bool IsEqual(const CTGitPathList& list);
410 /** Convert into the Git API parameter format */
411 // apr_array_header_t * MakePathArray (apr_pool_t *pool) const;
413 typedef std::vector<CTGitPath> PathVector;
414 PathVector m_paths;
415 // If the list contains just files in one directory, then
416 // this contains the directory name
417 mutable CTGitPath m_commonBaseDirectory;