/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of Qt Creator. ** ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3 as published by the Free Software ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-3.0.html. ** ****************************************************************************/ #pragma once #include "gitsettings.h" #include "commitdata.h" #include #include #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE class QProcessEnvironment; class QMenu; QT_END_NAMESPACE namespace Core { class ICore; } namespace VcsBase { class VcsCommand; class SubmitFileModel; class VcsBaseEditorWidget; } namespace DiffEditor { class ChunkSelection; class DiffEditorController; } namespace Git { namespace Internal { class CommitData; class GitBaseDiffEditorController; class GitSubmitEditorPanelData; class Stash; enum StatusMode { ShowAll = 0, NoUntracked = 1, NoSubmodules = 2 }; enum StashFlag { Default = 0x00, /* Prompt and do not allow unstashed */ AllowUnstashed = 0x01, NoPrompt = 0x02 }; enum PushFailure { Unknown, NonFastForward, NoRemoteBranch }; class SubmoduleData { public: QString dir; QString url; QString ignore; }; using SubmoduleDataMap = QMap; class UpstreamStatus { public: UpstreamStatus() = default; UpstreamStatus(int ahead, int behind) : ahead(ahead), behind(behind) {} int ahead = 0; int behind = 0; }; class GitClient : public VcsBase::VcsBaseClientImpl { Q_OBJECT public: enum CommandInProgress { NoCommand, Revert, CherryPick, Rebase, Merge, RebaseMerge }; class StashInfo { public: StashInfo() = default; enum StashResult { StashUnchanged, StashCanceled, StashFailed, Stashed, NotStashed /* User did not want it */ }; bool init(const QString &workingDirectory, const QString &command, StashFlag flag = Default, PushAction pushAction = NoPush); bool stashingFailed() const; void end(); StashResult result() const { return m_stashResult; } QString stashMessage() const { return m_message; } private: void stashPrompt(const QString &command, const QString &statusOutput, QString *errorMessage); void executeStash(const QString &command, QString *errorMessage); StashResult m_stashResult = NotStashed; QString m_message; QString m_workingDir; StashFlag m_flags = Default; PushAction m_pushAction = NoPush; }; explicit GitClient(GitSettings *settings); static GitClient *instance(); static GitSettings &settings(); Utils::FilePath vcsBinary() const override; unsigned gitVersion(QString *errorMessage = nullptr) const; VcsBase::VcsCommand *vcsExecAbortable(const QString &workingDirectory, const QStringList &arguments, bool isRebase = false, QString abortCommand = QString()); QString findRepositoryForDirectory(const QString &directory) const; QString findGitDirForRepository(const QString &repositoryDir) const; bool managesFile(const QString &workingDirectory, const QString &fileName) const; QStringList unmanagedFiles(const QStringList &filePaths) const; void diffFile(const QString &workingDirectory, const QString &fileName) const; void diffFiles(const QString &workingDirectory, const QStringList &unstagedFileNames, const QStringList &stagedFileNames) const; void diffProject(const QString &workingDirectory, const QString &projectDirectory) const; void diffRepository(const QString &workingDirectory) const { return diffRepository(workingDirectory, {}, {}); } void diffRepository(const QString &workingDirectory, const QString &leftCommit, const QString &rightCommit) const; void diffBranch(const QString &workingDirectory, const QString &branchName) const; void merge(const QString &workingDirectory, const QStringList &unmergedFileNames = QStringList()); void status(const QString &workingDirectory) const; void log(const QString &workingDirectory, const QString &fileName = QString(), bool enableAnnotationContextMenu = false, const QStringList &args = QStringList()); void reflog(const QString &workingDirectory, const QString &branch = {}); VcsBase::VcsBaseEditorWidget *annotate( const QString &workingDir, const QString &file, const QString &revision = QString(), int lineNumber = -1, const QStringList &extraOptions = QStringList()) override; void reset(const QString &workingDirectory, const QString &argument, const QString &commit = QString()); void removeStaleRemoteBranches(const QString &workingDirectory, const QString &remote); void recoverDeletedFiles(const QString &workingDirectory); void addFile(const QString &workingDirectory, const QString &fileName); bool synchronousLog(const QString &workingDirectory, const QStringList &arguments, QString *output, QString *errorMessage = nullptr, unsigned flags = 0); bool synchronousAdd(const QString &workingDirectory, const QStringList &files, const QStringList &extraOptions = {}); bool synchronousDelete(const QString &workingDirectory, bool force, const QStringList &files); bool synchronousMove(const QString &workingDirectory, const QString &from, const QString &to); bool synchronousReset(const QString &workingDirectory, const QStringList &files = QStringList(), QString *errorMessage = nullptr); bool synchronousCleanList(const QString &workingDirectory, const QString &modulePath, QStringList *files, QStringList *ignoredFiles, QString *errorMessage); bool synchronousApplyPatch(const QString &workingDirectory, const QString &file, QString *errorMessage, const QStringList &extraArguments = QStringList()); bool synchronousInit(const QString &workingDirectory); bool synchronousCheckoutFiles(const QString &workingDirectory, QStringList files = QStringList(), QString revision = QString(), QString *errorMessage = nullptr, bool revertStaging = true); enum class StashMode { NoStash, TryStash }; VcsBase::VcsCommand *checkout(const QString &workingDirectory, const QString &ref, StashMode stashMode = StashMode::TryStash); QStringList setupCheckoutArguments(const QString &workingDirectory, const QString &ref); void updateSubmodulesIfNeeded(const QString &workingDirectory, bool prompt); // Do a stash and return identier. enum { StashPromptDescription = 0x1, StashImmediateRestore = 0x2, StashIgnoreUnchanged = 0x4 }; QString synchronousStash(const QString &workingDirectory, const QString &messageKeyword = QString(), unsigned flags = 0, bool *unchanged = nullptr) const; bool executeSynchronousStash(const QString &workingDirectory, const QString &message = QString(), bool unstagedOnly = false, QString *errorMessage = nullptr) const; bool synchronousStashRestore(const QString &workingDirectory, const QString &stash, bool pop = false, const QString &branch = QString()) const; bool synchronousStashRemove(const QString &workingDirectory, const QString &stash = QString(), QString *errorMessage = nullptr) const; bool synchronousBranchCmd(const QString &workingDirectory, QStringList branchArgs, QString *output, QString *errorMessage) const; bool synchronousTagCmd(const QString &workingDirectory, QStringList tagArgs, QString *output, QString *errorMessage) const; bool synchronousForEachRefCmd(const QString &workingDirectory, QStringList args, QString *output, QString *errorMessage = nullptr) const; VcsBase::VcsCommand *asyncForEachRefCmd(const QString &workingDirectory, QStringList args) const; bool synchronousRemoteCmd(const QString &workingDirectory, QStringList remoteArgs, QString *output = nullptr, QString *errorMessage = nullptr, bool silent = false) const; QMap synchronousRemotesList(const QString &workingDirectory, QString *errorMessage = nullptr) const; QStringList synchronousSubmoduleStatus(const QString &workingDirectory, QString *errorMessage = nullptr) const; SubmoduleDataMap submoduleList(const QString &workingDirectory) const; QByteArray synchronousShow(const QString &workingDirectory, const QString &id, unsigned flags = 0) const; bool synchronousRevListCmd(const QString &workingDirectory, const QStringList &extraArguments, QString *output, QString *errorMessage = nullptr) const; bool synchronousParentRevisions(const QString &workingDirectory, const QString &revision, QStringList *parents, QString *errorMessage) const; QString synchronousShortDescription(const QString &workingDirectory, const QString &revision) const; QString synchronousShortDescription(const QString &workingDirectory, const QString &revision, const QString &format) const; QString synchronousCurrentLocalBranch(const QString &workingDirectory) const; bool synchronousHeadRefs(const QString &workingDirectory, QStringList *output, QString *errorMessage = nullptr) const; QString synchronousTopic(const QString &workingDirectory) const; bool synchronousRevParseCmd(const QString &workingDirectory, const QString &ref, QString *output, QString *errorMessage = nullptr) const; QString synchronousTopRevision(const QString &workingDirectory, QDateTime *dateTime = nullptr); void synchronousTagsForCommit(const QString &workingDirectory, const QString &revision, QString &precedes, QString &follows) const; bool isRemoteCommit(const QString &workingDirectory, const QString &commit); bool isFastForwardMerge(const QString &workingDirectory, const QString &branch); void fetch(const QString &workingDirectory, const QString &remote); void pull(const QString &workingDirectory, bool rebase); void push(const QString &workingDirectory, const QStringList &pushArgs = QStringList()); bool synchronousMerge(const QString &workingDirectory, const QString &branch, bool allowFastForward = true); bool canRebase(const QString &workingDirectory) const; void rebase(const QString &workingDirectory, const QString &argument); void cherryPick(const QString &workingDirectory, const QString &argument); void revert(const QString &workingDirectory, const QString &argument); bool synchronousRevert(const QString &workingDirectory, const QString &commit); bool synchronousCherryPick(const QString &workingDirectory, const QString &commit); void interactiveRebase(const QString &workingDirectory, const QString &commit, bool fixup); void synchronousAbortCommand(const QString &workingDir, const QString &abortCommand); QString synchronousTrackingBranch(const QString &workingDirectory, const QString &branch = QString()); bool synchronousSetTrackingBranch(const QString &workingDirectory, const QString &branch, const QString &tracking); // git svn support (asynchronous). void synchronousSubversionFetch(const QString &workingDirectory) const; void subversionLog(const QString &workingDirectory) const; void subversionDeltaCommit(const QString &workingDirectory) const; void stashPop(const QString &workingDirectory, const QString &stash = QString()); void revert(const QStringList &files, bool revertStaging); bool synchronousStashList(const QString &workingDirectory, QList *stashes, QString *errorMessage = nullptr) const; // Resolve a stash name from message (for IVersionControl's names). bool stashNameFromMessage(const QString &workingDirectory, const QString &messge, QString *name, QString *errorMessage = nullptr) const; QString readGitVar(const QString &workingDirectory, const QString &configVar) const; QString readConfigValue(const QString &workingDirectory, const QString &configVar) const; void setConfigValue(const QString &workingDirectory, const QString &configVar, const QString &value) const; QTextCodec *encoding(const QString &workingDirectory, const QString &configVar) const; bool readDataFromCommit(const QString &repoDirectory, const QString &commit, CommitData &commitData, QString *errorMessage = nullptr, QString *commitTemplate = nullptr); bool getCommitData(const QString &workingDirectory, QString *commitTemplate, CommitData &commitData, QString *errorMessage); bool addAndCommit(const QString &workingDirectory, const GitSubmitEditorPanelData &data, CommitType commitType, const QString &amendSHA1, const QString &messageFile, VcsBase::SubmitFileModel *model); enum StatusResult { StatusChanged, StatusUnchanged, StatusFailed }; StatusResult gitStatus(const QString &workingDirectory, StatusMode mode, QString *output = nullptr, QString *errorMessage = nullptr) const; CommandInProgress checkCommandInProgress(const QString &workingDirectory) const; QString commandInProgressDescription(const QString &workingDirectory) const; void continueCommandIfNeeded(const QString &workingDirectory, bool allowContinue = true); QString extendedShowDescription(const QString &workingDirectory, const QString &text) const; void launchGitK(const QString &workingDirectory, const QString &fileName) const; void launchGitK(const QString &workingDirectory) const { launchGitK(workingDirectory, QString()); } bool launchGitGui(const QString &workingDirectory); Utils::FilePath gitBinDirectory() const; bool launchGitBash(const QString &workingDirectory); void launchRepositoryBrowser(const QString &workingDirectory) const; QStringList synchronousRepositoryBranches(const QString &repositoryURL, const QString &workingDirectory = QString()) const; QProcessEnvironment processEnvironment() const override; bool beginStashScope(const QString &workingDirectory, const QString &command, StashFlag flag = Default, PushAction pushAction = NoPush); StashInfo &stashInfo(const QString &workingDirectory); void endStashScope(const QString &workingDirectory); bool isValidRevision(const QString &revision) const; void handleMergeConflicts(const QString &workingDir, const QString &commit, const QStringList &files, const QString &abortCommand); void addFuture(const QFuture &future); static QString msgNoChangedFiles(); static QString msgNoCommits(bool includeRemote); void show(const QString &source, const QString &id, const QString &name = QString()); void archive(const QString &workingDirectory, QString commit); VcsBase::VcsCommand *asyncUpstreamStatus(const QString &workingDirectory, const QString &branch, const QString &upstream); enum class BranchTargetType { Remote, Commit }; static QString suggestedLocalBranchName( const QString &workingDirectory, const QStringList &existingLocalNames, const QString &target, BranchTargetType targetType); static void addChangeActions(QMenu *menu, const QString &source, const QString &change); static QString fileWorkingDirectory(const QString &file); enum class ShowEditor { OnlyIfDifferent, Always }; Core::IEditor *openShowEditor(const QString &workingDirectory, const QString &ref, const QString &path, ShowEditor showSetting = ShowEditor::Always); private: void finishSubmoduleUpdate(); void chunkActionsRequested(QMenu *menu, int fileIndex, int chunkIndex, const DiffEditor::ChunkSelection &selection); void stage(DiffEditor::DiffEditorController *diffController, const QString &patch, bool revert); enum CodecType { CodecSource, CodecLogOutput, CodecNone }; QTextCodec *codecFor(CodecType codecType, const QString &source = QString()) const; void requestReload(const QString &documentId, const QString &source, const QString &title, const QString &workingDirectory, std::function factory) const; // determine version as '(major << 16) + (minor << 8) + patch' or 0. unsigned synchronousGitVersion(QString *errorMessage = nullptr) const; QString readOneLine(const QString &workingDirectory, const QStringList &arguments) const; enum RevertResult { RevertOk, RevertUnchanged, RevertCanceled, RevertFailed }; RevertResult revertI(QStringList files, bool *isDirectory, QString *errorMessage, bool revertStaging); void connectRepositoryChanged(const QString & repository, VcsBase::VcsCommand *cmd); bool executeAndHandleConflicts(const QString &workingDirectory, const QStringList &arguments, const QString &abortCommand = QString()) const; bool tryLauchingGitK(const QProcessEnvironment &env, const QString &workingDirectory, const QString &fileName, const QString &gitBinDirectory) const; bool cleanList(const QString &workingDirectory, const QString &modulePath, const QString &flag, QStringList *files, QString *errorMessage); enum ContinueCommandMode { ContinueOnly, SkipOnly, SkipIfNoChanges }; void continuePreviousGitCommand(const QString &workingDirectory, const QString &msgBoxTitle, QString msgBoxText, const QString &buttonName, const QString &gitCommand, ContinueCommandMode continueMode); mutable Utils::FilePath m_gitVersionForBinary; mutable unsigned m_cachedGitVersion = 0; QString m_gitQtcEditor; QMap m_stashInfo; QString m_pushFallbackCommand; QString m_diffCommit; QStringList m_updatedSubmodules; bool m_disableEditor = false; QFutureSynchronizer m_synchronizer; // for commit updates }; class GitRemote : public Core::IVersionControl::RepoUrl { public: GitRemote(const QString &location); }; } // namespace Internal } // namespace Git