{"id":20941,"library":"approval-utilities","title":"Approval Utilities","description":"Supporting utilities for approval testing in Python, commonly used with the approvaltests package. Current version 18.0.1, released regularly via GitHub releases. Supports Python 3.10+.","status":"active","version":"18.0.1","language":"python","source_language":"en","source_url":"https://github.com/approvals/ApprovalTests.Python","tags":["approval-testing","utilities","testing"],"install":[{"cmd":"pip install approval-utilities","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"verify moved to approval_utilities in v18; avoid cross-package coupling","wrong":"from approvaltests import verify","symbol":"verify","correct":"from approval_utilities.utilities import verify"}],"quickstart":{"code":"from approval_utilities.utilities import LoggerUtilities\nlogger = LoggerUtilities()\nlogger.log('test')","lang":"python","description":"Quick example of using LoggerUtilities from approval_utilities."},"warnings":[{"fix":"Upgrade to Python 3.10+ or stay on v17.x if you cannot upgrade Python.","message":"Removed support for Python 3.8 and 3.9 in v18.0.0. These versions are no longer compatible.","severity":"breaking","affected_versions":"<18.0.0"},{"fix":"Run 'pip install approval-utilities' alongside approvaltests-minimal.","message":"The package 'approvaltests-minimal' now correctly declares dependency on 'approval_utilities' from v18.0.0 onwards, but older versions might missing the dependency. Install explicitly if needed.","severity":"gotcha","affected_versions":"<18.0.0"},{"fix":"Use 'from approval_utilities.utilities import verify' instead.","message":"The verify function imported from approvaltests is deprecated and will be removed in future approvaltests releases. Migrate to approval_utilities.","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'pip install approval-utilities' (or 'pip install --upgrade approval-utilities').","cause":"Package not installed or not upgraded to version that includes 'approval_utilities' module.","error":"ModuleNotFoundError: No module named 'approval_utilities'"},{"fix":"Change import to 'from approval_utilities.utilities import verify'.","cause":"The verify function might not be in the top-level of approval_utilities; it's in approval_utilities.utilities.","error":"ImportError: cannot import name 'verify' from 'approval_utilities'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}