A library for building HTML documents with a simple and learnable syntax
Project description
PyHTML Enhanced
A library for building HTML documents with a simple and learnable syntax, inspired by, and similar to the original PyHTML library, but with improved documentation and type safety.
Benefits over PyHTML
-
Inline documentation and type safety for all tags. Documentation for tags is pulled from MDN Web Docs.
-
A modern and readable codebase.
-
No dependencies.
Usage
import pyhtml as h
my_website = h.html(
h.head(
h.title("Hello, world!"),
h.script(src="http://example.com/script.js"),
),
h.body(
h.h1("Hello, world!"),
h.p("This is my amazing website rendered with PyHTML Enhanced!"),
),
)
# Converting it to a string is all you need to do to render it!
print(str(my_website))
This will produce the following HTML code:
<html>
<head>
<script src="http://example.com/script.js"></script>
<title>
Hello, world!
</title>
</head>
<body>
<h1>
Hello, world!
</h1>
<p>
This is my amazing website rendered with PyHTML Enhanced!
</p>
</body>
</html>
TODOs
There are a couple of things I haven't done yet
- Make tags by themselves render, so
str(br)renders to<br/> - Add default properties to tags
- Make inline documentation include documentation of suggested properties
- Update links within documentation to make them point to the right locations.
- Some tags (eg
<pre>) currently aren't properly implemented
How it works
Since there are so many HTML tags, it would be extremely tedious to document
them all manually. In the meta directory, you will find code that solves this
problem with the following steps:
-
Download the Markdown source for MDN's documentation of all HTML elements.
-
Parse the markdown to gather all tag names and descriptions, discarding garbage data and obsolete tags.
-
Use data from a YAML configuration file (
meta/tags.yml) to gather information on suggested properties and base classes to use for each tag. -
Generate Python code to represent all of these tags.
Credits
Cenkalti/PyHTML
Cenk Altı's work was used as a source of inspiration and reference. Although
all the code in pyhtml-enhanced was written by me, I want to thank them for
the significant help their hard work provided while creating this project.
MDN Web Docs
Almost all of the documentation was gathered from the MDN Web Docs. It's super neat that all their documentation is open (licensed as CC-BY-SA-2.5 if you're interested).
License
All code in this project is licensed under the MIT License.
However, the documentation found in
pyhtml/__tags/generated.py was copied from
MDN Web Docs, and is licensed under
CC-BY-SA-2.5. See
LICENSE_DOCS.md for a copy of the license.
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 pyhtml_enhanced-0.2.0-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 01118eb72b3ea2ed80343f2f89669a9ed72146a497c36bef2b2a2a91e14c249c |
|
| MD5 | c8c860dbdc696cac8071cd459f7a6347 |
|
| BLAKE2b-256 | acd9894d4652554dbb3880bc06c5b3f3231a8e5124887f3a5e2d1d6741af4de3 |
