Skip to content

Conversation

@KostaIlic2
Copy link

@KostaIlic2 KostaIlic2 commented Dec 19, 2025

What does this Pull Request accomplish?

I encountered unexpected doctest failures, and got copilot to fix them. To prevent this situation in the future, I got copilot to add doctests to the pipeline. I then tracked down that acceptance tests are also not in CI, so I had copilot add those too.

Summary of changes:

  • Add doctest and acceptance test steps to run_unit_tests.yml workflow
  • Fix DigitalWaveformFailure doctest: remove column_index field that no longer exists in API
  • Fix _mask_to_column_indices doctest: add missing bitorder parameter

This ensures doctests are run as part of CI to catch future API/documentation mismatches. It also ensures acceptance tests are run as part of CI.

Why should this Pull Request be merged?

To reduce probability of incorrect documentation examples and surprises with acceptance tests in the future. And to unblock future contributions.

What testing has been done?

I leaned on draft PR pipeline build for required automated QA.

Root Cause Analysis

I asked copilot to figure out which PR broke doctests. Here is what it figured:

PR #222 "Reverse Indices for Digital Waveform Signals" broke the doctests
👤 Author: Mike Prosser (@mikeprosserni)
📅 Date: December 10, 2025 (9 days ago)
🔗 Commit: 0108c35

- Add doctest step to run_unit_tests.yml workflow
- Fix DigitalWaveformFailure doctest: remove column_index field that no longer exists in API
- Fix _mask_to_column_indices doctest: add missing bitorder parameter

This ensures doctests are run as part of CI to catch future API/documentation mismatches.

Signed-off-by: Kosta Ilic <[email protected]>
@KostaIlic2 KostaIlic2 marked this pull request as ready for review December 19, 2025 03:15
With only 6 tests taking ~0.1s to run, acceptance tests provide valuable
integration testing coverage for memory-mapping functionality across
all OS/Python combinations with minimal CI overhead.

Signed-off-by: Kosta Ilic <[email protected]>
@KostaIlic2 KostaIlic2 changed the title Add doctests to CI pipeline and fix broken doctests Add doctests and acceptance tests to CI pipeline and fix broken doctests Dec 19, 2025
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