1. Des produits
  2.   Tableur
  3.   Rust
  4.   calamine

calamine

 
 

Bibliothèque Rust pure pour les feuilles de calcul

Lisez les fichiers XLS, XLSX, XLSM, XLSB, ODS & plus avec une désérialisation sans copie en Rust.

Qu’est-ce que calamine ?

calamine est une bibliothèque Rust pure, haute performance, destinée à la lecture et à la désérialisation des fichiers de classeur Excel et OpenDocument. Elle prend en charge des formats tels que XLS, XLSX, XLSM, XLSB, ODS, et plus encore, en se concentrant sur une extraction de données rapide, sûre et sans copie. Conçue pour la fiabilité et avec un minimum de dépendances, calamine évite les bibliothèques système externes et repose uniquement sur des implémentations Rust pures. Son API permet aux développeurs d'extraire efficacement les valeurs des cellules, de gérer les projets VBA et d'analyser les formules sans configuration complexe ni surcharge d'exécution.

La bibliothèque excelle dans les applications critiques en termes de performances, offrant un traitement nettement plus rapide que les alternatives en Python, C# et Go. Grâce à l'intégration native de Serde, calamine permet un mappage fluide des données de classeur vers des structures Rust. Elle prend en charge le chargement paresseux pour les gros fichiers, la configuration de la ligne d'en-tête, ainsi que des fonctionnalités optionnelles telles que le support des dates/horaires avec chrono et l'extraction des données d'images. Que vous construisiez des outils CLI, des back‑ends web ou des systèmes embarqués, calamine offre des performances robustes et prévisibles sur toutes les plateformes.

Previous Next

Premiers pas avec calamine

Pour commencer à utiliser calamine, ajoutez‑le à votre projet Rust via Cargo. Vous pouvez l’installer directement en utilisant cargo add calamine ou ajouter manuellement la dépendance à votre Cargo.toml. La bibliothèque est disponible sur crates.io et son code source est hébergé sur calamine GitHub. Pour une utilisation avancée, activez les fonctionnalités optionnelles comme chrono pour la prise en charge des dates/heure ou picture pour l’extraction de données d’image. La bibliothèque se compile proprement sur Rust stable et ne nécessite aucun binaire ou bibliothèque système externe.

Installer calamine via Cargo

cargo add calamine

Désérialisation de feuilles de calcul basée sur Serde

calamine fournit une intégration puissante de Serde pour mapper les données de feuilles de calcul directement aux structures Rust. En utilisant RangeDeserializerBuilder, les développeurs peuvent définir des modèles de données fortement typés et désérialiser automatiquement les lignes en enregistrements structurés. La bibliothèque inclut des fonctions d'aide comme deserialize_as_f64_or_none et deserialize_as_f64_or_string pour gérer gracieusement les colonnes de types mixtes. Cette approche garantit la sécurité des types, réduit le code boilerplate et permet la validation à la compilation des structures de données. Elle est particulièrement utile pour les pipelines de données, les outils de reporting et les applications ETL où la fiabilité et les performances sont critiques.

Désérialiser les lignes de feuilles de calcul en structures Rust

use calamine::{deserialize_as_f64_or_none, open_workbook, RangeDeserializerBuilder, Reader, Xlsx};
use serde::Deserialize;

#[derive(Deserialize)]
struct Record {
    metric: String,
    #[serde(deserialize_with = "deserialize_as_f64_or_none")]
    value: Option,
}

let mut excel: Xlsx<_> = open_workbook("file.xlsx")?;
let range = excel.worksheet_range("Sheet1")?;
let iter = RangeDeserializerBuilder::with_headers(&["metric", "value"]).from_range(&range)?;
for result in iter {
    let record: Record = result?;
    println!("{:?}", record);
}

Extraction de projets VBA et de formules

calamine permet l'extraction des modules de projet VBA et des définitions de formules à partir des fichiers Excel. Les développeurs peuvent récupérer le code VBA des modules, détecter les références cassées et inspecter les noms définis ainsi que leurs formules. Cette capacité est essentielle pour les outils de migration, les utilitaires d'audit et l'analyse des systèmes hérités. L'API fournit un accès structuré aux métadonnées VBA et prend en charge à la fois les scénarios d'introspection de classeur simples et complexes. Que vous analysiez des macros pour la sécurité ou que vous convertissiez la logique Excel héritée, calamine offre un accès précis et de bas niveau au contenu caché du classeur.

Extraire le code VBA et les noms définis

use calamine::{open_workbook_auto, Reader};

let mut workbook = open_workbook_auto("file.xlsx")?;
if let Ok(Some(vba)) = workbook.vba_project() {
    let module = vba.get_module("Module1").unwrap();
    println!("{}", module);
    for ref in vba.get_references() {
        if ref.is_missing() { println!("Broken: {}", ref.name); }
    }
}
for (name, formula) in workbook.defined_names() {
    println!("{}: {}", name, formula);
}

Chargement paresseux et gestion des gros fichiers

calamine prend en charge le chargement paresseux des fichiers XLSX et XLSB, permettant un traitement efficace de grandes feuilles de calcul sans charger toutes les feuilles en mémoire simultanément. En configurant les lignes d'en-tête et en utilisant une itération basée sur des plages, les développeurs peuvent réduire l'empreinte mémoire et maximiser le débit. Cette fonctionnalité est particulièrement précieuse pour les fonctions serverless, les outils CLI et les déploiements embarqués où les ressources sont limitées. Les benchmarks montrent que calamine lit plus d'un million de lignes avec une surcharge mémoire minimale comparée à des alternatives comme openpyxl et ClosedXML, ce qui le rend idéal pour les pipelines d'ingestion de données à grande échelle.

Traiter efficacement de grands classeurs

use calamine::{open_workbook, Reader, Xlsx};

let mut excel: Xlsx<_> = open_workbook("large.xlsx")?;
let range = excel
    .worksheet_range("Sheet1")?
    .expect("Sheet not found");

for row in range.rows() {
    // Process row without loading entire file
    process_row(row);
}

Performance Optimization and Benchmarks

calamine offre des performances exceptionnelles, traitant 41 millions de cellules en moins de 25 secondes—dépassant les bibliothèques Python, C# et Go jusqu’à 9,4 fois. Son architecture zéro copie et ses allocations de tas minimales réduisent considérablement l’utilisation du CPU et de la mémoire. Les benchmarks sur un fichier XLSX de 186 Mo montrent que calamine n’utilise que 186 Mo de lectures disque contre 1,5 Go pour excelize. Le comportement mémoire déterministe de la bibliothèque et la faible pression du ramasse-miettes la rendent adaptée aux applications en temps réel et sensibles à la latence. Les développeurs bénéficient d’une utilisation prévisible des ressources et d’un débit constant sur des charges de travail diverses.

 Français