
calamine
Thư viện Rust thuần cho bảng tính
Đọc XLS, XLSX, XLSM, XLSB, ODS & hơn nữa với giải mã không sao chép trong Rust.
Calamine là gì?
calamine là một thư viện Rust thuần hiệu năng cao, dùng để đọc và giải mã các tệp bảng tính Excel và OpenDocument. Nó hỗ trợ các định dạng như XLS, XLSX, XLSM, XLSB, ODS và hơn thế nữa, tập trung vào việc trích xuất dữ liệu nhanh, an toàn và không sao chép. Được thiết kế để đáng tin cậy và phụ thuộc tối thiểu, calamine tránh các thư viện hệ thống bên ngoài và chỉ dựa vào các triển khai Rust thuần. API của nó cho phép các nhà phát triển hiệu quả trích xuất giá trị ô, xử lý dự án VBA và phân tích công thức mà không cần cài đặt phức tạp hay chi phí thời gian chạy.
Thư viện này nổi trội trong các ứng dụng yêu cầu hiệu năng cao, cung cấp tốc độ xử lý nhanh hơn đáng kể so với các giải pháp thay thế bằng Python, C# và Go. Với tích hợp Serde sẵn có, calamine cho phép ánh xạ liền mạch dữ liệu bảng tính sang các struct Rust. Nó hỗ trợ tải lười cho các tệp lớn, cấu hình hàng tiêu đề, và các tính năng tùy chọn như hỗ trợ ngày/giờ chrono và trích xuất dữ liệu hình ảnh. Dù bạn đang xây dựng công cụ CLI, backend web, hay hệ thống nhúng, calamine mang lại hiệu năng vững chắc và dự đoán được trên mọi nền tảng.
Bắt đầu với calamine
Để bắt đầu sử dụng calamine, thêm nó vào dự án Rust của bạn qua Cargo. Bạn có thể cài đặt trực tiếp bằng cargo add calamine hoặc thủ công thêm phụ thuộc vào tệp Cargo.toml. Thư viện có sẵn trên crates.io và mã nguồn của nó được lưu trữ trên GitHub của calamine. Đối với việc sử dụng nâng cao, bật các tính năng tùy chọn như chrono để hỗ trợ ngày/giờ hoặc picture để trích xuất dữ liệu hình ảnh. Thư viện biên dịch sạch sẽ trên Rust ổn định và không yêu cầu bất kỳ binary hay thư viện hệ thống nào bên ngoài.
Cài đặt calamine qua Cargo
cargo add calamineGiải tuần tự bảng tính dựa trên Serde
calamine cung cấp tích hợp Serde mạnh mẽ để ánh xạ dữ liệu bảng tính trực tiếp vào các struct Rust. Sử dụng RangeDeserializerBuilder, các nhà phát triển có thể định nghĩa mô hình dữ liệu có kiểu mạnh và tự động giải mã các hàng thành các bản ghi có cấu trúc. Thư viện bao gồm các hàm trợ giúp như deserialize_as_f64_or_none và deserialize_as_f64_or_string để xử lý các cột hỗn hợp kiểu một cách linh hoạt. Cách tiếp cận này đảm bảo tính an toàn kiểu, giảm bớt mã lặp lại và cho phép xác thực cấu trúc dữ liệu tại thời điểm biên dịch. Nó đặc biệt hữu ích cho các pipeline dữ liệu, công cụ báo cáo và ứng dụng ETL nơi độ tin cậy và hiệu suất là yếu tố quan trọng.
Giải tuần tự các hàng bảng tính thành struct Rust
use calamine::{deserialize_as_f64_or_none, open_workbook, RangeDeserializerBuilder, Reader, Xlsx};
use serde::Deserialize;
#[derive(Deserialize)]
struct Record {
metric: String,
#[serde(deserialize_with = "deserialize_as_f64_or_none")]
value: Option,
}
let mut excel: Xlsx<_> = open_workbook("file.xlsx")?;
let range = excel.worksheet_range("Sheet1")?;
let iter = RangeDeserializerBuilder::with_headers(&["metric", "value"]).from_range(&range)?;
for result in iter {
let record: Record = result?;
println!("{:?}", record);
} Trích xuất dự án VBA và công thức
calamine cho phép trích xuất các mô-đun dự án VBA và định nghĩa công thức từ các tệp Excel. Các nhà phát triển có thể lấy mã VBA từ các mô-đun, phát hiện các tham chiếu bị hỏng, và kiểm tra các tên đã định nghĩa cùng công thức của chúng. Khả năng này là thiết yếu cho các công cụ di chuyển, tiện ích kiểm toán và phân tích hệ thống kế thừa. API cung cấp truy cập có cấu trúc tới siêu dữ liệu VBA và hỗ trợ cả các kịch bản kiểm tra sổ làm việc đơn giản và phức tạp. Cho dù bạn đang phân tích macro để bảo mật hay chuyển đổi logic Excel kế thừa, calamine cung cấp truy cập chi tiết, cấp thấp tới nội dung ẩn của sổ làm việc.
Trích xuất mã VBA và các tên đã định nghĩa
use calamine::{open_workbook_auto, Reader};
let mut workbook = open_workbook_auto("file.xlsx")?;
if let Ok(Some(vba)) = workbook.vba_project() {
let module = vba.get_module("Module1").unwrap();
println!("{}", module);
for ref in vba.get_references() {
if ref.is_missing() { println!("Broken: {}", ref.name); }
}
}
for (name, formula) in workbook.defined_names() {
println!("{}: {}", name, formula);
}Tải lười và xử lý tệp lớn
calamine hỗ trợ tải lười (lazy loading) cho các tệp XLSX và XLSB, cho phép xử lý hiệu quả các bảng tính lớn mà không cần tải toàn bộ các sheet vào bộ nhớ cùng một lúc. Bằng cách cấu hình các hàng tiêu đề và sử dụng vòng lặp dựa trên phạm vi, các nhà phát triển có thể giảm thiểu dung lượng bộ nhớ và tối đa hoá thông lượng. Tính năng này đặc biệt có giá trị cho các hàm không máy chủ, công cụ CLI và triển khai nhúng nơi tài nguyên bị hạn chế. Các phép đo hiệu năng cho thấy calamine đọc hơn 1 triệu hàng với mức tiêu thụ bộ nhớ tối thiểu so với các giải pháp thay thế như openpyxl và ClosedXML, làm cho nó trở thành lựa chọn lý tưởng cho các pipeline thu thập dữ liệu quy mô lớn.
Xử lý bảng tính lớn một cách hiệu quả
use calamine::{open_workbook, Reader, Xlsx};
let mut excel: Xlsx<_> = open_workbook("large.xlsx")?;
let range = excel
.worksheet_range("Sheet1")?
.expect("Sheet not found");
for row in range.rows() {
// Process row without loading entire file
process_row(row);
}Tối ưu hoá hiệu năng và các tiêu chuẩn
calamine cung cấp hiệu năng xuất sắc, xử lý 41 triệu ô trong chưa tới 25 giây—vượt trội so với các thư viện Python, C# và Go lên tới 9,4 lần. Thiết kế zero-copy và việc cấp phát heap tối thiểu giảm đáng kể việc sử dụng CPU và bộ nhớ. Các phép đo trên tệp XLSX 186 MB cho thấy calamine chỉ sử dụng 186 MB đọc đĩa so với 1,5 GB của excelize. Hành vi bộ nhớ quyết định và áp lực GC thấp của thư viện khiến nó phù hợp cho các ứng dụng thời gian thực và nhạy cảm với độ trễ. Các nhà phát triển được hưởng lợi từ việc sử dụng tài nguyên dự đoán được và thông lượng ổn định trên nhiều tải công việc đa dạng.
