# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause """Received Webmention 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 RECEIVED_STATUS_CHOICES = { "": "All statuses", "pending": "Pending", "verifying": "Verifying", "verified": "Verified", "declined": "Declined", } def default_received_page_size() -> int: """Use 25 rows unless the configured maximum is lower.""" return min(25, current_app.config["RECEIVED_MAX_PAGE_SIZE"]) class ReceivedWebmentionFilterForm(FlaskForm): """GET filters for the received Webmention list.""" status = SelectField("Status", choices=RECEIVED_STATUS_CHOICES, default="") q = SearchField("Source or target") date_from = DateField( "Updated from (UTC)", validators=[Optional(), CanonicalDate()] ) date_to = DateField("Updated to (UTC)", validators=[Optional(), CanonicalDate()]) sort = HiddenField( default="received", validators=[AnyOf(("received", "updated", "status", "source", "target"))], ) order = HiddenField(default="desc", validators=[AnyOf(("asc", "desc"))]) per_page = IntegerField( "Rows per page", default=default_received_page_size, validators=[NumberRange(min=1)], ) def validate_per_page(self, field: IntegerField) -> None: """Enforce the deployment's maximum received-list page size.""" if ( field.data is not None and field.data > current_app.config["RECEIVED_MAX_PAGE_SIZE"] ): raise ValidationError("Rows per page exceeds the configured maximum.") def validate_date_to(self, field: DateField) -> None: """Require the end date to be 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.")