starter

Python Starter

This directory is a runnable Python provider example for Observer.

Read ../HOWTO.md first if you want the full model.

The key thing to notice in this starter is that Python is not being used as a wrapper shell around one coarse integration script.

Instead, Python is the authoring language for granular verification of the underlying ledger behavior. Observer sees separate targets for those behaviors, which is the preferred pattern.

It is intended to show the whole real process:

• write ordinary Python code under test
• author tests with describe(...), test(...), and expect(...) against real ledger behaviors
• expose them through a tiny Python provider host
• inspect the raw provider list output
• derive canonical inventory with observer derive-inventory
• run a suite against that inventory
• verify canonical hashes and JSONL output

Useful commands:

make list
make inventory
make host-run TARGET='ledger/rejects-overdraft'
make run
make report
make verify

Compare this directory with ../starter-failure/ once the passing flow is clear.