Skip to main content

simple, elegant HTML generation

Project description

To construct HTML start with an instance of html.HTML(). Add tags by accessing the tag’s attribute on that object. For example:

>>> from html import HTML
>>> h = HTML()
>>> print h

If the tag should have text content you may pass it at tag creation time or later using the tag’s .text() method (note it is assumed that a fresh HTML instance is created for each of the following examples):

>>> p = h.p('hello, world!\n')
>>> p.text('more text')
>>> h.p
>>> print h
<p>hello, world!
more text</p>

Any HTML-specific characters (<>&") in the text will be quoted as appropriate. Note also that the top-level HTML object adds newlines between tags by default.

If the tag should have sub-tags you have two options. You may either add the sub-tags directly on the tag:

>>> l = h.ol
>>>'item 1')
>>>'item 2 > 1')
>>> print h
<li>item 1</li>
<li>item 2 &gt; 1</li>

Note that the default behavior with lists (and tables) is to add newlines between sub-tags to generate a nicer output. The alternative to the above method is to use the containter tag as a context for adding the sub-tags:

>>> with h.table(border='1'):
...   for i in range(2):
...     with
...'column 1')
...'column 2')
...  print h
<table border="1">
<tr><td>column 1</td><td>column 2</td></tr>
<tr><td>column 1</td><td>column 2</td></tr>

Note the addition of an attribute to the <table> tag.

You may turn off/on adding newlines by passing newlines=False or True to the tag (or HTML instance) at creation time:

>>> l = h.ol(newlines=False)
>>>'item 1')
>>>'item 2')
>>> print h
<ol><li>item 1</li><li>item 2</li></ol>

This code is copyright 2009 Inc ( See the end of the source file for the license of use.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

html-1.0.tar.gz (3.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page