Struct SourceMapBuilder

pub struct SourceMapBuilder { /* private fields */ }

Helper for sourcemap generation

This helper exists because generating and modifying SourceMap objects is generally not very comfortable. As a general aid this type can help.

Implementations

impl SourceMapBuilder

pub fn new(file: Option<&str>) -> SourceMapBuilder

Creates a new source map builder and sets the file.

pub fn set_debug_id(&mut self, debug_id: Option<DebugId>)

Sets the debug id for the sourcemap (optional)

pub fn set_file<T: Into<Arc<str>>>(&mut self, value: Option<T>)

Sets the file for the sourcemap (optional)

pub fn get_file(&self) -> Option<&str>

Returns the currently set file.

pub fn set_source_root<T: Into<Arc<str>>>(&mut self, value: Option<T>)

Sets a new value for the source_root.

pub fn get_source_root(&self) -> Option<&str>

Returns the embedded source_root in case there is one.

pub fn add_source(&mut self, src: &str) -> u32

Registers a new source with the builder and returns the source ID.

pub fn set_source(&mut self, src_id: u32, src: &str)

Changes the source name for an already set source.

pub fn get_source(&self, src_id: u32) -> Option<&str>

Looks up a source name for an ID.

pub fn add_to_ignore_list(&mut self, src_id: u32)

pub fn set_source_contents(&mut self, src_id: u32, contents: Option<&str>)

Sets the source contents for an already existing source.

pub fn get_source_contents(&self, src_id: u32) -> Option<&str>

Returns the current source contents for a source.

pub fn has_source_contents(&self, src_id: u32) -> bool

Checks if a given source ID has source contents available.

pub fn load_local_source_contents( &mut self, base_path: Option<&Path>, ) -> Result<usize>

Loads source contents from locally accessible files if referenced accordingly. Returns the number of loaded source contents

pub fn add_name(&mut self, name: &str) -> u32

Registers a name with the builder and returns the name ID.

pub fn add( &mut self, dst_line: u32, dst_col: u32, src_line: u32, src_col: u32, source: Option<&str>, name: Option<&str>, is_range: bool, ) -> RawToken

Adds a new mapping to the builder.

pub fn add_raw( &mut self, dst_line: u32, dst_col: u32, src_line: u32, src_col: u32, source: Option<u32>, name: Option<u32>, is_range: bool, ) -> RawToken

Adds a new mapping to the builder.

pub fn add_token(&mut self, token: &Token<'_>, with_name: bool) -> RawToken

Shortcut for adding a new mapping based of an already existing token, optionally removing the name.

pub fn strip_prefixes<S: AsRef<str>>(&mut self, prefixes: &[S])

Strips common prefixes from the sources in the builder

pub fn into_sourcemap(self) -> SourceMap

Converts the builder into a sourcemap.