hugs/angelo

Angelo is a tool that makes it easy to run the same test suite over and over again. If you're building an app and want to check your tests repeatedly, say, as you're developing or debugging, Angelo handles that without the usual headaches. Here's the problem it solves: Mocha, the popular testing framework, has trouble re-running tests in the same process because it caches files after loading them once. If you try to run your tests a second time, Mocha doesn't actually reload the files, so it can't run fresh tests. Angelo gets around this by spawning a new child process each time you run tests, which means each run is completely clean. You just load your test file path once, then call "play" as many times as you want. The API is intentionally simple. You create an Angelo object, point it at your test file, and hit play. That's it. No complex configuration needed. Behind the scenes, Angelo communicates with Mocha through a JSON stream, so results come back as they happen rather than all at once. This streaming approach means you get feedback in real time, which is especially nice if you're waiting for test results while actively coding. Who benefits from this? Developers who run tests programmatically (not just from the command line) and who need to re-run suites during development cycles. Another nice feature is that because tests run in isolated child processes, you can run multiple test files in parallel by creating multiple Angelo instances, which speeds things up compared to running them one after another. If you're building a development tool, continuous testing system, or anything that needs flexible, repeatable test execution, this library fills that gap.