A minimal python dsl for generating html.
Project description
hype
A minimal python dsl for generating html.
Install
Install via pip
pip install hype-html
Alteratively, in the spirit of removing dependencies, you could simply copy/paste the hype/element.py file into your project.
Usage
Hype exposes classes for each html tag.
from hype import *
doc = Doc(Html('Hello World!'))
print(doc)
# <!DOCTYPE html>
# <div>Hello World!</div>
Elements can also be rendered by calling.
doc() == str(doc)
Inner HTML
Arguments passed in the element constructor are rendered using the str function and indented (if the element only has one argument it will not be indented.)
body = Body(
H1('Hello World'),
P('This is a paragraph'),
'Just a string',
P('Another paragraph')
)
print(body)
# <body>
# <h1>Hello World</h1>
# <p>This is a paragraph</p>Just a string
# <p>Another paragraph</p>
# </body>
Append to an elementes list of inner html elements.
body = Body(
H1('Hello World'),
P('This is a paragraph'),
'Just a string'
)
body.append(P('Another paragraph'))
print(body)
# <body>
# <h1>Hello World</h1>
# <p>This is a paragraph</p>Just a string
# <p>Another paragraph</p>
# </body>
Attributes
Attributes are passed as keyword arguments to the element's constructor.
span = Span('span', width='50px')
print(span)
# <span width="50px">span</span>
Since some built-in, and possibly custom, attributes conflict with python keywords, keywords will automatically have all leading underscores stripped.
span = Span('span', _id='my-span', width='50px')
print(span)
# <span id="my-span" width="50px">span</span>
Any remaining underscores will be converted to hyphens.
span = Span('span', custom_attrbiute='custom')
print(span)
# <span custom-attribute="custom">span</span>
Also add attributes using a method's attrs method add keyword arguments.
span = Span('span')
span.attrs(_id='my-span', test='test')
print(span)
# <span id="my-span" test="test">span</span>
Custom Elements
If you to create a custom tag, just subtype the Element class and add a tag.
class CustomTag(Element):
tag = 'custom-tag'
tag = CustomTag()
print(tag)
# <custom-tag></custom-tag>
To create a custom self closing tag, subtype the SelfClosingElement class.
class CustomTag(SelfClosingElement):
tag = 'custom-tag'
tag = CustomTag()
print(tag)
# <custom-tag/>
Indents
The indent to be used can be passed as a keyword arg to the Doc constructor.
doc = Doc(content, indent=Indent.TAB)
It can also be passed as a keyword arg when calling and element.
div = Div(H1('Header'))
print(div(indent=Indent.FOUR_SPACES))
# <div>
# <h1>Header</h1>
# </div>
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
File details
Details for the file hype-html-1.1.0.tar.gz.
File metadata
- Download URL: hype-html-1.1.0.tar.gz
- Upload date:
- Size: 11.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/6.6.0 pkginfo/1.9.6 requests/2.29.0 requests-toolbelt/0.10.1 tqdm/4.65.0 CPython/3.10.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 501ab029dd50c18de7dc0daedfdf84e94e2f59ad1c1e522c6200a82317b64797 |
|
| MD5 | a73ea9ccfeda47ae63a57524b0df7545 |
|
| BLAKE2b-256 | 357aeb8ab93dd957d59e772ece433647220bfd857f01632a616cfdb42ae7a2dd |
File details
Details for the file hype_html-1.1.0-py3-none-any.whl.
File metadata
- Download URL: hype_html-1.1.0-py3-none-any.whl
- Upload date:
- Size: 11.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/6.6.0 pkginfo/1.9.6 requests/2.29.0 requests-toolbelt/0.10.1 tqdm/4.65.0 CPython/3.10.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3afd6788aeaeede727c30c4b9d51ec3005f48059a5a76e7a0ecb4697e0934d86 |
|
| MD5 | 5bab6c81e046f7700c7ae0db8c51ed2e |
|
| BLAKE2b-256 | a29b50e4e82891f355a698e1d6c71c360c9607695d7c983f17c2df426b69d79f |
