Add bid validation module with EUPHEMIA compliance checks

[tommed]

Summary

• Adds validation.py with comprehensive EUPHEMIA-compliance checks, data quality validation, temporal constraint enforcement, and portfolio-level sanity checks
• Exports all validation functions and exception types (ValidationError, EuphemiaValidationError, DataQualityError, TemporalValidationError, PortfolioValidationError) from the top-level package
• Documents validation usage with examples in the README

Test plan

• 248 tests pass (make test)
• 97% overall code coverage (validation module at 95%)
• mypy src — no issues
• ruff check src tests — all checks passed

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[tommed]

@claude can you improve the code coverage for the 7 lines missing in validation.py?

[claude]

Claude finished @tommed's task in 5m 14s —— View job

---

Improving code coverage for validation.py

• Read validation.py and test_validation.py to identify uncovered lines
• Add tests to cover the 7 missing lines:
  • Line 154: return in validate_price_step_increments for single-step curve → test_validate_price_step_increments_single_step_passes
  • Line 312: raise ValueError in validate_delivery_within_day for naive auction_day → test_validate_delivery_within_day_requires_timezone_aware_auction_day
  • Line 338: raise ValueError in validate_mtu_within_day for naive auction_day → test_validate_mtu_within_day_requires_timezone_aware_auction_day
  • Line 436: return in validate_exclusive_group_volumes for < 2 bids → test_validate_exclusive_group_volumes_single_bid_skips_check (uses model_construct to bypass the Pydantic validator that normally prevents < 2 bids)
  • Line 488: validate_linked_block_bid(bid) in validate_bid → test_validate_bid_dispatches_linked_block_bid
  • Line 490: validate_exclusive_group_bid(bid) in validate_bid → test_validate_bid_dispatches_exclusive_group_bid
  • Line 564: submission_time = datetime.now(UTC) → test_validate_order_book_for_submission_defaults_submission_time
• Commit and push changes

7 new tests added in tests/test_validation.py (+101 lines). The changes are pushed to the branch and CI should confirm 100% line coverage for validation.py.
|