build!: Declare Python dependencies in pyproject.toml#38769
Draft
kdmccormick wants to merge 1 commit into
Draft
Conversation
Before this change, openedx-platform deps had to be installed in two steps (using `pip` or `uv pip`): # first, install dependencies. one of the following: pip install -r requirements/edx/base.txt pip install -r requirements/edx/development.txt pip install -r requirements/edx/testing.txt pip install -r requirements/edx/doc.txt # then, compile metadata for entrypoints: pip install -e . Now, with the dependencies listed in pyproject.toml, it's only one step: # one of the following: pip install -e '.' pip install -e '.[development]' pip install -e '.[testing]' pip install -e '.[doc]' BREAKING CHANGE: Running `pip install -e .` or other similar commands will now install all of openedx-platform's base dependencies. This command used to run very quickly, but now it will take longer, you may want to adjust the command's position in your build scripts. Otherwise, this change is backwards-compatible; it is still fine to run both `pip install -r <file>` and `pip install -e .`, just redundant. This brings the project more in line with Python standards and will make it easier to install and run the platform outside of an environment manager like Tutor. Note that this commit does NOT do anything to install build dependencies (assets.txt) in a more standard way; that could be a future work. Bumps version to 0.14
feanil
reviewed
Jun 16, 2026
feanil
left a comment
Contributor
There was a problem hiding this comment.
This seems fine but is now part way to the full transition we're making in other repos. I'm not against it but will muddle things when we want to switch fully to uv and uv.lock for this. What do you think about asking aximprovements to modernize this repo sooner rather than later instead?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Before this change, openedx-platform deps had to be installed in two steps (using
piporuv pip):Now, with the dependencies listed in pyproject.toml, it's only one step:
BREAKING CHANGE: Running
pip install -e .or other similar commands will now install all of openedx-platform's base dependencies. This command used to run very quickly, but now it will take longer, you may want to adjust the command's position in your build scripts. Otherwise, this change is backwards-compatible; it is still fine to run bothpip install -r <file>andpip install -e ., just redundant.This brings the project more in line with Python standards and will make it easier to install and run the platform outside of an environment manager like Tutor. Note that this commit does NOT do anything to install build dependencies (assets.txt) in a more standard way; that could be a future work.
Bumps version to 0.14
Testing
With the Makefile and workflow updates, most CI shards will use this new path to install requirements in one go, which will smoke-test the change.
I'm also building a sandbox on this PR and will smoke-test on it.
Merge deadline
None, although it would be nice to have this in so I can continue working on a reproducible Tutor-less dev setup.
https://github.com/kdmccormick/openedx-template-site