
rust_xlsxwriter
Nyílt forráskódú Rust könyvtár Excel XLSX fájlokhoz
Excel 2007+ XLSX fájlok generálása teljes formázással, diagramokkal, képletekkel és képekkel Rust API-n keresztül.
Mi az a rust_xlsxwriter?
rust_xlsxwriter egy nagy teljesítményű, tiszta Rust crate az Excel XLSX fájlok generálásához, anélkül, hogy az Excelre vagy külső függőségekre lenne szükség. Lehetővé teszi a fejlesztők számára, hogy programozottan hozzanak létre táblázatokat szöveggel, számokkal, dátumokkal, képletekkel, diagramokkal, képekkel, egyesített cellákkal, feltételes formázással, adatellenőrzéssel és még sok mással. Megbízhatóságra és sebességre tervezve, szorosan követi az Excel natív fájlformátumát, és támogatja a konstans memória módot nagy adathalmazok esetén. A könyvtár hűséges Rust átírása a népszerű Python XlsxWriter könyvtárnak, idiomatikus API-kkal és átfogó dokumentációval.
rust_xlsxwriter kizárólag az Excel fájlok írására összpontosít — nem olvas vagy módosít meglévő fájlokat. Támogatja a modern Excel funkciókat, mint a dinamikus tömbök, sparklinek, jelölőnégyzetek, szövegdobozok, táblázatok, automatikus szűrők, definiált nevek és munkafüzet témák. Opcionális funkciókkal, mint a Serde sorosítás, chrono/jiff dátumtámogatás és a Polars integráció, alkalmazkodik a különféle Rust ökoszisztémákhoz. Teljesítménye csak a C verzió után áll, 3.8× gyorsabb végrehajtást biztosít a Python XlsxWriter-hez képest. A részletekért tekintse meg a rust_xlsxwriter GitHub tárolót.
Első lépések a rust_xlsxwriter használatával
rust_xlsxwriter elérhető a crates.io-n, és telepíthető a `cargo add rust_xlsxwriter` paranccsal. A kibővített funkcionalitáshoz engedélyezze az opcionális funkciókat, mint a `constant_memory`, `chrono`, `serde` vagy `polars`. A könyvtár Rust 1.56+ verziót igényel, és natív binárisokra fordul, külső futtatási függőségek nélkül, kivéve az alapértelmezett `zip` crate-et. Teljes dokumentációval rendelkezik, beleértve egy felhasználói útmutatót, oktatóanyagot és szakácskönyvet. Részletes példákért és forráskódért látogassa meg a rust_xlsxwriter GitHub tárolót.
A rust_xlsxwriter telepítése Cargo segítségével
cargo add rust_xlsxwriterFormázott cellák írása szöveggel, számokkal és dátumokkal
rust_xlsxwriter egyszerű és intuitív API-t biztosít a formázott tartalom Excel cellákba írásához. A fejlesztők a `Format` struktúra segítségével egyéni formátumokat alkalmazhatnak számokra, dátumokra, betűtípusokra, szegélyekre, igazításra és színekre. A könyvtár támogatja a egyszerű szöveg, numerikus értékek, dátumok, képletek és URL-ek írását opcionális formázással. Emellett támogatja a gazdag többformátumú karakterláncokat a cellán belüli vegyes formázáshoz. Ez ideálissá teszi jelentések, műszerfalak és adatexportok generálásához, ahol a vizuális tisztaság és struktúra elengedhetetlen. Az API magas hűséget biztosít az Excel natív formázó motorjával.
Hogyan írjunk formázott szöveget, számokat és dátumokat Rust segítségével?
use rust_xlsxwriter::*;
let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();
let bold = Format::new().set_bold();
let decimal = Format::new().set_num_format("0.00");
let date_fmt = Format::new().set_num_format("yyyy-mm-dd");
worksheet.write_with_format(0, 0, "Hello", &bold)?;
worksheet.write(1, 0, 123.456)?;
worksheet.write_with_format(2, 0, 789.012, &decimal)?;
let date = ExcelDateTime::from_ymd(2023, 12, 25)?;
worksheet.write_with_format(3, 0, &date, &date_fmt)?;
workbook.save("formatted.xlsx")?;Diagramok, sparklinek és képek létrehozása
rust_xlsxwriter támogatja professzionális diagramok, sparklinek és képek közvetlen beágyazását az Excel fájlokba. A fejlesztők oszlop-, vonal-, kör-, szórt- és területdiagramokat hozhatnak létre testreszabható tengelyekkel, jelmagyarázatokkal és adat sorozatokkal. A sparklinek kompakt trendábrázolást biztosítanak a cellákon belül. Képek (PNG, JPEG, GIF, BMP) beilleszthetők és elhelyezhetők méretezési és rögzítési beállításokkal. Ezek a vizuális elemek javítják az adatmesélés és jelentéskészítés képességeit. A könyvtár biztosítja a kompatibilitást az Excel 2007+ verziókkal, és megőrzi a megjelenítés pontosságát a különböző platformokon.
Hogyan adhatunk hozzá diagramot és képet az Excelhez Rust segítségével?
use rust_xlsxwriter::*;
let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();
// Write sample data
for i in 0..5 {
worksheet.write_number(i, 0, (i + 1) as f64 * 10.0)?;
}
// Create a chart
let mut chart = Chart::new(ChartType::Column);
chart.add_series().set_values("Sheet1!$A$1:$A$5");
worksheet.insert_chart(0, 2, &chart)?;
// Insert an image
let image = Image::new("logo.png")?;
worksheet.insert_image(5, 2, &image)?;
workbook.save("chart_image.xlsx")?;Speciális formázás: egyesített cellák, táblázatok és feltételes formázás
rust_xlsxwriter lehetővé teszi a fejlett Excel formázási funkciókat, mint például az egyesített tartományok, strukturált táblázatok, automatikus szűrők és feltételes formázási szabályok. A fejlesztők egyesíthetik a cellákat fejlécek vagy címkék számára, alkalmazhatnak táblastílusokat csíkozott sorok/oszlopok használatával, és meghatározhatják a szűrőket a felhasználói interaktivitáshoz. A feltételes formázás támogatja a színskálákat, adatcsíkokat, ikonkészleteket és egyedi képleteket a trendek vagy anomáliák kiemelésére. Ezek a funkciók javítják az adatok olvashatóságát és az interaktivitást a generált munkafüzetekben. Az API a komplex XML struktúrákat intuitív Rust metódusokká absztrahálja, biztosítva a karbantarthatóságot és a típusbiztonságot.
Hogyan egyesíthetünk cellákat és adhatunk hozzá táblázatokat feltételes formázással?
use rust_xlsxwriter::*;
let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();
// Merge cells
let merge_fmt = Format::new()
.set_border(FormatBorder::Thin)
.set_align(FormatAlign::Center);
worksheet.merge_range(0, 0, 0, 2, "Report Header", &merge_fmt)?;
// Add table
worksheet.add_table(1, 0, 5, 2, Table::new().set_columns(&[
("Item", None),
("Value", None),
("Status", None),
]))?;
// Conditional formatting
worksheet.conditional_format(
2, 0, 5, 2,
ConditionalFormat::new()
.set_type(ConditionalFormatType::Cell)
.set_format(&Format::new().set_bg_color("#D8E4BC"))
.set_formula("=A2>100")
)?;
workbook.save("advanced.xlsx")?;Teljesítményoptimalizálás és nagy fájlok támogatása
A rust_xlsxwriter a sebesség és memóriahatékonyság szempontjából optimalizált, különösen nagy adathalmazok esetén. Támogatja a konstans memória módot (`constant_memory` funkció), amely az adatokat fokozatosan írja a lemezre, minimalizálva a heap használatát. Ez a mód ideális több megabájtos Excel-fájlok generálásához OOM hibák nélkül. A benchmarkok azt mutatják, hogy körülbelül ~3.8× gyorsabb, mint a Python XlsxWriter, és csak ~14% lassabb a natív C könyvtárnál. Opcionális funkciók, mint a `zmij` és a `zlib`, tovább gyorsítják a numerikus írásokat és a tömörítést. Ezek a képességek alkalmassá teszik kötegelt jelentéskészítésre, ETL csővezetékekre és szerveroldali Excel-generálásra.
Hogyan aktiválhatjuk a konstans memória módot nagy fájlokhoz?
cargo add rust_xlsxwriter -F constant_memoryuse rust_xlsxwriter::*;
let mut workbook = Workbook::new();
workbook.set_constant_memory(true); // Enable constant memory mode
let worksheet = workbook.add_worksheet();
for i in 0..100_000 {
worksheet.write_number(i, 0, i as f64)?;
}
workbook.save("large_file.xlsx")?;