build!: Restructure repo & rename to xblocks-core

[kdmccormick]

Related

• Switch to top-level Python packages #237
• Rename the repo to xblocks-core #149
• build: Upgrade to xblocks-core openedx-platform#38473

Description

Overview

This PR reshapes the project around two breaking changes: it renames the distribution from xblocks-contrib
to xblocks-core, and it restructures the codebase so each built-in XBlock lives in its own standalone
package under src/.

The changes are broken down by commit, with the major ones highlighted below.

Rename: xblocks-contrib → xblocks-core

The project was originally named "xblocks-contrib" after django.contrib, but "Contrib" isn't a widely
understood term in Open edX, whereas "Core Blocks" is. Since the project is still new, we're renaming it
now. This updates the PyPI package name, the GitHub repository URL, the development-status classifier (Alpha
→ Production/Stable), and all README and documentation references. No code or file layout changes are part
of the rename itself.

Restructure: one package per XBlock under src/

Previously all built-in XBlocks shared a single xblocks_contrib namespace package
(xblocks_contrib.annotatable, xblocks_contrib.video, etc.), with xblock_pdf as a separate exception.
Each XBlock now lives in its own standalone package under src/:

src/xblock_annotatable/
src/xblock_discussion/
src/xblock_html/
src/xblock_lti/
src/xblock_pdf/
src/xblock_poll_question/
src/xblock_problem/
src/xblock_video/
src/xblock_word_cloud/
src/xblocks_core/          (shared legacy utilities)

Each package has a single block.py entry point, an __init__.py that re-exports the block class, and its
own conf/locale/ and .tx/config for translations. This makes it straightforward to eventually publish
any XBlock as an independently versioned package, and makes it low-risk to add new blocks without changing
their import paths.

A couple of notable details:

• The poll XBlock becomes xblock_poll_question rather than xblock_poll, because xblock_poll is already
  registered on PyPI by OpenCraft's polling XBlock. The entry-point key was already
  _poll_question_extracted, so consumers using the entry-point API are unaffected — only direct Python
  imports of xblocks_contrib.poll change.
• Dev and prod static-asset paths are now the same (public/<asset> relative to each block), removing a
  special-case code path that produced different paths in the two environments.

Supporting changes

The remaining commits are follow-on build and cleanup work to support the new layout: updated test and
coverage configuration for the src/ layout, an explicit webpack-merge dev dependency, a
package-lock.json regeneration to pick up the pdf-block Vitest dependency tree, a ruff format pass,
and removal of a redundant pip install from the docs tox environment.

BREAKING CHANGES (across all commits)

• The distribution is renamed from xblocks-contrib to xblocks-core.
• Direct Python imports move from the shared xblocks_contrib.* namespace to per-block packages (e.g.
  xblocks_contrib.poll → xblock_poll_question). Consumers using the XBlock entry-point API are unaffected.

AI

Opus did the first-pass restructuring. Feanil and I both added fixes of our own. I reviewed all changes line-by-line/

The git history became a mess, so I used Sonnet to split it back up into multiple commits.

Testing

Needs to be tested with the accompanying platform PR:

• build: Upgrade to xblocks-core openedx-platform#38473

I validated that this works with dev settings on my machine using my bare-metal setup.

I validated that this works with prod settings using the sandbox on the linked openedx-platform PR.

Testing process:

• import demo course
• add block types which are not in the demo course: pdf, lti, poll_question, annotatable?, discussion?, word_cloud?, survey?
• import demo course content into a V2 content library
• ensure a block of each type can be edited, previewed, and published from the library.
• in a new course, add a block of each type from the library.
• ensure each block can be edited and previewed. publish all.
• view in LMS. ensure they can be viewed and, if relevent, submitted.
• downloadable test course: (download link)

[kdmccormick]

Does this matter?

[feanil]

The only mention of this is in this file and I didn't see any mention of this in the openedx-platform history so I have no idea.

[farhan]

We added it for testing purpose to differentiate between BuiltIn and Extracted Block at brower.

• renaming with repo sounds good.
• We can remove it after removal of BuiltIn blocks, removing now seems alright as well as we are pretty much done with the major testing.

[kdmccormick]

Suggested change

	fail-fast: false
	fail-fast: true

Note to self: Undo this before merging

[kdmccormick]

@feanil Tests all pass on this locally. I'm still manually testing and waiting on GHA to catch up, but feel free to take a look if you have time. You can review commit-by-commit.

[feanil]

I tried to do as thorough a review as I could on this big change, but there are a lot of moving parts so the openedx-platform testing will be critical for this. That said, a not for other reviewers is that the consolidated diff makes reading the translations changes a bit confusing since it makes it seem like translations conf files were move around in between blocks. But looking at the commit diffs it's more obvious what's going on.

[feanil]

The only mention of this is in this file and I didn't see any mention of this in the openedx-platform history so I have no idea.

[kdmccormick]

Thanks @feanil !

Per my latest testing, this is working fine on tutor dev, but failing on tutor local:

I'll hold off until merging until I can fix local.

[farhan]

LGTM!

Skipped translations code review as it needs to work on it later on.

[farhan]

Suggested change

	* Done: The built-in block has been removed. The setup.py entrypoint has been removed from edx-platform and added to xblock-core.