Better support pointing to a specific cache file. Right now, setting cache_dir and cache_name works, but it adds the extra README.md file, which is imprecise when cache-assert doesn't actually create the folder

There is a use case for accessing the cached data that exposing the read_cached_data could be useful:

https://github.com/KyleKing/pytest_cache_assert/blob/cc747a926613d7ef7c4bec305284fb6f7cbe0679/pytest_cache_assert/main.py#LL67C28-L67C28

Consider https://github.com/augustogoulart/awesome-pytest

• Store metadata in frontmatter with python-frontmatter using a new LocalMDCacheStore (example: https://stackoverflow.com/a/52196222/3219667)
  • Maybe consider https://github.com/takuti/prelims
• When the context is code, should it be in a code block to prevent markdown renders from gobbling the content? Maybe add a decorator to make using a code block configurable since regular markdown is likely a rare use case?

Large diffs are hard to read in CLI output, so always write to the cached file even if an AssertionError was found (that way the changes can be reviewed in VCS)

Only downside is that a repeated test, such as one run with pytest-watcher will appear flaky so this feature will be opt-in only

Either set globally or per-fixture with an argument

Con: lose rule logic for types, like datetime comparison, but could be re-implemented with pendulum.parse if the rule was specified

Pro: fewer edge cases that need to be manually implemented (like serializing arbitrary classes)