skillfed

approval-utilities

Utilities for your production code that work well with approvaltests

approval-utilities v19.1.1 157.9K downloads/30d#10,743 on PyPI209
Permissive license Apache-2.0 Active released

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 on this page — 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

approval-utilities on PyPI

pip

pip install approval-utilities

uv

uv add approval-utilities

poetry

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 the current Python release (>=3.10)
Install friction low — pure-Python wheel
Runtime dependencies 1 — typing_extensions
Maintenance actively maintained — 12 days since the last release
Last repo commit
First released
Downloads 157,901/month — #10,743 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: approval_utilities-19.1.1-py3-none-any.whl

Development Status :: 4 - BetaIntended Audience :: DevelopersOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software Development :: Libraries

Tags

snapshot testing utilitiestest verification helpersgolden master testingapproval testing frameworktest assertion libraryverification utilitiestesting tools
snapshot-testingtest-utilities

More Libraries packages