citum-refs 0.79.0

/*
SPDX-License-Identifier: MIT OR Apache-2.0
SPDX-FileCopyrightText: © 2023-2026 Bruce D'Arcus and Citum contributors
*/

//! BibLaTeX bibliography loading and entry/field mapping helpers.
//!
//! [`load_biblatex`] and [`parse_biblatex_str`] are the I/O entry points; the
//! entry/field → `InputReference` conversion logic lives in a private
//! `mapping` submodule and is re-exported here
//! ([`input_reference_from_biblatex`],
//! [`contributors_from_biblatex_persons`]).

mod mapping;
mod tables;

use std::fs;
use std::path::Path;

use citum_schema::InputBibliography;

pub use mapping::{contributors_from_biblatex_persons, input_reference_from_biblatex};
pub use tables::{
    BiblatexEntryTypeDescriptor, BiblatexFieldDescriptor, biblatex_entry_type_descriptors,
    biblatex_field_descriptors,
};

use crate::RefsError;

/// Parse BibLaTeX bibliography content from an in-memory string.
///
/// This is the core parsing primitive; [`load_biblatex`] delegates to it after
/// reading the file.
///
/// # Errors
///
/// Returns an error when `src` cannot be parsed as valid BibLaTeX.
pub fn parse_biblatex_str(src: &str) -> Result<InputBibliography, RefsError> {
    let bibliography = ::biblatex::Bibliography::parse(src)
        .map_err(|e| RefsError::ParseError("BibLaTeX".to_string(), e.to_string()))?;
    let references = bibliography
        .iter()
        .map(mapping::input_reference_from_biblatex)
        .collect();
    Ok(InputBibliography {
        references,
        ..Default::default()
    })
}

/// Load a BibLaTeX bibliography from a file path.
///
/// # Errors
///
/// Returns an error when the file cannot be read or parsed as BibLaTeX.
pub fn load_biblatex(path: &Path) -> Result<InputBibliography, RefsError> {
    let src = fs::read_to_string(path)?;
    parse_biblatex_str(&src)
}