ion 0.12.0

*.ion file parser
Documentation
use criterion::{Criterion, black_box, criterion_group, criterion_main};
use ion::{Ion, Parser};
use std::str::FromStr;

const DEF_HOTEL_ON_START: &str = include_str!("data/def_hotel_on_start.ion");
const DEF_HOTEL_ON_END: &str = include_str!("data/def_hotel_on_end.ion");
const FILTERED_SECTIONS: &[&str] = &["CONTRACT", "DEF.HOTEL"];

#[cfg(feature = "dictionary-indexmap")]
const BACKEND: &str = "indexmap";
#[cfg(not(feature = "dictionary-indexmap"))]
const BACKEND: &str = "btree";

fn bench_name(name: &str) -> String {
    format!("{name}_{BACKEND}")
}

fn parse_benches(c: &mut Criterion) {
    let mut group = c.benchmark_group(format!("parse_{BACKEND}"));

    group.bench_function(bench_name("section_on_start_of_ion"), |b| {
        b.iter(|| {
            let result = Ion::from_str(DEF_HOTEL_ON_START);
            black_box(result.unwrap())
        })
    });

    group.bench_function(bench_name("section_on_end_of_ion"), |b| {
        b.iter(|| {
            let result = Ion::from_str(DEF_HOTEL_ON_END);
            black_box(result.unwrap())
        })
    });

    group.bench_function(bench_name("section_on_start_of_ion_tuned_parser"), |b| {
        b.iter(|| {
            let result = Parser::new(DEF_HOTEL_ON_START)
                .with_row_capacity(12)
                .with_array_capacity(4)
                .with_section_capacity(1024)
                .read();

            black_box(result.unwrap())
        })
    });

    group.bench_function(
        bench_name("section_on_start_of_ion_parser_no_prealloc"),
        |b| {
            b.iter(|| {
                let result = Parser::new(DEF_HOTEL_ON_START)
                    .with_row_capacity(0)
                    .with_array_capacity(0)
                    .with_section_capacity(0)
                    .read();

                black_box(result.unwrap())
            })
        },
    );

    group.bench_function(bench_name("section_on_end_of_ion_tuned_parser"), |b| {
        b.iter(|| {
            let result = Parser::new(DEF_HOTEL_ON_END)
                .with_row_capacity(12)
                .with_array_capacity(4)
                .with_section_capacity(1024)
                .read();

            black_box(result.unwrap())
        })
    });

    group.bench_function(
        bench_name("section_on_end_of_ion_parser_no_prealloc"),
        |b| {
            b.iter(|| {
                let result = Parser::new(DEF_HOTEL_ON_END)
                    .with_row_capacity(0)
                    .with_array_capacity(0)
                    .with_section_capacity(0)
                    .read();

                black_box(result.unwrap())
            })
        },
    );

    group.finish();
}

fn parse_filtered_benches(c: &mut Criterion) {
    let mut group = c.benchmark_group(format!("parse_filtered_{BACKEND}"));

    group.bench_function(bench_name("section_on_start_of_ion"), |b| {
        b.iter(|| {
            let result = Ion::from_str_filtered(DEF_HOTEL_ON_START, FILTERED_SECTIONS.to_vec());
            black_box(result.unwrap())
        })
    });

    group.bench_function(bench_name("section_on_end_of_ion"), |b| {
        b.iter(|| {
            let result = Ion::from_str_filtered(DEF_HOTEL_ON_END, FILTERED_SECTIONS.to_vec());
            black_box(result.unwrap())
        })
    });

    group.finish();
}

fn backend_benches(c: &mut Criterion) {
    let mut group = c.benchmark_group(format!("backend_{BACKEND}"));

    group.bench_function(bench_name("to_string_hotel"), |b| {
        let ion = Ion::from_str(DEF_HOTEL_ON_START).unwrap();
        b.iter(|| black_box(ion.to_string()))
    });

    group.bench_function(bench_name("read_hotel"), |b| {
        b.iter(|| {
            let result = Parser::new(DEF_HOTEL_ON_START).read();
            black_box(result.unwrap())
        })
    });

    group.finish();
}

criterion_group!(
    benches,
    parse_benches,
    parse_filtered_benches,
    backend_benches
);
criterion_main!(benches);