markupy - HTML in Python
Project description
Overview
markupy is a plain Python alternative to traditional templates engines for generating HTML code.
Writing this code in Python with markupy...
# Import "elements" like they were regular Python objects
from markupy.elements import A, Body, Head, Html, Li, P, Title, Ul
menu = [("Home", "/"), ("About us", "/about"), ("Contact", "/contact")]
print(
Html[
Head[Title["My website"]],
Body[
P["Table of contents:"],
Ul(".menu")[(Li[A(href=url)[title]] for title, url in menu)],
],
]
)
...will generate this HTML:
<!doctype html>
<html>
<head>
<title>My website</title>
</head>
<body>
<p>Table of contents:</p>
<ul class="menu">
<li><a href="/">Home</a></li>
<li><a href="/about">About us</a></li>
<li><a href="/contact">Contact</a></li>
</ul>
</body>
</html>
Seems interesting? Try it by yourself with our online html2markupy converter.
Motivation
Like most Python web developers, we have relied on template engines (Jinja, Django, ...) since forever to generate HTML on the server side. Although this is fine for simple needs, when your site grows bigger, you might start facing some issues:
-
More an more Python code get put into unreadable and untestable macros
-
Extends and includes make it very hard to track required parameters
-
Templates are very permissive regarding typing making it more error prone
If this is you struggling with templates, then you should definitely give markupy a try!
Inspiration
markupy started as a fork of htpy. Even though the two projects are still conceptually very similar, we started markupy in order to support a slightly different syntax to optimize readability, reduce risk of conflicts with variables, and better support for non native html attributes syntax. On top of that, markupy provides a first class support for class based components.
Key Features
-
Leverage static types: Use mypy or pyright to type check your code.
-
Great debugging: Avoid cryptic stack traces from templates. Use your favorite Python debugger.
-
Easy to extend: There is no special way to define template tags/filters. Just call regular functions.
-
Works with existing Python web framework: Works great with Django, Flask or any other Python web framework!
-
Works great with htmx: markupy makes for a great experience when writing server rendered partials/components.
-
Create reusable components: Define components, snippets, complex layouts/pages as regular Python variables or functions.
-
Familiar concepts from React: React helped make it popular writing HTML with a programming language. markupy uses a lot of similar constructs.
-
Customizable: Use or create 3rd party libraries to leverage the power of markupy
Philosophy
markupy generates HTML elements and attributes and provide a few helpers.
markupy does not enforce any particular pattern or style to organize your pages, components and layouts. That does not mean that markupy cannot be used to build sophisticated web pages or applications.
Rather the opposite: you are encouraged the leverage the power of Python to structure your project. Use modules, classes, functions, decorators, list comprehension, generators, conditionals, static typing and any other feature of Python to organize your components. This gives you a lot of power and makes markupy scale from a small one file project to bigger applications.
Installation
markupy is available on PyPI. You may install the latest version using pip:
pip install markupy
Documentation
The full documentation is available at markupy.witiz.com:
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file markupy-2.3.0.tar.gz.
File metadata
- Download URL: markupy-2.3.0.tar.gz
- Upload date:
- Size: 92.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.32.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5fbd2cc884a2e731069b0bdcd2f4cdc837ed93f65149770f4f694727bfe835d2
|
|
| MD5 |
8dd17d86d39e7ab20d67bfd0ea3753de
|
|
| BLAKE2b-256 |
da076a45912920349acd6835a40b0d90c7be8ed4eca75b65ba3e25a018c3d52f
|
File details
Details for the file markupy-2.3.0-py3-none-any.whl.
File metadata
- Download URL: markupy-2.3.0-py3-none-any.whl
- Upload date:
- Size: 23.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.32.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
30bb6906883f265227a559b7e3f045afa351479c11ccd10dbc907610d9aae7b3
|
|
| MD5 |
09195991c285c5324b201068715e032e
|
|
| BLAKE2b-256 |
e4d3ae628637e5b39c55b1d9f27e51100d125517cde3c21741d696a1f6b92b37
|
