Skip to content

Install mcpy in the docs workflow and run it on pull requests - #34

Merged
farrisric merged 1 commit into
mainfrom
fix/docs-workflow-install
Aug 24, 2026
Merged

farrisric merged 1 commit into
mainfrom
fix/docs-workflow-install

Conversation

@farrisric

Copy link
Copy Markdown
Owner

The Pages docs job builds with -W, and it never installs the package, so
sphinx.ext.autodoc cannot import mcpy. Every push to main since #32 failed
with 37 No module named 'mcpy' warnings. #33 fixed the same cause on the Read
the Docs side only, which is why main still fails.

It also ran only on pushes to main, so no pull request could catch it: the one
place the docs are compiled with warnings as errors never saw a PR. Now:

  • pip install . alongside sphinx and the theme,
  • the workflow runs on pull_request as well,
  • the Pages upload, the deploy job and the Read the Docs trigger are gated to
    non-PR events, so nothing publishes from a branch.

Verified locally with the exact CI command in a clean env holding only sphinx,
sphinx_rtd_theme==3.0.1, myst_parser==3.0.1 and mcpy:

sphinx-build -W --keep-going -b html docs _build   ->  build succeeded.

The same env without mcpy reproduces the 37 warnings.

The GitHub Pages docs job builds with -W, and it does not install the package
either, so it failed with 37 "No module named 'mcpy'" warnings on the merge of
#32. Same cause as the Read the Docs fix in the previous commit, different
builder.

It also ran only on pushes to main, which is why no pull request could ever
catch it: the one place the docs are compiled with warnings as errors never
saw a PR. It now runs on pull requests too, with the Pages upload, the deploy
job and the Read the Docs trigger gated to non-PR events so nothing publishes
from a branch.
@farrisric
farrisric merged commit 79cf857 into main Aug 24, 2026
7 checks passed
@farrisric
farrisric deleted the fix/docs-workflow-install branch August 24, 2026 14:19
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