
xlsxwriter-rs
Βιβλιοθήκη Rust για δημιουργία Excel XLSX
Δημιουργήστε πλήρως συμβατά αρχεία Excel XLSX με μορφοποίηση, συγχωνευμένα κελιά, αυτόματα φίλτρα και εικόνες μέσω του Rust API.
Τι είναι το xlsxwriter-rs;
Το xlsxwriter-rs είναι μια υψηλής απόδοσης σύνδεση Rust για τη δημοφιλής βιβλιοθήκη C libxlsxwriter, επιτρέποντας στους προγραμματιστές να δημιουργούν πλήρως συμβατά αρχεία Excel XLSX απευθείας από εφαρμογές Rust. Υποστηρίζει ολοκληρωμένη μορφοποίηση Excel, συμπεριλαμβανομένων γραμματοσειρών, χρωμάτων, στοίχισης, περιγραμμάτων και μορφών αριθμών, καθώς και προχωρημένες λειτουργίες όπως συγχωνευμένα κελιά, αυτόματα φίλτρα, επικύρωση δεδομένων και ενσωματωμένες εικόνες PNG/JPEG. Σχεδιασμένο για αξιοπιστία και ταχύτητα, το xlsxwriter-rs είναι ιδανικό για δημιουργία αναφορών στο διακομιστή, αγωγούς εξαγωγής δεδομένων και οποιοδήποτε σενάριο που απαιτεί προγραμματιστική δημιουργία αρχείων Excel σε Rust.
Η βιβλιοθήκη αξιοποιεί την ασφάλεια μνήμης του Rust και τις αφαιρέσεις μηδενικού κόστους για να παρέχει ένα ασφαλές και αποδοτικό API για τη δημιουργία Excel χωρίς να απαιτείται το Microsoft Excel ή εξωτερικές εξαρτήσεις όπως το COM. Ενσωματώνεται άψογα με το Cargo και υποστηρίζει προαιρετικές σημαίες χαρακτηριστικών για την προσαρμογή της συμπεριφοράς, όπως η απενεργοποίηση των ελέγχων MD5 ή η χρήση του συστημικού zlib. Με το καθαρό, ιδιωματικό περιβάλλον Rust και την εκτενή τεκμηρίωση, το xlsxwriter-rs δίνει τη δυνατότητα στους προγραμματιστές να δημιουργούν ανθεκτικά, δια-πλατφορμικά εργαλεία δημιουργίας Excel διατηρώντας πλήρη έλεγχο της δομής και του περιεχομένου των αρχείων.
Ξεκινώντας με το xlsxwriter-rs
Για να ξεκινήσετε να χρησιμοποιείτε το xlsxwriter-rs, προσθέστε το στο Cargo.toml μέσω cargo add xlsxwriter ή συμπεριλάβετε χειροκίνητα το [dependencies] με xlsxwriter = "0.1". Η βιβλιοθήκη απαιτεί LLVM και Clang για τη μεταγλώττιση bindgen. Για Windows, εγκαταστήστε το Visual Studio και το LLVM, στη συνέχεια ορίστε το LIBCLANG_PATH στον φάκελο bin του LLVM. Μετά τη ρύθμιση, κλωνοποιήστε το αποθετήριο, εκτελέστε git submodule update --init --recursive για να κατεβάσετε τη βιβλιοθήκη C, και δημιουργήστε τα παραδείγματα με cargo run --example hello_spreadsheet. Πλήρης τεκμηρίωση και παραδείγματα είναι διαθέσιμα στο xlsxwriter-rs GitHub.
Εγκατάσταση του xlsxwriter-rs μέσω Cargo
cargo add xlsxwriterΠλήρης υποστήριξη μορφοποίησης Excel
Το xlsxwriter-rs παρέχει ολοκληρωμένες δυνατότητες μορφοποίησης, επιτρέποντας στους προγραμματιστές να προσαρμόζουν γραμματοσειρές, χρώματα, περιθώρια, στοίχιση και μορφές αριθμών για μεμονωμένα κελιά ή περιοχές. Μπορείτε να εφαρμόζετε έντονη, πλάγια, υπογράμμιση, μέγεθος γραμματοσειράς και προσαρμοσμένα χρώματα στο κείμενο, να ορίζετε χρώματα γεμίσματος φόντου, να ορίζετε περιθώρια κελιών με διάφορα στυλ (λεπτό, μεσαίο, παχύ), και να ελέγχετε την οριζόντια/κατακόρυφη στοίχιση. Αυτό το επίπεδο ελέγχου εξασφαλίζει ότι τα παραγόμενα αρχεία Excel ταιριάζουν με τα επαγγελματικά πρότυπα αναφοράς. Η μορφοποίηση εφαρμόζεται χρησιμοποιώντας τη δομή Format, η οποία υποστηρίζει αλυσίδωση μεθόδων για διαισθητική διαμόρφωση. Αυτή η δυνατότητα είναι απαραίτητη για τη δημιουργία οπτικά διακριτών αναφορών, ταμπλό και εξαγωγών δεδομένων που βελτιώνουν την αναγνωσιμότητα και την εμπειρία χρήστη.
Εφαρμογή χρώματος γραμματοσειράς και στοίχισης στα κελιά
let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(
0, 0,
"Red text",
Some(&Format::new().set_font_color(FormatColor::Red))
)?;
sheet1.write_string(
2, 0,
"Centered green text",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;Συγχωνευμένα κελιά και περιοχές
Η βιβλιοθήκη υποστηρίζει τη συγχώνευση ορθογώνιων περιοχών κελιών, κάτι που είναι κρίσιμο για τη δημιουργία κεφαλίδων, τίτλων και ομαδοποιημένων ενοτήτων δεδομένων σε αναφορές Excel. Χρησιμοποιώντας τη μέθοδο merge_range, μπορείτε να επεκτείνετε σε πολλές γραμμές και στήλες ενώ εφαρμόζετε μορφοποίηση σε ολόκληρο το συγχωνευμένο μπλοκ. Αυτό εξασφαλίζει συνεπή στυλ και διάταξη σε πολύπλοκα φύλλα εργασίας. Τα συγχωνευμένα κελιά είναι πλήρως συμβατά με τη μηχανή απόδοσης του Excel και διατηρούν τη μορφοποίηση όπως η στοίχιση κειμένου, τα περιγράμματα και τα χρώματα φόντου. Αυτή η δυνατότητα είναι ιδιαίτερα χρήσιμη για οικονομικές καταστάσεις, πίνακες ελέγχου και φόρμες όπου η οπτική ομαδοποίηση ενισχύει την κατανόηση των δεδομένων και την ποιότητα παρουσίασης.
Συγχώνευση περιοχής με προσαρμοσμένη μορφοποίηση
sheet1.merge_range(
2, 0,
3, 2,
"Hello, world",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;Αυτόματα φίλτρα και επικύρωση δεδομένων
Το xlsxwriter-rs επιτρέπει τη προγραμματιστική δημιουργία αυτόματων φίλτρων και κανόνων επικύρωσης δεδομένων, δίνοντας τη δυνατότητα στους χρήστες να ταξινομούν, φιλτράρουν και επικυρώνουν δεδομένα απευθείας στο Excel. Μπορείτε να εφαρμόσετε ένα αυτόματο φίλτρο σε μια περιοχή κελιών χρησιμοποιώντας set_autofilter, και να ορίσετε λίστες πτυσσόμενων επιλογών για την εισαγωγή από τον χρήστη μέσω επικύρωσης δεδομένων. Αυτό υποστηρίζει επικύρωση βάσει λίστας, αριθμητικές περιοχές, ημερομηνίες και προσαρμοσμένους τύπους. Αυτά τα χαρακτηριστικά ενισχύουν την αλληλεπίδραση και την ακεραιότητα των δεδομένων στα υπολογιστικά φύλλα, καθιστώντας τα κατάλληλα για φόρμες, πρότυπα και συνεργατική εισαγωγή δεδομένων. Τα παραγόμενα αρχεία XLSX διατηρούν πλήρη λειτουργικότητα όταν ανοίγονται στο Excel, LibreOffice ή Google Sheets, εξασφαλίζοντας ευρεία συμβατότητα.
Εφαρμογή αυτόματου φίλτρου και επικύρωσης δεδομένων
// Apply autofilter to A1:C10
sheet1.set_autofilter("A1:C10")?;
// Add data validation (drop-down list) in B2
sheet1.data_validation(
"B2",
DataValidation::new_list(&["Option1", "Option2", "Option3"])
)?;Ενσωμάτωση εικόνων και υπερσυνδέσμων
Μπορείτε να ενσωματώσετε εικόνες PNG και JPEG απευθείας σε φύλλα εργασίας του Excel χρησιμοποιώντας το xlsxwriter-rs, υποστηρίζοντας την τοποθέτηση, το μέγεθος και την κλιμάκωση. Αυτό είναι ιδανικό για την προσθήκη λογοτύπων, διαγραμμάτων ή οπτικών ενδείξεων σε αναφορές. Επιπλέον, η βιβλιοθήκη υποστηρίζει υπερσυνδέσμους και URL με προσαρμόσιμη μορφοποίηση (π.χ., μπλε κείμενο και υπογραμμίσεις), επιτρέποντας κλικ-συνδέσμους σε ιστοσελίδες, έγγραφα ή άλλα φύλλα. Αυτές οι δυνατότητες καθιστούν το xlsxwriter-rs κατάλληλο για τη δημιουργία πλούσιων, διαδραστικών αναφορών και ταμπλό που συνδυάζουν δεδομένα, οπτικά στοιχεία και πλοήγηση. Όλο το ενσωματωμένο περιεχόμενο είναι πλήρως συμβατό με τη μηχανή απόδοσης του Excel και διατηρεί την ακεραιότητα της διάταξης σε όλες τις πλατφόρμες.
Γράψιμο URL και ενσωμάτωση εικόνας
// Write a clickable URL
sheet1.write_url(
1, 1,
"https://github.com/informationsea/xlsxwriter-rs",
Some(&Format::new()
.set_font_color(FormatColor::Blue)
.set_underline(FormatUnderline::Single)
)
)?;
// Embed an image (requires image path)
// sheet1.insert_image(5, 0, "logo.png")?;