add VDOM to HTML util function

[rmorshea]

Sample implementation:

from html import escape as html_escape

def vdom_to_html(vdom: Union[str, VdomDict]) -> str:
    """Convert a VDOM dictionary into an HTML string

    Only the following keys are translated to HTML:

    - ``tagName``
    - ``attributes``
    - ``children`` (must be strings or more VDOM dicts)
    """
    if isinstance(vdom, str):
        return vdom

    try:
        tag = vdom["tagName"]
    except TypeError as error:
        raise TypeError(f"Expected a VDOM dictionary or string, not {vdom}") from error

    if "attributes" in vdom:
        attributes = " " + " ".join(
            f'{k}="{html_escape(v)}"' for k, v in vdom["attributes"].items()
        )
    else:
        attributes = ""

    if "children" in vdom:
        children = "".join(map(vdom_to_html, vdom["children"]))
    else:
        children = ""

    return f"<{tag}{attributes}>{children}</{tag}>"

[rmorshea]

@Archmonger there's the function.

[Archmonger]

@rmorshea I believe I was looking for the inverse of this. Would be useful for Django purposes (ex. render via Django template, push template into IDOM).

[rmorshea]

That actually exists 🙂: html_to_vdom

[Archmonger]

Yep, but if I recall the conservation was brought up in reference to it not being documented.

[rmorshea]

The documentation is linked to above. Maybe I'm misunderstanding?

[Archmonger]

Oh that's my bad. I must have missed it when scrolling through the docs.

[rmorshea]

@acivitillo, if you want to use IDOM for HTML templating, this might be a good thing to try contributing.