aboutsummaryrefslogtreecommitdiffstats
path: root/src/plugins/languageclient/languageclienthoverhandler.h
blob: 6bf0eba0159060007e184a82560d55b913fc0b10 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
// Copyright (C) 2019 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0+ OR GPL-3.0 WITH Qt-GPL-exception-1.0

#pragma once

#include "languageclient_global.h"

#include <languageserverprotocol/languagefeatures.h>
#include <texteditor/basehoverhandler.h>

#include <functional>

namespace LanguageClient {

class Client;

using HelpItemProvider = std::function<void(const LanguageServerProtocol::HoverRequest::Response &,
                                            const LanguageServerProtocol::DocumentUri &uri)>;

class LANGUAGECLIENT_EXPORT HoverHandler final : public TextEditor::BaseHoverHandler
{
    Q_DECLARE_TR_FUNCTIONS(HoverHandler)
public:
    explicit HoverHandler(Client *client);
    ~HoverHandler() override;

    void abort() override;

    /// If prefer diagnostics is enabled the hover handler checks whether a diagnostics is at the
    /// pos passed to identifyMatch _before_ sending hover request to the server. If a diagnostic
    /// can be found it will be used as a tooltip and no hover request is sent to the server.
    /// If prefer diagnostics is disabled the diagnostics are only checked if the response is empty.
    /// Defaults to prefer diagnostics.
    void setPreferDiagnosticts(bool prefer);

    void setHelpItemProvider(const HelpItemProvider &provider) { m_helpItemProvider = provider; }
    void setHelpItem(const LanguageServerProtocol::MessageId &msgId, const Core::HelpItem &help);

protected:
    void identifyMatch(TextEditor::TextEditorWidget *editorWidget,
                       int pos,
                       ReportPriority report) override;

private:
    void handleResponse(const LanguageServerProtocol::HoverRequest::Response &response,
                        const QTextCursor &cursor);
    void setContent(const LanguageServerProtocol::HoverContent &content);
    bool reportDiagnostics(const QTextCursor &cursor);

    QPointer<Client> m_client;
    Utils::optional<LanguageServerProtocol::MessageId> m_currentRequest;
    LanguageServerProtocol::DocumentUri m_uri;
    LanguageServerProtocol::HoverRequest::Response m_response;
    TextEditor::BaseHoverHandler::ReportPriority m_report;
    HelpItemProvider m_helpItemProvider;
    bool m_preferDiagnostics = true;
};

} // namespace LanguageClient