Fixed possible NPE in SymbolsLabelProvider during tests.

java.lang.NullPointerException
at org.eclipse.lsp4e.outline.SymbolsLabelProvider.lambda$0(SymbolsLabelProvider.java:68)
at org.eclipse.core.internal.events.NotificationManager$1.run(NotificationManager.java:305)
at org.eclipse.core.runtime.SafeRunner.run(SafeRunner.java:45)

Change-Id: I9ec1f6ef0e9e85a987b10451c6eb35474031eb7b
Signed-off-by: Markus Ofterdinger <markus.ofterdinger@sap.com>
1 file changed
tree: 6b048334cff758eb62ce544250f6e1064e5cf0c7
  1. .mvn/
  2. documentation/
  3. org.eclipse.lsp4e/
  4. org.eclipse.lsp4e.debug/
  5. org.eclipse.lsp4e.test/
  6. org.eclipse.lsp4e.tests.mock/
  7. repository/
  8. svg/
  9. target-platforms/
  10. .gitignore
  11. .project
  12. CONTRIBUTING.md
  13. pom.xml
  14. README.md
README.md

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).