jinja2-simple-tags

What it is and what it does

jinja2-simple-tags is a lightweight library that reduces boilerplate when writing custom Jinja2 template tags. Instead of implementing the full Jinja2 Extension API, you subclass one of three provided tag types—StandaloneTag (for simple output tags), ContainerTag (for tags with opening and closing markers), or InclusionTag (for template inclusion)—and implement a render method. The library handles registration, argument parsing, context access, and output escaping.

It's designed for developers building Jinja2-based applications (web frameworks, static site generators, templating systems) who need to extend templates with custom logic without wrestling with Jinja2's lower-level extension machinery. The package supports Python 3.6 and later, depends only on Jinja2, and has no known security vulnerabilities.

Use it for:

• Add a custom {% now %} tag to templates that outputs the current date and time in a specified format.
• Create a {% hmac %} container tag that signs template content with a secret key and returns the digest.
• Build an {% include_header %} tag that includes a template fragment with injected context variables like logo paths.
• Implement a {% username %} tag that accesses the current request context to render the logged-in user's name.
• Define tags that assign their output to template variables using the 'as' keyword for later reuse.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides base classes to create custom Jinja2 template tags (standalone, container, and inclusion types) with minimal boilerplate by implementing a render method.

Yes. The package is actively maintained, has no dependencies beyond Jinja2, carries a permissive license, and solves a real problem for anyone building Jinja2 applications. The API is straightforward and well-documented. Install it if you need to write custom template tags and want to avoid boilerplate.

Install

jinja2-simple-tags on PyPI

pip install jinja2-simple-tags

uv add jinja2-simple-tags

poetry add jinja2-simple-tags

Installing jinja2-simple-tags

Before you install

Low friction: pure Python wheel with a single runtime dependency (Jinja2 >= 2.10). Maintained actively with recent commits; last release was in 2024.

License in practice

BSD license (permissive) places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart

pip install jinja2-simple-tags

from jinja2_simple_tags import StandaloneTag
from datetime import datetime

class NowExtension(StandaloneTag):
    tags = {"now"}
    def render(self, format="%Y-%m-%d %H:%I:%S"):
        return datetime.now().strftime(format)

Verify before relying

• Whether the package is actively maintained beyond the last 2024 release (last commit is dated 2026-04-13 but days_since_release is 891, creating a timeline gap that needs clarification).

Package facts

Evidence: jinja2_simple_tags-0.6.1-py2.py3-none-any.whl

Tags

More Python Modules packages