#source-map #parser #mapping #maps #utilities

sora

lightweight and fast source map parser and utils

3 releases

0.0.3 Jun 23, 2024
0.0.2 May 26, 2024
0.0.1 May 26, 2024

#18 in #source-map

Download history 16/week @ 2024-07-01 39/week @ 2024-07-29 16/week @ 2024-09-16 22/week @ 2024-09-23 46/week @ 2024-09-30

69 downloads per month

MIT license

5.5MB
1K SLoC

sora

Latest Version License CI Docs Build

Documentation: https://docs.rs/sora

MSRV: 1.70.0 (1 June, 2023)

License: MIT


lib.rs:

sora

This crate provides data structures and utilities for working with source maps in Rust.

Getting Started

use sora::SourceMap;

// Load a source map from a buffer
let sm = SourceMap::from(buf).unwrap();

// Find a mapping at the given position (line 10, column 12)
let found = sm.find_mapping((10, 12)).unwrap();

// Print the found mapping
println!("Found mapping at (10, 12): {found}");
// Expected output: "Found mapping at (10, 12): 10:12 -> 1:6:8"

Overview

BorrowedSourceMap

[BorrowedSourceMap] is a source map containing borrowed or owned strings. It allows for efficient parsing and manipulation of source maps, with several methods provided for creating, accessing, and modifying its contents.

SourceMap

[SourceMap] is a type alias to [BorrowedSourceMap] but owns all its internal strings, providing a more straightforward and safe API for users who do not need to manage the lifetimes of the strings manually.

Position

[Position] represents a 0-based line and 0-based column in a file.

Mapping

[Mapping] presents an item of the mappings in source maps.

Features

  • builder: Enables [SourceMapBuilder] and functions like Mappings::new for manual construction of source maps.
  • index-map: Enables support for index maps, as specified in spec.
  • ignore_list: Enables support for ignoreList.

Dependencies

~6.5MB
~114K SLoC