PyPDFForm 4.5.0__tar.gz → 4.5.2__tar.gz

{pypdfform-4.5.0 → pypdfform-4.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 4.5.0
+Version: 4.5.2
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/__init__.py

@@ -20,7 +20,7 @@ The library supports various PDF form features, including:
 PyPDFForm aims to simplify PDF form manipulation, making it accessible to developers of all skill levels.
 """
 
-__version__ = "4.5.0"
+__version__ = "4.5.2"
 
 from .annotations import Annotations
 from .assets.blank import BlankPage

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/adapter.py

@@ -11,7 +11,7 @@ stream before further processing.
 """
 
 from os.path import isfile
-from typing import Any, BinaryIO, Union
+from typing import Any, BinaryIO
 
 
 def readable(obj: Any) -> bool:
@@ -32,7 +32,7 @@ def readable(obj: Any) -> bool:
 
 
 def fp_or_f_obj_or_stream_to_stream(
-    fp_or_f_obj_or_stream: Union[bytes, str, BinaryIO],
+    fp_or_f_obj_or_stream: bytes | str | BinaryIO,
 ) -> bytes:
     """
     Adapt a file path, file object, or stream to a byte stream.
@@ -44,7 +44,7 @@ def fp_or_f_obj_or_stream_to_stream(
         - file-like objects with a read() method (BinaryIO)
 
     Args:
-        fp_or_f_obj_or_stream (Union[bytes, str, BinaryIO]): The input to adapt.
+        fp_or_f_obj_or_stream (bytes | str | BinaryIO): The input to adapt.
             It can be a byte stream, a file path (string), or a file object.
 
     Returns:
@@ -59,17 +59,14 @@ def fp_or_f_obj_or_stream_to_stream(
     elif readable(fp_or_f_obj_or_stream):
         result = fp_or_f_obj_or_stream.read()
 
-    elif isinstance(fp_or_f_obj_or_stream, str):
-        if not isfile(fp_or_f_obj_or_stream):
-            pass
-        else:
-            with open(fp_or_f_obj_or_stream, "rb") as _file:
-                result = _file.read()
+    elif isinstance(fp_or_f_obj_or_stream, str) and isfile(fp_or_f_obj_or_stream):
+        with open(fp_or_f_obj_or_stream, "rb") as _file:
+            result = _file.read()
     return result
 
 
 def fp_or_f_obj_or_f_content_to_content(
-    fp_or_f_obj_or_f_content: Union[str, BinaryIO],
+    fp_or_f_obj_or_f_content: str | BinaryIO,
 ) -> str:
     """
     Adapt a file path, file object, or file content to file content.
@@ -81,7 +78,7 @@ def fp_or_f_obj_or_f_content_to_content(
         - file-like objects with a read() method (BinaryIO)
 
     Args:
-        fp_or_f_obj_or_f_content (Union[str, BinaryIO]): The input to adapt.
+        fp_or_f_obj_or_f_content (str | BinaryIO): The input to adapt.
             It can be file content, a file path (string), or a file object.
 
     Returns:

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/annotations/__init__.py

@@ -10,11 +10,10 @@ annotations, facilitating their creation and manipulation within PDF documents.
 """
 
 from dataclasses import dataclass
-from typing import Union
 
 from .text import TextAnnotation
 
-AnnotationTypes = Union[TextAnnotation]
+AnnotationTypes = TextAnnotation
 
 
 @dataclass

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/constants.py

@@ -15,8 +15,6 @@ Using constants improves code readability and maintainability by providing
 meaningful names for frequently used values and reducing the risk of typos.
 """
 
-from typing import Union
-
 from .middleware.checkbox import Checkbox
 from .middleware.dropdown import Dropdown
 from .middleware.image import Image
@@ -37,7 +35,7 @@ VERSION_IDENTIFIERS = [
 ]
 VERSION_IDENTIFIER_PREFIX = "%PDF-".encode("utf-8")
 
-WIDGET_TYPES = Union[Text, Checkbox, Radio, Dropdown, Signature, Image]
+WIDGET_TYPES = Text | Checkbox | Radio | Dropdown | Signature | Image
 
 DEPRECATION_NOTICE = "{} will be deprecated soon. Use {} instead."
 

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/filler.py

@@ -9,7 +9,7 @@ supports flattening the filled form to prevent further modifications.
 """
 
 from io import BytesIO
-from typing import Dict, Union, cast
+from typing import Dict, cast
 
 from pypdf import PdfReader, PdfWriter
 from pypdf.generic import DictionaryObject
@@ -31,7 +31,7 @@ from .watermark import create_watermarks_and_draw, merge_watermarks_with_pdf
 
 
 def signature_image_handler(
-    widget: dict, middleware: Union[Signature, Image], images_to_draw: list
+    widget: dict, middleware: Signature | Image, images_to_draw: list
 ) -> bool:
     """Handles signature and image widgets by extracting image data and preparing it for drawing.
 
@@ -43,7 +43,7 @@ def signature_image_handler(
 
     Args:
         widget (dict): The widget dictionary representing the signature or image field.
-        middleware (Union[Signature, Image]): The middleware object containing the image data and properties.
+        middleware (Signature | Image): The middleware object containing the image data and properties.
         images_to_draw (list): A list to store image data for drawing.
 
     Returns:
@@ -70,6 +70,81 @@ def signature_image_handler(
     return any_image_to_draw
 
 
+def update_widget(
+    annot: DictionaryObject,
+    widget: WIDGET_TYPES,
+    key: str,
+    radio_button_tracker: Dict[str, int],
+    images_to_draw_page: list,
+    need_appearances: bool,
+    flatten: bool,
+) -> bool:
+    """Updates a single widget's value and handles its properties.
+
+    This function updates the value of a single PDF form widget based on its type. It also
+    handles widget flattening and prepares images or signatures for drawing if applicable.
+
+    Args:
+        annot (DictionaryObject): The annotation object representing the widget in the PDF.
+        widget (WIDGET_TYPES): The widget middleware object containing the new value.
+        key (str): The unique key identifying the widget.
+        radio_button_tracker (Dict[str, int]): A tracker for radio button groups to manage their indices.
+        images_to_draw_page (list): A list to store image data for the current page.
+        need_appearances (bool): If True, skips updating appearance streams for certain fields.
+        flatten (bool): Whether to flatten the widget to prevent further editing.
+
+    Returns:
+        bool: True if an image or signature was prepared for drawing, False otherwise.
+    """
+    if flatten:
+        flatten_field(annot, True)
+    if widget.value is None:
+        return False
+
+    any_image_to_draw = False
+    if isinstance(widget, (Signature, Image)):
+        any_image_to_draw = signature_image_handler(annot, widget, images_to_draw_page)
+    elif type(widget) is Checkbox:
+        update_checkbox_value(annot, widget.value)
+    elif isinstance(widget, Radio):
+        if key not in radio_button_tracker:
+            radio_button_tracker[key] = 0
+        radio_button_tracker[key] += 1
+        if widget.value == radio_button_tracker[key] - 1:
+            update_radio_value(annot)
+    elif isinstance(widget, Dropdown):
+        update_dropdown_value(annot, widget, need_appearances)
+    elif isinstance(widget, Text):
+        update_text_value(annot, widget, need_appearances)
+
+    return any_image_to_draw
+
+
+def handle_image_drawing(
+    result: bytes,
+    images_to_draw: Dict[int, list],
+) -> bytes:
+    """Merges prepared images and signatures with the filled PDF.
+
+    This function takes the filled PDF and a dictionary of images to draw (from signatures
+    or image fields) and merges them into the PDF as watermarks.
+
+    Args:
+        result (bytes): The filled PDF as bytes.
+        images_to_draw (Dict[int, list]): A dictionary mapping page numbers to lists of image data.
+
+    Returns:
+        bytes: The PDF with images and signatures merged.
+    """
+    images = []
+    for page, elements in images_to_draw.items():
+        images.extend(
+            [{"page_number": page, "type": "image", **element} for element in elements]
+        )
+
+    return merge_watermarks_with_pdf(result, create_watermarks_and_draw(result, images))
+
+
 def fill(
     template: bytes,
     widgets: Dict[str, WIDGET_TYPES],
@@ -101,7 +176,6 @@ def fill(
                The image drawn stream is only returned if there are any image or signature widgets
                in the form.
     """
-    # pylint: disable=R0912
     pdf = PdfReader(stream_to_io(template))
     out = PdfWriter()
     out.append(pdf)
@@ -120,28 +194,15 @@ def fill(
             if widget is None:
                 continue
 
-            # flatten all
-            if flatten:
-                flatten_field(annot, True)
-            if widget.value is None:
-                continue
-
-            if isinstance(widgets[key], (Signature, Image)):
-                any_image_to_draw |= signature_image_handler(
-                    annot, widgets[key], images_to_draw[page_num + 1]
-                )
-            elif type(widget) is Checkbox:
-                update_checkbox_value(annot, widget.value)
-            elif isinstance(widget, Radio):
-                if key not in radio_button_tracker:
-                    radio_button_tracker[key] = 0
-                radio_button_tracker[key] += 1
-                if widget.value == radio_button_tracker[key] - 1:
-                    update_radio_value(annot)
-            elif isinstance(widget, Dropdown):
-                update_dropdown_value(annot, widget, need_appearances)
-            elif isinstance(widget, Text):
-                update_text_value(annot, widget, need_appearances)
+            any_image_to_draw |= update_widget(
+                annot,
+                widget,
+                key,
+                radio_button_tracker,
+                images_to_draw[page_num + 1],
+                need_appearances,
+                flatten,
+            )
 
     with BytesIO() as f:
         out.write(f)
@@ -151,12 +212,4 @@ def fill(
     if not any_image_to_draw:
         return result, None
 
-    images = []
-    for page, elements in images_to_draw.items():
-        images.extend(
-            [{"page_number": page, "type": "image", **element} for element in elements]
-        )
-
-    return result, (
-        merge_watermarks_with_pdf(result, create_watermarks_and_draw(result, images))
-    )
+    return result, handle_image_drawing(result, images_to_draw)

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/font.py

@@ -27,6 +27,7 @@ from .constants import (DEFAULT_ASSUMED_GLYPH_WIDTH, DR, EM_TO_PDF_FACTOR,
                         MissingWidth, Resources, Subtype, TrueType, Type,
                         Widths, WinAnsiEncoding)
 from .utils import stream_to_io
+from .watermark import get_watermark_with_font
 
 
 @lru_cache
@@ -144,7 +145,7 @@ def compute_font_glyph_widths(ttf_file: BytesIO, missing_width: float) -> list[f
 
 
 def register_font_acroform(
-    pdf: bytes, ttf_stream: bytes, need_appearances: bool
+    pdf: bytes, font_name: str, ttf_stream: bytes, need_appearances: bool
 ) -> tuple:
     """
     Registers a TrueType font within the PDF's AcroForm dictionary.
@@ -156,6 +157,7 @@ def register_font_acroform(
     Args:
         pdf (bytes): The PDF file data as bytes. This is the PDF document that
             will be modified to include the new font.
+        font_name (str): The name of the font being registered.
         ttf_stream (bytes): The font file data in TTF format as bytes. This is the
             raw data of the TrueType font file.
         need_appearances (bool): If True, attempts to retrieve existing font parameters
@@ -175,7 +177,7 @@ def register_font_acroform(
     font_dict_params = {}
     if need_appearances:
         font_descriptor_params, font_dict_params = get_additional_font_params(
-            pdf, base_font_name
+            get_watermark_with_font(font_name), base_font_name
         )
 
     font_file_stream = StreamObject()

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/hooks.py

@@ -11,7 +11,7 @@ filling process, allowing for customization of the form's appearance and behavio
 
 import sys
 from io import BytesIO
-from typing import TextIO, Union, cast
+from typing import TextIO, cast
 
 from pypdf import PdfReader, PdfWriter
 from pypdf.generic import (ArrayObject, DictionaryObject, FloatObject,
@@ -393,7 +393,7 @@ def update_field_hidden(annot: DictionaryObject, val: bool) -> None:
 
 
 def _update_field_javascript(
-    annot: DictionaryObject, trigger_event: str, val: Union[str, TextIO]
+    annot: DictionaryObject, trigger_event: str, val: str | TextIO
 ) -> None:
     """
     Updates a specific JavaScript action for a form field annotation.
@@ -405,7 +405,7 @@ def _update_field_javascript(
         annot (DictionaryObject): The annotation dictionary for the form field.
         trigger_event (str): The event that triggers the JavaScript action
             (e.g., E for enter, X for exit, D for down, U for up, Fo for focus, Bl for blur).
-        val (Union[str, TextIO]): The JavaScript code to execute. Can be a string
+        val (str | TextIO): The JavaScript code to execute. Can be a string
             containing the code or a file-like object/path to a file containing the code.
     """
     if AA not in annot:
@@ -424,7 +424,7 @@ def _update_field_javascript(
 
 
 def update_field_on_hovered_over_javascript(
-    annot: DictionaryObject, val: Union[str, TextIO]
+    annot: DictionaryObject, val: str | TextIO
 ) -> None:
     """
     Updates the JavaScript action triggered when the mouse enters the field area.
@@ -434,13 +434,13 @@ def update_field_on_hovered_over_javascript(
 
     Args:
         annot (DictionaryObject): The annotation dictionary for the form field.
-        val (Union[str, TextIO]): The JavaScript code to execute.
+        val (str | TextIO): The JavaScript code to execute.
     """
     _update_field_javascript(annot, E, val)
 
 
 def update_field_on_hovered_off_javascript(
-    annot: DictionaryObject, val: Union[str, TextIO]
+    annot: DictionaryObject, val: str | TextIO
 ) -> None:
     """
     Updates the JavaScript action triggered when the mouse exits the field area.
@@ -450,13 +450,13 @@ def update_field_on_hovered_off_javascript(
 
     Args:
         annot (DictionaryObject): The annotation dictionary for the form field.
-        val (Union[str, TextIO]): The JavaScript code to execute.
+        val (str | TextIO): The JavaScript code to execute.
     """
     _update_field_javascript(annot, X, val)
 
 
 def update_field_on_mouse_pressed_javascript(
-    annot: DictionaryObject, val: Union[str, TextIO]
+    annot: DictionaryObject, val: str | TextIO
 ) -> None:
     """
     Updates the JavaScript action triggered when the mouse button is pressed down inside the field.
@@ -466,13 +466,13 @@ def update_field_on_mouse_pressed_javascript(
 
     Args:
         annot (DictionaryObject): The annotation dictionary for the form field.
-        val (Union[str, TextIO]): The JavaScript code to execute.
+        val (str | TextIO): The JavaScript code to execute.
     """
     _update_field_javascript(annot, D, val)
 
 
 def update_field_on_mouse_released_javascript(
-    annot: DictionaryObject, val: Union[str, TextIO]
+    annot: DictionaryObject, val: str | TextIO
 ) -> None:
     """
     Updates the JavaScript action triggered when the mouse button is released inside the field.
@@ -482,13 +482,13 @@ def update_field_on_mouse_released_javascript(
 
     Args:
         annot (DictionaryObject): The annotation dictionary for the form field.
-        val (Union[str, TextIO]): The JavaScript code to execute.
+        val (str | TextIO): The JavaScript code to execute.
     """
     _update_field_javascript(annot, U, val)
 
 
 def update_field_on_focused_javascript(
-    annot: DictionaryObject, val: Union[str, TextIO]
+    annot: DictionaryObject, val: str | TextIO
 ) -> None:
     """
     Updates the JavaScript action triggered when the field receives input focus.
@@ -498,13 +498,13 @@ def update_field_on_focused_javascript(
 
     Args:
         annot (DictionaryObject): The annotation dictionary for the form field.
-        val (Union[str, TextIO]): The JavaScript code to execute.
+        val (str | TextIO): The JavaScript code to execute.
     """
     _update_field_javascript(annot, Fo, val)
 
 
 def update_field_on_blurred_javascript(
-    annot: DictionaryObject, val: Union[str, TextIO]
+    annot: DictionaryObject, val: str | TextIO
 ) -> None:
     """
     Updates the JavaScript action triggered when the field loses input focus.
@@ -514,6 +514,6 @@ def update_field_on_blurred_javascript(
 
     Args:
         annot (DictionaryObject): The annotation dictionary for the form field.
-        val (Union[str, TextIO]): The JavaScript code to execute.
+        val (str | TextIO): The JavaScript code to execute.
     """
     _update_field_javascript(annot, Bl, val)

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/image.py

@@ -8,14 +8,14 @@ account whether to preserve the aspect ratio.
 """
 
 from io import BytesIO
-from typing import Tuple, Union
+from typing import Tuple
 
 from PIL import Image
 
 from .constants import Rect
 
 
-def rotate_image(image_stream: bytes, rotation: Union[float, int]) -> bytes:
+def rotate_image(image_stream: bytes, rotation: float | int) -> bytes:
     """
     Rotates an image by a specified angle in degrees.
 
@@ -26,7 +26,7 @@ def rotate_image(image_stream: bytes, rotation: Union[float, int]) -> bytes:
 
     Args:
         image_stream (bytes): The image data as bytes.
-        rotation (Union[float, int]): The rotation angle in degrees. Positive values
+        rotation (float | int): The rotation angle in degrees. Positive values
             rotate the image counterclockwise, while negative values rotate it clockwise.
 
     Returns:

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/middleware/base.py

@@ -8,7 +8,7 @@ common attributes and methods for all form widgets, such as name, value,
 and schema definition.
 """
 
-from typing import Any, List, TextIO, Union
+from typing import Any, List, Optional, TextIO
 
 
 class Widget:
@@ -49,25 +49,25 @@ class Widget:
         super().__init__()
         self._name = name
         self._value = value
-        self.tooltip: str = None
-        self.readonly: bool = None
-        self.required: bool = None
-        self.hidden: bool = None
+        self.tooltip: Optional[str] = None
+        self.readonly: Optional[bool] = None
+        self.required: Optional[bool] = None
+        self.hidden: Optional[bool] = None
         self.hooks_to_trigger: list = []
 
         # coordinate & dimension
-        self.x: Union[float, List[float]] = None
-        self.y: Union[float, List[float]] = None
-        self.width: Union[float, List[float]] = None
-        self.height: Union[float, List[float]] = None
+        self.x: Optional[float | List[float]] = None
+        self.y: Optional[float | List[float]] = None
+        self.width: Optional[float | List[float]] = None
+        self.height: Optional[float | List[float]] = None
 
         # javascript
-        self.on_hovered_over_javascript: Union[str, TextIO] = None
-        self.on_hovered_off_javascript: Union[str, TextIO] = None
-        self.on_mouse_pressed_javascript: Union[str, TextIO] = None
-        self.on_mouse_released_javascript: Union[str, TextIO] = None
-        self.on_focused_javascript: Union[str, TextIO] = None
-        self.on_blurred_javascript: Union[str, TextIO] = None
+        self.on_hovered_over_javascript: Optional[str | TextIO] = None
+        self.on_hovered_off_javascript: Optional[str | TextIO] = None
+        self.on_mouse_pressed_javascript: Optional[str | TextIO] = None
+        self.on_mouse_released_javascript: Optional[str | TextIO] = None
+        self.on_focused_javascript: Optional[str | TextIO] = None
+        self.on_blurred_javascript: Optional[str | TextIO] = None
 
     def __setattr__(self, name: str, value: Any) -> None:
         """

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/middleware/checkbox.py

@@ -6,7 +6,7 @@ This module defines the Checkbox class, which is a subclass of the
 Widget class. It represents a checkbox form field in a PDF document.
 """
 
-from typing import Any, Union
+from typing import Any, Optional
 
 from .base import Widget
 
@@ -42,7 +42,7 @@ class Checkbox(Widget):
         )
         super().__init__(name, value)
 
-        self.size: float = None
+        self.size: Optional[float] = None
 
     def __setattr__(self, name: str, value: Any) -> None:
         """
@@ -75,7 +75,7 @@ class Checkbox(Widget):
         return {"type": "boolean", **super().schema_definition}
 
     @property
-    def sample_value(self) -> Union[bool, int]:
+    def sample_value(self) -> bool | int:
         """
         Returns a sample value for the checkbox.
 
@@ -83,6 +83,6 @@ class Checkbox(Widget):
         checkbox field.
 
         Returns:
-            Union[bool, int]: A sample value for the checkbox.
+            bool | int: A sample value for the checkbox.
         """
         return True

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/middleware/dropdown.py

@@ -6,7 +6,7 @@ This module defines the Dropdown class, which is a subclass of the
 Widget class. It represents a dropdown form field in a PDF document.
 """
 
-from typing import Union
+from typing import Optional
 
 from .base import Widget
 
@@ -54,10 +54,10 @@ class Dropdown(Widget):
         )
         super().__init__(name, value)
 
-        self.font: str = None
-        self.font_size: float = None
-        self.font_color: tuple = None
-        self.choices: Union[tuple, list] = None
+        self.font: Optional[str] = None
+        self.font_size: Optional[float] = None
+        self.font_color: Optional[tuple] = None
+        self.choices: Optional[tuple | list] = None
 
     @property
     def value(self) -> int:
@@ -70,7 +70,7 @@ class Dropdown(Widget):
         return super().value
 
     @value.setter
-    def value(self, value: Union[str, int]) -> None:
+    def value(self, value: str | int) -> None:
         """
         Sets the value of the dropdown.
 
@@ -79,7 +79,7 @@ class Dropdown(Widget):
         added to the choices, and its new index is used.
 
         Args:
-            value (Union[str, int]): The value to set. Can be a string
+            value (str | int): The value to set. Can be a string
                                       (option text) or an integer (index).
         """
         if isinstance(value, str):
@@ -91,7 +91,7 @@ class Dropdown(Widget):
 
         self._value = value
 
-    def _get_option_index(self, value: str) -> Union[int, None]:
+    def _get_option_index(self, value: str) -> int | None:
         """
         Gets the index of a given option value in the dropdown's choices.
 
@@ -99,7 +99,7 @@ class Dropdown(Widget):
             value (str): The option value to search for.
 
         Returns:
-            Union[int, None]: The index of the option if found, otherwise None.
+            int | None: The index of the option if found, otherwise None.
         """
         for i, each in enumerate(self.choices):
             if value == each:

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/middleware/signature.py

@@ -8,7 +8,6 @@ allowing users to add their signature as an image.
 """
 
 from os.path import expanduser
-from typing import Union
 
 from ..adapter import fp_or_f_obj_or_stream_to_stream
 from .base import Widget
@@ -55,7 +54,7 @@ class Signature(Widget):
         return expanduser("~/Downloads/sample_image.jpg")
 
     @property
-    def stream(self) -> Union[bytes, None]:
+    def stream(self) -> bytes | None:
         """
         Returns the stream of the signature image.
 
@@ -64,7 +63,7 @@ class Signature(Widget):
         as a stream of bytes.
 
         Returns:
-            Union[bytes, None]: The stream of the signature image.
+            bytes | None: The stream of the signature image.
         """
         return (
             fp_or_f_obj_or_stream_to_stream(self.value)

{pypdfform-4.5.0 → pypdfform-4.5.2}/PyPDFForm/middleware/text.py

@@ -7,6 +7,8 @@ Widget class. It represents a text field form field in a PDF document,
 allowing users to enter text.
 """
 
+from typing import Optional
+
 from .base import Widget
 
 
@@ -56,13 +58,13 @@ class Text(Widget):
         )
         super().__init__(name, value)
 
-        self.font: str = None
-        self.font_size: float = None
-        self.font_color: tuple = None
-        self.comb: bool = None
-        self.alignment: int = None
-        self.multiline: bool = None
-        self.max_length: int = None
+        self.font: Optional[str] = None
+        self.font_size: Optional[float] = None
+        self.font_color: Optional[tuple] = None
+        self.comb: Optional[bool] = None
+        self.alignment: Optional[int] = None
+        self.multiline: Optional[bool] = None
+        self.max_length: Optional[int] = None
 
     @property
     def value(self) -> str: