ptag 0.2.1

pythonic way to create HTML/XML/SVG tags

ptag

pythonic way to create HTML/XML/SVG tags

• create tags in pure python
• use context manager for tag hierarchy
• no external dependencies
• read the docs

Quick Start

Installation: pip install ptag

from ptag import div, img, form, label, input_, del_
from ptag import Tag  # for creating custom element

# === html element ===
tag = div(img(src="url"), id="bar")
print(tag)  # <div id="bar"><img src="url"/></div>

# === custom element ===
my_tag = Tag("MyTag", child="foo", attr="bar")
print(my_tag)  # <MyTag attr="bar">foo</MyTag>

# == ⭐️ context manager ⭐️ ==
with form() as f:
    label("foo", for_="bar")  # python keyword 'for' -> 'for_'
    input_(None, name="bar", type="checkbox", value="baz")

print(f.pretty())
# <form>
#     <label for="bar">foo</label>
#     <input name="bar" type="checkbox" value="baz"/>
# </form>

# === add content and attributes to existing tag ===
# position args -> attribute w/o value
# python keyword 'class' -> 'class_'
tag = div(class_="foo") 
# python keyword 'del' -> 'del_'
tag.affix(del_("bar"), "m-2", "rounded", id="baz") 
print(tag)  
# <div m-2 rounded class="foo" id="baz"><del>bar</del></div>

more examples could be found on tests and references

Limitations

• add trailing underscore to work around python keywords and built-in object
  • tag attributes: class_, for_
  • tag object: del_, input_, map_, object_
• prettify() method doesn't support attribute without value
  • use kwargs instead of positional args if prettifying is needed
  • eg. selected -> selected=""

Motivation

When working with HTML, instead of separating python and template files like this:

<ul id="navigation">
    {% for item in navigation %}
    <li><a href="{{ item.href }}">{{ item.caption }}</a></li>
    {% endfor %}
</ul>

I prefer a pythonic approach like this:

with ul(id="navigation") as nav:
    for item in navigation:
        li(a(item.caption, href=item.href))

It provides full intellisense, type checking, extensive language supports from text editors... etc. a much better DX.

Need Help?

github issue

posts