chore: modernize Python repo to uv + pyproject.toml

[farhan]

Important

Written with the assistance of Claude Code, human-reviewed before posting.

Modernize django-wiki
Part of openedx/public-engineering#506

Summary

• Package is published to PyPI as openedx-django-wiki.
• Move the wiki and django_notify packages into a src/ layout; the testproject/wiki and testproject/django_notify symlinks now point to ../src/*.
• Replace setup.py with pyproject.toml (PEP 621 static metadata) and set requires-python = ">=3.12" (pyproject.toml:8); edx_release had no python_requires and already tested only on 3.12.
• Switch from pip-compile to uv with PEP 735 dependency groups (pyproject.toml:48-75) and commit uv.lock.
• Add a docs tox env (tox.ini:15-21) and CI job (.github/workflows/ci.yml:16).
• Update CI to use astral-sh/setup-uv and SHA-pin all actions.
• Add python-semantic-release and .github/workflows/release.yml (OIDC trusted publishing), releasing from edx_release.
• Mark CHANGELOG.md as deprecated (CHANGELOG.md:1); release notes now live on GitHub Releases.

Removed/Updated

Deleted files: setup.py, requirements/, openedx.yaml (legacy OEP-2 metadata), .github/workflows/pypi-publish.yml (superseded by release.yml)

Updated Makefile targets:

Target	Change
upgrade	pip-compile commands replaced with edx_lint write_uv_constraints pyproject.toml + uv lock --upgrade (Makefile:3-5)
test	New; runs pytest --cov wiki --cov django_notify from testproject/ (Makefile:7-8); called by the django42/django52 tox envs
docs	New; runs make -C docs html (Makefile:10-11); called by the docs tox env

Versioning

setuptools-scm with dynamic = ["version"] (pyproject.toml:33) and fallback_version = "0.0.0.dev0" (pyproject.toml:109). edx_release had a PyPI publish workflow; python-semantic-release now controls the version string at release time via git tags. The latest tag v3.1.2 matches the latest PyPI release, so it is the release baseline. src/wiki/__init__.py exposes __version__ via importlib.metadata.

Important Notes

• Default branch is edx_release, not master. .github/workflows/release.yml targets edx_release in all 3 places (push trigger at line 5, if: guards at lines 14 and 70), and pyproject.toml:103-104 adds [tool.semantic_release.branches.edx_release], because PSR only releases from main/master by default. Without this, the release job would pass and publish nothing. Feanil agreed with this approach in chore: modernize Python repo to uv + pyproject.toml #329 (comment).
• .github/workflows/ci.yml drops the push: branches: [master] trigger. release.yml calls ci.yml via workflow_call, so a push trigger would run CI twice on every merge (see platform-plugin-aspects#257).
• .github/workflows/ci.yml keeps the workflow name Python CI for parity. --locked is used only on uv sync (line 31), not on uv run. There is no fetch-depth: 0, no secrets: inherit and no Codecov step.
• CI check names change from Tests (ubuntu-latest, 3.12, djangoXY) to docs, django42 and django52. The only required status check on edx_release is openedx/cla, so no required checks are affected.
• pyproject.toml metadata matches setup.py except authors, which uses the org-standard Open edX Project <oscm@openedx.org> (as in openedx/sample-plugin and build: modernize Python packaging to uv + pyproject.toml (PEP 621) openedx-atlas#78) instead of Benjamin Bach. It keeps the same classifiers including Operating System :: OS Independent, and no Natural Language / Python :: 3 classifiers. The License :: OSI Approved :: GNU General Public License v3 (GPLv3) classifier is dropped in favour of the PEP 639 license = "GPL-3.0-only" expression (pyproject.toml:9).
• The README settings link now points to src/wiki/conf/settings.py (README.md:79), and the Development setup step now uses uv sync --group dev instead of pip install -r requirements.txt (README.md:130).
• MANIFEST.in excludes testproject/ and repo-only files (pylintrc, catalog-info.yaml, model_chart_wiki.pdf, CHANGELOG.md, TODO.md, uv.lock) from the sdist.
• Wheel parity was checked by building the wheel from edx_release and from this branch. The PR wheel has every file from the edx_release wheel, plus 5 doc files inside the package dirs: wiki/COPYING, django_notify/COPYING, django_notify/README.md, wiki/plugins/images/static/wiki/colorbox/README.md and wiki/plugins/notifications/TODO.md. Requires-Dist is unchanged.

Out of Scope

Item	Notes	Next action
pylint quality env	edx_release never ran pylint in tox, the Makefile or CI, so no quality env is added (parity). pylintrc is kept.	Follow-up PR: fix pylint errors in the code base, then add quality as a real gate

Testing Notes

Note: PR creator has tested the PR via CI and building the packages manually. No manual testing has been done to test the repo features. It will be great if the repo owner could test it.

---

🤖 Generated with Claude Code

[farhan]

Caution

release.yml targets master — auto-releases will never fire after this PR merges

This repo's default branch is edx_release. The master branch exists but has had no commits since November 2014 — all development merges into edx_release.

Why this is a breaking change: The existing pypi-publish.yml (deleted by this PR) triggered on on: release: types: [published] — a manually created GitHub Release. That flow worked regardless of branch name. This PR replaces it with PSR auto-release on push to a branch. That branch is master, which never receives commits, so PSR will never run and PyPI publishing is effectively broken from day one after merge.

As currently written, release.yml listens on branches: [master] and guards both the release and publish_to_pypi jobs with if: github.ref_name == 'master'.

Fix: Update the three occurrences in .github/workflows/release.yml:

• on.push.branches: [master] → [edx_release]
• if: github.ref_name == 'master' (×2) → 'edx_release'

@feanil -- Can you please look/share your thoughts into this issue or tag the relevant maintainer

[feanil]

That makes sense to me.

[farhan]

@feanil FYI: this PR changes the package author from Benjamin Bach <benjamin@overtag.dk> (edx_release setup.py) to the org-standard Open edX Project <oscm@openedx.org>.