{}",
+ obj.get_mechanism(),
+ )
diff --git a/spf_generator/apps.py b/spf_generator/apps.py
new file mode 100644
index 0000000..c761dd8
--- /dev/null
+++ b/spf_generator/apps.py
@@ -0,0 +1,10 @@
+"""App configuration for the SPF Generator app."""
+
+from django.apps import AppConfig
+
+
+class SpfGeneratorConfig(AppConfig):
+ """App configuration for the SPF Generator app."""
+
+ default_auto_field = "django.db.models.BigAutoField"
+ name = "spf_generator"
diff --git a/spf_generator/forms.py b/spf_generator/forms.py
new file mode 100644
index 0000000..ca69463
--- /dev/null
+++ b/spf_generator/forms.py
@@ -0,0 +1,104 @@
+"""Forms for the spf_generator app."""
+
+import ipaddress
+from typing import Any
+
+from django import forms
+from django.core.exceptions import ValidationError
+
+from spf_generator.models import EmailProvider, ProviderCategory, SpfAllMechanism
+
+
+def validate_ip_address(value: str) -> None:
+ """Validates if the string is a valid IPv4 or IPv6 address.
+
+ Args:
+ value: String to validate
+
+ Raises:
+ ValidationError: If the string is not a valid IP address
+ """
+ if not value:
+ return
+
+ try:
+ ipaddress.ip_address(value)
+ except ValueError as exc:
+ msg = "Please enter a valid IP address"
+ raise ValidationError(msg) from exc
+
+
+class ProviderSelectForm(forms.Form):
+ """Form for selecting email providers.
+
+ The form dynamically generates checkboxes for each active provider,
+ grouped by category.
+ """
+
+ all_mechanism = forms.ChoiceField(
+ choices=SpfAllMechanism.choices,
+ initial=SpfAllMechanism.FAIL,
+ required=True,
+ help_text=(
+ "Choose how to handle mail from unlisted servers:
" + "Please note: I have made best efforts to ensure the information below is correct. But I highly recommend checking and validating the SPF record before updating it in your DNS. Please contact me if you spot any mistakes.
+Select the email services that you use with your domain from the lists below.
+