---
id: jinjanator-plugins
version: "25.1.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# jinjanator-plugins — Package which provides the plugin API for the jinjanator tool

License: permissive · Maintenance: active · Downloads: 1.1M/mo

## What it is and what it does

jinjanator-plugins is an API package that defines the contract for extending the jinjanator tool through plugins. It provides decorators and exception classes that plugin developers use to hook custom functionality into jinjanator's template processing pipeline. Plugins can contribute data format parsers, Jinja2 filters, tests, globals, and extensions—all discovered and loaded automatically via Python entry points.

This package is not meant to be installed directly by end users; instead, it serves as a dependency for plugin packages. Plugin developers import from it to mark their hook functions and define format classes. The package itself is lightweight, depending only on attrs, pluggy, and typing-extensions, and supports Python 3.10 through 3.14. It is actively maintained and carries no known security vulnerabilities.

Use it for:

- Develop a custom data format parser plugin to allow jinjanator to read proprietary or domain-specific file formats.
- Create filter functions in a plugin to add domain-specific transformations available in Jinja2 templates.
- Build a plugin that registers test functions for conditional logic in templates (e.g., custom validation checks).
- Extend jinjanator with a plugin that provides global functions to fetch data from external APIs or databases.
- Package a plugin that adds Jinja2 extensions to enable new template syntax or capabilities.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides the plugin API and hook decorators that allow developers to extend the jinjanator tool with custom formats, filters, tests, globals, and Jinja2 extensions.

Yes, if you are developing a plugin for jinjanator. This package is essential for plugin authors and should be pinned to a specific version in your plugin's dependencies to avoid API breakage. For end users of jinjanator who are not writing plugins, there is no need to install it directly. No security concerns; actively maintained.

## Install

pip install jinjanator-plugins
uv add jinjanator-plugins
poetry add jinjanator-plugins

## Installing jinjanator-plugins

Before you install: Low install friction with three lightweight runtime dependencies (attrs, pluggy, typing-extensions). Actively maintained with a recent release; the repo shows ongoing development. The package explicitly recommends pinning to a narrow version range to avoid API breakage.

License in practice: Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions; you must include a copy of the license and note any modifications.

Quickstart:

# Install as a dependency of your plugin package
# In your plugin's pyproject.toml:
# dependencies = ["jinjanator-plugins==25.1.0"]

# In your plugin module:
from jinjanator_plugins import (
    plugin_filters_hook,
    plugin_formats_hook,
)

@plugin_filters_hook
def plugin_filters():
    return {"my_filter": my_filter_function}

@plugin_formats_hook
def plugin_formats():
    return {"my_format": MyFormatClass}

Requires Python 3.10 or later. Plugins must be installed into the same environment as jinjanator itself and registered via entry points in pyproject.toml.

Verify before relying:

- Whether the package maintains backward compatibility across minor version updates despite the recommendation to pin versions narrowly.
- Performance characteristics when a plugin provides many filters, tests, or formats simultaneously.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

jinjanator plugin development, jinja2 template plugin api, custom format parsers, template filter extensions, plugin hook decorators, plugin-framework, jinja2-extension, template-processing

[View on SkillFed](https://skillfed.io/packages/jinjanator-plugins) · [View on PyPI](https://pypi.org/project/jinjanator-plugins/)