xlsxturbo 0.7.0__tar.gz → 0.9.0__tar.gz

xlsxturbo-0.9.0/.github/dependabot.yml

@@ -0,0 +1,15 @@
+version: 2
+updates:
+  # Rust dependencies (Cargo.toml)
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  # GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 3

{xlsxturbo-0.7.0 → xlsxturbo-0.9.0}/.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Rust
         uses: dtolnay/rust-toolchain@stable
@@ -27,7 +27,7 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Rust
         uses: dtolnay/rust-toolchain@stable

{xlsxturbo-0.7.0 → xlsxturbo-0.9.0}/.github/workflows/release.yml

@@ -17,9 +17,9 @@ jobs:
       matrix:
         target: [x86_64, aarch64]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.11'
 
@@ -44,9 +44,9 @@ jobs:
       matrix:
         target: [x64]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.11'
           architecture: ${{ matrix.target }}
@@ -70,9 +70,9 @@ jobs:
       matrix:
         target: [x86_64, aarch64]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.11'
 
@@ -93,7 +93,7 @@ jobs:
   sdist:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Build sdist
         uses: PyO3/maturin-action@v1
@@ -120,7 +120,7 @@ jobs:
       id-token: write  # Required for trusted publishing
     steps:
       - name: Download all wheels
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v7
         with:
           pattern: wheels-*
           path: dist

xlsxturbo-0.9.0/BUILD.md

@@ -0,0 +1,191 @@
+# Build & Release Guide
+
+## Prerequisites
+
+- Rust toolchain (stable): https://rustup.rs/
+- Python 3.8+
+- maturin: `pip install maturin`
+
+## Local Development
+
+### Setup
+
+```bash
+# Clone and enter directory
+git clone https://github.com/tstone-1/xlsxturbo.git
+cd xlsxturbo
+
+# Install in development mode
+pip install -e ".[dev]"
+# Or with maturin:
+maturin develop --release
+```
+
+### Running Tests
+
+```bash
+# Rust unit tests
+cargo test
+
+# Python integration tests
+python tests/test_features.py
+
+# Or with pytest
+pytest tests/
+```
+
+### Code Quality Checks
+
+```bash
+# Format check (must pass before commit)
+cargo fmt --check
+
+# Linter (must pass with no warnings)
+cargo clippy -- -D warnings
+
+# Format code (if check fails)
+cargo fmt
+```
+
+## Pre-Push Checklist
+
+Before pushing to main or creating a PR, verify all checks pass locally:
+
+```bash
+# 1. Format check
+cargo fmt --check
+
+# 2. Linter (no warnings)
+cargo clippy -- -D warnings
+
+# 3. Rust tests
+cargo test
+
+# 4. Build release
+maturin develop --release
+
+# 5. Python tests
+python tests/test_features.py
+```
+
+All 5 steps must succeed before pushing.
+
+## Release Process
+
+### 1. Update Version
+
+Update version in both files (must match):
+
+- `Cargo.toml`: `version = "X.Y.Z"`
+- `pyproject.toml`: `version = "X.Y.Z"`
+
+Follow SemVer:
+- MAJOR: Breaking API changes
+- MINOR: New features (backward compatible)
+- PATCH: Bug fixes (backward compatible)
+
+### 2. Update CHANGELOG.md
+
+Add entry for new version with:
+- Date
+- Summary of changes
+- Breaking changes (if any)
+
+### 3. Commit Version Bump
+
+```bash
+git add Cargo.toml pyproject.toml CHANGELOG.md
+git commit -m "chore: bump version to X.Y.Z"
+git push origin main
+```
+
+### 4. Check Dependabot PRs
+
+Before releasing, review open Dependabot PRs:
+
+1. Go to: https://github.com/tstone-1/xlsxturbo/pulls
+2. Check for open Dependabot PRs (dependency updates)
+3. For each PR, decide:
+   - **Merge** if CI passes and update is safe
+   - **Close** if update causes issues or is not needed yet
+   - **Defer** to next release (document why)
+
+Don't release with unreviewed dependency PRs piling up.
+
+### 5. Verify CI Passes
+
+**IMPORTANT:** Before creating a release tag, verify GitHub Actions succeed.
+
+1. Go to: https://github.com/tstone-1/xlsxturbo/actions
+2. Check the latest push to `main`
+3. Verify both workflows show green checkmarks:
+   - **CI / test (push)** - Rust tests pass
+   - **CI / lint (push)** - Format and clippy pass
+
+Do NOT proceed if CI is failing.
+
+### 6. Create Release Tag
+
+```bash
+git tag vX.Y.Z
+git push origin vX.Y.Z
+```
+
+### 7. Verify Release Workflow
+
+After pushing the tag:
+
+1. Go to: https://github.com/tstone-1/xlsxturbo/actions
+2. Watch the **Release** workflow
+3. Verify all jobs succeed:
+   - **linux** (x86_64, aarch64)
+   - **windows** (x64)
+   - **macos** (x86_64, aarch64)
+   - **sdist**
+   - **Publish to PyPI**
+
+### 8. Verify PyPI Publication
+
+1. Go to: https://pypi.org/project/xlsxturbo/
+2. Verify new version appears
+3. Test installation: `pip install xlsxturbo==X.Y.Z`
+
+## Troubleshooting
+
+### CI Lint Fails
+
+```bash
+# Check what needs formatting
+cargo fmt --check
+
+# Auto-fix formatting
+cargo fmt
+
+# Check clippy warnings
+cargo clippy -- -D warnings
+```
+
+### Release Workflow Fails
+
+1. Check which job failed in GitHub Actions
+2. Common issues:
+   - **Build fails**: Check Cargo.toml dependencies
+   - **PyPI publish fails**: Check PyPI trusted publisher settings
+   - **Wheel build fails**: Check maturin configuration
+
+### Maturin Develop Doesn't Update
+
+If changes aren't reflected after `maturin develop`:
+
+```bash
+# Uninstall and reinstall
+pip uninstall xlsxturbo -y
+pip install .
+```
+
+## GitHub Actions Summary
+
+| Workflow | Trigger | Jobs |
+|----------|---------|------|
+| CI | Push/PR to main | `test` (cargo test), `lint` (fmt + clippy) |
+| Release | Push tag `v*` | Build wheels (linux/win/mac) + PyPI publish |

{xlsxturbo-0.7.0 → xlsxturbo-0.9.0}/CHANGELOG.md

@@ -5,13 +5,63 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.0] - 2026-01-15
+
+### Added
+- **Conditional formatting** - Visual formatting based on cell values
+  - `2_color_scale`: Gradient from min_color to max_color
+  - `3_color_scale`: Three-color gradient with min/mid/max colors
+  - `data_bar`: In-cell bar chart with customizable color, direction, solid fill
+  - `icon_set`: Traffic lights, arrows, flags (3/4/5 icons), with reverse and icons_only options
+  - Supports column name patterns: `'price_*': {'type': 'data_bar', ...}`
+  - Available in both `df_to_xlsx()` and `dfs_to_xlsx()` with per-sheet overrides
+  - Example: `conditional_formats={'score': {'type': '2_color_scale', 'min_color': '#FF0000', 'max_color': '#00FF00'}}`
+- **Formula columns** - Add calculated columns with Excel formulas
+  - Use `{row}` placeholder for row numbers (1-based)
+  - Columns appear after data columns
+  - Order preserved (first formula = first new column)
+  - Available in both `df_to_xlsx()` and `dfs_to_xlsx()` with per-sheet overrides
+  - Example: `formula_columns={'Total': '=A{row}+B{row}', 'Percentage': '=C{row}/D{row}*100'}`
+- **Merged cells** - Merge cell ranges for headers, titles, and grouped labels
+  - Uses Excel notation for ranges (e.g., 'A1:D1')
+  - Optional formatting with HeaderFormat options (bold, colors, etc.)
+  - Available in both `df_to_xlsx()` and `dfs_to_xlsx()` with per-sheet overrides
+  - Example: `merged_ranges=[('A1:C1', 'Title'), ('A2:C2', 'Subtitle', {'bold': True})]`
+- **Hyperlinks** - Add clickable links to cells
+  - Uses Excel notation for cell reference (e.g., 'A1', 'B5')
+  - Optional display text (defaults to URL if not provided)
+  - Available in both `df_to_xlsx()` and `dfs_to_xlsx()` with per-sheet overrides
+  - Example: `hyperlinks=[('A2', 'https://example.com'), ('B2', 'https://google.com', 'Google')]`
+
+## [0.8.0] - 2026-01-15
+
+### Added
+- **Date order parameter** - `date_order` for `csv_to_xlsx()` to handle ambiguous dates
+  - `"auto"` (default): ISO first, then European (DMY), then US (MDY)
+  - `"mdy"` or `"us"`: US format where 01-02-2024 = January 2nd
+  - `"dmy"` or `"eu"`: European format where 01-02-2024 = February 1st
+  - Also available in CLI: `--date-order us`
+- **BUILD.md** - Developer guide for building, testing, and releasing
+
+### Fixed
+- **Pattern matching order** - `column_formats` patterns now match in definition order (first match wins). Previously, HashMap iteration order was non-deterministic.
+- **Empty DataFrame with table_style** - No longer crashes; tables are skipped when DataFrame has no data rows
+- **Hex color validation** - Colors like `#FF` now raise descriptive error instead of silently misparsing
+- **Invalid table_style validation** - Unknown styles now raise error instead of silently defaulting to Medium9
+- **CLI division by zero** - Instant conversions now show "instant rows/sec" instead of "inf"
+
+### Changed
+- Uses `indexmap` crate to preserve pattern insertion order
+- Updated `pyo3` 0.23 → 0.27, `rust_xlsxwriter` 0.79 → 0.92
+- Added Dependabot for automated dependency updates
+
 ## [0.7.0] - 2025-12-28
 
 ### Added
 - **Column formatting with wildcards** - `column_formats` parameter for styling columns by pattern
   - Wildcard patterns: `prefix*`, `*suffix`, `*contains*`, or exact match
   - Format options: `bg_color`, `font_color`, `num_format`, `bold`, `italic`, `underline`, `border`
-  - Example: `column_formats={'mcpt_*': {'bg_color': '#D6EAF8', 'num_format': '0.00000', 'border': True}}`
+  - Example: `column_formats={'price_*': {'bg_color': '#D6EAF8', 'num_format': '$#,##0.00', 'border': True}}`
   - Available in both `df_to_xlsx()` and `dfs_to_xlsx()`
   - Per-sheet column formats via options dict in `dfs_to_xlsx()`
 
@@ -121,6 +171,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for custom sheet names
 - Verbose mode for progress reporting
 
+[0.9.0]: https://github.com/tstone-1/xlsxturbo/releases/tag/v0.9.0
+[0.8.0]: https://github.com/tstone-1/xlsxturbo/releases/tag/v0.8.0
 [0.7.0]: https://github.com/tstone-1/xlsxturbo/releases/tag/v0.7.0
 [0.6.0]: https://github.com/tstone-1/xlsxturbo/releases/tag/v0.6.0
 [0.5.0]: https://github.com/tstone-1/xlsxturbo/releases/tag/v0.5.0