Implement XLSX init support in MiniExcel

- Add error handling with custom error types in `error.rs`.
- Create core library structure in `lib.rs` with modules for cell handling, error management, options, reading, writing, and serialization helpers.
- Define `ReadOptions` and `WriteOptions` in `options.rs` for configuring read/write behavior.
- Implement `XlsxReader` in `reader.rs` for reading XLSX files, including dynamic row handling and deserialization.
- Add serialization helpers in `serde_helpers.rs` for date, time, and duration types.
- Implement `XlsxWriter` in `writer.rs` for writing XLSX files, including schema validation and cell formatting.
- Create common test utilities in `common/mod.rs` for file path handling.
- Add tests for reading dynamic and typed rows, handling empty rows, and round-trip writing/reading of XLSX files.
- Set Rust toolchain version and formatting options in `rust-toolchain.toml` and `rustfmt.toml`.

Author: shps951023

.github/workflows/rust.yml

@@ -0,0 +1,69 @@
+name: Rust
+
+on:
+  pull_request:
+    paths:
+      - "rust/**"
+      - "tests/data/xlsx/**"
+      - ".github/workflows/rust.yml"
+  push:
+    branches: [master]
+    paths:
+      - "rust/**"
+      - "tests/data/xlsx/**"
+      - ".github/workflows/rust.yml"
+
+permissions:
+  contents: read
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install stable Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: rust -> target
+      - name: Check formatting
+        run: cargo fmt --manifest-path rust/Cargo.toml --all -- --check
+      - name: Run Clippy
+        run: cargo clippy --manifest-path rust/Cargo.toml --workspace --all-targets --locked -- -D warnings
+      - name: Build documentation
+        run: cargo doc --manifest-path rust/Cargo.toml --workspace --no-deps --locked
+        env:
+          RUSTDOCFLAGS: -D warnings
+
+  test:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install stable Rust
+        uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: rust -> target
+      - name: Run tests
+        run: cargo test --manifest-path rust/Cargo.toml --workspace --all-targets --locked
+
+  msrv:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Rust 1.85.0
+        uses: dtolnay/rust-toolchain@1.85.0
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: rust -> target
+          key: msrv
+      - name: Check minimum supported Rust version
+        run: cargo check --manifest-path rust/Cargo.toml --workspace --all-targets --locked

.gitignore

@@ -403,3 +403,6 @@ FodyWeavers.xsd
 /tests/MiniExcel.Tests/TemplateOptimization
 /tests/data/xlsx/Test_EnableWriteFilePath.xlsx
 samples/xlsx/Test_EnableWriteFilePath.xlsx
+
+# Rust
+/rust/target/

README.md

@@ -34,6 +34,8 @@
 
 MiniExcel is a simple and efficient Excel processing tool for .NET, specifically designed to minimize memory usage.
 
+> **Experimental Rust XLSX MVP:** See the [Rust implementation and usage guide](rust/README.md).
+
 At present, most popular frameworks need to load all the data from an Excel document into memory to facilitate operations, but this may cause memory consumption problems. MiniExcel's approach is different: the data is processed row by row in a streaming manner, reducing the original consumption from potentially hundreds of megabytes to just a few megabytes, effectively preventing out-of-memory(OOM) issues.
 
 ```mermaid

README.zh-CN.md

@@ -45,6 +45,8 @@
 
 MiniExcel简单、高效避免OOM的.NET处理Excel查、写、填充数据工具。
 
+> **实验性 Rust XLSX MVP：** 请查看 [Rust 实现与使用说明](rust/README.zh-CN.md)。
+
 
 目前主流框架大多需要将数据全载入到内存方便操作，但这会导致内存消耗问题，MiniExcel 尝试以 Stream 角度写底层算法逻辑，能让原本1000多MB占用降低到几MB，避免内存不够情况。