Enum Version 

pub enum Version<V, U>
where
    V: Versioned,
    U: Debug,
{
    Certain(V),
    Uncertain(U),
}

An OCPI object with a certain or uncertain version.

Variants

Certain(V)

The version of the object V is certain.

Uncertain(U)

The version of the object U is uncertain.

Implementations

impl<V, U> Version<V, U>

where V: Versioned, U: Unversioned<Versioned = V>,

pub fn into_version(self) -> Version<Version, ()>

Convert the OCPI object into it’s Version if it’s Versioned. Otherwise, return Uncertain(()).

pub fn as_version(&self) -> Version<Version, ()>

Convert a reference to the an OCPI object into it’s Version if it’s Versioned. Otherwise, return Uncertain(()).

pub fn certain_or(self, fallback: Version) -> V

Return the contained OCPI object if it’s Versioned. Otherwise, force convert the object to the given Version.

Examples found in repository

examples/lint_tariff.rs (line 26)

fn main() {
    const TARIFF_JSON: &str =
        include_str!("../test_data/v221/real_world/misspelled_field/tariff.json");

    let report = tariff::parse_and_report(TARIFF_JSON).unwrap();
    let guess::Report {
        unexpected_fields,
        version,
    } = report;

    if !unexpected_fields.is_empty() {
        eprintln!("Strange... there are fields in the tariff that are not defined in the spec.");

        for path in &unexpected_fields {
            eprintln!("  * {path}");
        }

        eprintln!();
    }

    let tariff = version.certain_or(Version::V221);
    let report = tariff::lint(&tariff);

    print_lint_warnings(&report.warnings);
}

examples/generate_cdr_from_tariff.rs (line 32)

fn main() {
    const TARIFF_JSON: &str = include_str!(
        "../test_data/v211/real_world/time_and_parking_time_separate_tariff/tariff.json"
    );

    let report = tariff::parse_and_report(TARIFF_JSON).unwrap();
    let guess::Report {
        unexpected_fields,
        version,
    } = report;

    if !unexpected_fields.is_empty() {
        eprintln!("Strange... there are fields in the tariff that are not defined in the spec.");

        for path in &unexpected_fields {
            eprintln!("  * {path}");
        }

        eprintln!();
    }

    let tariff = version.certain_or(Version::V221);

    let config = generate::Config {
        timezone: chrono_tz::Europe::Amsterdam,
        start_date_time: DateTime::<Utc>::from_str("2025-06-12 18:22:33+00:00").unwrap(),
        end_date_time: DateTime::<Utc>::from_str("2025-06-12 22:33:44+00:00").unwrap(),
        max_current_supply_amp: Decimal::from(4),
        max_energy_battery_kwh: Decimal::from(24),
        max_power_supply_kw: Decimal::from(80),
    };
    let report = match cdr::generate_from_tariff(&tariff, config) {
        Ok(r) => r,
        Err(set) => {
            let (error, warnings) = set.into_parts();
            print_error(&error);
            print_warnings(&warnings);
            return;
        }
    };
    let (report, warnings) = report.into_parts();

    print_warnings(&warnings);

    let generate::Report {
        tariff_id,
        tariff_currency_code,
        partial_cdr,
    } = report;

    println!("CDR genereated for tariff with id: `{tariff_id}` and currency code: `{tariff_currency_code}`");
    println!("{partial_cdr:#?}");
}

examples/price_cdr_with_unknown_version.rs (line 18)

fn main() {
    const CDR_JSON: &str =
        include_str!("../test_data/v211/real_world/time_and_parking_time/cdr.json");

    // First the raw JSON should be parsed into a `cdr::Versioned` object.
    // The `cdr::Report` returned from calling `cdr::parse` contains a `cdr::Versioned` object
    // and a potential list of unexpected fields based on the OCPI v221 spec.
    let cdr = cdr::parse(CDR_JSON).expect("Unable to parse CDR JSON");

    // The guessed Version can be either certain or uncertain.
    // In this case we discard the CDR object and try to convert it into a version.
    // If the version is uncertain then fallback to presuming the CDR is v211.
    let cdr = cdr.certain_or(Version::V211);

    // The timezone can be inferred or found in the CDR, but a versioned CDR is required.
    let timezone = match timezone::find_or_infer(&cdr) {
        Ok(tz) => tz,
        Err(err_set) => {
            let (error, warnings) = err_set.into_parts();
            eprintln!("Unable to infer timezone");
            print_timezone_error(&error);
            print_timezone_warnings(&warnings);
            return;
        }
    };
    let (timezone_source, warnings) = timezone.into_parts();

    if !warnings.is_empty() {
        print_timezone_warnings(&warnings);
    }

    // We don't care whether the timezone was found or inferred.
    let timezone = timezone_source.into_timezone();
    let report = cdr::parse_with_version(CDR_JSON, Version::V211).expect("Unable to parse CDR");
    let cdr::ParseReport {
        cdr,
        unexpected_fields,
    } = report;

    if !unexpected_fields.is_empty() {
        eprintln!("Strange... there are fields in the CDR that are not defined in the spec.");

        for path in &unexpected_fields {
            eprintln!("{path}");
        }
    }

    let report = match cdr::price(&cdr, price::TariffSource::UseCdr, timezone) {
        Ok(r) => r,
        Err(set) => {
            let (error, warnings) = set.into_parts();
            print_pricing_error(&error);
            print_pricing_warnings(&warnings);
            return;
        }
    };

    let (report, warnings) = report.into_parts();

    print_pricing_warnings(&warnings);

    // The various fields of the `price::Report` can be examined or converted to JSON.
    let price::Report {
        periods: _,
        tariff_used: _,
        tariff_reports: _,
        timezone: _,
        billed_energy: _,
        billed_parking_time: _,
        total_charging_time: _,
        billed_charging_time: _,
        total_cost: _,
        total_fixed_cost: _,
        total_time: _,
        total_time_cost: _,
        total_energy: _,
        total_energy_cost: _,
        total_parking_time: _,
        total_parking_cost: _,
        total_reservation_cost: _,
    } = report;
}

pub fn certain_or_none(self) -> Option<V>

Return Some OCPI object if it’s Versioned. Otherwise, return None if the object’s version is uncertain.

Trait Implementations

impl<V, U> Debug for Version<V, U>

where V: Versioned + Debug, U: Debug + Debug,

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

Formats the value using the given formatter.