// Copyright (C) 2016 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0 #include "vcsbaseplugin.h" #include "commonvcssettings.h" #include "vcsbasesubmiteditor.h" #include "vcsbasetr.h" #include "vcsplugin.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include using namespace Core; using namespace Utils; using namespace ProjectExplorer; namespace { static Q_LOGGING_CATEGORY(baseLog, "qtc.vcs.base", QtWarningMsg) static Q_LOGGING_CATEGORY(findRepoLog, "qtc.vcs.find-repo", QtWarningMsg) static Q_LOGGING_CATEGORY(stateLog, "qtc.vcs.state", QtWarningMsg) } /*! \namespace VcsBase \brief The VcsBase namespace contains classes for the VcsBase plugin. */ /*! \namespace VcsBase::Internal \brief The Internal namespace contains internal classes for the VcsBase plugin. \internal */ namespace VcsBase { namespace Internal { /*! \class VcsBase::Internal::State \brief The State class provides the internal state created by the state listener and VcsBasePluginState. Aggregated in the QSharedData of VcsBase::VcsBasePluginState. */ class State { public: void clearFile(); void clearPatchFile(); void clearProject(); inline void clear(); bool equals(const State &rhs) const; inline bool hasFile() const { return !currentFileTopLevel.isEmpty(); } inline bool hasProject() const { return !currentProjectTopLevel.isEmpty(); } inline bool isEmpty() const { return !hasFile() && !hasProject(); } FilePath currentFile; QString currentFileName; FilePath currentPatchFile; QString currentPatchFileDisplayName; FilePath currentFileDirectory; FilePath currentFileTopLevel; FilePath currentProjectPath; QString currentProjectName; FilePath currentProjectTopLevel; }; void State::clearFile() { currentFile.clear(); currentFileName.clear(); currentFileDirectory.clear(); currentFileTopLevel.clear(); } void State::clearPatchFile() { currentPatchFile.clear(); currentPatchFileDisplayName.clear(); } void State::clearProject() { currentProjectPath.clear(); currentProjectName.clear(); currentProjectTopLevel.clear(); } void State::clear() { clearFile(); clearPatchFile(); clearProject(); } bool State::equals(const State &rhs) const { return currentFile == rhs.currentFile && currentFileName == rhs.currentFileName && currentPatchFile == rhs.currentPatchFile && currentPatchFileDisplayName == rhs.currentPatchFileDisplayName && currentFileTopLevel == rhs.currentFileTopLevel && currentProjectPath == rhs.currentProjectPath && currentProjectName == rhs.currentProjectName && currentProjectTopLevel == rhs.currentProjectTopLevel; } QDebug operator<<(QDebug in, const State &state) { QDebug nospace = in.nospace(); nospace << "State: "; if (state.isEmpty()) { nospace << ""; } else { if (state.hasFile()) { nospace << "File=" << state.currentFile << ',' << state.currentFileTopLevel; } else { nospace << ""; } nospace << '\n'; if (state.hasProject()) { nospace << " Project=" << state.currentProjectName << ',' << state.currentProjectPath << ',' << state.currentProjectTopLevel; } else { nospace << ""; } nospace << '\n'; } return in; } /*! \class VcsBase::Internal::StateListener \brief The StateListener class connects to the relevant signals of \QC, tries to find version controls and emits signals to the plugin instances. Singleton (as not to do checks multiple times). */ class StateListener : public QObject { Q_OBJECT public: explicit StateListener(QObject *parent); ~StateListener(); static QString windowTitleVcsTopic(const FilePath &filePath); signals: void stateChanged(const VcsBase::Internal::State &s, IVersionControl *vc); public slots: void slotStateChanged(); }; StateListener::StateListener(QObject *parent) : QObject(parent) { connect(EditorManager::instance(), &EditorManager::currentEditorChanged, this, &StateListener::slotStateChanged); connect(EditorManager::instance(), &EditorManager::currentDocumentStateChanged, this, &StateListener::slotStateChanged); connect(VcsManager::instance(), &VcsManager::repositoryChanged, this, &StateListener::slotStateChanged); connect(ProjectTree::instance(), &ProjectTree::currentProjectChanged, this, &StateListener::slotStateChanged); connect(ProjectManager::instance(), &ProjectManager::startupProjectChanged, this, &StateListener::slotStateChanged); EditorManager::setWindowTitleVcsTopicHandler(&StateListener::windowTitleVcsTopic); } StateListener::~StateListener() { EditorManager::setWindowTitleVcsTopicHandler({}); } QString StateListener::windowTitleVcsTopic(const FilePath &filePath) { FilePath searchPath; if (!filePath.isEmpty()) { searchPath = filePath.absolutePath(); } else { // use single project's information if there is only one loaded. const QList projects = ProjectManager::projects(); if (projects.size() == 1) searchPath = projects.first()->projectDirectory(); } if (searchPath.isEmpty()) return {}; FilePath topLevelPath; IVersionControl *vc = VcsManager::findVersionControlForDirectory( searchPath, &topLevelPath); return (vc && !topLevelPath.isEmpty()) ? vc->vcsTopic(topLevelPath) : QString(); } static inline QString displayNameOfEditor(const FilePath &fileName) { IDocument *document = DocumentModel::documentForFilePath(fileName); if (document) return document->displayName(); return {}; } void StateListener::slotStateChanged() { // Get the current file. Are we on a temporary submit editor indicated by // temporary path prefix or does the file contains a hash, indicating a project // folder? State state; IDocument *currentDocument = EditorManager::currentDocument(); if (currentDocument) { state.currentFile = currentDocument->filePath(); if (state.currentFile.isEmpty() || currentDocument->isTemporary()) state.currentFile = VcsBase::source(currentDocument); } // Get the file and its control. Do not use the file unless we find one IVersionControl *fileControl = nullptr; if (!state.currentFile.isEmpty()) { if (state.currentFile.exists()) { // Quick check: Does it look like a patch? const bool isPatch = state.currentFile.endsWith(".patch") || state.currentFile.endsWith(".diff"); if (isPatch) { // Patch: Figure out a name to display. If it is a temp file, it could be // Codepaster. Use the display name of the editor. state.currentPatchFile = state.currentFile; state.currentPatchFileDisplayName = displayNameOfEditor(state.currentPatchFile); if (state.currentPatchFileDisplayName.isEmpty()) state.currentPatchFileDisplayName = state.currentFile.fileName(); } if (state.currentFile.isDir()) { state.currentFileDirectory = state.currentFile.absoluteFilePath(); state.currentFile.clear(); } else { state.currentFileDirectory = state.currentFile.absolutePath(); state.currentFileName = state.currentFile.fileName(); } fileControl = VcsManager::findVersionControlForDirectory( state.currentFileDirectory, &state.currentFileTopLevel); } if (!fileControl) state.clearFile(); } // Check for project, find the control IVersionControl *projectControl = nullptr; Project *currentProject = ProjectTree::currentProject(); if (!currentProject) currentProject = ProjectManager::startupProject(); if (currentProject) { state.currentProjectPath = currentProject->projectDirectory(); state.currentProjectName = currentProject->displayName(); projectControl = VcsManager::findVersionControlForDirectory( state.currentProjectPath, &state.currentProjectTopLevel); if (projectControl) { // If we have both, let the file's one take preference if (fileControl && projectControl != fileControl) state.clearProject(); } else { state.clearProject(); // No control found } } // Assemble state and emit signal. IVersionControl *vc = fileControl; if (!vc) vc = projectControl; if (!vc) state.clearPatchFile(); // Need a repository to patch qCDebug(stateLog).noquote() << "VC:" << (vc ? vc->displayName() : QString("None")) << state; EditorManager::updateWindowTitles(); emit stateChanged(state, vc); } } // namespace Internal class VcsBasePluginStateData : public QSharedData { public: Internal::State m_state; }; /*! \class VcsBase::VcsBasePluginState \brief The VcsBasePluginState class provides relevant state information about the VCS plugins. Qt Creator's state relevant to VCS plugins is a tuple of \list \li Current file and it's version system control/top level \li Current project and it's version system control/top level \endlist \sa VcsBase::VcsBasePlugin */ VcsBasePluginState::VcsBasePluginState() : data(new VcsBasePluginStateData) { } VcsBasePluginState::VcsBasePluginState(const VcsBasePluginState &rhs) : data(rhs.data) { } VcsBasePluginState::~VcsBasePluginState() = default; VcsBasePluginState &VcsBasePluginState::operator=(const VcsBasePluginState &rhs) { if (this != &rhs) data.operator=(rhs.data); return *this; } FilePath VcsBasePluginState::currentFile() const { return data->m_state.currentFile; } QString VcsBasePluginState::currentFileName() const { return data->m_state.currentFileName; } FilePath VcsBasePluginState::currentFileTopLevel() const { return data->m_state.currentFileTopLevel; } FilePath VcsBasePluginState::currentFileDirectory() const { return data->m_state.currentFileDirectory; } QString VcsBasePluginState::relativeCurrentFile() const { QTC_ASSERT(hasFile(), return {}); return data->m_state.currentFile.relativeChildPath(data->m_state.currentFileTopLevel).path(); } QString VcsBasePluginState::currentPatchFile() const { return data->m_state.currentPatchFile.toString(); } QString VcsBasePluginState::currentPatchFileDisplayName() const { return data->m_state.currentPatchFileDisplayName; } FilePath VcsBasePluginState::currentProjectPath() const { return data->m_state.currentProjectPath; } QString VcsBasePluginState::currentProjectName() const { return data->m_state.currentProjectName; } FilePath VcsBasePluginState::currentProjectTopLevel() const { return data->m_state.currentProjectTopLevel; } QString VcsBasePluginState::relativeCurrentProject() const { QTC_ASSERT(hasProject(), return QString()); return data->m_state.currentProjectPath.relativeChildPath(data->m_state.currentProjectTopLevel).toString(); } bool VcsBasePluginState::hasTopLevel() const { return data->m_state.hasFile() || data->m_state.hasProject(); } FilePath VcsBasePluginState::topLevel() const { return hasFile() ? data->m_state.currentFileTopLevel : data->m_state.currentProjectTopLevel; } bool VcsBasePluginState::equals(const Internal::State &rhs) const { return data->m_state.equals(rhs); } bool VcsBasePluginState::equals(const VcsBasePluginState &rhs) const { return equals(rhs.data->m_state); } void VcsBasePluginState::clear() { data->m_state.clear(); } void VcsBasePluginState::setState(const Internal::State &s) { data->m_state = s; } bool VcsBasePluginState::isEmpty() const { return data->m_state.isEmpty(); } bool VcsBasePluginState::hasFile() const { return data->m_state.hasFile(); } bool VcsBasePluginState::hasPatchFile() const { return !data->m_state.currentPatchFile.isEmpty(); } bool VcsBasePluginState::hasProject() const { return data->m_state.hasProject(); } VCSBASE_EXPORT QDebug operator<<(QDebug in, const VcsBasePluginState &state) { in << state.data->m_state; return in; } /*! \class VcsBase::VcsBasePlugin \brief The VcsBasePlugin class is the base class for all version control plugins. The plugin connects to the relevant change signals in Qt Creator and calls the virtual updateActions() for the plugins to update their menu actions according to the new state. This is done centrally to avoid single plugins repeatedly invoking searches/QFileInfo on files, etc. Independently, there are accessors for current patch files, which return a file name if the current file could be a patch file which could be applied and a repository exists. If current file/project are managed by different version controls, the project is discarded and only the current file is taken into account, allowing to do a diff also when the project of a file is not opened. When triggering an action, a copy of the state should be made to keep it, as it may rapidly change due to context changes, etc. */ bool VersionControlBase::supportsRepositoryCreation() const { return supportsOperation(IVersionControl::CreateRepositoryOperation); } static Internal::StateListener *m_listener = nullptr; VersionControlBase::VersionControlBase(const Context &context) : m_context(context) { EditorManager::addCloseEditorListener([this](IEditor *editor) { bool result = true; if (editor == m_submitEditor) { result = m_submitEditor->promptSubmit(this); if (result) discardCommit(); } return result; }); // First time: create new listener if (!m_listener) m_listener = new Internal::StateListener(Internal::VcsPlugin::instance()); connect(m_listener, &Internal::StateListener::stateChanged, this, &VersionControlBase::slotStateChanged); // VCSes might have become (un-)available, so clear the VCS directory cache connect(this, &IVersionControl::configurationChanged, VcsManager::instance(), &VcsManager::clearVersionControlCache); connect(this, &IVersionControl::configurationChanged, m_listener, &Internal::StateListener::slotStateChanged); } void VersionControlBase::extensionsInitialized() { // Initialize enable menus. m_listener->slotStateChanged(); } void VersionControlBase::slotStateChanged(const Internal::State &newInternalState, IVersionControl *vc) { if (vc == this) { // We are directly affected: Change state if (!m_state.equals(newInternalState)) { m_state.setState(newInternalState); updateActions(VcsEnabled); ICore::addAdditionalContext(m_context); } } else { // Some other VCS plugin or state changed: Reset us to empty state. const ActionState newActionState = vc ? OtherVcsEnabled : NoVcsEnabled; if (m_actionState != newActionState || !m_state.isEmpty()) { m_actionState = newActionState; const VcsBasePluginState emptyState; m_state = emptyState; updateActions(newActionState); } ICore::removeAdditionalContext(m_context); } } const VcsBasePluginState &VersionControlBase::currentState() const { return m_state; } VcsCommand *VersionControlBase::createInitialCheckoutCommand(const QString &url, const FilePath &baseDirectory, const QString &localName, const QStringList &extraArgs) { Q_UNUSED(url) Q_UNUSED(baseDirectory) Q_UNUSED(localName) Q_UNUSED(extraArgs) return nullptr; } bool VersionControlBase::enableMenuAction(ActionState as, QAction *menuAction) const { qCDebug(baseLog) << "enableMenuAction" << menuAction->text() << as; switch (as) { case NoVcsEnabled: { const bool supportsCreation = supportsRepositoryCreation(); menuAction->setVisible(supportsCreation); menuAction->setEnabled(supportsCreation); return supportsCreation; } case OtherVcsEnabled: menuAction->setVisible(false); return false; case VcsEnabled: menuAction->setVisible(true); menuAction->setEnabled(true); break; } return true; } QString VersionControlBase::commitDisplayName() const { //: Name of the "commit" action of the VCS return Tr::tr("Commit", "name of \"commit\" action of the VCS."); } QString VersionControlBase::commitAbortTitle() const { return Tr::tr("Close Commit Editor"); } QString VersionControlBase::commitAbortMessage() const { return Tr::tr("Closing this editor will abort the commit."); } QString VersionControlBase::commitErrorMessage(const QString &error) const { if (error.isEmpty()) return Tr::tr("Cannot commit."); return Tr::tr("Cannot commit: %1.").arg(error); } void VersionControlBase::commitFromEditor() { QTC_ASSERT(m_submitEditor, return); m_submitEditor->accept(this); } bool VersionControlBase::promptBeforeCommit() { return DocumentManager::saveAllModifiedDocuments(Tr::tr("Save before %1?") .arg(commitDisplayName().toLower())); } void VersionControlBase::promptToDeleteCurrentFile() { const VcsBasePluginState state = currentState(); QTC_ASSERT(state.hasFile(), return); const bool rc = VcsManager::promptToDelete(this, state.currentFile()); if (!rc) QMessageBox::warning(ICore::dialogParent(), Tr::tr("Version Control"), Tr::tr("The file \"%1\" could not be deleted."). arg(state.currentFile().toUserOutput()), QMessageBox::Ok); } static inline bool ask(QWidget *parent, const QString &title, const QString &question, bool defaultValue = true) { const QMessageBox::StandardButton defaultButton = defaultValue ? QMessageBox::Yes : QMessageBox::No; return QMessageBox::question(parent, title, question, QMessageBox::Yes|QMessageBox::No, defaultButton) == QMessageBox::Yes; } void VersionControlBase::createRepository() { QTC_ASSERT(supportsOperation(IVersionControl::CreateRepositoryOperation), return); // Find current starting directory FilePath directory; if (const Project *currentProject = ProjectTree::currentProject()) directory = currentProject->projectFilePath().absolutePath(); // Prompt for a directory that is not under version control yet QWidget *mw = ICore::dialogParent(); do { directory = FileUtils::getExistingDirectory(nullptr, Tr::tr("Choose Repository Directory"), directory); if (directory.isEmpty()) return; const IVersionControl *managingControl = VcsManager::findVersionControlForDirectory(directory); if (managingControl == nullptr) break; const QString question = Tr::tr("The directory \"%1\" is already managed by a version control system (%2)." " Would you like to specify another directory?") .arg(directory.toUserOutput(), managingControl->displayName()); if (!ask(mw, Tr::tr("Repository already under version control"), question)) return; } while (true); // Create const bool rc = vcsCreateRepository(directory); const QString nativeDir = directory.toUserOutput(); if (rc) { QMessageBox::information(mw, Tr::tr("Repository Created"), Tr::tr("A version control repository has been created in %1."). arg(nativeDir)); } else { QMessageBox::warning(mw, Tr::tr("Repository Creation Failed"), Tr::tr("A version control repository could not be created in %1."). arg(nativeDir)); } } void VersionControlBase::setSubmitEditor(VcsBaseSubmitEditor *submitEditor) { m_submitEditor = submitEditor; } VcsBaseSubmitEditor *VersionControlBase::submitEditor() const { return m_submitEditor; } bool VersionControlBase::raiseSubmitEditor() const { if (!m_submitEditor) return false; EditorManager::activateEditor(m_submitEditor, EditorManager::IgnoreNavigationHistory); return true; } void VersionControlBase::discardCommit() { } // Find top level for version controls like git/Mercurial that have // a directory at the top of the repository. // Note that checking for the existence of files is preferred over directories // since checking for directories can cause them to be created when // AutoFS is used (due its automatically creating mountpoints when querying // a directory). In addition, bail out when reaching the home directory // of the user or root (generally avoid '/', where mountpoints are created). FilePath findRepositoryForFile(const FilePath &fileOrDir, const QString &checkFile) { const FilePath dirS = fileOrDir.isDir() ? fileOrDir : fileOrDir.parentDir(); qCDebug(findRepoLog) << ">" << dirS << checkFile; QTC_ASSERT(!dirS.isEmpty() && !checkFile.isEmpty(), return {}); const QString root = QDir::rootPath(); const QString home = QDir::homePath(); QDir directory(dirS.toString()); do { const QString absDirPath = directory.absolutePath(); if (absDirPath == root || absDirPath == home) break; if (QFileInfo(directory, checkFile).isFile()) { qCDebug(findRepoLog) << "<" << absDirPath; return FilePath::fromString(absDirPath); } } while (!directory.isRoot() && directory.cdUp()); qCDebug(findRepoLog) << "< bailing out at" << directory.absolutePath(); return {}; } static const char SOURCE_PROPERTY[] = "qtcreator_source"; void setSource(IDocument *document, const FilePath &source) { document->setProperty(SOURCE_PROPERTY, source.toVariant()); m_listener->slotStateChanged(); } FilePath source(IDocument *document) { return FilePath::fromVariant(document->property(SOURCE_PROPERTY)); } void setProcessEnvironment(Environment *e) { const QString prompt = Internal::commonSettings().sshPasswordPrompt().path(); if (!prompt.isEmpty()) { e->set("SSH_ASKPASS", prompt); e->set("SSH_ASKPASS_REQUIRE", "force"); } } } // namespace VcsBase #include "vcsbaseplugin.moc"