v5.0.0

Syrupy 5.0.0

(2025-09-28)

This release introduces new features, bug fixes, and a major license change. It also includes several breaking changes, so please review those carefully before upgrading.

---

New Features ✨

• Add --snapshot-dirname option: A new option, --snapshot-dirname, is now available to change the default directory snapshots are stored in. ([#810](#810))
• Remove private underscore prefix: The unnecessary underscore prefixes have been removed from public methods for better code clarity. ([8cfc905](8cfc905))

---

Bug Fixes 🐛

• Fix terminal summary for xdist workers: Resolves an issue where the terminal summary was not displayed correctly with xdist workers. ([#978](#978))
• Ensure pytest_assertrepr_compare hook is called first: This change ensures that Syrupy's assertion hook takes precedence, improving compatibility with other plugins. ([#984](#984))

---

Breaking Changes ⚠️

• License change: The project has switched to the more permissive MIT license. This change applies to all versions from 5.0.0 and beyond. If you need to use the previous Apache 2.0 license, you must continue to use Syrupy versions 4.x or earlier. ([#945](#945))

• Python and pytest version requirements: Syrupy now requires Python 3.10 or higher. Support for Python 3.8 has been dropped as it reached its end of life in October 2024. The minimum required version of pytest is v8. ([#904](#904), [#1024](#1024))

• Method and constant name changes: Several methods and constants have been renamed for improved clarity and to align with public API standards.

  • SnapshotCollectionStorage

    • _read_snapshot_collection -> read_snapshot_collection
    • _read_snapshot_data_from_location -> read_snapshot_data_from_location
    • _write_snapshot_collection -> write_snapshot_collection
    • _get_file_basename -> get_file_basename
    • _file_extension -> file_extension

  • AmberDataSerializer

    • _snapshot_sort_key -> snapshot_sort_key

  • Constants

    • SNAPSHOT_EMPTY_FOSSIL_KEY -> SNAPSHOT_EMPTY_COLLECTION_KEY
    • SNAPSHOT_UNKNOWN_FOSSIL_KEY -> SNAPSHOT_UNKNOWN_COLLECTION_KEY
    • SNAPSHOT_DIRNAME has been removed in favour of the property on the SnapshotCollectionStorage class and associated CLI option.

New Contributors

• @paul-ollis made their first contribution in #978
• @rahuliyer95 made their first contribution in #984

Full Changelog: v4.9.1...v5.0.0