Mark Jinja as optional dependency

Author: stephane

README.md

@@ -30,10 +30,16 @@ To upgrade to `webstack-django-sorting` v1.0.0+, you must remove the old middlew
 
 ## How to use it in your project
 
-The provide is available on PyPI:
+The package is available on PyPI:
 
 ```shell
-uv add webstack_django_sorting
+uv add webstack-django-sorting
+```
+
+For Jinja2 template support, install with the optional dependency:
+
+```shell
+uv add webstack-django-sorting[jinja2]
 ```
 
 The project provides examples of integration with Django and Jinja2 templates.

pyproject.toml

@@ -28,6 +28,9 @@ classifiers = [
     "Natural Language :: English",
 ]
 
+[project.optional-dependencies]
+jinja2 = ["jinja2>=3.0"]
+
 [project.urls]
 repository = "https://github.com/webstack/webstack-django-sorting.git"
 changelog = "https://github.com/webstack/webstack-django-sorting/blob/master/CHANGELOG.md"
@@ -45,6 +48,7 @@ dev = [
     "ruff>=0.8",
     "mypy>=1.0",
     "django-stubs>=5.0",
+    "jinja2>=3.1.6",
 ]
 
 [tool.hatch.metadata]

src/testproj/uv.lock

@@ -3,7 +3,14 @@
 
 from django.db.models import QuerySet
 from django.http import HttpRequest
-from markupsafe import Markup
+
+try:
+    from markupsafe import Markup
+except ImportError as e:
+    raise ImportError(
+        "Jinja2 support requires the 'jinja2' package. "
+        "Install it with: uv add webstack-django-sorting[jinja2]"
+    ) from e
 
 from . import common
 

src/webstack_django_sorting/jinja2_globals.py

@@ -82,7 +82,7 @@ def render(self, context: Context) -> str:
                 raise Http404(
                     "Invalid field sorting. If INVALID_FIELD_RAISES_404 were set to "
                     "False, the error would have been ignored."
-                )
+                ) from None
             context[key] = queryset
 
         return ""