wolfxl-core 0.6.0

Pure-Rust xlsx reader with Excel number-format-aware cell rendering. Backs the wolfxl-cli previewer.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

//! wolfxl-core: pure-Rust xlsx reader with Excel number-format-aware rendering.
//!
//! This crate carries no PyO3 / Python coupling. It opens xlsx workbooks via
//! [`calamine-styles`], exposes a `Workbook → Sheet → Cell` API, and renders
//! cell values with awareness of common Excel number formats (currency,
//! percentage, scientific, date, time).
//!
//! ```no_run
//! use wolfxl_core::Workbook;
//!
//! let mut wb = Workbook::open("examples/sample-financials.xlsx")?;
//! let sheet = wb.first_sheet()?;
//! let (rows, cols) = sheet.dimensions();
//! println!("{} rows × {} columns", rows, cols);
//! # Ok::<_, wolfxl_core::Error>(())
//! ```
//!
//! ## Scope
//!
//! - **In scope today:** read xlsx values + best-effort number-format strings,
//!   classify formats into [`FormatCategory`], render via [`format_cell`], map
//!   workbook structure, and infer per-column schema/cardinality summaries.
//! - **Not yet:** full `xl/styles.xml` cellXfs walker (style ids fall back to
//!   None for fixtures generated by openpyxl), write side.
//!
//! The existing PyO3 layer in the sibling `wolfxl` cdylib still owns its own
//! implementation; unifying the two is follow-up work.

pub mod cell;
pub mod error;
pub mod format;
pub mod map;
pub mod schema;
pub mod sheet;
pub mod workbook;

pub use cell::{Cell, CellValue};
pub use error::{Error, Result};
pub use format::{format_cell, FormatCategory};
pub use map::{classify_sheet, SheetClass, SheetMap, WorkbookMap};
pub use schema::{infer_sheet_schema, Cardinality, ColumnSchema, InferredType, SheetSchema};
pub use sheet::Sheet;
pub use workbook::Workbook;