~/testml examples
Every example here is a working .tml file. Copy it. Save it next to your code. Run it in Python, JavaScript, Ruby, Perl or Java. The same lines pass on every stack.
/examples/recipes
Each card is a real .tml file. Each one runs the same on every supported stack. No mocks. No glue code. Just YAML and clear pass results.
# HTTP login flow — runs in 5 languages test: "Login returns a session token" when: POST: "/api/login" body: { email: "dev@testml.org" } then: status: 200 json.session: "/^sess_[a-z0-9]{16}$/"
Hits a real endpoint. Checks the status code. Matches the session ID against a regex. Works in every supported runtime.
# Database fixture round-trip fixture: "orders/seed.sql" test: "Active orders are billed" when: sql: "SELECT count(*) FROM orders WHERE paid" then: rows[0].count: 42 duration_ms: < 50
Loads a seed file. Runs raw SQL. Checks both the row count and the query time. Catches slow queries before they ship.
# CLI golden snapshot test: "build --json prints a stable tree" when: shell: "./bin/build --json" then: exit: 0 stdout.json: "@snapshot:./golden/build.json"
Runs a binary. Parses stdout as JSON. Diffs the tree against a saved golden file. Update with one flag when output is meant to change.
# Async event payload shape test: "checkout emits order.paid" when: call: "app.checkout(cart_id=1)" then: events: - type: "order.paid" payload.amount: 1999 payload.cart_id: 1
Calls an action. Catches the emitted events. Pins the type and payload shape so silent regressions never reach prod.
/one-file-many-runtimes
Each .tml file is the source of truth. No language port. No mirror suite. Run the same lines from any host. Drop the duplication and the drift.
$ python -m testml tests/api/login.tml ✓ Login returns a session token (84ms) $ node testml.js tests/api/login.tml ✓ Login returns a session token (78ms) $ ruby testml.rb tests/api/login.tml ✓ Login returns a session token (102ms) $ perl testml.pl tests/api/login.tml ✓ Login returns a session token (95ms) $ java -jar testml.jar tests/api/login.tml ✓ Login returns a session token (112ms) 5/5 runtimes pass · same file · no edits
/install/by-runtime
Install once for the runtime you live in. No new SDK. No paid tier. The command below is all you need to start.
pip install testml
npm i testml
gem install testml
cpan TestML
mvn add testml
/process/4-steps
No setup ceremony. No vendor onboarding. Each step takes minutes, not days. Most teams have their first green test the same hour.
Open the .tml file. Read the test block. The shape is plain YAML. Nothing else to learn.
Save it next to your code. Use any folder name. TestML walks the tree and finds it.
Call testml from Python, Node, Ruby, Perl or Java. The same file passes in all of them.
Each runtime exits with a clean code. Pipe the report to JUnit XML. CI dashboards just work.
Pick any .tml above. Drop it into your repo. Run it in your stack. The same lines pass on every runtime — no port, no mock, no drift.