ul-api-utils 7.7.10__py3-none-any.whl → 7.8.0__py3-none-any.whl

ul_api_utils/resources/web_forms/custom_fields/custom_checkbox_select.py

@@ -0,0 +1,5 @@
+from wtforms import SelectMultipleField, widgets  # type: ignore
+
+
+class MultiCheckboxField(SelectMultipleField):
+    option_widget = widgets.CheckboxInput()

ul_api_utils/resources/web_forms/custom_widgets/custom_select_widget.py

@@ -0,0 +1,86 @@
+from typing import Any
+
+from markupsafe import Markup
+from wtforms import SelectField  # type: ignore
+from wtforms.widgets.core import html_params, Select  # type: ignore
+
+
+class CustomLiveSearchPlaceholderSelect(Select):
+    """
+    Renders a CUSTOM select field.
+
+    If `multiple` is True, then the `size` property should be specified on
+    rendering to make the field useful.
+
+    The field must provide an `iter_choices()` method which the widget will
+    call on rendering; this method must yield tuples of
+    `(value, label, selected)`.
+    It also must provide a `has_groups()` method which tells whether choices
+    are divided into groups, and if they do, the field must have an
+    `iter_groups()` method that yields tuples of `(label, choices)`, where
+    `choices` is an iterable of `(value, label, selected)` tuples.
+    Otherwise, `selected` is False for any option field in select item group.
+    """
+    def __call__(self, field: SelectField, **kwargs: Any) -> Markup:
+        kwargs.setdefault("id", field.id)
+        if self.multiple:
+            kwargs["multiple"] = True
+        flags = getattr(field, "flags", {})
+        for k in dir(flags):
+            if k in self.validation_attrs and k not in kwargs:
+                kwargs[k] = getattr(flags, k)
+
+        html = ["<select data-live-search='true' data-show-subtext='true' %s>" % html_params(name=field.name, **kwargs),
+                "<option value='' disabled selected>Select something...</option>"]
+
+        if field.has_groups():
+            for group, choices in field.iter_groups():
+                html.append("<optgroup %s>" % html_params(label=group))
+                for val, label, selected in choices:
+                    html.append(self.render_option(val, label, selected))
+                html.append("</optgroup>")
+        else:
+            for val, label, _ in field.iter_choices():
+                html.append(self.render_option(val, label, False))
+        html.append("</select>")
+        return Markup("".join(html))
+
+
+class CustomLiveSearchSelect(Select):
+    """
+    Renders a CUSTOM select field.
+
+    If `multiple` is True, then the `size` property should be specified on
+    rendering to make the field useful.
+
+    The field must provide an `iter_choices()` method which the widget will
+    call on rendering; this method must yield tuples of
+    `(value, label, selected)`.
+    It also must provide a `has_groups()` method which tells whether choices
+    are divided into groups, and if they do, the field must have an
+    `iter_groups()` method that yields tuples of `(label, choices)`, where
+    `choices` is an iterable of `(value, label, selected)` tuples.
+    Otherwise, `selected` is False for any option field in select item group.
+    """
+    def __call__(self, field: SelectField, **kwargs: Any) -> Markup:
+        kwargs.setdefault("id", field.id)
+        if self.multiple:
+            kwargs["multiple"] = True
+        flags = getattr(field, "flags", {})
+        for k in dir(flags):
+            if k in self.validation_attrs and k not in kwargs:
+                kwargs[k] = getattr(flags, k)
+
+        html = ["<select data-live-search='true' data-show-subtext='true' %s>" % html_params(name=field.name, **kwargs)]
+
+        if field.has_groups():
+            for group, choices in field.iter_groups():
+                html.append("<optgroup %s>" % html_params(label=group))
+                for val, label, selected in choices:
+                    html.append(self.render_option(val, label, selected))
+                html.append("</optgroup>")
+        else:
+            for val, label, selected in field.iter_choices():
+                html.append(self.render_option(val, label, selected))
+        html.append("</select>")
+        return Markup("".join(html))

ul_api_utils/resources/web_forms/custom_widgets/custom_text_input_widget.py

@@ -0,0 +1,42 @@
+from typing import Optional, Any
+
+from wtforms import StringField   # type: ignore
+from wtforms.widgets import TextInput   # type: ignore
+from markupsafe import Markup
+
+
+class CustomTextInput(TextInput):
+    """
+    Render a single-line text input with optional input attributes ("required", "maxlength", "minlength", "pattern").
+
+    examples: TextInputCustom(required=True, min_length=5, max_length=255, pattern=r"^(d+(,d+)*)?$")
+              TextInputCustom(max_length=255, pattern=r"^(d+(,d+)*)?$")
+              TextInputCustom(required=True, pattern=r"^(d+(,d+)*)?$")
+              TextInputCustom(max_length=255)
+    In model usage: ... info={"label": "LABEL:", "widget": TextInputCustom(pattern=r"^(d+(,d+)*)?$")}
+    """
+    validation_attrs = ["required", "maxlength", "minlength", "pattern"]
+
+    def __init__(self, required: Optional[bool] = None, max_length: Optional[int] = None, min_length: Optional[int] = None, pattern: Optional[str] = None):
+        super().__init__()
+        self.required = required
+        self.max_length = max_length
+        self.min_length = min_length
+        self.pattern = pattern
+
+    def __call__(self, field: StringField, **kwargs: Any) -> Markup:
+        kwargs.setdefault("id", field.id)
+        kwargs.setdefault("type", self.input_type)
+        if self.min_length:
+            kwargs.setdefault("minlength", self.min_length)
+        if self.max_length:
+            kwargs.setdefault("maxlength", self.max_length)
+        if self.pattern:
+            kwargs.setdefault("pattern", self.pattern)
+        if "value" not in kwargs:
+            kwargs["value"] = field._value()
+        flags = getattr(field, "flags", {})
+        for k in dir(flags):
+            if k in self.validation_attrs and k not in kwargs:
+                kwargs[k] = getattr(flags, k)
+        return Markup("<input %s>" % self.html_params(name=field.name, **kwargs))

ul_api_utils/resources/web_forms/uni_form.py

@@ -0,0 +1,75 @@
+from typing import Type, Any, Dict, Optional, Tuple
+
+from ul_db_utils.modules.db import db
+from sqlalchemy.dialects import postgresql
+from sqlalchemy.dialects.postgresql import ARRAY
+from wtforms_alchemy import ModelForm, ClassMap, FormGenerator  # type: ignore
+from wtforms.fields import SelectField  # type: ignore
+
+from ul_db_utils.model.base_model import BaseModel
+
+from ul_api_utils.resources.web_forms.custom_fields.custom_checkbox_select import MultiCheckboxField
+
+
+def form_factory(model_obj: Type[BaseModel], edition: bool = False, *, extra_fields: Optional[Dict[str, Any]] = None) -> Type[ModelForm]:
+    """
+    Returns generated model form.
+
+            Parameters:
+                    model_obj (type_of(BaseModel)): model object which will use for form generation
+                    edition (bool): flag to indicate creation or edition form will be generated
+                    extra_fields (optional(dict(str, any))): additional fields for generated form
+
+            Returns:
+                    Form (type_of(ModelForm)): web model form
+    """
+
+    class ExtraFieldsFormGenerator(FormGenerator):
+        def create_fields(self, form: Any, properties: Dict[str, Any]) -> None:
+            """
+            Creates fields for given form based on given model attributes.
+
+            :param form: form to attach the generated fields into
+            :param properties: model attributes to generate the form fields from
+            """
+            super(ExtraFieldsFormGenerator, self).create_fields(form, properties)
+
+            if extra_fields:
+                for field_name, field in extra_fields.items():
+                    setattr(form, field_name, field)
+
+    class Form(ModelForm):
+        """
+        A class for representing a web form.
+
+        ...
+
+        Attributes
+        ----------
+        property_columns : dict(str, any)
+            Model property columns such as ID, USER_CREATED etc.
+
+        Methods
+        -------
+
+        """
+
+        property_columns: Dict[str, Any] = {}
+
+        def __init__(self, *args: Tuple[Any], **kwargs: Dict[str, Any]) -> None:
+            super(Form, self).__init__(*args, **kwargs)
+            self.property_columns = model_obj.get_property_columns(self._obj) if self._obj else {}
+
+        class Meta:
+            model = model_obj
+            type_map = ClassMap({postgresql.UUID: SelectField, ARRAY: MultiCheckboxField})
+            only = model_obj.get_edit_columns() if edition else model_obj.get_create_columns()
+            form_generator = ExtraFieldsFormGenerator
+
+        @classmethod
+        def get_session(cls) -> Any:
+            return db.session
+
+    Form.__name__ = f"{model_obj.__name__}Form"
+
+    return Form

{ul_api_utils-7.7.10.dist-info → ul_api_utils-7.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ul-api-utils
-Version: 7.7.10
+Version: 7.8.0
 Summary: Python api utils
 Author: Unic-lab
 Author-email: 

{ul_api_utils-7.7.10.dist-info → ul_api_utils-7.8.0.dist-info}/RECORD

@@ -77,6 +77,13 @@ ul_api_utils/resources/health_check/const.py,sha256=QzVZP_ZKmVKleUACiOGjzP-v54FD
 ul_api_utils/resources/health_check/health_check.py,sha256=bb_ONn3akNXxNFELIUcW6foqwiKqeinmr-Wl0fQ7Q4c,18449
 ul_api_utils/resources/health_check/health_check_template.py,sha256=Qih-sVoFVoVxfmDYBTzwlNSicCr7zNelUJLJMnM-C_Q,2572
 ul_api_utils/resources/health_check/resource.py,sha256=SPd9kMzBOVhFZgMVfV26bDpZya3BmwxTfOR4MZ2dL4o,4199
+ul_api_utils/resources/web_forms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ul_api_utils/resources/web_forms/uni_form.py,sha256=x71Ti_Rkb0WxXq_SkwltHMYX0BYKsoV-8DPivra0HHw,2699
+ul_api_utils/resources/web_forms/custom_fields/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ul_api_utils/resources/web_forms/custom_fields/custom_checkbox_select.py,sha256=M2k9qqSXSXjd3ajGMjK3dQwCFefNKf-AL89PSOU0GxU,158
+ul_api_utils/resources/web_forms/custom_widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ul_api_utils/resources/web_forms/custom_widgets/custom_select_widget.py,sha256=691DZl8znlcKvl03SflpZWcp_9Rs_4LvPLfjsqf2Tn4,3777
+ul_api_utils/resources/web_forms/custom_widgets/custom_text_input_widget.py,sha256=Mn6MpFrZIHPjM-l1ytWC6yGiHsIdcfbJoZiTF9XIENc,1888
 ul_api_utils/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ul_api_utils/utils/api_encoding.py,sha256=dqXknOKgc3HBOk48zDoVOLLwc1vRFATkBY8JW_RVLCo,1450
 ul_api_utils/utils/api_format.py,sha256=wGuk5QP6b7oyl9SJ1ebNVirzCipmyTxqjoEPh2cJzAY,2025
@@ -126,9 +133,9 @@ ul_api_utils/validators/validate_empty_object.py,sha256=3Ck_iwyJE_M5e7l6s1i88aqb
 ul_api_utils/validators/validate_uuid.py,sha256=EfvlRirv2EW0Z6w3s8E8rUa9GaI8qXZkBWhnPs8NFrA,257
 ul_api_utils/validators/__tests__/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ul_api_utils/validators/__tests__/test_custom_fields.py,sha256=QLZ7DFta01Z7DOK9Z5Iq4uf_CmvDkVReis-GAl_QN48,1447
-ul_api_utils-7.7.10.dist-info/LICENSE,sha256=6Qo8OdcqI8aGrswJKJYhST-bYqxVQBQ3ujKdTSdq-80,1062
-ul_api_utils-7.7.10.dist-info/METADATA,sha256=K7S32IQ3Ick056nvnE5wSiVhw_WrGjKpAUmVayd4W8M,14455
-ul_api_utils-7.7.10.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-ul_api_utils-7.7.10.dist-info/entry_points.txt,sha256=8tL3ySHWTyJMuV1hx1fHfN8zumDVOCOm63w3StphkXg,53
-ul_api_utils-7.7.10.dist-info/top_level.txt,sha256=1XsW8iOSFaH4LOzDcnNyxHpHrbKU3fSn-aIAxe04jmw,21
-ul_api_utils-7.7.10.dist-info/RECORD,,
+ul_api_utils-7.8.0.dist-info/LICENSE,sha256=6Qo8OdcqI8aGrswJKJYhST-bYqxVQBQ3ujKdTSdq-80,1062
+ul_api_utils-7.8.0.dist-info/METADATA,sha256=ye4_rHtf-C06Ltam7yrnIsVqoJ5IqMFZxpIQEh4xOfg,14454
+ul_api_utils-7.8.0.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
+ul_api_utils-7.8.0.dist-info/entry_points.txt,sha256=8tL3ySHWTyJMuV1hx1fHfN8zumDVOCOm63w3StphkXg,53
+ul_api_utils-7.8.0.dist-info/top_level.txt,sha256=1XsW8iOSFaH4LOzDcnNyxHpHrbKU3fSn-aIAxe04jmw,21
+ul_api_utils-7.8.0.dist-info/RECORD,,