adding new form

venv/lib/python3.11/site-packages/bootstrap5/forms.py

@@ -0,0 +1,147 @@
+from django.forms import EmailInput, NumberInput, PasswordInput, Textarea, TextInput, URLInput
+from django.utils.safestring import mark_safe
+
+from .bootstrap import get_bootstrap_setting, get_field_renderer, get_form_renderer, get_formset_renderer
+from .exceptions import BootstrapError
+from .text import text_value
+from .utils import add_css_class, render_tag
+
+FORM_GROUP_CLASS = "mb-3"
+
+
+def render_formset(formset, **kwargs):
+    """Render a formset to a Bootstrap layout."""
+    renderer_cls = get_formset_renderer(**kwargs)
+    return renderer_cls(formset, **kwargs).render()
+
+
+def render_formset_errors(formset, **kwargs):
+    """Render formset errors to a Bootstrap layout."""
+    renderer_cls = get_formset_renderer(**kwargs)
+    return renderer_cls(formset, **kwargs).render_errors()
+
+
+def render_form(form, **kwargs):
+    """Render a form to a Bootstrap layout."""
+    renderer_cls = get_form_renderer(**kwargs)
+    return renderer_cls(form, **kwargs).render()
+
+
+def render_form_errors(form, type="all", **kwargs):
+    """Render form errors to a Bootstrap layout."""
+    renderer_cls = get_form_renderer(**kwargs)
+    return renderer_cls(form, **kwargs).render_errors(type)
+
+
+def render_field(field, **kwargs):
+    """Render a field to a Bootstrap layout."""
+    renderer_cls = get_field_renderer(**kwargs)
+    return renderer_cls(field, **kwargs).render()
+
+
+def render_label(content, label_for=None, label_class="form-label", label_title=""):
+    """Render a label with content."""
+    attrs = {}
+    if label_for:
+        attrs["for"] = label_for
+    if label_class:
+        attrs["class"] = label_class
+    if label_title:
+        attrs["title"] = label_title
+    return render_tag("label", attrs=attrs, content=content)
+
+
+def render_button(
+    content,
+    button_type=None,
+    button_class="btn-primary",
+    size="",
+    href="",
+    name=None,
+    value=None,
+    title=None,
+    extra_classes="",
+    id="",
+):
+    """Render a button with content."""
+    attrs = {}
+    classes = add_css_class("btn", button_class)
+    size = text_value(size).lower().strip()
+    if size == "xs":
+        classes = add_css_class(classes, "btn-xs")
+    elif size == "sm" or size == "small":
+        classes = add_css_class(classes, "btn-sm")
+    elif size == "lg" or size == "large":
+        classes = add_css_class(classes, "btn-lg")
+    elif size == "md" or size == "medium":
+        pass
+    elif size:
+        raise BootstrapError('Parameter "size" should be "xs", "sm", "lg" or empty ("{size}" given).'.format(size=size))
+
+    if button_type:
+        if button_type not in ("submit", "reset", "button", "link"):
+            raise BootstrapError(
+                (
+                    'Parameter "button_type" should be "submit", "reset", "button", "link" or empty '
+                    '("{button_type}" given).'
+                ).format(button_type=button_type)
+            )
+        if button_type != "link":
+            attrs["type"] = button_type
+
+    classes = add_css_class(classes, extra_classes)
+    attrs["class"] = classes
+
+    if href:
+        tag = "a"
+        if button_type and button_type != "link":
+            raise BootstrapError(
+                'Button of type "{button_type}" is not allowed a "href" parameter.'.format(button_type=button_type)
+            )
+        attrs["href"] = href
+        # Specify role for link with button appearance
+        attrs.setdefault("role", "button")
+    else:
+        tag = "button"
+
+    if id:
+        attrs["id"] = id
+    if name:
+        attrs["name"] = name
+    if value:
+        attrs["value"] = value
+    if title:
+        attrs["title"] = title
+    return render_tag(tag, attrs=attrs, content=mark_safe(content))
+
+
+def render_field_and_label(field, label, field_class="", label_for=None, label_class="", layout="", **kwargs):
+    """Render a field with its label."""
+    if layout == "horizontal":
+        if not label_class:
+            label_class = get_bootstrap_setting("horizontal_label_class")
+        if not field_class:
+            field_class = get_bootstrap_setting("horizontal_field_class")
+        if not label:
+            label = mark_safe(" ")
+        label_class = add_css_class(label_class, "control-label")
+    html = field
+    if field_class:
+        html = '<div class="{field_class}">{html}</div>'.format(field_class=field_class, html=html)
+    if label:
+        html = render_label(label, label_for=label_for, label_class=label_class) + html
+    return html
+
+
+def render_form_group(content, css_class=FORM_GROUP_CLASS):
+    """Render a Bootstrap form group."""
+    return '<div class="{css_class}">{content}</div>'.format(css_class=css_class, content=content)
+
+
+def is_widget_with_placeholder(widget):
+    """
+    Return whether this widget should have a placeholder.
+
+    Only text, text area, number, e-mail, url, password, number and derived inputs have placeholders.
+    """
+    return isinstance(widget, (TextInput, Textarea, NumberInput, EmailInput, URLInput, PasswordInput))