---
id: pytest-cookies
version: "0.7.0"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pytest-cookies — The pytest plugin for your Cookiecutter templates. 🍪

License: permissive · Maintenance: abandoned · Downloads: 93.5K/mo

## What it is and what it does

pytest-cookies is a pytest plugin that wraps the cookiecutter API into a reusable `cookies` fixture for testing cookiecutter project templates. When you call `cookies.bake()`, it generates a new project from your template using default values from `cookiecutter.json`, optionally overriding them with `extra_context` to test different input scenarios. The fixture automatically cleans up generated projects after tests complete, keeping your test environment tidy.

The plugin depends on pytest and cookiecutter as runtime dependencies. It supports Python 3.7 through 3.11 and is classified as Production/Stable. The package has been in development since 2015 but has entered abandoned maintenance with no releases since 2023-03-22, though the repository has not been archived.

Use it for:

- Verify that a cookiecutter template generates valid project structures with expected file layouts and naming conventions.
- Test template rendering by injecting custom context values and asserting the output contains correct variable substitutions.
- Validate that cookiecutter templates work correctly across different Python versions and operating systems in CI/CD pipelines.
- Ensure template validation rules and default values produce sensible projects without manual intervention.

## Worth the install?

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

A pytest plugin that provides a `cookies` fixture for testing cookiecutter templates by generating projects from them and automatically cleaning up afterward.

Yes, if you maintain a cookiecutter template and need to test it—the plugin is straightforward and has no known vulnerabilities. However, proceed with caution: the package is in abandoned maintenance with no releases since 2023-03-22. If you encounter bugs or compatibility issues with newer pytest or cookiecutter versions, you may need to fork or patch it yourself.

## Install

pip install pytest-cookies
uv add pytest-cookies
poetry add pytest-cookies

## Installing pytest-cookies

Before you install: Low install friction with just two runtime dependencies. However, the package is in abandoned maintenance status with no releases since 2023-03-22, though the repository remains active.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install pytest-cookies

# In your test file:
def test_bake_project(cookies):
    result = cookies.bake(extra_context={"repo_name": "helloworld"})
    assert result.exit_code == 0
    assert result.project_path.is_dir()

Verify before relying:

- Whether the package remains compatible with current versions of pytest and cookiecutter despite no releases since 2023-03-22
- Whether abandonment status means critical bugs or security issues will not be addressed going forward

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 93.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest cookiecutter template testing, test cookiecutter templates, pytest plugin for templates, cookiecutter project generation testing, template validation pytest, cookiecutter, template-testing, pytest-plugin

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