semvec/pypi-packages huggingface dataset:
wtforms-polyglot 0.4.0
WTForms companion library to provide polyglot HTML output
License: BSD-3-Clause
Requires Python: >=3.7,<4.0

WTForms-Polyglot
================

WTForms companion library to provide [polyglot HTML][1] (i.e., XML-compatible)
output.

Polyglot markup is a set of rules for how to write HTML.  A document that uses
polyglot markup is both a valid HTML5 document as well as a well-formed XML
document, that can be served with either a `text/html` or an
`application/xhtml+xml` MIME type.

This package provides the `PolyglotForm` class, which is built on top of
WTForms’ default `Form`.  When using `PolyglotForm`, fields will be rendered
with polyglot markup.  For example, given the following form:

    from wtf_polyglot import PolyglotForm
    from wtforms import BooleanField

    class MyForm(PolyglotForm):
        foo = BooleanField("foo", default=True)

Rendering `MyForm.foo` will result in the following XML-compliant output:

    <input checked="checked" id="foo" name="foo" type="checkbox" value="y" />

In contrast, using WTForms’ default `Form`, the output would be:

    <input checked id="foo" name="foo" type="checkbox" value="y">

In addition, this package provides a custom implementation of WTForms’
`SubmitField`, which renders as a `<button>` instead of an `<input>` element.
For example:

    from wtf_polyglot import PolyglotForm, SubmitField

    class MyForm(PolyglotForm):
        foo = SubmitField("Bar")

Produces this output:

    <button id="foo" name="foo" type="submit" value="Bar">Bar</button>

[1]: http://www.w3.org/TR/html-polyglot/