aboutsummaryrefslogtreecommitdiff
path: root/webmentions_ssg/forms/sources.py
diff options
context:
space:
mode:
authorDennis Fink2026-11-18 21:13:34 +0100
committerDennis Fink2026-11-18 21:13:34 +0100
commitb2b5429bcf008db357d9d65db77ba37f7af908a8 (patch)
treeed913ee050817609b56d2f5515b2c3fbc9945a75 /webmentions_ssg/forms/sources.py
parentbeb0131b089293512c2dab2243b9b2ff314e2387 (diff)
downloadwebmentions-ssg-b2b5429bcf008db357d9d65db77ba37f7af908a8.tar.gz
webmentions-ssg-b2b5429bcf008db357d9d65db77ba37f7af908a8.zip
feat(sender): add source list filters and sorting
Add status, search, date, sorting, and page-size controls to the source list with validated query parameters and stable pagination. Preserve list context across source details, rescans, resends, and pagination, and surface failed and retrying delivery counts with retry deadlines.
Diffstat (limited to '')
-rw-r--r--webmentions_ssg/forms/sources.py81
1 files changed, 81 insertions, 0 deletions
diff --git a/webmentions_ssg/forms/sources.py b/webmentions_ssg/forms/sources.py
new file mode 100644
index 0000000..04afe77
--- /dev/null
+++ b/webmentions_ssg/forms/sources.py
@@ -0,0 +1,81 @@
+# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
+#
+# SPDX-License-Identifier: BSD-3-Clause
+
+"""Source document filtering form."""
+
+from flask import current_app
+from flask_wtf import FlaskForm
+from wtforms import (
+ DateField,
+ HiddenField,
+ IntegerField,
+ SearchField,
+ SelectField,
+ ValidationError,
+)
+from wtforms.validators import AnyOf, NumberRange, Optional
+
+from .validators import CanonicalDate
+
+SOURCE_STATUS_CHOICES = {
+ "": "All sources",
+ "failing": "Failing sends",
+ "retrying": "Awaiting retry",
+ "deleted": "Deleted sources",
+}
+
+
+def default_source_page_size() -> int:
+ """Use 25 rows unless the configured maximum is lower."""
+ return min(25, current_app.config["SOURCES_MAX_PAGE_SIZE"])
+
+
+class SourceFilterForm(FlaskForm):
+ """GET filters for the source document list."""
+
+ status = SelectField("Status", choices=SOURCE_STATUS_CHOICES, default="")
+ q = SearchField("Path or URL")
+ date_from = DateField(
+ "Last seen from (UTC)", validators=[Optional(), CanonicalDate()]
+ )
+ date_to = DateField("Last seen to (UTC)", validators=[Optional(), CanonicalDate()])
+ sort = HiddenField(
+ default="last_seen",
+ validators=[
+ AnyOf(
+ (
+ "path",
+ "url",
+ "webmentions",
+ "revision",
+ "created",
+ "last_seen",
+ "status",
+ )
+ )
+ ],
+ )
+ order = HiddenField(default="desc", validators=[AnyOf(("asc", "desc"))])
+ per_page = IntegerField(
+ "Rows per page",
+ default=default_source_page_size,
+ validators=[NumberRange(min=1)],
+ )
+
+ def validate_per_page(self, field: IntegerField) -> None:
+ """Enforce the deployment's maximum source-list page size."""
+ if (
+ field.data is not None
+ and field.data > current_app.config["SOURCES_MAX_PAGE_SIZE"]
+ ):
+ raise ValidationError("Rows per page exceeds the configured maximum.")
+
+ def validate_date_to(self, field: DateField) -> None:
+ """Require an end date on or after the start date."""
+ if (
+ self.date_from.data is not None
+ and field.data is not None
+ and field.data < self.date_from.data
+ ):
+ raise ValidationError("End date must be on or after start date.")