
umya-spreadsheet
Thư viện Rust Thuần cho Tệp XLSX/XLSM
Đọc, Ghi, Định dạng và Thao tác Bảng tính XLSX/XLSM mà không cần phụ thuộc bên ngoài.
umya-spreadsheet là gì?
umya-spreadsheet là một thư viện Rust thuần, hiệu năng cao, dùng để đọc và ghi các tệp bảng tính Excel ở định dạng XLSX và XLSM. Được thiết kế để an toàn và hiệu quả, nó tránh sử dụng mã không an toàn và các phụ thuộc bên ngoài, khiến nó lý tưởng cho các ứng dụng desktop, xử lý phía máy chủ và môi trường WebAssembly. Thư viện cung cấp một API Rust sạch sẽ, mang phong cách idiomatic, cho phép truy cập các ô, hàng, cột, kiểu dáng, biểu đồ và hình ảnh, giúp các nhà phát triển xây dựng công cụ bảng tính mạnh mẽ mà không cần dựa vào Microsoft Office hoặc COM interop.
Với hỗ trợ đầy đủ cho việc tải lười (lazy loading), bảo vệ bằng mật khẩu và định dạng phong phú, umya-spreadsheet thu hẹp khoảng cách giữa hiệu năng và khả năng sử dụng. Nó hỗ trợ xuất CSV, tạo biểu đồ, nhúng hình ảnh và các thao tác phạm vi như di chuyển và sao chép. Dự án được duy trì tích cực, tài liệu đầy đủ và được kiểm thử, tập trung vào độ chính xác và khả năng tương thích với các tính năng Excel hiện đại. Các nhà phát triển có thể tích hợp nó vào công cụ CLI, backend web, hoặc ứng dụng desktop bằng các framework như Tauri hoặc Axo.
Bắt đầu với umya-spreadsheet
Để bắt đầu sử dụng umya-spreadsheet, thêm nó vào Cargo.toml của bạn với `umya-spreadsheet = "3.1.1"`. Đối với hỗ trợ WebAssembly, bật tính năng `js`. Thư viện nhẹ về phụ thuộc và biên dịch nhanh chóng. Sau khi cài đặt, nhập nó bằng `extern crate umya_spreadsheet;` và bắt đầu đọc hoặc ghi bảng tính. Bạn cũng có thể khám phá GitHub của umya-spreadsheet để xem các ví dụ, kiểm thử và tài liệu. Nó hỗ trợ tải lười cho các tệp lớn và cung cấp xử lý lỗi mạnh mẽ.
Cài đặt umya-spreadsheet qua Cargo
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
Đọc & Ghi tệp XLSX/XLSM
umya-spreadsheet cung cấp các API trực quan để đọc và ghi các tệp XLSX và XLMS. Sử dụng `reader::xlsx::read()` để tải một workbook từ đĩa, hoặc `new_file()` để tạo một tệp trống. Việc ghi cũng tương tự đơn giản: gọi `writer::xlsx::write()` với workbook và đường dẫn đích. Thư viện hỗ trợ tải lười qua `lazy_read()` để cải thiện hiệu năng trên các tệp lớn, và cho phép ghi có bảo vệ mật khẩu hoặc đặt mật khẩu sau khi tạo. Tất cả các thao tác đều an toàn, không sao chép khi có thể, và tránh sử dụng các binary bên ngoài.
Cách đọc và ghi tệp XLSX bằng Rust?
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();
Truy cập ô & Thao tác kiểu dáng
Truy cập và sửa đổi giá trị ô là rất đơn giản: sử dụng `cell("A1")` hoặc `cell((1,1))` để đọc, và `cell_mut()` để ghi. Các kiểu được quản lý qua `style_mut()`, cho phép thay đổi màu nền, phông chữ, viền và căn chỉnh. Thư viện cung cấp một bộ thuộc tính kiểu phong phú trong khi vẫn duy trì các cam kết bất biến khi có thể. Bạn cũng có thể lấy các giá trị đã định dạng, áp dụng logic điều kiện, và cập nhật hàng loạt các kiểu trên các phạm vi. Điều này làm cho nó trở thành lựa chọn lý tưởng để tạo báo cáo, bảng điều khiển, hoặc xuất dữ liệu với định dạng nhất quán.
Cách sửa giá trị ô và kiểu dáng bằng 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);
Hỗ trợ biểu đồ & hình ảnh
umya-spreadsheet hỗ trợ tạo và chỉnh sửa biểu đồ—bao gồm biểu đồ đường, cột và khu vực—bằng cách định nghĩa phạm vi series và các dấu đánh dấu. Bạn có thể nhúng hình ảnh trực tiếp vào các sheet bằng cấu trúc `Image`, với hỗ trợ PNG và các định dạng khác tùy thuộc vào các tính năng được bật. Biểu đồ và hình ảnh tích hợp liền mạch với tọa độ ô và lớp vẽ, cho phép tạo bảng điều khiển động. Mặc dù một số tính năng vẽ nâng cao vẫn đang được phát triển, chức năng cốt lõi đã sẵn sàng cho sản xuất và có thể mở rộng.
Cách thêm biểu đồ đường vào bảng tính bằng 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);
Thao tác vùng & Bảo vệ bằng mật khẩu
Thực hiện các thao tác nâng cao như di chuyển, sao chép và thay đổi kích thước phạm vi bằng cách sử dụng `move_range()`, cho phép tổ chức lại dữ liệu một cách động. Thư viện cũng hỗ trợ sổ làm việc được bảo mật bằng mật khẩu: ghi tệp với `write_with_password()` hoặc áp dụng mật khẩu cho các tệp hiện có qua `set_password()`. Những tính năng này rất quan trọng cho việc xử lý dữ liệu an toàn trong các ứng dụng doanh nghiệp hoặc nhạy cảm về tuân thủ. Khi kết hợp với thiết kế không phụ thuộc và khả năng tương thích WASM, umya-spreadsheet mang lại cả tính linh hoạt và bảo mật.
Cách di chuyển một phạm vi và bảo vệ tệp bằng mật khẩu bằng 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();
