Skip to content

varlanv/selfie

 
 

Repository files navigation

Selfie: snapshot testing and memoizing for Python, JVM, and (your PR here)

gif demo of selfie in action

Key features

  • Just add a test dependency (py, jvm), zero setup, zero config.
  • Snapshots can be inline literals or on disk.
  • Use expect_selfie for testing or cache_selfie for memoizing expensive API calls.
  • Disk snapshots are automatically garbage collected when the test class or test method is removed.
  • Snapshots are just strings. Use html, json, markdown, whatever. No magic serializers.
  • Record multiple facets of the entity under test, e.g. for a web request...
    • store the HTML as one facet
    • store HTML-rendered-to-markdown as another facet
    • store cookies in another facet
    • assert some facets on disk, others inline
    • see gif above for live demo, detailed example here

Python and JVM ports are both production-ready, other platforms on the way: js, .NET, go, ...

Documentation

Contributing

PRs welcome! Horror stories and glory stories too, share your experience! See CONTRIBUTING.md.

Acknowledgements

Heavily inspired by origin-energy's java-snapshot-testing, which in turn is heavily inspired by Facebook's jest-snapshot.

About

Snapshot testing for Java, Kotlin, and the JVM

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Kotlin 51.9%
  • Python 25.1%
  • MDX 9.8%
  • TypeScript 7.1%
  • Java 3.4%
  • JavaScript 1.2%
  • Other 1.5%