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 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77
//! This library implements basic processing of JavaScript sourcemaps. //! //! # Installation //! //! The crate is called sourcemap and you can depend on it via cargo: //! //! ```toml //! [dependencies] //! sourcemap = "*" //! ``` //! //! If you want to use the git version: //! //! ```toml //! [dependencies.sourcemap] //! git = "https://github.com/getsentry/rust-sourcemap.git" //! ``` //! //! # Basic Operation //! //! This crate can load JavaScript sourcemaps from JSON files. It uses //! `serde` for parsing of the JSON data. Due to the nature of sourcemaps //! the entirety of the file must be loaded into memory which can be quite //! memory intensive. //! //! Usage: //! //! ```rust //! use sourcemap::SourceMap; //! let input: &[_] = b"{ //! \"version\":3, //! \"sources\":[\"coolstuff.js\"], //! \"names\":[\"x\",\"alert\"], //! \"mappings\":\"AAAA,GAAIA,GAAI,EACR,IAAIA,GAAK,EAAG,CACVC,MAAM\" //! }"; //! let sm = SourceMap::from_reader(input).unwrap(); //! let token = sm.lookup_token(0, 0).unwrap(); // line-number and column //! println!("token: {}", token); //! ``` //! //! # Features //! //! Functionality of the crate can be turned on and off by feature flags. This is the //! current list of feature flags: //! //! * `ram_bundle`: turns on RAM bundle support //! #[warn(missing_docs)] mod macros; pub use crate::builder::SourceMapBuilder; pub use crate::decoder::{decode, decode_data_url, decode_slice}; pub use crate::detector::{ is_sourcemap, is_sourcemap_slice, locate_sourcemap_reference, locate_sourcemap_reference_slice, SourceMapRef, }; pub use crate::errors::{Error, Result}; pub use crate::sourceview::SourceView; pub use crate::types::{ DecodedMap, RawToken, RewriteOptions, SourceMap, SourceMapIndex, SourceMapSection, SourceMapSectionIter, Token, TokenIter, }; pub use crate::utils::make_relative_path; mod builder; mod decoder; mod detector; mod encoder; mod errors; mod jsontypes; mod sourceview; mod types; mod utils; #[cfg(feature = "ram_bundle")] pub mod ram_bundle; pub mod vlq;