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 เช่น อาเรย์แบบไดนามิก, สปาร์คลไลน์, กล่องทำเครื่องหมาย, กล่องข้อความ, ตาราง, ตัวกรองอัตโนมัติ, ชื่อที่กำหนด, และธีมของเวิร์กบุ๊ก ด้วยคุณลักษณะเสริมเช่น การทำซีเรียลไลซ์ด้วย Serde, การสนับสนุนวันที่ chrono/jiff, และการบูรณาการกับ Polars, มันปรับตัวให้เข้ากับระบบนิเวศ Rust ที่หลากหลาย ประสิทธิภาพของมันอยู่รองจากเวอร์ชัน C เท่านั้น โดยให้ความเร็วการทำงานเร็วกว่า XlsxWriter ของ Python ถึง 3.8 เท่า สำหรับรายละเอียดเต็ม ๆ ดูที่ ที่เก็บ rust_xlsxwriter บน GitHub.

Previous Next

เริ่มต้นใช้งาน rust_xlsxwriter

rust_xlsxwriter มีให้ใช้งานบน crates.io และสามารถติดตั้งได้ผ่าน `cargo add rust_xlsxwriter`. สำหรับการทำงานที่เพิ่มขึ้น ให้เปิดใช้งานฟีเจอร์เสริมเช่น `constant_memory`, `chrono`, `serde`, หรือ `polars`. ไลบรารีต้องการ Rust 1.56+ และคอมไพล์เป็นไบนารีเนทีฟโดยไม่มีการพึ่งพา runtime ภายนอกนอกจาก crate `zip` (โดยค่าเริ่มต้น). มีเอกสารครบถ้วนรวมถึงคู่มือผู้ใช้, บทแนะนำ, และสูตรอาหาร. สำหรับตัวอย่างโดยละเอียดและซอร์สโค้ด, เยี่ยมชม ที่เก็บ GitHub ของ rust_xlsxwriter.

ติดตั้ง 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) ซึ่งจะเขียนข้อมูลลงดิสก์อย่างต่อเนื่อง เพื่อลดการใช้ heap โหมดนี้เหมาะสำหรับการสร้างไฟล์ Excel ขนาดหลายเมกะไบต์โดยไม่เกิดข้อผิดพลาด OOM การทดสอบแสดงว่ามันทำงานเร็วประมาณ ~3.8× มากกว่า XlsxWriter ของ Python และช้ากว่าไลบรารี C ดั้งเดิมเพียง ~14% ฟีเจอร์เสริมเช่น `zmij` และ `zlib` ช่วยเร่งการเขียนตัวเลขและการบีบอัด ความสามารถเหล่านี้ทำให้เหมาะสำหรับการรายงานแบบแบตช์, pipeline ETL, และการสร้าง Excel ฝั่งเซิร์ฟเวอร์

วิธีเปิดใช้งานโหมดหน่วยความจำคงที่สำหรับไฟล์ขนาดใหญ่?

cargo add rust_xlsxwriter -F constant_memory
use 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")?;
 ไทย