zahirscan 0.3.6

//! Structured formats: CSV, HTML, JSON, EPUB, PDF, columnar binaries
//! (Parquet, Arrow IPC, Avro, ORC), `NumPy` (NPY/NPZ), MATLAB (`.mat`),
//! HDF5, `NetCDF`, Matrix Market (`.mtx`), Zarr, and Tetration (`.tet`).

pub mod constants;

mod columnar;
mod csv;
mod epub;
mod hdf5;
mod html;
mod json;
mod mat;
mod mtx;
mod netcdf;
mod numpy;
mod pdf;
mod pickle;
mod table_sample_profile;
pub mod tensor3d;
mod tetration;
mod zarr;

pub use columnar::*;
pub use csv::{
    delimiter_byte_for_reader, detect_delimiter_byte, extract_csv_metadata, extract_csv_templates,
};
pub use epub::{extract_epub_metadata, extract_epub_templates};
pub use hdf5::{extract_hdf5_metadata, extract_hdf5_templates};
pub use html::{extract_html_metadata, extract_html_templates};
pub use json::{extract_json_metadata, extract_json_templates};
pub use mat::{extract_mat_metadata, extract_mat_templates};
pub use mtx::{extract_mtx_metadata, extract_mtx_templates};
pub use netcdf::{extract_netcdf_metadata, extract_netcdf_templates};
pub use numpy::*;
pub use pdf::{extract_pdf_metadata, extract_pdf_templates};
pub use pickle::{extract_pickle_metadata, extract_pickle_templates};
pub use table_sample_profile::*;
pub use tetration::{extract_tetration_metadata, extract_tetration_templates};
pub use zarr::extract_zarr_metadata;

use anyhow::Result;
use memmap2::Mmap;

use crate::config::RuntimeConfig;
use crate::parsers::{FileType, ParseResult};
use crate::results::MiningResult;

/// Dispatch by file type; fills structured metadata fields and returns templates.
///
/// # Errors
///
/// Returns an error if the mmap is not valid UTF-8 where required, or if a structured parser fails.
pub fn process(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    match stats.file_type {
        FileType::Csv => structured_csv(stats, mmap, config),
        FileType::Json => structured_json(stats, mmap, config),
        FileType::Epub => structured_epub(stats, mmap, config),
        FileType::Html => structured_html(stats, mmap, config),
        FileType::Pdf => structured_pdf(stats, mmap, config),
        FileType::Parquet => structured_parquet(stats, mmap, config),
        FileType::ArrowIpc => structured_arrow_ipc(stats, mmap, config),
        FileType::Avro => structured_avro(stats, mmap, config),
        FileType::Orc => structured_orc(stats, mmap, config),
        FileType::Npy => structured_npy(stats, mmap, config),
        FileType::Npz => structured_npz(stats, mmap, config),
        FileType::Hdf5 => structured_hdf5(stats, mmap, config),
        FileType::NetCdf => structured_netcdf(stats, mmap, config),
        FileType::Mtx => structured_mtx(stats, mmap, config),
        FileType::Mat => structured_mat(stats, mmap, config),
        FileType::Zarr => structured_zarr(stats, mmap, config),
        FileType::Tetration => structured_tetration(stats, mmap, config),
        FileType::Pickle => structured_pickle(stats, mmap, config),
        _ => unreachable!("structured::process called with {:?}", stats.file_type),
    }
}

fn structured_csv(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        csv_metadata,
        extract_csv_metadata(mmap, stats, config),
        crate::results::CsvMetadata,
        FileType::Csv,
        extract_csv_templates(mmap, stats, config)
    )
}

fn structured_json(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    let content = std::str::from_utf8(mmap)?;
    stats.json_metadata = Some(extract_json_metadata(content, stats));
    extract_json_templates(content, stats, config)
}

fn structured_epub(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        epub_metadata,
        extract_epub_metadata(mmap, stats, config),
        crate::results::EpubMetadata,
        FileType::Epub,
        extract_epub_templates(mmap, stats, config)
    )
}

fn structured_html(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        html_metadata,
        extract_html_metadata(mmap, stats, config),
        crate::results::HtmlMetadata,
        FileType::Html,
        extract_html_templates(mmap, stats, config)
    )
}

fn structured_pdf(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        pdf_metadata,
        extract_pdf_metadata(mmap, stats, config),
        crate::results::PdfMetadata,
        FileType::Pdf,
        extract_pdf_templates(mmap, stats, config)
    )
}

fn structured_parquet(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        parquet_metadata,
        extract_parquet_metadata(mmap, stats, config),
        crate::results::ParquetMetadata,
        FileType::Parquet,
        extract_parquet_templates(mmap, stats, config)
    )
}

fn structured_arrow_ipc(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        arrow_ipc_metadata,
        extract_arrow_ipc_metadata(mmap, stats, config),
        crate::results::ArrowIpcMetadata,
        FileType::ArrowIpc,
        extract_arrow_ipc_templates(mmap, stats, config)
    )
}

fn structured_avro(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        avro_metadata,
        extract_avro_metadata(mmap, stats, config),
        crate::results::AvroMetadata,
        FileType::Avro,
        extract_avro_templates(mmap, stats, config)
    )
}

fn structured_orc(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        orc_metadata,
        extract_orc_metadata(mmap, stats, config),
        crate::results::OrcMetadata,
        FileType::Orc,
        extract_orc_templates(mmap, stats, config)
    )
}

fn structured_npy(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        npy_metadata,
        extract_npy_metadata(mmap, stats, config),
        crate::results::NpyMetadata,
        FileType::Npy,
        extract_npy_templates(mmap, stats, config)
    )
}

fn structured_npz(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        npz_metadata,
        extract_npz_metadata(mmap, stats, config),
        crate::results::NpzMetadata,
        FileType::Npz,
        extract_npz_templates(mmap, stats, config)
    )
}

fn structured_zarr(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        zarr_metadata,
        zarr::extract_zarr_metadata(&stats.file_path, stats, config),
        crate::results::ZarrMetadata,
        FileType::Zarr,
        zarr::extract_zarr_templates(mmap, stats, config)
    )
}

fn structured_tetration(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        tetration_metadata,
        extract_tetration_metadata(mmap, stats, config),
        crate::results::TetrationMetadata,
        FileType::Tetration,
        extract_tetration_templates(mmap, stats, config)
    )
}

fn structured_hdf5(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        hdf5_metadata,
        extract_hdf5_metadata(mmap, stats, config),
        crate::results::Hdf5Metadata,
        FileType::Hdf5,
        extract_hdf5_templates(mmap, stats, config)
    )
}

fn structured_netcdf(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        netcdf_metadata,
        extract_netcdf_metadata(mmap, stats, config),
        crate::results::NetCdfMetadata,
        FileType::NetCdf,
        extract_netcdf_templates(mmap, stats, config)
    )
}

fn structured_mtx(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        mtx_metadata,
        extract_mtx_metadata(mmap, stats, config),
        crate::results::MtxMetadata,
        FileType::Mtx,
        extract_mtx_templates(mmap, stats, config)
    )
}

fn structured_mat(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        mat_metadata,
        extract_mat_metadata(mmap, stats, config),
        crate::results::MatMetadata,
        FileType::Mat,
        extract_mat_templates(mmap, stats, config)
    )
}

fn structured_pickle(
    stats: &mut ParseResult,
    mmap: &Mmap,
    config: &RuntimeConfig,
) -> Result<MiningResult> {
    // Metadata-only: opcode walk extracts globals and content hints; no template mining.
    crate::process_with_metadata!(
        stats,
        mmap,
        config,
        pickle_metadata,
        extract_pickle_metadata(mmap, stats),
        crate::results::PickleMetadata,
        FileType::Pickle,
        extract_pickle_templates(mmap, stats, config)
    )
}