
calamine
स्प्रेडशीट के लिए शुद्ध Rust लाइब्रेरी
Rust में शून्य-प्रतिलिपि डीसीरियलाइज़ेशन के साथ XLS, XLSX, XLSM, XLSB, ODS और अधिक पढ़ें।
calamine क्या है?
calamine एक उच्च-प्रदर्शन, शुद्ध Rust लाइब्रेरी है जो Excel और OpenDocument स्प्रेडशीट फ़ाइलों को पढ़ने और डीसीरियलाइज़ करने के लिए उपयोग होती है। यह XLS, XLSX, XLSM, XLSB, ODS आदि जैसे फ़ॉर्मैट्स का समर्थन करती है, और तेज़, सुरक्षित और ज़ीरो-कॉपी डेटा निष्कर्षण पर केंद्रित है। विश्वसनीयता और न्यूनतम निर्भरताओं के लिए डिज़ाइन की गई, calamine बाहरी सिस्टम लाइब्रेरीज़ से बचती है और केवल शुद्ध Rust कार्यान्वयन पर निर्भर करती है। इसका API डेवलपर्स को सेल मानों को कुशलतापूर्वक निकालने, VBA प्रोजेक्ट्स को संभालने, और जटिल सेटअप या रनटाइम ओवरहेड के बिना फ़ॉर्मूले पार्स करने में सक्षम बनाता है।
यह लाइब्रेरी प्रदर्शन-सम्बंधी महत्वपूर्ण अनुप्रयोगों में उत्कृष्ट है, और Python, C#, तथा Go विकल्पों की तुलना में काफी तेज़ प्रोसेसिंग प्रदान करती है। अंतर्निहित Serde एकीकरण के साथ, calamine स्प्रेडशीट डेटा को Rust स्ट्रक्ट्स में सहजता से मैप करने की सुविधा देती है। यह बड़े फ़ाइलों के लिए लेज़ी लोडिंग, हेडर रो कॉन्फ़िगरेशन, और वैकल्पिक सुविधाएँ जैसे chrono तिथि/समय समर्थन और चित्र डेटा निष्कर्षण का समर्थन करती है। चाहे आप CLI टूल्स, वेब बैकएंड्स, या एम्बेडेड सिस्टम बना रहे हों, calamine विभिन्न प्लेटफ़ॉर्म पर मजबूत, पूर्वानुमेय प्रदर्शन प्रदान करती है।
calamine के साथ शुरूआत
calamine का उपयोग शुरू करने के लिए, इसे अपने Rust प्रोजेक्ट में Cargo के माध्यम से जोड़ें। आप इसे सीधे cargo add calamine का उपयोग करके स्थापित कर सकते हैं या मैन्युअल रूप से अपनी Cargo.toml में निर्भरता जोड़ सकते हैं। यह लाइब्रेरी crates.io पर उपलब्ध है और इसका स्रोत कोड calamine GitHub पर होस्ट किया गया है। उन्नत उपयोग के लिए, chrono जैसी वैकल्पिक सुविधाएँ तिथि/समय समर्थन के लिए या picture छवि डेटा निष्कर्षण के लिए सक्षम करें। यह लाइब्रेरी स्थिर Rust पर साफ़-सुथरे ढंग से संकलित होती है और किसी भी बाहरी बाइनरी या सिस्टम लाइब्रेरी की आवश्यकता नहीं होती।
Cargo के माध्यम से calamine स्थापित करें
cargo add calamineSerde-आधारित स्प्रेडशीट डीसीरियलाइज़ेशन
calamine शक्तिशाली Serde एकीकरण प्रदान करता है जो स्प्रेडशीट डेटा को सीधे Rust structs में मैप करता है। RangeDeserializerBuilder का उपयोग करके, डेवलपर्स सख्त-टाइप्ड डेटा मॉडल परिभाषित कर सकते हैं और पंक्तियों को स्वचालित रूप से संरचित रिकॉर्ड में डीसिरियलाइज़ कर सकते हैं। लाइब्रेरी में deserialize_as_f64_or_none और deserialize_as_f64_or_string जैसी सहायक फ़ंक्शन शामिल हैं जो मिश्रित-प्रकार कॉलम को सहजता से संभालते हैं। यह दृष्टिकोण टाइप सुरक्षा सुनिश्चित करता है, बायलरप्लेट को कम करता है, और डेटा संरचनाओं की कंपाइल-टाइम वैधता सक्षम करता है। यह विशेष रूप से डेटा पाइपलाइन, रिपोर्टिंग टूल्स, और ETL अनुप्रयोगों के लिए उपयोगी है जहाँ विश्वसनीयता और प्रदर्शन महत्वपूर्ण हैं।
स्प्रेडशीट पंक्तियों को 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);
} VBA प्रोजेक्ट और फ़ॉर्मूला निष्कर्षण
calamine Excel फ़ाइलों से VBA प्रोजेक्ट मॉड्यूल और फ़ॉर्मूला परिभाषाओं को निकालने में सक्षम बनाता है। डेवलपर्स मॉड्यूल से VBA कोड प्राप्त कर सकते हैं, टूटे हुए रेफ़रेंसेज़ का पता लगा सकते हैं, और परिभाषित नामों तथा उनके फ़ॉर्मूले की जांच कर सकते हैं। यह क्षमता माइग्रेशन टूल्स, ऑडिट यूटिलिटीज़ और लेगेसी सिस्टम विश्लेषण के लिए आवश्यक है। API VBA मेटाडेटा तक संरचित पहुँच प्रदान करती है और सरल तथा जटिल वर्कबुक इंट्रोस्पेक्शन परिदृश्यों दोनों का समर्थन करती है। चाहे आप सुरक्षा के लिए मैक्रो का विश्लेषण कर रहे हों या लेगेसी Excel लॉजिक को परिवर्तित कर रहे हों, calamine छिपी हुई वर्कबुक सामग्री तक सटीक, लो-लेवल पहुँच प्रदान करता है।
VBA कोड और परिभाषित नाम निकालें
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);
}लेज़ी लोडिंग और बड़े फ़ाइल हैंडलिंग
calamine XLSX और XLSB फ़ाइलों के लिए लेज़ी लोडिंग का समर्थन करता है, जिससे बड़ी स्प्रेडशीट्स को एक बार में सभी शीट्स को मेमोरी में लोड किए बिना कुशलतापूर्वक प्रोसेस किया जा सकता है। हेडर पंक्तियों को कॉन्फ़िगर करके और रेंज-आधारित इटरेशन का उपयोग करके, डेवलपर्स मेमोरी फुटप्रिंट को न्यूनतम और थ्रूपुट को अधिकतम कर सकते हैं। यह सुविधा विशेष रूप से सर्वरलेस फ़ंक्शन्स, CLI टूल्स, और एम्बेडेड डिप्लॉयमेंट्स के लिए मूल्यवान है जहाँ संसाधन सीमित होते हैं। बेंचमार्क दिखाते हैं कि calamine 1M+ पंक्तियों को न्यूनतम मेमोरी ओवरहेड के साथ पढ़ता है, जो openpyxl और ClosedXML जैसे विकल्पों की तुलना में अधिक है, जिससे यह उच्च-स्केल डेटा इन्ज़ेशन पाइपलाइनों के लिए आदर्श बनता है।
बड़े स्प्रेडशीट्स को कुशलतापूर्वक प्रोसेस करें
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);
}प्रदर्शन अनुकूलन और बेंचमार्क
calamine असाधारण प्रदर्शन प्रदान करता है, 41 मिलियन कोशिकाओं को 25 सेकंड से कम समय में प्रोसेस करता है—Python, C#, और Go लाइब्रेरीज़ को 9.4 गुना तक पीछे छोड़ता है। इसका ज़ीरो-कॉपी डिज़ाइन और न्यूनतम हीप आवंटन CPU और मेमोरी उपयोग को काफी कम करते हैं। 186MB XLSX फ़ाइल पर बेंचमार्क दिखाते हैं कि calamine केवल 186MB डिस्क रीड्स का उपयोग करता है, जबकि excelize के लिए 1.5GB है। लाइब्रेरी का निर्धारक मेमोरी व्यवहार और कम GC दबाव इसे रीयल-टाइम और लेटेंसी-संवेदनशील अनुप्रयोगों के लिए उपयुक्त बनाते हैं। डेवलपर्स को पूर्वानुमेय संसाधन उपयोग और विविध कार्यभार में स्थिर थ्रूपुट मिलता है।
