
rust_xlsxwriter
Ανοιχτή πηγή Rust βιβλιοθήκη για αρχεία Excel XLSX
Δημιουργήστε αρχεία Excel 2007+ XLSX με πλήρη μορφοποίηση, γραφήματα, τύπους & εικόνες μέσω Rust API.
Τι είναι το rust_xlsxwriter;
rust_xlsxwriter είναι ένα υψηλής απόδοσης, καθαρό crate Rust για τη δημιουργία αρχείων Excel XLSX χωρίς την ανάγκη του Excel ή εξωτερικών εξαρτήσεων. Επιτρέπει στους προγραμματιστές να δημιουργούν προγραμματιστικά λογιστικά φύλλα με κείμενο, αριθμούς, ημερομηνίες, τύπους, γραφήματα, εικόνες, συγχωνευμένα κελιά, μορφοποίηση υπό όρους, επικύρωση δεδομένων και άλλα. Σχεδιασμένο για αξιοπιστία και ταχύτητα, ταιριάζει στενά με τη φυσική μορφή αρχείου του Excel και υποστηρίζει τη λειτουργία σταθερής μνήμης για μεγάλα σύνολα δεδομένων. Η βιβλιοθήκη είναι μια πιστή επανεγγραφή σε Rust της δημοφιλούς βιβλιοθήκης Python XlsxWriter, με ιδιωματικά API και εκτενή τεκμηρίωση.
Το rust_xlsxwriter εστιάζει αποκλειστικά στη δημιουργία αρχείων Excel—χωρίς ανάγνωση ή τροποποίηση υπαρχόντων αρχείων. Υποστηρίζει σύγχρονα χαρακτηριστικά του Excel όπως δυναμικούς πίνακες, sparklines, πλαίσια ελέγχου, πλαίσια κειμένου, πίνακες, αυτόματα φίλτρα, ορισμένα ονόματα και θέματα βιβλίου εργασίας. Με προαιρετικές λειτουργίες όπως η σειριοποίηση Serde, η υποστήριξη ημερομηνιών chrono/jiff και η ενσωμάτωση Polars, προσαρμόζεται σε διάφορα οικοσυστήματα Rust. Η απόδοσή του είναι δεύτερη μόνο από την έκδοση C, προσφέροντας εκτέλεση 3,8× πιο γρήγορη από το XlsxWriter της Python. Για πλήρεις λεπτομέρειες, δείτε το αποθετήριο rust_xlsxwriter στο GitHub.
Ξεκινώντας με το rust_xlsxwriter
Το rust_xlsxwriter είναι διαθέσιμο στο crates.io και μπορεί να εγκατασταθεί μέσω `cargo add rust_xlsxwriter`. Για βελτιωμένη λειτουργικότητα, ενεργοποιήστε προαιρετικές δυνατότητες όπως `constant_memory`, `chrono`, `serde` ή `polars`. Η βιβλιοθήκη απαιτεί Rust 1.56+ και μεταγλωττίζεται σε εγγενή δυαδικά αρχεία χωρίς εξωτερικές εξαρτήσεις χρόνου εκτέλεσης πέρα από τη βιβλιοθήκη `zip` (από προεπιλογή). Είναι πλήρως τεκμηριωμένη με οδηγό χρήστη, σεμινάριο και βιβλιοθήκη συνταγών. Για λεπτομερή παραδείγματα και πηγαίο κώδικα, επισκεφθείτε το αποθετήριο rust_xlsxwriter στο GitHub.
Εγκατάσταση rust_xlsxwriter μέσω Cargo
cargo add rust_xlsxwriterΓράψτε μορφοποιημένα κελιά με κείμενο, αριθμούς & ημερομηνίες
Το rust_xlsxwriter παρέχει ένα απλό και διαισθητικό API για τη γραφή μορφοποιημένου περιεχομένου σε κελιά του Excel. Οι προγραμματιστές μπορούν να εφαρμόσουν προσαρμοσμένες μορφές για αριθμούς, ημερομηνίες, γραμματοσειρές, περιγράμματα, στοίχιση και χρώματα χρησιμοποιώντας τη δομή `Format`. Η βιβλιοθήκη υποστηρίζει τη γραφή απλού κειμένου, αριθμητικών τιμών, ημερομηνιών, τύπων και URL με προαιρετική μορφοποίηση. Υποστηρίζει επίσης πλούσιες συμβολοσειρές πολλαπλών μορφών για μικτή μορφοποίηση εντός ενός κελιού. Αυτό την καθιστά ιδανική για τη δημιουργία αναφορών, πινάκων ελέγχου και εξαγωγών δεδομένων όπου η οπτική σαφήνεια και η δομή είναι ουσιώδεις. Το API εξασφαλίζει υψηλή πιστότητα με τη μηχανή μορφοποίησης του Excel.
Πώς να γράψετε μορφοποιημένο κείμενο, αριθμούς & ημερομηνίες μέσω Rust;
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")?;Δημιουργία διαγραμμάτων, σπάρκλινς & εικόνων
Το rust_xlsxwriter υποστηρίζει τη δημιουργία επαγγελματικών διαγραμμάτων, sparklines και την ενσωμάτωση εικόνων απευθείας σε αρχεία Excel. Οι προγραμματιστές μπορούν να δημιουργήσουν ραβδόγραμμα, γραμμικό διάγραμμα, διάγραμμα πίτας, διάγραμμα διασποράς και διάγραμμα περιοχής με προσαρμόσιους άξονες, υπομνήματα και σειρές δεδομένων. Τα sparklines παρέχουν συμπαγή οπτικοποίηση τάσεων μέσα στα κελιά. Οι εικόνες (PNG, JPEG, GIF, BMP) μπορούν να εισαχθούν και να τοποθετηθούν με επιλογές κλιμάκωσης και αγκύρωσης. Αυτά τα οπτικά στοιχεία ενισχύουν την αφήγηση δεδομένων και τις δυνατότητες αναφοράς. Η βιβλιοθήκη εξασφαλίζει συμβατότητα με το Excel 2007+ και διατηρεί την πιστότητα απόδοσης σε όλες τις πλατφόρμες.
Πώς να προσθέσετε ένα γράφημα & εικόνα στο Excel μέσω Rust;
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")?;Προηγμένη μορφοποίηση: Συγχωνευμένα κελιά, πίνακες & υπό συνθήκες μορφοποίηση
Το rust_xlsxwriter επιτρέπει προχωρημένα χαρακτηριστικά μορφοποίησης του Excel όπως συγχωνευμένες περιοχές, δομημένους πίνακες, αυτόματους φίλτρους και κανόνες μορφοποίησης υπό συνθήκη. Οι προγραμματιστές μπορούν να συγχωνεύσουν κελιά για κεφαλίδες ή ετικέτες, να εφαρμόσουν στυλ πίνακα με εναλλασσόμενες γραμμές/στήλες και να ορίσουν φίλτρα για αλληλεπίδραση χρήστη. Η μορφοποίηση υπό συνθήκη υποστηρίζει κλίμακες χρωμάτων, γραμμές δεδομένων, σύνολα εικονιδίων και προσαρμοσμένους τύπους για την επισήμανση τάσεων ή ανωμαλιών. Αυτά τα χαρακτηριστικά βελτιώνουν την αναγνωσιμότητα των δεδομένων και την αλληλεπίδραση σε δημιουργημένα βιβλία εργασίας. Το API αφαιρεί την πολυπλοκότητα των δομών XML σε διαισθητικές μεθόδους Rust, εξασφαλίζοντας συντηρησιμότητα και ασφάλεια τύπων.
Πώς να συγχωνεύσετε κελιά & να προσθέσετε πίνακες με μορφοποίηση υπό όρους;
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")?;Βελτιστοποίηση απόδοσης & υποστήριξη μεγάλων αρχείων
rust_xlsxwriter είναι βελτιστοποιημένο για ταχύτητα και αποδοτικότητα μνήμης, ιδιαίτερα για μεγάλα σύνολα δεδομένων. Υποστηρίζει τη λειτουργία σταθερής μνήμης (`constant_memory` feature), η οποία γράφει δεδομένα σταδιακά στο δίσκο, ελαχιστοποιώντας τη χρήση της στοίβας. Αυτή η λειτουργία είναι ιδανική για τη δημιουργία αρχείων Excel πολλαπλών megabyte χωρίς σφάλματα OOM. Τα benchmarks δείχνουν ότι τρέχει ~3.8× πιο γρήγορα από το XlsxWriter της Python και μόνο ~14% πιο αργά από τη φυσική βιβλιοθήκη C. Προαιρετικές δυνατότητες όπως `zmij` και `zlib` επιταχύνουν περαιτέρω τις αριθμητικές εγγραφές και τη συμπίεση. Αυτές οι δυνατότητες το καθιστούν κατάλληλο για αναφορές παρτίδας, αγωγούς ETL και δημιουργία Excel από την πλευρά του διακομιστή.
Πώς να ενεργοποιήσετε τη λειτουργία σταθερής μνήμης για μεγάλα αρχεία;
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")?;