Files
llvm/mlir/lib/Tools/mlir-lsp-server/LSPServer.cpp
River Riddle 751c14fc42 [mlir][mlir-lsp] Add a new C++ LSP server for MLIR named mlir-lsp-server
This commits adds a basic LSP server for MLIR that supports resolving references and definitions. Several components of the setup are simplified to keep the size of this commit down, and will be built out in later commits. A followup commit will add a vscode language client that communicates with this server, paving the way for better IDE experience when interfacing with MLIR files.

The structure of this tool is similar to mlir-opt and mlir-translate, i.e. the implementation is structured as a library that users can call into to implement entry points that contain the dialects/passes that they are interested in.

Note: This commit contains several files, namely those in `mlir-lsp-server/lsp`, that have been copied from the LSP code in clangd and adapted for use in MLIR. This copying was decided as the best initial path forward (discussed offline by several stake holders in MLIR and clangd) given the different needs of our MLIR server, and the one for clangd. If a strong desire/need for unification arises in the future, the existence of these files in mlir-lsp-server can be reconsidered.

Differential Revision: https://reviews.llvm.org/D100439
2021-04-21 14:44:37 -07:00

168 lines
6.1 KiB
C++

//===- LSPServer.cpp - MLIR Language Server -------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#include "LSPServer.h"
#include "MLIRServer.h"
#include "lsp/Logging.h"
#include "lsp/Protocol.h"
#include "lsp/Transport.h"
#include "llvm/ADT/FunctionExtras.h"
#include "llvm/ADT/StringMap.h"
#define DEBUG_TYPE "mlir-lsp-server"
using namespace mlir;
using namespace mlir::lsp;
//===----------------------------------------------------------------------===//
// LSPServer::Impl
//===----------------------------------------------------------------------===//
struct LSPServer::Impl {
Impl(MLIRServer &server, JSONTransport &transport)
: server(server), transport(transport) {}
//===--------------------------------------------------------------------===//
// Initialization
void onInitialize(const InitializeParams &params,
Callback<llvm::json::Value> reply);
void onInitialized(const InitializedParams &params);
void onShutdown(const NoParams &params, Callback<std::nullptr_t> reply);
//===--------------------------------------------------------------------===//
// Document Change
void onDocumentDidOpen(const DidOpenTextDocumentParams &params);
void onDocumentDidClose(const DidCloseTextDocumentParams &params);
void onDocumentDidChange(const DidChangeTextDocumentParams &params);
//===--------------------------------------------------------------------===//
// Definitions and References
void onGoToDefinition(const TextDocumentPositionParams &params,
Callback<std::vector<Location>> reply);
void onReference(const ReferenceParams &params,
Callback<std::vector<Location>> reply);
MLIRServer &server;
JSONTransport &transport;
/// Used to indicate that the 'shutdown' request was received from the
/// Language Server client.
bool shutdownRequestReceived = false;
};
//===----------------------------------------------------------------------===//
// Initialization
void LSPServer::Impl::onInitialize(const InitializeParams &params,
Callback<llvm::json::Value> reply) {
llvm::json::Object serverCaps{
{"textDocumentSync",
llvm::json::Object{
{"openClose", true},
{"change", (int)TextDocumentSyncKind::Full},
{"save", true},
}},
{"definitionProvider", true},
{"referencesProvider", true},
};
llvm::json::Object result{
{{"serverInfo",
llvm::json::Object{{"name", "mlir-lsp-server"}, {"version", "0.0.0"}}},
{"capabilities", std::move(serverCaps)}}};
reply(std::move(result));
}
void LSPServer::Impl::onInitialized(const InitializedParams &) {}
void LSPServer::Impl::onShutdown(const NoParams &,
Callback<std::nullptr_t> reply) {
shutdownRequestReceived = true;
reply(nullptr);
}
//===----------------------------------------------------------------------===//
// Document Change
void LSPServer::Impl::onDocumentDidOpen(
const DidOpenTextDocumentParams &params) {
server.addOrUpdateDocument(params.textDocument.uri, params.textDocument.text);
}
void LSPServer::Impl::onDocumentDidClose(
const DidCloseTextDocumentParams &params) {
server.removeDocument(params.textDocument.uri);
}
void LSPServer::Impl::onDocumentDidChange(
const DidChangeTextDocumentParams &params) {
// TODO: We currently only support full document updates, we should refactor
// to avoid this.
if (params.contentChanges.size() != 1)
return;
server.addOrUpdateDocument(params.textDocument.uri,
params.contentChanges.front().text);
}
//===----------------------------------------------------------------------===//
// Definitions and References
void LSPServer::Impl::onGoToDefinition(const TextDocumentPositionParams &params,
Callback<std::vector<Location>> reply) {
std::vector<Location> locations;
server.getLocationsOf(params.textDocument.uri, params.position, locations);
reply(std::move(locations));
}
void LSPServer::Impl::onReference(const ReferenceParams &params,
Callback<std::vector<Location>> reply) {
std::vector<Location> locations;
server.findReferencesOf(params.textDocument.uri, params.position, locations);
reply(std::move(locations));
}
//===----------------------------------------------------------------------===//
// LSPServer
//===----------------------------------------------------------------------===//
LSPServer::LSPServer(MLIRServer &server, JSONTransport &transport)
: impl(std::make_unique<Impl>(server, transport)) {}
LSPServer::~LSPServer() {}
LogicalResult LSPServer::run() {
MessageHandler messageHandler(impl->transport);
// Initialization
messageHandler.method("initialize", impl.get(), &Impl::onInitialize);
messageHandler.notification("initialized", impl.get(), &Impl::onInitialized);
messageHandler.method("shutdown", impl.get(), &Impl::onShutdown);
// Document Changes
messageHandler.notification("textDocument/didOpen", impl.get(),
&Impl::onDocumentDidOpen);
messageHandler.notification("textDocument/didClose", impl.get(),
&Impl::onDocumentDidClose);
messageHandler.notification("textDocument/didChange", impl.get(),
&Impl::onDocumentDidChange);
// Definitions and References
messageHandler.method("textDocument/definition", impl.get(),
&Impl::onGoToDefinition);
messageHandler.method("textDocument/references", impl.get(),
&Impl::onReference);
LogicalResult result = success();
if (llvm::Error error = impl->transport.run(messageHandler)) {
Logger::error("Transport error: {0}", error);
llvm::consumeError(std::move(error));
result = failure();
} else {
result = success(impl->shutdownRequestReceived);
}
return result;
}