swamp-source-map 0.1.10

Source map cache for Swamp
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# Swamp Source Map

Manages source files for the [Swamp programming language](https://github.com/swamp/swamp) compiler, providing mapping between file IDs, paths, and source locations (line/column).

## Overview

This crate provides the `SourceMap` struct, which is responsible for:

*   **Mounting Directories:** Associates symbolic names ("mounts") with file system directories containing source code.
*   **Reading & Caching:** Reads source files either by absolute path or relative to a mount point, caching their contents and metadata.
*   **File IDs:** Assigns a unique `FileId` (u16) to each loaded file.
*   **Location Mapping:** Efficiently converts byte offsets within a file (often obtained from parsers or lexers using crates like `swamp-node`) into human-readable line and column numbers.
*   **Source Snippets:** Retrieves the source text corresponding to a given span (file ID, offset, length).

## Installation

Add this to your `Cargo.toml`:

```toml
[dependencies]
swamp-source-map = "0.1.10"
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Copyright

Copyright (c) Peter Bjorklund. All rights reserved. https://github.com/swamp/swamp