copier-template-extensions

What it is and what it does

Copier Template-Extensions is a Jinja2 extension for Copier that lets you define custom template extensions as Python files stored in your template directory, then reference them by relative file path instead of Python module dotted notation. This is particularly useful for template authors who want to add custom filters, tests, or context manipulation without requiring users to install separate Python packages or manage complex module paths.

The package provides two main features: a TemplateExtensionLoader that resolves file-path-based extension references, and a ContextHook base class that simplifies adding or modifying template context variables during rendering. This is helpful when you want to compute derived values (like converting a project type into a module name) or apply transformations without cluttering template filenames with Jinja macros or inline logic.

Use it for

• Add custom Jinja filters (like slugify) to a Copier template without publishing them as a separate package.
• Compute derived context variables during template rendering based on user answers (e.g., inferring module names from project type).
• Organize template logic into separate Python modules within the template directory for readability and maintainability.
• Implement template-specific hooks that run during different Copier phases (prompting, rendering, tasks, migrations) to validate or transform context.
• Avoid ugly Jinja macro imports or inline context updates in template filenames by centralizing logic in Python extension classes.

Worth the install?

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

Install

copier-template-extensions on PyPI

Before you install

Low friction: pure Python wheel with a single runtime dependency on copier. Maintenance status is aging—last release was 395 days ago, though the repository remains active and the package is typed.

Requires copier to be installed; intended for use within Copier template projects, not standalone.

License in practice

ISC license is permissive and imposes minimal restrictions; safe for commercial and private use without significant compliance burden.

Quickstart

pip install copier-template-extensions

# In copier.yml:
_jinja_extensions:
  - copier_template_extensions.TemplateExtensionLoader
  - extensions/myext.py:MyExtension

# In extensions/myext.py:
from copier_template_extensions import ContextHook
class MyExtension(ContextHook):
    def hook(self, context):
        context["new_var"] = "computed_value"

Package facts

Evidence: copier_template_extensions-0.3.3-py3-none-any.whl

Tags

More Software Development packages

See also copier · copier-templates-extensions · Jinja2 · mkdocs-macros-plugin · sphinx-jinja · jinja2_pluralize · jinja_partials · ruamel.yaml.jinja2 · pyramid-jinja2 · vsdx