plain 0.68.0__py3-none-any.whl → 0.103.0__py3-none-any.whl

plain/forms/__init__.py

@@ -2,7 +2,58 @@
 Plain validation and HTML form handling.
 """
 
-from .boundfield import BoundField  # NOQA
-from .exceptions import FormFieldMissingError, ValidationError  # NOQA
-from .fields import *  # NOQA
-from .forms import Form  # NOQA
+from .boundfield import BoundField
+from .exceptions import FormFieldMissingError, ValidationError
+from .fields import (
+    BooleanField,
+    CharField,
+    ChoiceField,
+    DateField,
+    DateTimeField,
+    DecimalField,
+    DurationField,
+    EmailField,
+    Field,
+    FileField,
+    FloatField,
+    ImageField,
+    IntegerField,
+    JSONField,
+    MultipleChoiceField,
+    NullBooleanField,
+    RegexField,
+    TimeField,
+    TypedChoiceField,
+    URLField,
+    UUIDField,
+)
+from .forms import BaseForm, Form
+
+__all__ = [
+    "BoundField",
+    "FormFieldMissingError",
+    "ValidationError",
+    "BooleanField",
+    "CharField",
+    "ChoiceField",
+    "DateField",
+    "DateTimeField",
+    "DecimalField",
+    "DurationField",
+    "EmailField",
+    "Field",
+    "FileField",
+    "FloatField",
+    "ImageField",
+    "IntegerField",
+    "JSONField",
+    "MultipleChoiceField",
+    "NullBooleanField",
+    "RegexField",
+    "TimeField",
+    "TypedChoiceField",
+    "URLField",
+    "UUIDField",
+    "BaseForm",
+    "Form",
+]

plain/forms/boundfield.py

@@ -1,4 +1,11 @@
+from __future__ import annotations
+
 from functools import cached_property
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .fields import Field
+    from .forms import BaseForm
 
 __all__ = ("BoundField",)
 
@@ -6,24 +13,24 @@ __all__ = ("BoundField",)
 class BoundField:
     "A Field plus data"
 
-    def __init__(self, form, field, name):
+    def __init__(self, form: BaseForm, field: Field, name: str):
         self._form = form
         self.field = field
         self.name = name
         self.html_name = form.add_prefix(name)
         self.html_id = form.add_prefix(self._auto_id)
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f'<{self.__class__.__name__} "{self.html_name}">'
 
     @property
-    def errors(self):
+    def errors(self) -> list[str]:
         """
         Return an error list (empty if there are no errors) for this field.
         """
         return self._form.errors.get(self.name, [])
 
-    def value(self):
+    def value(self) -> Any:
         """
         Return the value for this BoundField, using the initial value if
         the form is not bound or the data otherwise.
@@ -36,22 +43,22 @@ class BoundField:
         return self.field.prepare_value(data)
 
     @cached_property
-    def initial(self):
+    def initial(self) -> Any:
         return self._form.get_initial_for_field(self.field, self.name)
 
-    def _has_changed(self):
+    def _has_changed(self) -> bool:
         return self.field.has_changed(
             self.initial, self._form._field_data_value(self.field, self.html_name)
         )
 
     @property
-    def _auto_id(self):
+    def _auto_id(self) -> str:
         """
         Calculate and return the ID attribute for this BoundField, if the
         associated Form has specified auto_id. Return an empty string otherwise.
         """
         auto_id = self._form._auto_id  # Boolean or string
-        if auto_id and "%s" in str(auto_id):
+        if auto_id and isinstance(auto_id, str) and "%s" in auto_id:
             return auto_id % self.html_name
         elif auto_id:
             return self.html_name

plain/forms/exceptions.py

@@ -2,7 +2,7 @@ from plain.exceptions import ValidationError
 
 
 class FormFieldMissingError(Exception):
-    def __init__(self, field_name):
+    def __init__(self, field_name: str):
         self.field_name = field_name
         self.message = f'The "{self.field_name}" field is missing from the form data.'