Function parse 

pub fn parse(cdr_json: &str) -> Result<CdrVersion<'_>, ParseError>

Parse the JSON and try guess the Version based on fields defined in the OCPI v2.1.1[^spec-v211] and v2.2.1[^spec-v221] CDR spec.

The parser is forgiving and will not complain if the CDR JSON is missing required fields. The parser will also not complain if unexpected fields are present in the JSON. The Version guess is based on fields that exist.

Example

let cdr = cdr::parse(CDR_JSON)?;

match cdr {
    guess::Version::Certain(cdr) => {
        println!("The CDR version is `{}`", cdr.version());
    },
    guess::Version::Uncertain(_cdr) => {
        eprintln!("Unable to guess the version of given CDR JSON.");
    }
}

---

1. https://github.com/ocpi/ocpi/blob/release-2.1.1-bugfixes/mod_cdrs.md ↩

2. https://github.com/ocpi/ocpi/blob/release-2.2.1-bugfixes/mod_cdrs.asciidoc ↩

Examples found in repository

examples/price_cdr_with_unknown_version.rs (line 13)

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 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_source, warnings) = timezone::find_or_infer(&cdr).into_parts();

    let Some(timezone_source) = timezone_source else {
        eprintln!("Unable to infer timezone");
        print_timezone_warnings(&cdr, &warnings.into_report());
        return;
    };

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

    // 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 =
        cdr::price(cdr, price::TariffSource::UseCdr, timezone).expect("unable to price CDR JSON");

    // The various fields of the `price::Report` can be examined or converted to JSON.
    let price::Report {
        warnings: _,
        periods: _,
        tariff: _,
        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;
}