// Copyright (C) 2016 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0 #pragma once #include "cppeditor_global.h" #include "cursorineditor.h" #include "projectinfo.h" #include "projectpart.h" #include #include #include #include #include #include #include #include #include #include namespace Core { class IDocument; class IEditor; class SearchResult; } namespace CPlusPlus { class AST; class CallAST; class LookupContext; } // namespace CPlusPlus namespace ProjectExplorer { class Project; } namespace TextEditor { class BaseHoverHandler; class TextDocument; } // namespace TextEditor namespace CppEditor { class AbstractEditorSupport; class BaseEditorDocumentProcessor; class CppCompletionAssistProvider; class CppEditorDocumentHandle; class CppIndexingSupport; class CppLocatorData; class FollowSymbolUnderCursor; class ModelManagerSupportProvider; class ModelManagerSupport; class SymbolFinder; class WorkingCopy; namespace Internal { class CppSourceProcessor; class CppEditorPluginPrivate; class CppModelManagerPrivate; } namespace Tests { class ModelManagerTestHelper; } enum class SignalSlotType { OldStyleSignal, NewStyleSignal, None }; class CPPEDITOR_EXPORT CppModelManager final : public CPlusPlus::CppModelManagerBase { Q_OBJECT private: friend class Internal::CppEditorPluginPrivate; CppModelManager(); ~CppModelManager() override; public: using Document = CPlusPlus::Document; static CppModelManager *instance(); void registerJsExtension(); // Documented in source file. enum ProgressNotificationMode { ForcedProgressNotification, ReservedProgressNotification }; QFuture updateSourceFiles(const QSet &sourceFiles, ProgressNotificationMode mode = ReservedProgressNotification); void updateCppEditorDocuments(bool projectsUpdated = false) const; WorkingCopy workingCopy() const; QByteArray codeModelConfiguration() const; CppLocatorData *locatorData() const; bool setExtraDiagnostics(const QString &fileName, const QString &kind, const QList &diagnostics) override; const QList diagnosticMessages(); ProjectInfoList projectInfos() const; ProjectInfo::ConstPtr projectInfo(ProjectExplorer::Project *project) const; QFuture updateProjectInfo(const ProjectInfo::ConstPtr &newProjectInfo, const QSet &additionalFiles = {}); /// \return The project part with the given project file ProjectPart::ConstPtr projectPartForId(const QString &projectPartId) const; /// \return All project parts that mention the given file name as one of the sources/headers. QList projectPart(const Utils::FilePath &fileName) const; QList projectPart(const QString &fileName) const { return projectPart(Utils::FilePath::fromString(fileName)); } /// This is a fall-back function: find all files that includes the file directly or indirectly, /// and return its \c ProjectPart list for use with this file. QList projectPartFromDependencies(const Utils::FilePath &fileName) const; /// \return A synthetic \c ProjectPart which consists of all defines/includes/frameworks from /// all loaded projects. ProjectPart::ConstPtr fallbackProjectPart(); CPlusPlus::Snapshot snapshot() const override; Document::Ptr document(const Utils::FilePath &filePath) const; bool replaceDocument(Document::Ptr newDoc); void emitDocumentUpdated(Document::Ptr doc); void emitAbstractEditorSupportContentsUpdated(const QString &filePath, const QString &sourcePath, const QByteArray &contents); void emitAbstractEditorSupportRemoved(const QString &filePath); static bool isCppEditor(Core::IEditor *editor); static bool usesClangd(const TextEditor::TextDocument *document); bool isClangCodeModelActive() const; QSet abstractEditorSupports() const; void addExtraEditorSupport(AbstractEditorSupport *editorSupport); void removeExtraEditorSupport(AbstractEditorSupport *editorSupport); const QList cppEditorDocuments() const; CppEditorDocumentHandle *cppEditorDocument(const Utils::FilePath &filePath) const; static BaseEditorDocumentProcessor *cppEditorDocumentProcessor(const Utils::FilePath &filePath); void registerCppEditorDocument(CppEditorDocumentHandle *cppEditorDocument); void unregisterCppEditorDocument(const QString &filePath); QList references(CPlusPlus::Symbol *symbol, const CPlusPlus::LookupContext &context); SignalSlotType getSignalSlotType(const Utils::FilePath &filePath, const QByteArray &content, int position) const; void renameUsages(CPlusPlus::Symbol *symbol, const CPlusPlus::LookupContext &context, const QString &replacement = QString(), const std::function &callback = {}); void renameUsages(const CPlusPlus::Document::Ptr &doc, const QTextCursor &cursor, const CPlusPlus::Snapshot &snapshot, const QString &replacement, const std::function &callback); void findUsages(CPlusPlus::Symbol *symbol, const CPlusPlus::LookupContext &context); void findMacroUsages(const CPlusPlus::Macro ¯o); void renameMacroUsages(const CPlusPlus::Macro ¯o, const QString &replacement); void finishedRefreshingSourceFiles(const QSet &files); void activateClangCodeModel(std::unique_ptr &&modelManagerSupport); CppCompletionAssistProvider *completionAssistProvider() const; BaseEditorDocumentProcessor *createEditorDocumentProcessor( TextEditor::TextDocument *baseTextDocument) const; TextEditor::BaseHoverHandler *createHoverHandler() const; static FollowSymbolUnderCursor &builtinFollowSymbol(); enum class Backend { Builtin, Best }; static void followSymbol(const CursorInEditor &data, const Utils::LinkHandler &processLinkCallback, bool resolveTarget, bool inNextSplit, Backend backend = Backend::Best); static void followSymbolToType(const CursorInEditor &data, const Utils::LinkHandler &processLinkCallback, bool inNextSplit, Backend backend = Backend::Best); static void switchDeclDef(const CursorInEditor &data, const Utils::LinkHandler &processLinkCallback, Backend backend = Backend::Best); static void startLocalRenaming(const CursorInEditor &data, const ProjectPart *projectPart, RenameCallback &&renameSymbolsCallback, Backend backend = Backend::Best); static void globalRename(const CursorInEditor &data, const QString &replacement, const std::function &callback = {}, Backend backend = Backend::Best); static void findUsages(const CursorInEditor &data, Backend backend = Backend::Best); static void switchHeaderSource(bool inNextSplit, Backend backend = Backend::Best); static void showPreprocessedFile(bool inNextSplit); static void findUnusedFunctions(const Utils::FilePath &folder); static void checkForUnusedSymbol(Core::SearchResult *search, const Utils::Link &link, CPlusPlus::Symbol *symbol, const CPlusPlus::LookupContext &context, const Utils::LinkHandler &callback); CppIndexingSupport *indexingSupport(); Utils::FilePaths projectFiles(); ProjectExplorer::HeaderPaths headerPaths(); // Use this *only* for auto tests void setHeaderPaths(const ProjectExplorer::HeaderPaths &headerPaths); ProjectExplorer::Macros definedMacros(); void enableGarbageCollector(bool enable); SymbolFinder *symbolFinder(); QThreadPool *sharedThreadPool(); static QSet timeStampModifiedFiles(const QList &documentsToCheck); static Internal::CppSourceProcessor *createSourceProcessor(); static const Utils::FilePath &configurationFileName(); static const Utils::FilePath &editorConfigurationFileName(); void setLocatorFilter(std::unique_ptr &&filter); void setClassesFilter(std::unique_ptr &&filter); void setIncludesFilter(std::unique_ptr &&filter); void setFunctionsFilter(std::unique_ptr &&filter); void setSymbolsFindFilter(std::unique_ptr &&filter); void setCurrentDocumentFilter(std::unique_ptr &&filter); Core::ILocatorFilter *locatorFilter() const; Core::ILocatorFilter *classesFilter() const; Core::ILocatorFilter *includesFilter() const; Core::ILocatorFilter *functionsFilter() const; Core::IFindFilter *symbolsFindFilter() const; Core::ILocatorFilter *currentDocumentFilter() const; /* * try to find build system target that depends on the given file - if the file is no header * try to find the corresponding header and use this instead to find the respective target */ QSet dependingInternalTargets(const Utils::FilePath &file) const; QSet internalTargets(const Utils::FilePath &filePath) const; void renameIncludes(const Utils::FilePath &oldFilePath, const Utils::FilePath &newFilePath); // for VcsBaseSubmitEditor Q_INVOKABLE QSet symbolsInFiles(const QSet &files) const; ModelManagerSupport *modelManagerSupport(Backend backend) const; signals: /// Project data might be locked while this is emitted. void aboutToRemoveFiles(const QStringList &files); void documentUpdated(CPlusPlus::Document::Ptr doc); void sourceFilesRefreshed(const QSet &files); void projectPartsUpdated(ProjectExplorer::Project *project); void projectPartsRemoved(const QStringList &projectPartIds); void globalSnapshotChanged(); void gcFinished(); // Needed for tests. void abstractEditorSupportContentsUpdated(const QString &filePath, const QString &sourcePath, const QByteArray &contents); void abstractEditorSupportRemoved(const QString &filePath); void fallbackProjectPartUpdated(); void diagnosticsChanged(const QString &fileName, const QString &kind); public slots: void updateModifiedSourceFiles(); void GC(); private: // This should be executed in the GUI thread. friend class Tests::ModelManagerTestHelper; void onAboutToLoadSession(); void onProjectAdded(ProjectExplorer::Project *project); void onAboutToRemoveProject(ProjectExplorer::Project *project); void onActiveProjectChanged(ProjectExplorer::Project *project); void onSourceFilesRefreshed() const; void onCurrentEditorChanged(Core::IEditor *editor); void onCoreAboutToClose(); void setupFallbackProjectPart(); void delayedGC(); void recalculateProjectPartMappings(); void replaceSnapshot(const CPlusPlus::Snapshot &newSnapshot); void removeFilesFromSnapshot(const QSet &removedFiles); void removeProjectInfoFilesAndIncludesFromSnapshot(const ProjectInfo &projectInfo); WorkingCopy buildWorkingCopyList(); void ensureUpdated(); Utils::FilePaths internalProjectFiles() const; ProjectExplorer::HeaderPaths internalHeaderPaths() const; ProjectExplorer::Macros internalDefinedMacros() const; void dumpModelManagerConfiguration(const QString &logFileId); void initCppTools(); private: Internal::CppModelManagerPrivate *d; }; } // CppEditor