python-fragments 0.36

Modern HTML template rendering in Python

This package is in early development and not yet stable. The API may change without notice between releases.

Modern HTML template rendering in Python. No build step, no template files, and native HTML awareness out of the box. Read More

from fastapi import APIRouter

router = APIRouter()

@router.get("/", response_class=HTMLResponse)
async def index() -> str:
    published = [p for p in POSTS if p.published]
    return <>
        <Layout title="My Blog">
            <h1>Latest Posts</h1>
            <PostCard for={{ post in published }} post={{ post }} />
        </Layout>
    </>

IDE Support

Type checking, completions, hover docs, go-to-definition, rename, and semantic highlighting. All working inside fragment syntax.

Install the Python Fragments VS Code extension to get started.

Installation

pip install python-fragments

Register the loader at your application's entry point, before importing any modules that contain fragments:

from fragments import loader  # isort: skip

Any .py file containing <> is transpiled automatically. Nothing else to configure.

Documentation

Full documentation is available at python-fragments.io.

Contributing

Bug reports, feature requests, and documentation improvements are all welcome. Code contributions aren't open yet while we work toward v1. See CONTRIBUTING.md for details.