{"author":"Sanic Community","author_email":"tronic@noreply.users.github.com","bugtrack_url":null,"classifiers":["Development Status :: 5 - Production/Stable","Intended Audience :: Developers","License :: OSI Approved :: MIT License","License :: Public Domain","Operating System :: OS Independent","Programming Language :: Python :: 3","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.7","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9","Topic :: Text Processing :: Markup :: HTML"],"description":"# HTML5 Generation with html5tagger: Fast, Pure Python, No Dependencies\n\nIf you're looking for a more efficient and streamlined way to generate HTML5, look no further than html5tagger! This module provides a simplified HTML5 syntax, so you can create your entire document template using only Python. Say goodbye to the clunky and error-prone process of manually writing HTML tags.\n\nWith html5tagger, you can safely and quickly generate HTML5 without any dependencies, making it the perfect solution for developers who value speed and simplicity. And with its pure Python implementation, you'll never have to worry about compatibility issues or adding extra libraries to your project.\n\nReady to streamline your page rendering process? It is super fast to get started. Trust us, once you try html5tagger, you'll never go back to Jinja2 or manual HTML writing again!\n\n```sh\npip install html5tagger\n```\n\n## Intro\n\nhtml5tagger provides two starting points for HTML generation: `E` as an empty builder for creating HTML snippets, or `Document` for generating full HTML documents with a DOCTYPE declaration. Both produce a `Builder` object, in case you need that for type annotations.\n\nCreate a snippet and add tags by dot notation:\n```python\nE.p(\"Powered by:\").br.a(href=\"...\")(\"html5tagger\")\n```\n```html\n

Powered by:
html5tagger\n```\n\nA complete example with template variables and other features:\n\n```python\nfrom html5tagger import Document, E\n\n# Create a document\ndoc = Document(\n E.TitleText_, # The first argument is for , adding variable TitleText\n lang=\"en\", # Keyword arguments for <html> attributes\n\n # Just list the resources you need, no need to remember link/script tags\n _urls=[ \"style.css\", \"favicon.png\", \"manifest.json\" ]\n)\n\n# Upper case names are template variables. You can modify them later.\ndoc.Head_\ndoc.h1.TitleText_(\"Demo\") # Goes inside <h1> and updates <title> as well\n\n# This has been a hard problem for DOM other such generators:\ndoc.p(\"A paragraph with \").a(\"a link\", href=\"/files\")(\" and \").em(\"formatting\")\n\n# Use with for complex nesting (not often needed)\nwith doc.table(id=\"data\"):\n doc.tr.th(\"First\").th(\"Second\").th(\"Third\")\n doc.TableRows_\n\n# Let's add something to the template variables\ndoc.Head._script(\"console.log('</script> escaping is weird')\")\n\ntable = doc.TableRows\nfor row in range(10):\n table.tr\n for col in range(3):\n table.td(row * col)\n\n# Or remove the table data we just added\ndoc.TableRows = None\n```\n\nYou can `str(doc)` to get the HTML code, and using `doc` directly usually has the desired effect as well (e.g. giving HTML responses). Jupyter Notebooks render it as HTML. For debugging, use `repr(doc)` where the templating variables are visible:\n\n```html\n>>> doc\n《Document Builder》\n<!DOCTYPE html><html lang=en><meta charset=\"utf-8\">\n<title>《TitleText:Demo》\n\n\n\n《Head:》\n

《TitleText:Demo》

A paragraph with a link and formatting\n

First	Second	Third\n 《TableRows》\n

\n```\n\nThe actual HTML output is similar. No whitespace is added to the document, it is all on one line unless the content contains newlines. You may notice that `body` and other familiar tags are missing and that the escaping is very minimal. This is HTML5: the document is standards-compliant with a lot less cruft.\n\n## Templating\n\nUse template variables to build a document once and only update the dynamic parts at render time for faster performance. Access template variables via doc.TitleText and add content in parenthesis after the tag name. The underscore at the end of a tag name indicates the tag is added to the document and can have content in parenthesis, but any further tags on the same line go to the original document, not the template.\n\n## Nesting\n\nIn HTML5 elements such as `

` do not need any closing tag, so we can keep adding content without worrying of when it should close. This module does not use closing tags for any elements where those are optional or forbidden.\n\nA tag is automatically closed when you add content to it or when another tag is added. Setting attributes alone does not close an element. Use `(None)` to close an empty element if any subsequent content is not meant to go inside it, e.g. `doc.script(None, src=\"...\")`.\n\nFor elements like `

` and `

\")\ndoc._comment(\"All-->OK\")\ndoc.iframe(srcdoc=Document().p(\"& is used for &\"))\n```\n\n```html\nEscaping & Context\n

<Escape>

\n\n\n```\n\nWorks perfectly in browsers.\n\n## Name mangling and boolean attributes\n\nUnderscore at the end of name is ignored so that `class_` and `for_` among other attributes may be used despite being reserved words in Python. Other underscores convert into hyphens.\n\n⚠️ The above only is true for HTML elements and attributes, but template placeholders only use an ending underscore to denote that the it is to be placed on the document, rather than be fetched for use.\n\nBoolean values convert into short attributes.\n\n```python\nE.input(type=\"checkbox\", id=\"somebox\", checked=True).label(for_=\"somebox\", aria_role=\"img\")(\"🥳\")\n```\n\n```html\n🥳\n```\n\n## Preformatted HTML\n\nAll content is automatically escaped, unless it provides an `__html__` method that returns a string in HTML format. Similarly, the builder objects of this module expose `__html__` and `_repr_html_` accessors that allow them to be rendered as HTML in Jupyter Notebooks and various other systems that follow this convention.\n\nAny preformatted HTML may be wrapped in `html5tagger.HTML(string_of_html)` to avoid it being escaped when included in a document, as the HTML class has those accessors.\n\n⚠️ Do not use `HTML()` for text, in particular not on messages sent by users, that may contain HTML that you didn't intend to execute as HTML.\n\n## Performance\n\n```python\n%timeit str(Document(\"benchmarking\", lang=\"en\", _urls=(\"foo.js\", \"bar.js\")))\n14 µs ± 153 ns per loop (mean ± std. dev. of 7 runs, 100,000 loops each)\n```\n\nJinja2 renders similar document from memory template within about 10 µs but it doesn't need to format any of the HTML. When Templating is similarly used with html5tagger, the rendering times drop to about 4 µs.\n\nIn the above benchmark html5tagger created the entire document from scratch, one element and attribute at a time. Unless you are creating very large documents dynamically, this should be quite fast enough.\n\n\n## Further development\n\nThere have been no changes to the tagging API since 2018 when this module was brought to production use, and thus the interface is considered stable.\n\nIn 2023 support for templating was added, allowing documents to be preformatted for all their static parts (as long strings), with only templates filled in between. This is a work on progress and has not been optimized yet.\n\nAdditionally, `_script` and `_style` special methods were added in 2023. These may eventually replace also the non-underscored automatic versions but for now a separate method was easier to implement.\n\nPull requests are still welcome.\n","description_content_type":"text/markdown","docs_url":null,"download_url":"","downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":"https://github.com/sanic-org/html5tagger","keywords":"HTML,HTML5,templating,Jinja2","license":"","license_expression":null,"license_files":null,"maintainer":"","maintainer_email":"","name":"html5tagger","package_url":"https://pypi.org/project/html5tagger/","platform":null,"project_url":"https://pypi.org/project/html5tagger/","project_urls":{"Homepage":"https://github.com/sanic-org/html5tagger"},"provides_extra":null,"release_url":"https://pypi.org/project/html5tagger/1.3.0/","requires_dist":null,"requires_python":">=3.7","summary":"Pythonic HTML generation/templating (no template files)","version":"1.3.0","yanked":false,"yanked_reason":null}

Package search

html5tagger

project_urls

Dependencies

All package metadata

Releases