source-map-mappings 0.5.0

Parse the `mappings` string from a source map.
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
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

//! Comparator functions for sorting mappings in different ways.

use super::{Mapping, OriginalLocation};
use std::cmp::Ordering;
use std::fmt;

/// A function that can compare two `T`s.
pub trait ComparatorFunction<T>: fmt::Debug {
    /// Compare the given values.
    fn compare(&T, &T) -> Ordering;
}

impl<T, F> ComparatorFunction<Option<T>> for F
where
    F: ComparatorFunction<T>,
{
    #[inline]
    fn compare(a: &Option<T>, b: &Option<T>) -> Ordering {
        match (a, b) {
            (&None, &None) => Ordering::Equal,
            (&Some(_), &None) => Ordering::Less,
            (&None, &Some(_)) => Ordering::Greater,
            (&Some(ref a), &Some(ref b)) => F::compare(a, b),
        }
    }
}

// Yes, using this style of comparison instead of `cmp.then(cmp2).then(cmp3)` is
// actually a big performance win in practice:
//
// ```
// $ cargo benchcmp control variable
// name                                     control ns/iter  variable ns/iter  diff ns/iter   diff %  speedup
// bench_parse_part_of_scala_js_source_map  2,029,981        1,290,716         -739,265       -36.42% x 1.57
// ```
//
// This doesn't seem right, but you can't argue with those numbers...
macro_rules! compare {
    ($a:expr, $b:expr) => {
        let cmp = ($a as i64) - ($b as i64);
        if cmp < 0 {
            return Ordering::Less;
        } else if cmp > 0 {
            return Ordering::Greater;
        }
    }
}

/// Sort mappings by their generated location, but don't compare generated
/// lines. This is useful for when we know that all mappings being sorted have
/// the same generated line number.
#[derive(Debug)]
pub struct ByGeneratedTail;

impl ComparatorFunction<Mapping> for ByGeneratedTail {
    #[inline]
    fn compare(a: &Mapping, b: &Mapping) -> Ordering {
        compare!(a.generated_column, b.generated_column);
        ByOriginalLocation::compare(&a.original, &b.original)
    }
}

/// Sort mappings by their original locations, breaking ties by their generated
/// locations.
#[derive(Debug)]
pub struct ByOriginalLocation;

impl ComparatorFunction<Mapping> for ByOriginalLocation {
    #[inline]
    fn compare(a: &Mapping, b: &Mapping) -> Ordering {
        let c = ByOriginalLocation::compare(&a.original, &b.original);
        match c {
            Ordering::Less | Ordering::Greater => c,
            Ordering::Equal => {
                compare!(a.generated_line, b.generated_line);
                compare!(a.generated_column, b.generated_column);
                Ordering::Equal
            }
        }
    }
}

impl ComparatorFunction<OriginalLocation> for ByOriginalLocation {
    #[inline]
    fn compare(a: &OriginalLocation, b: &OriginalLocation) -> Ordering {
        compare!(a.source, b.source);
        compare!(a.original_line, b.original_line);
        compare!(a.original_column, b.original_column);
        a.name.cmp(&b.name)
    }
}

/// Assuming mappings are in the same original source, sort mappings by their
/// original locations, breaking ties by their generated locations.
#[derive(Debug)]
pub struct ByOriginalLocationSameSource;

impl ComparatorFunction<Mapping> for ByOriginalLocationSameSource {
    #[inline]
    fn compare(a: &Mapping, b: &Mapping) -> Ordering {
        let c = ByOriginalLocationSameSource::compare(&a.original, &b.original);
        match c {
            Ordering::Less | Ordering::Greater => c,
            Ordering::Equal => {
                compare!(a.generated_line, b.generated_line);
                compare!(a.generated_column, b.generated_column);
                Ordering::Equal
            }
        }
    }
}

impl ComparatorFunction<OriginalLocation> for ByOriginalLocationSameSource {
    #[inline]
    fn compare(a: &OriginalLocation, b: &OriginalLocation) -> Ordering {
        debug_assert_eq!(a.source, b.source);
        compare!(a.original_line, b.original_line);
        compare!(a.original_column, b.original_column);
        a.name.cmp(&b.name)
    }
}