Skip to content

Comments

Refactor: move "contents" applet to be "media"#488

Merged
ormsbee merged 1 commit intoopenedx:mainfrom
ormsbee:media-refactor
Feb 23, 2026
Merged

Refactor: move "contents" applet to be "media"#488
ormsbee merged 1 commit intoopenedx:mainfrom
ormsbee:media-refactor

Conversation

@ormsbee
Copy link
Contributor

@ormsbee ormsbee commented Feb 20, 2026

BREAKING CHANGE for openedx-platform, as API function signatures and
model relations in openedx_content have changed:

- get_content -> get_media
- get_content_info_headers -> get_media_info_headers
- get_or_create_text_content -> get_or_create_text_media
- get_or_create_file_content -> get_or_create_file_media
- create_component_version_media -> create_component_version_media
- look_up_component_version_content -> look_up_component_version_media
- Content -> Media
- ComponentVersionContent -> ComponentVersionMedia
- ComponentVersion.contents -> ComponentVersion.media

The rationale for this change is that we use the term "content" as a
generic way to talk about all kinds of things: components, units,
courses, etc. We've also recently refactored so that the entire app is
called openedx_content. Changing our terminology to refer to raw data
blobs as "media" helps to reduce confusion.

Copy link
Member

@kdmccormick kdmccormick left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, pending checks. Haven't tested anything manually, though.

Could you add a ! and a BREAKING CHANGE notice to the commit message?

@ormsbee ormsbee force-pushed the media-refactor branch 2 times, most recently from fc72025 to 0da9906 Compare February 23, 2026 16:57
BREAKING CHANGE for openedx-platform, as API function signatures and
model relations in openedx_content have changed:

- get_content -> get_media
- get_content_info_headers -> get_media_info_headers
- get_or_create_text_content -> get_or_create_text_media
- get_or_create_file_content -> get_or_create_file_media
- create_component_version_media -> create_component_version_media
- look_up_component_version_content -> look_up_component_version_media
- Content -> Media
- ComponentVersionContent -> ComponentVersionMedia
- ComponentVersion.contents -> ComponentVersion.media

The rationale for this change is that we use the term "content" as a
generic way to talk about all kinds of things: components, units,
courses, etc. We've also recently refactored so that the entire app is
called openedx_content. Changing our terminology to refer to raw data
blobs as "media" helps to reduce confusion.

Updates version to 0.35.0.
@ormsbee ormsbee merged commit f7229c2 into openedx:main Feb 23, 2026
9 checks passed
@ormsbee ormsbee deleted the media-refactor branch February 23, 2026 20:01
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.

2 participants