html-filter 0.2.2

Crate to parse, filter, search and edit an HTML file.
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

//! Module that defines macros to deal with developer errors.
//!
//! These errors are those made by coding, i.e., are never mean't to be fired.
//! If they happen, it is asked to the user to raise an issue on the system
//! version control.

#![expect(clippy::arbitrary_source_item_ordering, reason = "macro used")]

/// Macro to add a developer error with a generic failure text.
macro_rules! safe_expect {
    ($code:expr, $reason:expr) => {
        $code.expect(&format!(
            "
This is not meant to happen.
Please report this problem at https://github.com/t-webber/html-parser/issues/new.
Please include the code snippet that created this error and the reason displayed below.
Thank you for signalling this issue!
We will try to fix it as soon as possible.
---------- Reason ----------
{}
----------------------------
",
            $reason
        ))
    };
}

/// Macro to make a developer error with a generic failure text.
#[expect(
    clippy::panic,
    reason = "called when code must fail to avoid undefined behaviour."
)]
pub fn safe_unreachable(reason: &str) -> ! {
    panic!(
        "
This is not meant to happen.
Please report this problem at https://github.com/t-webber/html-parser/issues/new.
Please include the code snippet that created this error and the reason displayed below.
Thank you for signalling this issue!
We will try to fix it as soon as possible.
---------- Reason ----------
{reason}
----------------------------
"
    )
}

pub(super) use safe_expect;