dbc_rs/
parse_options.rs

1/// Options for configuring DBC parsing behavior.
2///
3/// # Examples
4///
5/// ```
6/// use dbc_rs::{Dbc, ParseOptions};
7///
8/// let dbc_content = r#"VERSION "1.0"
9///
10/// BU_: ECM
11///
12/// BO_ 256 Test : 8 ECM
13///  SG_ Signal1 : 0|8@1+ (1,0) [0|255] ""
14/// "#;
15///
16/// // Use lenient mode to allow signals that extend beyond message boundaries
17/// let options = ParseOptions::lenient();
18/// let dbc = Dbc::parse_with_options(dbc_content, options)?;
19/// # Ok::<(), dbc_rs::Error>(())
20/// ```
21#[derive(Debug, Clone, Copy, PartialEq, Eq)]
22pub struct ParseOptions {
23    /// If `true`, signals that extend beyond message boundaries will cause a parse error.
24    /// If `false`, such signals will be allowed (lenient mode).
25    ///
26    /// Default: `true` (strict mode)
27    ///
28    /// # Note
29    ///
30    /// Many real-world DBC files have signals that technically extend beyond message
31    /// boundaries but are still valid in practice. Setting this to `false` allows
32    /// parsing such files.
33    pub strict_boundary_check: bool,
34}
35
36impl Default for ParseOptions {
37    fn default() -> Self {
38        Self {
39            strict_boundary_check: true,
40        }
41    }
42}
43
44impl ParseOptions {
45    /// Creates a new `ParseOptions` with default settings (strict mode).
46    #[must_use]
47    pub const fn new() -> Self {
48        Self {
49            strict_boundary_check: true,
50        }
51    }
52
53    /// Creates a new `ParseOptions` with lenient boundary checking enabled.
54    ///
55    /// This allows signals that extend beyond message boundaries, which is useful
56    /// for parsing real-world DBC files that may have technically invalid but
57    /// commonly used signal definitions.
58    #[must_use]
59    pub const fn lenient() -> Self {
60        Self {
61            strict_boundary_check: false,
62        }
63    }
64}
dbc_rs/parse_options.rs

dbc_rs/
parse_options.rs
