laces

What it is and what it does

Laces is a Django package that implements self-rendering components—Python objects that encapsulate both the template and the data needed to render it. Instead of passing data separately to templates and managing context manually, you create a component class, instantiate it with the data it needs, and pass the component object itself to your view template. The `{% component %}` template tag then renders it without the parent template needing to know anything about the component's internal structure or context requirements.

This pattern is particularly useful for nested components, where building the same nested structure twice (once in data, once in templates) becomes cumbersome. Components can override `get_context_data()` to provide template context, or `render_html()` to generate HTML directly. The package supports adding JavaScript and CSS assets to components and works with Django versions 3.2 through 5.0 on Python 3.8+. It originated from patterns used in the Wagtail admin interface and brings those tools to general Django projects.

Use it for

• Build reusable UI components (buttons, cards, modals) that encapsulate their own template and styling logic.
• Manage nested component hierarchies without duplicating data structure in both Python and templates.
• Create form components that bundle validation, rendering, and asset inclusion in a single class.
• Simplify passing components through view context by letting them manage their own template rendering.
• Organize complex template logic into self-contained, testable component classes instead of template files.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

laces on PyPI

Before you install

Installation is straightforward with a single pip install and minimal setup (adding to INSTALLED_APPS). The package has one runtime dependency (Django) and maintains active development with recent commits, though it remains in alpha status.

License in practice

Licensed under a permissive BSD license, allowing use in commercial and private projects with minimal restrictions.

Quickstart

# Install
pip install laces

# settings.py
INSTALLED_APPS = ["laces", ...]

# my_app/components.py
from laces.components import Component

class WelcomePanel(Component):
    template_name = "my_app/components/welcome.html"
    def __init__(self, name):
        self.name = name
    def get_context_data(self, parent_context=None):
        return {"name": self.name}

# my_app/views.py
welcome = WelcomePanel(name="Alice")
return render(request, "my_app/home.html", {"welcome": welcome})

# my_app/templates/my_app/home.html
{% load laces %}
{% component welcome %}

Package facts

Evidence: laces-0.1.2-py3-none-any.whl

Tags

More Application Frameworks packages

See also django-render-block · jinja2-fragments · django-components · django-debug-toolbar-template-timings · django-cotton · django-extra-views · jinja2-simple-tags · django-debug-toolbar-template-profiler · pybars4 · django-template-partials