openedx / openedx/xblocks-core
Switch to top-level Python packages
Open
@kdmccormick is already working on this.
Since May 4, 2026.
- Dominant language
- Python
- Stars
- 0
- Forks
- 15
- Avg merge
- 5d 16m
- Merged PRs (30d)
- 7
Description
Instead of:
- xblock_pdf/
- xblocks_contrib/
- html/
- problem/
- etc.
We should move to:
- src/
- xblock_pdf/
- xblock_html/
- xblock_problem/
- etc.
And the import roots will change:
- Before:
from xblock_contrib.problem import ProblemBlock - After:
from xblock_problem import ProblemBlock
Why?
- It matches the structure of xblocks-extra
- It allows us to move xblocks into and out of xblocks-extra, xblocks-core, and other repositories without changing their import paths. It decouples their public API from our specific way of structuring the blocks, allowing us to keep the API stable as maintenance needs change and architectural decisions are made.
Contributor guide
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.
Assessment
This issue has not been assessed yet.