This project was mostly used by me for my private projects. But i think it reached a state of maturity where i can share it. Here are some interesting facts about the project:

  • Mostly based on power-asserts. No assert_equals, assert_operator. Just the assert-macro.
  • Stacktraces are beautified
  • Avoid nested contexts. Prefer flat specs. Split them up if possible.
  • A very interesting thing you might want to have a look at for your own projects: The README.md is generate from a README.md.template. Images for console output are generate by running "aha" and "wkhtmltoimage" by running those in a docker container. Both the examples and their output are tested and generated by the "build.cr"

Of course this project has its flaws and it is far from being finished. E.g. there are some assert statements that cause exceptions when they fail. Also it is a bit difficult to get the exact line number of the assertion failures since everything is based on macros. Working on that. Thankful for feedback!