---
id: approval-utilities
version: "19.1.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# approval-utilities — Utilities for your production code that work well with approvaltests

License: permissive · Maintenance: active · Downloads: 157.9K/mo

## What it is and what it does

Approval-utilities is a utility package that provides helpers for snapshot-based testing workflows. It depends on typing_extensions and supports Python 3.10 through 3.14. The package is actively maintained with recent releases and integrates with modern Python environments.

The package is designed to work in testing contexts where developers need to verify complex objects and output against approved snapshots. It operates by comparing current test results against golden-master files, launching diff tools when results diverge to help developers review and approve changes.

Use it for:

- Verify complex nested data structures in tests without writing fragile equality checks.
- Compare long text output or formatted strings where manual assertion would be error-prone.
- Manage golden-master test files for regression detection in API or document generation tests.
- Review test output changes during development or refactoring using diff tools.
- Integrate snapshot-based testing into Python test suites with minimal boilerplate.

## Worth the install?

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

Provides utility functions and helpers for snapshot-based testing and verification workflows in Python.

Yes, if you need snapshot-based testing utilities. The package is actively maintained, has low install friction, carries a permissive Apache-2.0 license, and supports current Python versions (3.10 through 3.14). There are no known security vulnerabilities.

## Install

pip install approval-utilities
uv add approval-utilities
poetry add approval-utilities

## Installing approval-utilities

Before you install: Low friction install with a single runtime dependency (typing_extensions). Active maintenance with a recent release 12 days old and steady repository activity.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install approval-utilities

from approval_utilities import verify

result = "test output"
verify(result)

Requires Python 3.10 or later.

Verify before relying:

- What specific utility functions this package provides beyond core testing capabilities.
- Whether this package is intended for end users or primarily for internal use.
- How this package integrates with testing frameworks like pytest or unittest.
- What the verify() function signature and behavior are.

## Package facts

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

## Tags

snapshot testing utilities, test verification helpers, golden master testing, approval testing framework, test assertion library, verification utilities, testing tools, snapshot-testing, test-utilities

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