4 releases (2 breaking)
|0.3.1||Aug 23, 2022|
|0.3.0||Apr 19, 2022|
|0.2.0||Feb 17, 2022|
|0.1.0||Dec 17, 2021|
#351 in Algorithms
220 downloads per month
Used in 4 crates (2 directly)
lsp-positions crate defines LSP-compatible positioning information for
When writing a tool that analyzes or operates on source code, there's a good chance you need to interoperate with the Language Server Protocol. This seemingly simple requirement makes it surprisingly difficult to deal with character locations. This is because Rust stores Unicode string content (i.e., the source code you're analyzing) in UTF-8, while LSP specifies character locations using UTF-16 code units.
For some background, Unicode characters, or code points, are encoded as one or more code units. In UTF-8 a code unit is 1 byte, and a character is encoded in 1–4 code units (1–4 bytes). In UTF-16 a code unit is 2 bytes, and characters are encoded in 1–2 code units (2 or 4 bytes). Rust strings are encoded as UTF-8, and indexed by byte (which is the same as by code unit). Indices are only valid if they point to the first code unit of a code point.
We keep track of each source code position using two units: the UTF-8 byte
position within the file or containing line, which can be used to index into
[u8] data, and the UTF-16 code unit position within
the line, which can be used to generate
Position values for LSP.
To use this library, add the following to your
[dependencies] lsp-positions = "0.3"
Check out our documentation for more details on how to use this library.
Notable changes for each version are documented in the release notes.
Licensed under either of
at your option.