usage_python vignette fails with mudata >= 0.4
Nobody has claimed this yet.
- Dominant language
- R
- Stars
- 196
- Forks
- 22
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 7
Description
The usage_python vignette fails on CI since 2026-08-17, breaking R-CMD-check, r-universe and pkgdown on every branch:
Quitting from usage_python.Rmd:119-127 [load_mudata_example]
! anndata._io.specs.registry.IORegistryError: No read method registered for IOSpec(encoding_type='AnnData', encoding_version='0.1.0') from <class 'h5py._hl.group.Group'>. You may need to update your installation of anndata.
Cause
mudata 0.4.0 (released 2026-08-17) rewrote read_h5mu() to dispatch modality groups through anndata's IO registry on the encoding-type attribute. The example file used in the vignette (minipbcite.h5mu) was written by mudata <= 0.1.1 and stores encoding-type: "AnnData", while the registry only knows the lowercase "anndata" that mudata has written since 0.1.2. mudata's own backwards-compatibility test archives only go back to v0.1.2, so this went unnoticed upstream.
Verified locally:
- mudata 0.3.10 + anndata 0.12: reads the file fine
- mudata 0.4.0 / 0.4.1, with anndata 0.12 or 0.13:
IORegistryError - mudata 0.4.1 after rewriting the attribute to
"anndata": reads the file fine
Minimal reproducible example (no R needed):
curl -sLO https://github.com/gtca/h5xx-datasets/raw/b1177ac8877c89d8bb355b072164384b4e9cc81d/datasets/minipbcite.h5mu
uv run --with "mudata==0.4.1" python -c "import mudata; mudata.read_h5mu('minipbcite.h5mu')"
Plan
- Pin
mudata<0.4in the vignette so CI is green again - Report the regression upstream to scverse/mudata -- a fallback for the legacy capitalised
encoding-typewould fix it -- or switch the vignette to an example file written by a recent mudata - Remove the pin once either of those lands
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with vignettes/usage_python.Rmd lines 119-127 and run the provided uv command with mudata 0.4.1 to reproduce the failure. Pin mudata below 0.4 or update the example file as described, then verify that the vignette completes and R-CMD-check, r-universe, and pkgdown are no longer broken.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python, r
- Domain
- ci-cd, documentation
- Issue type
- Bug
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 74/100