/**************************************************************************** ** ** 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. ** ****************************************************************************/ #include "vcsbaseplugin.h" #include "vcsbasesubmiteditor.h" #include "vcsplugin.h" #include "commonvcssettings.h" #include "vcsoutputwindow.h" #include "vcscommand.h" #include #include #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; enum { debug = 0, debugRepositorySearch = 0 }; /*! \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(); } QString currentFile; QString currentFileName; QString currentPatchFile; QString currentPatchFileDisplayName; QString currentFileDirectory; QString currentFileTopLevel; QString currentProjectPath; QString currentProjectName; QString 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); static QString windowTitleVcsTopic(const QString &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(SessionManager::instance(), &SessionManager::startupProjectChanged, this, &StateListener::slotStateChanged); EditorManager::setWindowTitleVcsTopicHandler(&StateListener::windowTitleVcsTopic); } QString StateListener::windowTitleVcsTopic(const QString &filePath) { QString searchPath; if (!filePath.isEmpty()) { searchPath = QFileInfo(filePath).absolutePath(); } else { // use single project's information if there is only one loaded. const QList projects = SessionManager::projects(); if (projects.size() == 1) searchPath = projects.first()->projectDirectory().toString(); } if (searchPath.isEmpty()) return QString(); QString topLevelPath; IVersionControl *vc = VcsManager::findVersionControlForDirectory( searchPath, &topLevelPath); return (vc && !topLevelPath.isEmpty()) ? vc->vcsTopic(topLevelPath) : QString(); } static inline QString displayNameOfEditor(const QString &fileName) { IDocument *document = DocumentModel::documentForFilePath(fileName); if (document) return document->displayName(); return QString(); } 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().toString(); if (state.currentFile.isEmpty() || currentDocument->isTemporary()) state.currentFile = VcsBasePlugin::source(currentDocument); } // Get the file and its control. Do not use the file unless we find one IVersionControl *fileControl = 0; if (!state.currentFile.isEmpty()) { QFileInfo currentFi(state.currentFile); if (currentFi.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 = currentFi.fileName(); } if (currentFi.isDir()) { state.currentFile.clear(); state.currentFileDirectory = currentFi.absoluteFilePath(); } else { state.currentFileDirectory = currentFi.absolutePath(); state.currentFileName = currentFi.fileName(); } fileControl = VcsManager::findVersionControlForDirectory(state.currentFileDirectory, &state.currentFileTopLevel); } if (!fileControl) state.clearFile(); } // Check for project, find the control IVersionControl *projectControl = 0; Project *currentProject = ProjectTree::currentProject(); if (!currentProject) currentProject = SessionManager::startupProject(); if (currentProject) { state.currentProjectPath = currentProject->projectDirectory().toString(); 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 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; } QString VcsBasePluginState::currentFile() const { return data->m_state.currentFile; } QString VcsBasePluginState::currentFileName() const { return data->m_state.currentFileName; } QString VcsBasePluginState::currentFileTopLevel() const { return data->m_state.currentFileTopLevel; } QString VcsBasePluginState::currentFileDirectory() const { return data->m_state.currentFileDirectory; } QString VcsBasePluginState::relativeCurrentFile() const { QTC_ASSERT(hasFile(), return QString()); return QDir(data->m_state.currentFileTopLevel).relativeFilePath(data->m_state.currentFile); } QString VcsBasePluginState::currentPatchFile() const { return data->m_state.currentPatchFile; } QString VcsBasePluginState::currentPatchFileDisplayName() const { return data->m_state.currentPatchFileDisplayName; } QString VcsBasePluginState::currentProjectPath() const { return data->m_state.currentProjectPath; } QString VcsBasePluginState::currentProjectName() const { return data->m_state.currentProjectName; } QString VcsBasePluginState::currentProjectTopLevel() const { return data->m_state.currentProjectTopLevel; } QString VcsBasePluginState::relativeCurrentProject() const { QTC_ASSERT(hasProject(), return QString()); if (data->m_state.currentProjectTopLevel != data->m_state.currentProjectPath) return QDir(data->m_state.currentProjectTopLevel).relativeFilePath(data->m_state.currentProjectPath); return QString(); } bool VcsBasePluginState::hasTopLevel() const { return data->m_state.hasFile() || data->m_state.hasProject(); } QString 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. The class also detects the VCS plugin submit editor closing and calls the virtual submitEditorAboutToClose() to trigger the submit process. */ class VcsBasePluginPrivate { public: explicit VcsBasePluginPrivate(); inline bool supportsRepositoryCreation() const; QPointer m_submitEditor; IVersionControl *m_versionControl; Context m_context; VcsBasePluginState m_state; int m_actionState; static Internal::StateListener *m_listener; }; VcsBasePluginPrivate::VcsBasePluginPrivate() : m_versionControl(0), m_actionState(-1) { } bool VcsBasePluginPrivate::supportsRepositoryCreation() const { return m_versionControl && m_versionControl->supportsOperation(IVersionControl::CreateRepositoryOperation); } Internal::StateListener *VcsBasePluginPrivate::m_listener = 0; VcsBasePlugin::VcsBasePlugin() : d(new VcsBasePluginPrivate()) { } VcsBasePlugin::~VcsBasePlugin() { delete d; } void VcsBasePlugin::initializeVcs(IVersionControl *vc, const Context &context) { QTC_ASSERT(vc, return); d->m_versionControl = vc; d->m_context = context; Internal::VcsPlugin *plugin = Internal::VcsPlugin::instance(); connect(plugin, &Internal::VcsPlugin::submitEditorAboutToClose, this, &VcsBasePlugin::slotSubmitEditorAboutToClose); // First time: create new listener if (!VcsBasePluginPrivate::m_listener) VcsBasePluginPrivate::m_listener = new Internal::StateListener(plugin); connect(VcsBasePluginPrivate::m_listener, &Internal::StateListener::stateChanged, this, &VcsBasePlugin::slotStateChanged); // VCSes might have become (un-)available, so clear the VCS directory cache connect(vc, &IVersionControl::configurationChanged, VcsManager::instance(), &VcsManager::clearVersionControlCache); connect(vc, &IVersionControl::configurationChanged, VcsBasePluginPrivate::m_listener, &Internal::StateListener::slotStateChanged); } void VcsBasePlugin::extensionsInitialized() { // Initialize enable menus. VcsBasePluginPrivate::m_listener->slotStateChanged(); } void VcsBasePlugin::slotSubmitEditorAboutToClose(VcsBaseSubmitEditor *submitEditor, bool *result) { if (debug) qDebug() << this << "plugin's submit editor" << d->m_submitEditor << (d->m_submitEditor ? d->m_submitEditor->document()->id().name() : "") << "closing submit editor" << submitEditor << (submitEditor ? submitEditor->document()->id().name() : ""); if (submitEditor == d->m_submitEditor) *result = submitEditorAboutToClose(); } IVersionControl *VcsBasePlugin::versionControl() const { return d->m_versionControl; } void VcsBasePlugin::slotStateChanged(const VcsBase::Internal::State &newInternalState, IVersionControl *vc) { if (vc == d->m_versionControl) { // We are directly affected: Change state if (!d->m_state.equals(newInternalState)) { d->m_state.setState(newInternalState); updateActions(VcsEnabled); ICore::addAdditionalContext(d->m_context); } } else { // Some other VCS plugin or state changed: Reset us to empty state. const ActionState newActionState = vc ? OtherVcsEnabled : NoVcsEnabled; if (d->m_actionState != newActionState || !d->m_state.isEmpty()) { d->m_actionState = newActionState; const VcsBasePluginState emptyState; d->m_state = emptyState; updateActions(newActionState); } ICore::removeAdditionalContext(d->m_context); } } const VcsBasePluginState &VcsBasePlugin::currentState() const { return d->m_state; } bool VcsBasePlugin::enableMenuAction(ActionState as, QAction *menuAction) const { if (debug) qDebug() << "enableMenuAction" << menuAction->text() << as; switch (as) { case NoVcsEnabled: { const bool supportsCreation = d->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 VcsBasePlugin::commitDisplayName() const { return tr("commit", "name of \"commit\" action of the VCS."); } bool VcsBasePlugin::promptBeforeCommit() { return DocumentManager::saveAllModifiedDocuments(tr("Save before %1?").arg(commitDisplayName())); } void VcsBasePlugin::promptToDeleteCurrentFile() { const VcsBasePluginState state = currentState(); QTC_ASSERT(state.hasFile(), return); const bool rc = VcsManager::promptToDelete(versionControl(), state.currentFile()); if (!rc) QMessageBox::warning(ICore::dialogParent(), tr("Version Control"), tr("The file \"%1\" could not be deleted."). arg(QDir::toNativeSeparators(state.currentFile())), 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 VcsBasePlugin::createRepository() { QTC_ASSERT(d->m_versionControl->supportsOperation(IVersionControl::CreateRepositoryOperation), return); // Find current starting directory QString directory; if (const Project *currentProject = ProjectTree::currentProject()) directory = currentProject->projectFilePath().toString(); // Prompt for a directory that is not under version control yet QWidget *mw = ICore::mainWindow(); do { directory = QFileDialog::getExistingDirectory(mw, tr("Choose Repository Directory"), directory); if (directory.isEmpty()) return; const IVersionControl *managingControl = VcsManager::findVersionControlForDirectory(directory); if (managingControl == 0) break; const QString question = tr("The directory \"%1\" is already managed by a version control system (%2)." " Would you like to specify another directory?").arg(directory, managingControl->displayName()); if (!ask(mw, tr("Repository already under version control"), question)) return; } while (true); // Create const bool rc = d->m_versionControl->vcsCreateRepository(directory); const QString nativeDir = QDir::toNativeSeparators(directory); if (rc) { QMessageBox::information(mw, tr("Repository Created"), tr("A version control repository has been created in %1."). arg(nativeDir)); } else { QMessageBox::warning(mw, tr("Repository Creation Failed"), tr("A version control repository could not be created in %1."). arg(nativeDir)); } } void VcsBasePlugin::setSubmitEditor(VcsBaseSubmitEditor *submitEditor) { d->m_submitEditor = submitEditor; } VcsBaseSubmitEditor *VcsBasePlugin::submitEditor() const { return d->m_submitEditor; } bool VcsBasePlugin::raiseSubmitEditor() const { if (!d->m_submitEditor) return false; EditorManager::activateEditor(d->m_submitEditor, EditorManager::IgnoreNavigationHistory); return true; } // 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). QString VcsBasePlugin::findRepositoryForDirectory(const QString &dirS, const QString &checkFile) { if (debugRepositorySearch) qDebug() << ">VcsBasePlugin::findRepositoryForDirectory" << dirS << checkFile; QTC_ASSERT(!dirS.isEmpty() && !checkFile.isEmpty(), return QString()); const QString root = QDir::rootPath(); const QString home = QDir::homePath(); QDir directory(dirS); do { const QString absDirPath = directory.absolutePath(); if (absDirPath == root || absDirPath == home) break; if (QFileInfo(directory, checkFile).isFile()) { if (debugRepositorySearch) qDebug() << " " << absDirPath; return absDirPath; } } while (!directory.isRoot() && directory.cdUp()); if (debugRepositorySearch) qDebug() << "settings().sshPasswordPrompt; } bool VcsBasePlugin::isSshPromptConfigured() { return !sshPrompt().isEmpty(); } static const char SOURCE_PROPERTY[] = "qtcreator_source"; void VcsBasePlugin::setSource(IDocument *document, const QString &source) { document->setProperty(SOURCE_PROPERTY, source); VcsBasePluginPrivate::m_listener->slotStateChanged(); } QString VcsBasePlugin::source(IDocument *document) { return document->property(SOURCE_PROPERTY).toString(); } void VcsBasePlugin::setProcessEnvironment(QProcessEnvironment *e, bool forceCLocale, const QString &sshPromptBinary) { if (forceCLocale) { e->insert("LANG", "C"); e->insert("LANGUAGE", "C"); } if (!sshPromptBinary.isEmpty()) e->insert("SSH_ASKPASS", sshPromptBinary); } // Run a process synchronously, returning Utils::SynchronousProcessResponse // response struct and using the VcsBasePlugin flags as applicable SynchronousProcessResponse VcsBasePlugin::runVcs(const QString &workingDir, const FileName &binary, const QStringList &arguments, int timeOutS, unsigned flags, QTextCodec *outputCodec, const QProcessEnvironment &env) { VcsCommand command(workingDir, env.isEmpty() ? QProcessEnvironment::systemEnvironment() : env); command.addFlags(flags); command.setCodec(outputCodec); return command.runCommand(binary, arguments, timeOutS); } } // namespace VcsBase #include "vcsbaseplugin.moc"