bombadil README

The project's README from github.com/antithesishq/bombadil. As one markdown file: README.md.

Bombadil

Property-based testing for web and terminal UIs, autonomously exploring and validating correctness properties, finding harder bugs earlier.

Runs in your local developer environment, in CI, and inside Antithesis.

Documentation

Learn all about Bombadil with the following resources:

Join us

Join us on our quest to reinvent how the world thinks about software reliability. We are hiring.

Or, if you want to hack on it, see Contributing. We prefer GitHub issues and Discord discussions over drive-by pull requests. Make sure you read the Gen AI Policy before using LLMs in your contributions.


Tom Bombadil

Old Tom Bombadil is a merry fellow,
Bright blue his jacket is, and his boots are yellow.
Bugs have never fooled him yet, for Tom, he is the Master:
His specs are stronger specs, and his fuzzer is faster.

Built by Antithesis.

bombadil (antithesishq/bombadil)

Searching Database…

What is this?Bombadil is a property-based testing tool for web and terminal UIs. It autonomously explores the interface and checks correctness properties, aiming to catch harder bugs earlier.
Is it a library I import, or a tool I run?It's a tool you run against your app, not a library you import into your code. The README points to a manual for usage details.
How do I get it running?The README links to an Installation section and a manual but doesn't show the commands inline. It runs in your local dev environment, in CI, or inside Antithesis.
Can it test a terminal app as well as a website?Yes. The project describes testing both web UIs and terminal UIs.
How is this different from regular UI tests?Instead of only checking the specific cases someone scripted, it explores the UI on its own and validates correctness properties, which can surface bugs that hand-written tests miss.
Does it run locally or only inside Antithesis?Both. You can run it in your local developer environment and in CI, and it can also run inside Antithesis.
Is it free to use?Yes. The repository metadata lists it as MIT-licensed, so you can use, modify and redistribute it freely.
Where does the name come from?The tagline opens with a Tom Bombadil poem, a nod to Tolkien's character, with the line about his specs being stronger and his fuzzer being faster.
Size
7.2 MB
Stars
2.6K
Age
11mo
Commits · 90 Days