Pre-release

This release is a pre-release and may not be stable for production use.

Package Version PyPI - Status Tests Status Code Coverage Percentage Project License Python Versions

📋 A generic validator for Copier templates. Instantiates templates with various preset answer files (variants) and runs configurable validation commands against the generated projects.

Key Features

  • Configurable validation commands: Define validation commands in a TOML configuration file. The tool is agnostic about what gets validated.

  • Configurable answers directory: Specify where variant answer files live. No hardcoded convention imposed.

  • Placeholder interpolation: Use {template_directory}, {project_directory}, {temporary_directory}, and {variant} in command args and working directories.

  • Copier Python API: Uses copier.run_copy directly instead of shelling out to a subprocess.

  • Configuration hierarchy: CLI arguments, per-project config, and per-user config (via emcd-appcore) with clear precedence.

  • Structured error handling: Domain-specific exceptions with Markdown rendering for terminal display.

Installation 📦

Method: Install Executable Script

Install via the uv tool command:

uv tool install copiertv

or, run directly with uvx:

uvx copiertv

Or, install via pipx:

pipx install copiertv

Method: Install Python Package

Install via uv pip command:

uv pip install copiertv

Or, install via pip:

pip install copiertv

Usage

Survey Variants

List available template variants (reads answers directory from configuration):

copiertv survey

Validate a Variant

Validate a template variant:

copiertv validate default

Preserve the generated project for inspection:

copiertv validate --preserve default

Configuration File

Create .auxiliary/configuration/copiertv/general.toml in your template repository:

[answers]
directory = "data/copier"

[[commands]]
args = ["hatch", "env", "prune"]

[[commands]]
args = ["hatch", "--env", "develop", "run", "make-all"]

[options]
preserve = false
unsafe = false

Commands support placeholder interpolation for paths:

[[commands]]
args = ["make", "check", "--source", "{project_directory}"]
cwd = "{template_directory}"

Available placeholders: {template_directory}, {project_directory}, {temporary_directory}, {variant}.

Contribution 🤝

Contribution to this project is welcome! However, it must follow the code of conduct for the project.

Please file bug reports and feature requests in the issue tracker or submit pull requests to improve the source code or documentation.

For development guidance and standards, please see the development guide.

Additional Indicia

GitHub last commit Copier Hatch pre-commit Pyright Ruff PyPI - Implementation PyPI - Wheel

Other Projects by This Author 🌟

  • python-absence (absence on PyPI)

    🕳️ A Python library package which provides a sentinel for absent values - a falsey, immutable singleton that represents the absence of a value in contexts where None or False may be valid values.

  • python-accretive (accretive on PyPI)

    🌌 A Python library package which provides accretive data structures - collections which can grow but never shrink.

  • python-classcore (classcore on PyPI)

    🏭 A Python library package which provides foundational class factories and decorators for providing classes with attributes immutability and concealment and other custom behaviors.

  • python-detextive (detextive on PyPI)

    🕵️ A Python library which provides consolidated text detection capabilities for reliable content analysis. Offers MIME type detection, character set detection, and line separator processing.

  • python-dynadoc (dynadoc on PyPI)

    📝 A Python library package which bridges the gap between rich annotations and automatic documentation generation with configurable renderers and support for reusable fragments.

  • python-falsifier (falsifier on PyPI)

    🎭 A very simple Python library package which provides a base class for falsey objects - objects that evaluate to False in boolean contexts.

  • python-frigid (frigid on PyPI)

    🔒 A Python library package which provides immutable data structures - collections which cannot be modified after creation.

  • python-icecream-truck (icecream-truck on PyPI)

    🍦 Flavorful Debugging - A Python library which enhances the powerful and well-known icecream package with flavored traces, configuration hierarchies, customized outputs, ready-made recipes, and more.

  • python-librovore (librovore on PyPI)

    🐲 Documentation Search Engine - An intelligent documentation search and extraction tool that provides both a command-line interface for humans and an MCP (Model Context Protocol) server for AI agents. Search across Sphinx and MkDocs sites with fuzzy matching, extract clean markdown content, and integrate seamlessly with AI development workflows.

  • python-mimeogram (mimeogram on PyPI)

    📨 A command-line tool for exchanging collections of files with Large Language Models - bundle multiple files into a single clipboard-ready document while preserving directory structure and metadata… good for code reviews, project sharing, and LLM interactions.

Project links

Data verified by PyPI on Jul 10, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for emcd from gravatar.com emcd

Credits

Author: Eric McDonald

GitHub Statistics

Data verified by PyPI on Jul 10, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.10

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

copiertv-1.0a2.tar.gz (18.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

copiertv-1.0a2-py3-none-any.whl (22.6 kB view details)

Uploaded Python 3

File details

Details for the file copiertv-1.0a2.tar.gz.

File metadata

  • Download URL: copiertv-1.0a2.tar.gz
  • Upload date:
  • Size: 18.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for copiertv-1.0a2.tar.gz
Algorithm Hash digest
SHA256 20aaf37278888fc4e5e491c47eb5dc8a0641e35242e0042ffffdc95ce8f46050
MD5 9f1332ce5b2396d84aa9a5a3da74752b
BLAKE2b-256 a07397c3c7982b1dfc610b842a3080bcfcadff08672fe7457e363fce0092cad8

See more details on using hashes here.

Provenance

The following attestation bundles were made for copiertv-1.0a2.tar.gz:

Publisher: releaser.yaml on emcd/copier-template-validator

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file copiertv-1.0a2-py3-none-any.whl.

File metadata

  • Download URL: copiertv-1.0a2-py3-none-any.whl
  • Upload date:
  • Size: 22.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for copiertv-1.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 23185bc1e35bf1db2f84cf18939a65fa6e203a52f75631139ecab40c6a2ad89a
MD5 22ac3a3744d48cc51e83e067b602ba09
BLAKE2b-256 e80ca53d1feb78bf2125b0785db9a1eae4272805398a993c3b168e16116dd774

See more details on using hashes here.

Provenance

The following attestation bundles were made for copiertv-1.0a2-py3-none-any.whl:

Publisher: releaser.yaml on emcd/copier-template-validator

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page