Struct VehicleSchemaV1 

pub struct VehicleSchemaV1 {
    pub fastsim_version: u32,
    pub powertrain: String,
    pub make: String,
    pub model: String,
    pub year: String,
    pub variant: String,
    pub revision: u32,
}

Database organizational schema version 1 for the fastsim-vehicles repository.

Serializes to/from an 8-segment path-segment string, e.g. "v1/fastsim-3/conv/ford/fusion/2012/base/r1"

Segments in order:

1. v1 — schema version marker
2. fastsim-{N} — FASTSim version
3. {powertrain} — powertrain type (e.g., “conv”, “hev”, “phev”, “bev”)
4. {make} — vehicle make
5. {model} — vehicle model (may include trim information)
6. {year} — model year or year range
7. {variant} — variant/feature configuration (e.g., “base”)
8. r{N} — model revision/version for corrections

Fields

fastsim_version: u32

FASTSim version

powertrain: String

Powertrain type (e.g., “conv”, “hev”, “phev”, “bev”)

make: String

Vehicle make

model: String

Vehicle model (may include trim information)

year: String

Vehicle model year (or range of years)

variant: String

Vehicle variant (describes what modeling features are active, etc.)

revision: u32

Model revision/version for correcting model-level issues over time

Implementations

impl VehicleSchemaV1

pub fn new( fastsim_version: u32, powertrain: String, make: String, model: String, year: String, variant: String, revision: u32, ) -> Result<VehicleSchemaV1, VehicleSchemaV1Error>

Construct a schema from parsed field values, enforcing canonical identifiers.

Errors

Returns an error if any of powertrain, make, model, year, or variant is not already in canonical identifier form (lowercase, ASCII, dashes and periods allowed).

pub fn normalize_identifier(s: &str) -> String

Convert arbitrary text into the canonical identifier format used by schema paths. Examples:

• "Outback XT" → "outback-xt"
• "Model_3" → "model-3".

pub fn validate_identifier(s: &str) -> bool

Validate that a string is a valid identifier for path segments.

pub fn suggest_normalized_path(raw: &str) -> Option<(String, String)>

Suggests a normalized path when raw is structurally valid but not canonical.

Returns (current, suggested) when a suggestion differs from the current path.

pub fn path_segments(&self) -> [String; 8]

Build the ordered path segments as an 8-element array (without file extension).

Returns in order:

1. “v1” — schema version marker
2. “fastsim-{N}” — FASTSim version
3. powertrain — e.g., “conv”, “hev”, “phev”, “bev”
4. make — e.g., “ford”, “tesla”
5. model — e.g., “fusion”, “model-3”
6. year — e.g., “2012”, “2020”
7. variant — e.g., “base”, “trim-package”
8. “r{N}” — revision/version number

pub fn build_filepath<P>(&self, base_dir: P, extension: &str) -> PathBuf

where P: AsRef<Path>,

Build a local file path by joining the schema’s path-segment string with a base directory and extension.

Example: base_dir/v1/fastsim-3/conv/ford/fusion/2012/base/r1.yaml

pub fn build_url(&self, base_url: Option<&str>, extension: &str) -> String

Build a remote URL by joining the schema’s path-segment string with a base URL and extension.

If base_url is None, uses the default GitHub raw content URL. Example: https://raw.githubusercontent.com/.../v1/fastsim-3/conv/ford/fusion/2012/base/r1.yaml

Trait Implementations

impl Clone for VehicleSchemaV1

fn clone(&self) -> VehicleSchemaV1

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VehicleSchemaV1

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VehicleSchemaV1

fn deserialize<__D>( __deserializer: __D, ) -> Result<VehicleSchemaV1, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for VehicleSchemaV1

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Display the schema as its path-segment string representation.

Formats as: v1/fastsim-{N}/{powertrain}/{make}/{model}/{year}/{variant}/r{N}

impl FromStr for VehicleSchemaV1

fn from_str( s: &str, ) -> Result<VehicleSchemaV1, <VehicleSchemaV1 as FromStr>::Err>

Parse a schema from its path-segment string representation.

Expected format (8 segments): v1/fastsim-{N}/{powertrain}/{make}/{model}/{year}/{variant}/r{N}

Errors

This parser has two validation phases and may fail in either phase:

• Structural parsing (parse_structural): wrong segment count, wrong required prefixes, or non-numeric version fields.
• Canonical identifier validation (new): any of powertrain, make, model, year, or variant is not already a canonical identifier.

type Err = VehicleSchemaV1Error

The associated error which can be returned from parsing.

impl PartialEq for VehicleSchemaV1

fn eq(&self, other: &VehicleSchemaV1) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for VehicleSchemaV1

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for VehicleSchemaV1

impl TryFrom<String> for VehicleSchemaV1

type Error = VehicleSchemaV1Error

The type returned in the event of a conversion error.

fn try_from( s: String, ) -> Result<VehicleSchemaV1, <VehicleSchemaV1 as TryFrom<String>>::Error>

Performs the conversion.