
umya-spreadsheet
XLSX/XLSM फ़ाइलों के लिए शुद्ध रस्ट लाइब्रेरी
शून्य बाहरी निर्भरताओं के साथ XLSX/XLSM स्प्रेडशीट को पढ़ें, लिखें, शैली दें और संशोधित करें।
umya-spreadsheet क्या है?
umya-spreadsheet एक उच्च-प्रदर्शन, शुद्ध Rust लाइब्रेरी है जो XLSX और XLSM फ़ॉर्मेट में Excel स्प्रेडशीट फ़ाइलों को पढ़ने और लिखने के लिए उपयोग की जाती है। सुरक्षा और दक्षता के लिए डिज़ाइन की गई, यह असुरक्षित कोड और बाहरी निर्भरताओं से बचती है, जिससे यह डेस्कटॉप एप्लिकेशन, सर्वर-साइड प्रोसेसिंग, और WebAssembly वातावरण के लिए आदर्श बनती है। लाइब्रेरी एक साफ़, इडियोमैटिक Rust API प्रदान करती है जो सेल, पंक्तियों, कॉलम, शैलियों, चार्ट और छवियों तक पहुँच प्रदान करती है, जिससे डेवलपर्स Microsoft Office या COM इंटरऑप पर निर्भर हुए बिना मजबूत स्प्रेडशीट टूल बना सकते हैं।
पूरी तरह से लेज़ी लोडिंग, पासवर्ड सुरक्षा, और समृद्ध फ़ॉर्मेटिंग का समर्थन करने वाले umya-spreadsheet प्रदर्शन और उपयोगिता के बीच अंतर को पाटता है। यह CSV निर्यात, चार्ट जनरेशन, छवि एम्बेडिंग, और रेंज ऑपरेशन्स जैसे ले जाना और कॉपी करना को समर्थन देता है। यह प्रोजेक्ट सक्रिय रूप से मेंटेन किया जाता है, अच्छी तरह से दस्तावेज़ीकृत है, और परीक्षण किया गया है, जिसमें सहीपन और आधुनिक Excel सुविधाओं के साथ संगतता पर ध्यान दिया गया है। डेवलपर्स इसे CLI टूल्स, वेब बैकएंड्स, या डेस्कटॉप ऐप्स में Tauri या Axo जैसे फ्रेमवर्क का उपयोग करके एकीकृत कर सकते हैं।
umya-spreadsheet के साथ शुरूआत
umya-spreadsheet का उपयोग शुरू करने के लिए, इसे अपने Cargo.toml में `umya-spreadsheet = "3.1.1"` के साथ जोड़ें। WebAssembly समर्थन के लिए, `js` फीचर को सक्षम करें। यह लाइब्रेरी निर्भरता‑कम है और तेज़ी से संकलित होती है। स्थापित करने के बाद, इसे `extern crate umya_spreadsheet;` के माध्यम से इम्पोर्ट करें और स्प्रेडशीट पढ़ना या लिखना शुरू करें। आप उदाहरण, परीक्षण और दस्तावेज़ीकरण के लिए umya-spreadsheet GitHub भी देख सकते हैं। यह बड़े फ़ाइलों के लिए लेज़ी लोडिंग का समर्थन करता है और मजबूत त्रुटि प्रबंधन प्रदान करता है।
Cargo के माध्यम से umya-spreadsheet स्थापित करें
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
XLSX/XLSM फ़ाइलें पढ़ें और लिखें
umya-spreadsheet XLSX और XLMS फ़ाइलों को पढ़ने और लिखने के लिए सहज API प्रदान करता है। डिस्क से वर्कबुक लोड करने के लिए `reader::xlsx::read()` का उपयोग करें, या एक खाली वर्कबुक बनाने के लिए `new_file()` का उपयोग करें। लेखन भी उतना ही सरल है: वर्कबुक और लक्ष्य पथ के साथ `writer::xlsx::write()` को कॉल करें। लाइब्रेरी बड़े फ़ाइलों पर बेहतर प्रदर्शन के लिए `lazy_read()` के माध्यम से लेज़ी लोडिंग का समर्थन करती है, और पासवर्ड‑संरक्षित लेखन या निर्माण के बाद पासवर्ड सेट करने की सुविधा देती है। सभी ऑपरेशन सुरक्षित हैं, जहाँ संभव हो ज़ीरो‑कॉपी होते हैं, और बाहरी बाइनरीज़ से बचते हैं।
Rust के माध्यम से XLSX फ़ाइल को कैसे पढ़ें और लिखें?
use std::path::Path;
// Read file
let path = Path::new("./input.xlsx");
let mut book = umya_spreadsheet::reader::xlsx::read(path).unwrap();
// Write file
let out_path = Path::new("./output.xlsx");
umya_spreadsheet::writer::xlsx::write(&book, out_path).unwrap();
सेल एक्सेस और शैली संशोधन
सेल मानों तक पहुंचना और उन्हें संशोधित करना सरल है: पढ़ने के लिए `cell("A1")` या `cell((1,1))` का उपयोग करें, और लिखने के लिए `cell_mut()` का उपयोग करें। शैलियों को `style_mut()` के माध्यम से प्रबंधित किया जाता है, जिससे पृष्ठभूमि रंग, फ़ॉन्ट, बॉर्डर और संरेखण में परिवर्तन संभव होते हैं। लाइब्रेरी संभव होने पर अपरिवर्तनीयता की गारंटी रखते हुए शैली गुणों का समृद्ध सेट प्रदान करती है। आप स्वरूपित मानों को पुनः प्राप्त कर सकते हैं, शर्तीय लॉजिक लागू कर सकते हैं, और रेंजों में शैलियों को बैच में अपडेट कर सकते हैं। यह निरंतर स्वरूपण के साथ रिपोर्ट, डैशबोर्ड या डेटा निर्यात उत्पन्न करने के लिए आदर्श बनाता है।
Rust के माध्यम से सेल मान और शैली को कैसे संशोधित करें?
let mut book = umya_spreadsheet::new_file();
book.sheet_by_name_mut("Sheet1")
.unwrap()
.cell_mut("A1")
.set_value("Hello, Rust!");
let mut style = book.sheet_by_name_mut("Sheet1")
.unwrap()
.style_mut("A1");
style.set_background_color(umya_spreadsheet::Color::COLOR_RED);
चार्ट और छवि समर्थन
umua-spreadsheet चार्ट बनाने और संपादित करने का समर्थन करता है—लाइन, बार, और एरिया चार्ट सहित—सीरीज़ रेंज और मार्कर परिभाषित करके। आप `Image` स्ट्रक्ट का उपयोग करके छवियों को सीधे शीट्स में एम्बेड कर सकते हैं, जिसमें PNG और अन्य फ़ॉर्मेट्स का समर्थन शामिल है, जो सक्षम सुविधाओं पर निर्भर करता है। चार्ट और छवियां सेल कोऑर्डिनेट्स और ड्राइंग लेयर्स के साथ सहजता से एकीकृत होती हैं, जिससे डायनेमिक डैशबोर्ड जनरेशन संभव होता है। जबकि कुछ उन्नत ड्राइंग सुविधाएँ अभी विकसित हो रही हैं, कोर फ़ंक्शनैलिटी प्रोडक्शन-रेडी और विस्तारणीय है।
Rust के माध्यम से स्प्रेडशीट में लाइन चार्ट कैसे जोड़ें?
let mut book = umya_spreadsheet::new_file();
let mut from_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
from_marker.set_coordinate("C1");
let mut to_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
to_marker.set_coordinate("D11");
let series = vec!["Sheet1!$A$1:$A$10", "Sheet1!$B$1:$B$10"];
let mut chart = umya_spreadsheet::structs::Chart::default();
chart.new_chart(
umya_spreadsheet::structs::ChartType::LineChart,
from_marker,
to_marker,
series,
);
book.sheet_by_name_mut("Sheet1")
.unwrap()
.add_chart(chart);
रेंज ऑपरेशन और पासवर्ड सुरक्षा
`move_range()` का उपयोग करके रेंज को मूव, कॉपी और रिसाइज़ जैसे उन्नत ऑपरेशन्स करें, जिससे डायनेमिक डेटा पुनर्गठन संभव हो सके। लाइब्रेरी पासवर्ड-प्रोटेक्टेड वर्कबुक का भी समर्थन करती है: `write_with_password()` से फ़ाइलें लिखें या `set_password()` के माध्यम से मौजूदा फ़ाइलों पर पासवर्ड लागू करें। ये सुविधाएँ एंटरप्राइज़ या अनुपालन-संवेदनशील एप्लिकेशन्स में सुरक्षित डेटा हैंडलिंग के लिए महत्वपूर्ण हैं। शून्य-निर्भरता डिज़ाइन और WASM संगतता के साथ मिलकर, umua-spreadsheet लचीलापन और सुरक्षा दोनों प्रदान करता है।
Rust के माध्यम से रेंज को कैसे ले जाएँ और पासवर्ड के साथ फ़ाइल को सुरक्षित करें?
// Move range
let range = "A1:A3";
book.sheet_by_name_mut("Sheet1")
.unwrap()
.move_range(range, &10, &2);
// Password protection
umya_spreadsheet::writer::xlsx::write_with_password(
&book,
Path::new("./protected.xlsx"),
"mypassword",
).unwrap();
