#source-file #maps #compiler #position #representation #map #section

source-map

Utilities for building source maps (v3) for a compiler

28 releases (14 breaking)

0.15.0 May 21, 2024
0.14.10 Feb 10, 2024
0.14.9 Jan 19, 2024
0.14.7 Nov 24, 2023
0.2.0 Jul 26, 2021

#578 in Web programming

Download history 15/week @ 2024-09-18 22/week @ 2024-09-25 34/week @ 2024-10-02 140/week @ 2024-10-09 6/week @ 2024-10-16 8/week @ 2024-10-23 14/week @ 2024-10-30 17/week @ 2024-11-06 23/week @ 2024-11-13 14/week @ 2024-11-20 70/week @ 2024-11-27 24/week @ 2024-12-04 68/week @ 2024-12-11 5/week @ 2024-12-18 1/week @ 2024-12-25 14/week @ 2025-01-01

95 downloads per month
Used in 6 crates (4 directly)

MIT license

49KB
1K SLoC

Source map

crates.io badge docs.rs badge

Utilities for building source maps (v3), handling source location representations and source files.

Includes

  • SpanWithSource, a structure which represents a section of a specific source
  • SpanWithoutSource, a structure which represents a general section without a specific source
  • SourceId, a identifier for a source file
  • StringWithOptionalSourceMap, along with the ToString trait makes generating string representations with and adding source markings trivial
  • A lsp-types-morphisms feature which allows conversion of position type to lsp-types
  • The MapFileStore struct and the FileSystem trait for storing source files and other information
  • Utilities for turning byte indices into line and column information

Source map generation example

See generated example on GitHub actions.

git clone https://github.com/kaleidawave/source-map
cd source-map
cargo run -F inline-source-map --example source_map_creation -- LICENSE LICENSE.map

View pairings generated by uploading LICENSE.map to evan w's source map visualizer

Dependencies

~0–7.5MB
~49K SLoC