dbc_rs/value_descriptions/builder/mod.rs
1use std::{string::String, vec::Vec};
2
3/// Builder for creating `ValueDescriptions` programmatically.
4///
5/// This builder allows you to construct value descriptions when building DBC files
6/// programmatically. It validates that entries are within limits and non-empty.
7///
8/// # Examples
9///
10/// ```rust,no_run
11/// use dbc_rs::ValueDescriptionsBuilder;
12///
13/// let value_descriptions = ValueDescriptionsBuilder::new()
14/// .add_entry(0, "Park")
15/// .add_entry(1, "Reverse")
16/// .add_entry(2, "Neutral")
17/// .add_entry(3, "Drive")
18/// .build()?;
19///
20/// assert_eq!(value_descriptions.get(0), Some("Park"));
21/// assert_eq!(value_descriptions.get(1), Some("Reverse"));
22/// # Ok::<(), dbc_rs::Error>(())
23/// ```
24///
25/// # Validation
26///
27/// The builder validates:
28/// - At least one entry is required (non-empty)
29/// - Maximum of 64 value descriptions (MAX_VALUE_DESCRIPTIONS)
30/// - Description names must not exceed MAX_NAME_SIZE
31///
32/// # Feature Requirements
33///
34/// This builder requires the `std` feature to be enabled.
35#[derive(Debug, Clone)]
36pub struct ValueDescriptionsBuilder {
37 pub(crate) entries: Vec<(u64, String)>,
38}
39
40mod build;
41mod impls;