iriq 0.30.2

IRI/URL extraction, normalization, and shape clustering.
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

use crate::classifier::{
    canonical_currency, canonical_date, display_type, SegmentClassifier, SegmentType,
    DEFAULT_CLASSIFIER,
};
use crate::hints::{derive_hints, SegmentHint};

#[derive(Debug, Clone, Default)]
pub struct Shape {
    pub entries: Vec<SegmentHint>,
}

#[derive(Debug, Clone, Copy, Default)]
pub struct ShapeRenderOptions {
    /// Disables hint placeholders; when true, variable segments render as
    /// their display type (e.g. `{integer}`) rather than `{user_id}`.
    pub hints_off: bool,
    pub canonical_dates: bool,
    pub canonical_currencies: bool,
}

impl Shape {
    pub fn from_segments(segments: &[String], classifier: Option<&SegmentClassifier>) -> Self {
        let c = classifier.unwrap_or(&DEFAULT_CLASSIFIER);
        Shape {
            entries: derive_hints(segments, c),
        }
    }

    pub fn from_entries(entries: Vec<SegmentHint>) -> Self {
        Shape { entries }
    }

    pub fn render(&self, opts: ShapeRenderOptions) -> String {
        if self.entries.is_empty() {
            return "/".to_string();
        }
        let mut s = String::new();
        for e in &self.entries {
            s.push('/');
            s.push_str(&render_entry(e, opts));
        }
        s
    }

    pub fn equal(&self, other: &Shape) -> bool {
        self.render(ShapeRenderOptions::default()) == other.render(ShapeRenderOptions::default())
    }
}

impl std::fmt::Display for Shape {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(&self.render(ShapeRenderOptions::default()))
    }
}

fn render_entry(e: &SegmentHint, opts: ShapeRenderOptions) -> String {
    if !e.variable {
        return e.value.clone();
    }
    if opts.canonical_dates && e.ty == SegmentType::Date {
        if let Some(c) = canonical_date(&e.value) {
            return c;
        }
    }
    if opts.canonical_currencies && e.ty == SegmentType::Currency {
        if let Some(c) = canonical_currency(&e.value) {
            return c;
        }
    }
    if !opts.hints_off && !e.hint.is_empty() {
        return format!("{{{}}}", e.hint);
    }
    format!("{{{}}}", display_type(e.ty))
}