aboutsummaryrefslogtreecommitdiff
path: root/webmentions_ssg/forms/endpoint.py
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--webmentions_ssg/forms/endpoint.py52
1 files changed, 52 insertions, 0 deletions
diff --git a/webmentions_ssg/forms/endpoint.py b/webmentions_ssg/forms/endpoint.py
new file mode 100644
index 0000000..e063e73
--- /dev/null
+++ b/webmentions_ssg/forms/endpoint.py
@@ -0,0 +1,52 @@
+# SPDX-FileCopyrightText: 2026 Dennis Fink <me+coding@dennisfink.me>
+#
+# SPDX-License-Identifier: BSD-3-Clause
+
+"""Webmention submission form."""
+
+from flask_wtf import FlaskForm
+from wtforms import Field, StringField, ValidationError
+from wtforms.validators import InputRequired
+
+from .validators import (
+ AllowedTargetHostname,
+ MaxURLBytes,
+ RejectNonPublicIPLiteral,
+ StrictHTTPURL,
+)
+
+
+class WebmentionSubmissionForm(FlaskForm):
+ """Form for receiving a Webmention.
+
+ The source must be a public HTTP or HTTPS URL distinct from the target.
+ The target must be an HTTP or HTTPS URL using an allowed hostname.
+ """
+
+ source = StringField(
+ "source",
+ validators=[
+ InputRequired(),
+ MaxURLBytes(),
+ StrictHTTPURL(),
+ RejectNonPublicIPLiteral(),
+ ],
+ )
+ target = StringField(
+ "target",
+ validators=[
+ InputRequired(),
+ MaxURLBytes(),
+ StrictHTTPURL(),
+ AllowedTargetHostname(),
+ ],
+ )
+
+ def validate_source(self, field: Field) -> None:
+ """Reject a source URL that equals the target URL.
+
+ :param field: Source URL field being validated.
+ :raises ValidationError: If the source URL equals the target URL.
+ """
+ if field.data == self.target.data:
+ raise ValidationError(field.gettext("Field must not be equal to target."))