Swiftpack.co - apple/sourcekit-lsp as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by apple.
apple/sourcekit-lsp swift-DEVELOPMENT-SNAPSHOT-2024-03-26-a
Language Server Protocol implementation for Swift and C-based languages
⭐️ 3,087
πŸ•“ Yesterday
macOS linux android
.package(url: "https://github.com/apple/sourcekit-lsp.git", from: "swift-DEVELOPMENT-SNAPSHOT-2024-03-26-a")

SourceKit-LSP

SourceKit-LSP is an implementation of the Language Server Protocol (LSP) for Swift and C-based languages. It provides features like code-completion and jump-to-definition to editors that support LSP. SourceKit-LSP is built on top of sourcekitd and clangd for high-fidelity language support, and provides a powerful source code index as well as cross-language support. SourceKit-LSP supports projects that use the Swift Package Manager.

Getting Started

The SourceKit-LSP server is included with the Swift toolchain. Depending on how you installed Swift, you may already have SourceKit-LSP. Make sure you build your package with the same toolchain as you use sourcekit-lsp from to ensure compatibility.

  1. Get SourceKit-LSP with a Swift toolchain

    1. If you have installed Xcode 11.4+ or the corresponding Command Line Tools package, the SourceKit-LSP server is included and can be run with xcrun sourcekit-lsp.

    2. If you are using a toolchain from Swift.org, the SourceKit-LSP server is included and can be run with xcrun --toolchain swift sourcekit-lsp on macOS, or using the full path to the sourcekit-lsp executable on Linux.

    3. If your toolchain did not come with SourceKit-LSP, see Development for how to build it from source.

  2. Configure your editor to use SourceKit-LSP. See Editors for more information about editor integration.

  3. Build the project you are working on with swift build using the same toolchain as the SourceKit-LSP server. The language server depends on the build to provide module dependencies and to update the global index.

Development

For more information about developing SourceKit-LSP itself, see Development. For information about developing SourceKit-LSP clients (like editors or their language plugins), see Client Development.

Indexing While Building

SourceKit-LSP uses a global index called IndexStoreDB to provide features that cross file or module boundaries, such as jump-to-definition or find-references. To efficiently create an index of your source code we use a technique called "indexing while building". When the project is compiled for debugging using swift build, the compiler (swiftc or clang) automatically produces additional raw index data that is read by our indexer. Producing this information during compilation saves work and ensures that any time the project is built the index is updated and fully accurate.

In the future we intend to also provide automatic background indexing so that we can update the index in between builds or to include code that's not always built like unit tests. In the meantime, building your project should bring our index up to date.

Status

SourceKit-LSP is still in early development, so you may run into rough edges with any of the features. The following table shows the status of various features when using the latest development toolchain snapshot. See Caveats for important known issues you may run into.

Feature Status Notes
Swift βœ…
C/C++/ObjC βœ… Uses clangd
Code completion βœ…
Quick Help (Hover) βœ…
Diagnostics βœ…
Fix-its βœ…
Jump to Definition βœ…
Find References βœ…
Background Indexing ❌ Build project to update the index using Indexing While Building
Workspace Symbols βœ…
Rename ❌
Local Refactoring βœ…
Formatting βœ… Whole file only
Folding βœ…
Syntax Highlighting βœ… Both syntactic and semantic tokens
Document Symbols βœ…
Call Hierarchy βœ…
Type Hierarchy βœ…

Caveats

  • SourceKit-LSP does not update its global index in the background, but instead relies on indexing-while-building to provide data. This only affects global queries like find-references and jump-to-definition.
    • Workaround: build the project to update the index

GitHub

link
Stars: 3088
Last commit: 3 hours ago
Advertisement: IndiePitcher.com - Cold Email Software for Startups

Release Notes

Swift 5.10 Release
3 weeks ago

What's Changed

New Contributors

Full Changelog: https://github.com/apple/sourcekit-lsp/compare/swift-5.9.2-RELEASE...swift-5.10-RELEASE

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics