refactor: fold web_fragments into XBlock python project

CHANGELOG.rst

@@ -5,6 +5,12 @@ Change history for XBlock
 Unreleased
 ----------
 
+6.2.0 - 2026-06-09
+------------------
+
+* Migrated web_fragments into XBlock's project. You should remove web_fragments as a separate dependency if you
+  currently depend on it directly.
+
 5.3.0 - 2025-12-19
 ------------------
 

Makefile

@@ -21,7 +21,7 @@ help: ## display this help message
 
 quality: ## check coding style with pycodestyle and pylint
 	pycodestyle
-	pylint xblock
+	pylint xblock web_fragments
 
 validate: test
 

docs/fragments.rst

@@ -0,0 +1,11 @@
+.. _Fragments API:
+
+#############
+Fragments API
+#############
+
+.. automodule:: web_fragments.fragment
+    :members:
+
+.. autoclass:: web_fragments.views.FragmentView
+    :members:

docs/index.rst

@@ -21,5 +21,6 @@ in depth and guides developers through the process of creating an XBlock.
     runtime
     plugins
     exceptions
+    fragments
     xblock-tutorial/index
     xblock-utils/index

pyproject.toml

@@ -33,7 +33,6 @@ dependencies = [
     "pytz",
     "pyyaml",
     "simplejson",
-    "web-fragments",
     "webob>=1.6.0",
 ]
 
@@ -54,10 +53,15 @@ local_scheme = "no-local-version"
 include-package-data = true
 
 [tool.setuptools.packages.find]
+include = [
+    "xblock*",
+    "web_fragments*",
+]
 
 [tool.setuptools.package-data]
 "xblock.utils" = ["public/*", "templates/*", "templatetags/*"]
 "xblock.test.utils" = ["data/*"]
+"web_fragments" = ["templates/*"]
 
 [dependency-groups]
 # Base test packages, no Django version pinned

tox.ini

@@ -4,7 +4,7 @@ requires = tox-uv>=1
 
 [pytest]
 DJANGO_SETTINGS_MODULE = xblock.test.settings
-addopts = --cov xblock
+addopts = --cov xblock --cov web_fragments
 filterwarnings = always
 norecursedirs = .* docs requirements
 
@@ -14,7 +14,7 @@ dependency_groups =
     django42: django42
     django52: test
 commands =
-    python -Wd -m pytest {posargs:xblock}
+    python -Wd -m pytest {posargs:xblock web_fragments}
     python -m coverage xml
 allowlist_externals =
     make

web_fragments/__init__.py

@@ -0,0 +1,3 @@
+"""
+Web fragments.
+"""

web_fragments/apps.py

@@ -0,0 +1,12 @@
+"""
+Web Fragments Django application initialization.
+"""
+from django.apps import AppConfig
+
+
+class WebFragmentsConfig(AppConfig):
+    """
+    Configuration for the Web Fragments Django application.
+    """
+
+    name = 'web_fragments'

web_fragments/examples/urls.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python
+
+"""
+Provides a URL for testing
+"""
+from django.urls import path
+
+from web_fragments.examples.views import EXAMPLE_FRAGMENT_VIEW_NAME, ExampleFragmentView
+
+urlpatterns = [
+    path('test_fragment', ExampleFragmentView.as_view(), name=EXAMPLE_FRAGMENT_VIEW_NAME),
+]

web_fragments/examples/views.py

@@ -0,0 +1,25 @@
+#!/usr/bin/env python
+
+"""
+Example fragment view.
+"""
+from web_fragments.fragment import Fragment
+from web_fragments.test_utils import TEST_CSS, TEST_HTML, TEST_JS
+from web_fragments.views import FragmentView
+
+EXAMPLE_FRAGMENT_VIEW_NAME = 'example_fragment_view'
+
+
+class ExampleFragmentView(FragmentView):
+    """
+    Simple fragment view for testing.
+    """
+
+    def render_to_fragment(self, request, **kwargs):
+        """
+        Returns a simple fragment
+        """
+        fragment = Fragment(TEST_HTML)
+        fragment.add_javascript(TEST_JS)
+        fragment.add_css(TEST_CSS)
+        return fragment