django-components-lite 0.3.0

Lightweight reusable template components for Django. An exploratory fork of django-components.

django-components-lite

An exploratory, lightweight fork of django-components.

This package strips django-components down to its core: simple, reusable template components for Django, just templates with some optional python logic. The goal is to see how a minimal django-components feels in practice.

Attribution

This project is built on the excellent work of the django-components project by Emil Stenström, Juro Oravec, and all contributors. Their years of work made this possible.

If you're looking for a mature, full-featured, and battle-tested component library for Django, use django-components. It has an active community, extensive documentation, and a rich feature set.

Features

What django-components-lite keeps from django-components:

• Component classes with Python logic and Django templates
• {% comp %} / {% endcomp %} template tags
• Slots and fills ({% slot %}, {% fill %})
• Component autodiscovery
• Component registry
• Static file handling (JS/CSS)
• Isolated component context
• HTML attribute rendering utilities

What's removed?

Compared to django-components, the following have been stripped out:

• Extension system
• Built-in components (DynamicComponent, ErrorFallback)
• Component caching
• Provide/Inject system
• Template expressions
• Management commands
• JS/CSS data methods and dependency management
• Type validation (Args/Kwargs/Slots/TemplateData)
• on_render() generator system and deferred rendering
• context_behavior setting (always isolated, like Django's inclusion_tag)
• Tag formatters
• Component views and URLs
• libraries setting and import_libraries()
• reload_on_file_change setting
• All deprecated setting aliases

Installation

pip install django-components-lite

Add to your Django settings:

INSTALLED_APPS = [
    # ...
    "django_components_lite",
]

Quick example

# myapp/components/greeting/greeting.py
from django_components_lite import Component, register

@register("greeting")
class Greeting(Component):
    template_file = "greeting.html"

    def get_context_data(self, name):
        return {"name": name}

<!-- myapp/components/greeting/greeting.html -->
<div class="greeting">
  Hello, {{ name }}!
  {% slot "extra" %}{% endslot %}
</div>

<!-- In any template -->
{% load component_tags %}
{% comp "greeting" name="World" %}
  {% fill "extra" %}
    <p>Welcome!</p>
  {% endfill %}
{% endcomp %}

Links

• django-components (original) - the full-featured upstream project
• Documentation
• Issues

License

MIT - see LICENSE.