Clone this repo:
  1. e2ab68d Bug 558306 - NPE in LSContentAssistProcessor by Victor Rubezhny · 3 days ago master
  2. eec824f Bug 560366: Adapt LSP4E to new API in LSP4J by Jonah Graham · 4 weeks ago
  3. c6fd830 Bug 560366: Set target to LSP4J 0.9.0 Release & Restrict version range by Jonah Graham · 4 weeks ago
  4. 764435d Avoid Exception when marker doesn't set CHAR_END by Mickael Istria · 5 weeks ago
  5. 3f6745d Build with Tycho 1.6.0 by Alexander Kurtakov · 6 weeks ago

Eclipse LSP4E

Eclipse LSP4E makes Eclipse IDE able to consume the Language Server protocol and the Debug Adapter protocol.

Target audience are Eclipse plugin developers or Language developers willing to integrate a language which ships a Language Server or Debug Adapter into Eclipse IDE. End-users can also take advantage of this as LSP4E also defines a way to bind Eclipse IDE to existing language servers from UI.

Install it into Eclipse IDE, or add it to your target-platform using one of this p2 repository:

Preview

Language Server in Eclipse in the Eclipse IDE

Debug Adapter in action in the Eclipse IDE

Features

Edition

LSP4E mostly ships extensions to the Generic Editor proposal for Eclipse Platform Text. But those classes can be reused in any editor or other extensions.

At the moment, it provides regular JFace/Platform Text classes for:

  • detection of language server for given file
  • synchronization of files with Language Server
  • diagnostics as problem markers
  • completion
  • hover
  • jump to declaration
  • formatting
  • rename refactoring
  • Find References
  • File symbols (as Outline or Quick Outline)
  • Workspace symbols
  • Language Server messages as notifications

Debug

Support for the Debug Adapter Protocol includes usual debug operations (breakpoints, step forward, step into, view variable value, evaluate expression, change variable value...) in the Platform Debug framework and its related UI components.

Examples

Examples of integration contain:

  • Eclipse Corrosion Rust support plugin for Eclipse IDE, edition is powered by LSP4E and RLS.
  • Eclipse aCute C# edition in Eclipse IDE using LSP4E and OmniSharp LSP implementation.
  • End-user using Language Server from Docker image, providing edition feature in the IDE without creating specific Eclipse IDE plugin: http://www.screencast.com/t/vksX3uZm1aj
  • Eclipse WildWebDeveloper HTML, CSS, JavaScript, TypeScript, Node.js, Angular, JSON, YAML (+Kubernetes) and XMLL edition, using LSP4E and various language servers from SourceGraph and VSCode.
  • language-servers-for-eclipse Binds various language servers to the Eclipse IDE.
  • Solargraph Binds a Ruby language server to the Eclipse IDE.

All those examples are already good for usage as they provide advanced edition features, and great for showcase of the LSP4E project.

Community

Contributions are highly welcome. See how

Related projects

The Language Server protocol specification is an open-source project.

As the Language Server Protocol doesn't include support for syntax highlighting, most adopters of LSP4E usually pair it with the Eclipse TM4E project to provide Syntax Highlighting according to TextMate grammars.

Possible integration with Docker images as language-server are made possible thanks to Eclipse Docker Tools, which are part of the Eclipse LinuxTools project.

History

This has been initiated during the EclipseCon France 2016 Unconference. Some initial documentation is still available (although it may not be up to date).