runzmd VS Gauge

I put together a library in Golang, called runzmd which lets you use Markdown in a literate programming style. Blockquotes and comments can specify associated actions, calling back into your Go code. This lets you create tutorials and scripts which can be viewed in a browser or run on the command line. We use this in the OpenZiti project for our tutorials and demos. I thought others might be interested in using the code or even just the concept.

The only place I've used it so far is for Ziti stuff. I did add a (really tiny) example to the project itself to show how to structure it: https://github.com/openziti/runzmd/tree/main/example

That was one reason I left the ziti actions in the project, as I thought they'd be useful as real life examples for someone writing their own actions.

Selenium is cool but https://gauge.org/ really cuts down on the boilerplate and is a lot more lightweight, may want to give it a look too

This actually reminds me a lot of Gauge from Thoughtworks: https://github.com/getgauge/gauge

It's typically paired with Taiko for test automation, but generally speaking it's a markdown to logical instruction engine.

I dig it, but also worth taking a look at what the Thoughtworks team has done especially around the VS Code tooling and language server work that they did to bring intellisense into their Markdown templates.

Since the project also uses Postgres, Redis, and AMQP, we also write integration tests. A docker compose file is there to stack up the test suite, and before each test, the tables, the keys, and the queues are reset. We don't try to aim to test for all the cases but usually all the controllers are covered. I personally would prefer to write more test cases between multiple micro services (e2e?) using something like Gauge but these integration tests are kind of enough.

Gauge looks interesting, but reminds me heavily of BDD frameworks - it looks like it's an abstraction layer where instead of writing Gherkin/GWT, the tests are in their specific DSL that's Markdown based?

Gauge is a Behavior Driven Java testing framework launched by ThoughtWorks.Inc. This is also one of the best Java Testing Frameworks, which allows software engineers to develop automated frameworks and speed up the software development procedure.