Minimalistic HTML builder for Python 3.6+ with compact syntax
Project description
Minimalistic HTML generator for Python 3.6+ with compact syntax
Safely construct valid HTML with Python code. Example:
from microhtml import *
print(
ᑉhtml(
ᑉhead( ᑉtitle( 'Test page' )),
ᑉbody( ᑉspan( 'Simple example.', class_='example' ))).pretty())
This prints out a valid, formatted XHTML document:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
<head>
<title>
Test page
</title>
</head>
<body>
<span class="example">One line example!</span>
</body>
</html>
Yes, you'll probably need to copy-paste the unicode symbol and yes, you'll want to use a modern editor, but the resulting syntax is very compact and will not collide with your identifiers even with the import *.
Minimalism also extends to implementation – it's very short (70 lines in v0.1). Check out microhtml.py.
Longer example with more features showcased:
from microhtml import *
# Rendering a non-indented string (result: <p>Third <em>and last</em> paragraph</p>)
raw_html = str(ᑉp("Third ", ᑉem("and last"), ' paragraph'))
# Writing a nicely formatted / tidied XHTML document to a file descriptor
print(
ᑉhtml( lang='en_US' )(
ᑉhead(ᑉtitle("Test page")),
ᑉbody(
ᑉp("Hi!", width=123), # 123 becomes "123"
ᑉhr(class_='someclass'), # Reserved words like "class" can be written with a trailing underscore
ᑉp('Literal strings are safely <em>escaped</em> by default.'),
ᑉrawstr(raw_html), # Use ᑉrawstr() if you don't want escaping
ᑉtag('applet', code='Bubbles.class', width=350, height=350), # Tag with custom name
ᑉdiv(style='float: right')( # This is how you can type attributes on left and content on right
ᑉdiv(style='border: 1px solid black')(
ᑉa("Nested", href='#anchortest'), '|', 'link')))).pretty())
This outputs:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en_US">
<head>
<title>
Test page
</title>
</head>
<body>
<p width="123">
Hi!
</p>
<hr class="someclass">
<p>
Literal strings are safely <em>escaped</em> by default.
</p>
<p>
Third <em>and last</em> paragraph
</p><applet code="Bubbles.class" width="350" height="350">
</applet>
<div style="float: right">
<div style="border: 1px solid black">
<a href="#anchortest">Nested</a>|link
</div>
</div>
</body>
</html>
If you find unicode characters in source code a horrendous abomination, and don't mind endless nested with expressions, you might prefer Yattag.
Uses tidylib for pretty printing. Inspiration drawn from pyhtml by Cenk Altı.
Copyright 2019 Jarno Elonen. Released under the MIT license. See LICENSE for details.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for py_microhtml-0.1-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0ca6c6ab52d32724c66d8c5cc8d3d7fbdd67d2d4cfaac7e4eb7e72dc0e142a89 |
|
| MD5 | ab6516b339369ae7fba7d7ba01319665 |
|
| BLAKE2b-256 | 628c12f073e915df8cf9aa2d8cd3c758ea3c41d4b7f65c001fa95fd2cd4d26f3 |
