Skip to content

release: prepare ExcelAlchemy 2.2.3#62

Merged
ruicore merged 1 commit intomainfrom
v2.2
Apr 3, 2026
Merged

release: prepare ExcelAlchemy 2.2.3#62
ruicore merged 1 commit intomainfrom
v2.2

Conversation

@ruicore
Copy link
Copy Markdown
Contributor

@ruicore ruicore commented Apr 3, 2026

Summary

This PR prepares the 2.2.3 release of ExcelAlchemy.

It continues the stable 2.x line with a focused validation fix in the Pydantic adapter layer, while keeping the public import/export workflow API stable.

What changed

Validation fix

  • restore explicit ProgrammaticError handling for unsupported annotated declarations that use native Python types instead of ExcelFieldCodec subclasses
  • tighten codec resolution in the Pydantic adapter so unsupported declarations fail at the codec resolution boundary instead of being treated as valid runtime metadata
  • preserve existing behavior for valid ExcelFieldCodec and CompositeExcelFieldCodec declarations

Regression coverage

  • add an integration regression test for unsupported annotated declarations
  • verify that native Python annotations paired with ExcelMeta(...) do not silently enter the workbook schema path

Release prep

  • add the 2.2.3 changelog entry
  • add docs/releases/2.2.3.md
  • mark 2.2.2 as a dated release in the changelog

Compatibility notes

  • no public import/export workflow API was removed
  • valid codec-based declarations continue to work unchanged
  • unsupported native annotations with ExcelMeta(...) now fail early with the intended ProgrammaticError

Verification

  • ./.venv/bin/ruff check src/excelalchemy/helper/pydantic.py tests/integration/test_excelalchemy_workflows.py
  • ./.venv/bin/uv run pyright
  • ./.venv/bin/pytest tests/integration/test_excelalchemy_workflows.py -q

Release intent

After merge, this branch is intended to be tagged and published as:

  • v2.2.3

@ruicore ruicore merged commit 6990613 into main Apr 3, 2026
5 checks passed
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 3, 2026

Codecov Report

❌ Patch coverage is 80.00000% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.56%. Comparing base (0a9f9ea) to head (9533324).
⚠️ Report is 3 commits behind head on main.

Files with missing lines Patch % Lines
src/excelalchemy/helper/pydantic.py 77.77% 1 Missing and 1 partial ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main      #62      +/-   ##
==========================================
- Coverage   86.60%   86.56%   -0.04%     
==========================================
  Files          48       48              
  Lines        3306     3313       +7     
  Branches      375      377       +2     
==========================================
+ Hits         2863     2868       +5     
- Misses        276      277       +1     
- Partials      167      168       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant