Expand description
Private, disposable broker and daemon processes for module integration tests.
CK_SUBC_BIN and CK_BUS_BIN must name test builds, never installed binaries.
Every executable is staged through cortexkit_test_support::ckdev_binary.
See the crate README for a complete setup and the missing-binary skip policy.
Modules§
- signer
- Throwaway signing roots served as
claustrumfor private-bus tests. - trust
- Throwaway operator, system-account and account signing keys.
Structs§
- BusOptions
- BusServer
- Daemon
Options - Module
- A module the private subc daemon spawns and supervises, like a production module entry in subc.jsonc. Environment entries augment the daemon’s inherited environment; do not override its isolated XDG homes.
- Preloaded
Account - An additional account for tests that exercise user JWTs without ck-bus bootstrap.
- Private
Daemon - A binary daemon and a throwaway, in-client-process claustrum signer. The broker must outlive this value. No operator vault or installed daemon is used.
Enums§
- RigError
- A missing prerequisite is skippable; a broken rig is not.
Constants§
Functions§
- ck_
bus_ binary - ck_
subc_ binary - nats_
server_ bin - Returns a staged executable and its reported version. An old or unrecognizable server is a configuration error, not a missing prerequisite.
- new_
machine_ id - skip_
or_ fail - Call in an error arm, then return from the test. CI can require prerequisites
with
CK_BUS_TESTKIT_REQUIRE=1; all non-prerequisite errors always panic. - subc_
config - Build JSON (also valid JSONC) with a reserved ckbus and caller-supplied modules. All program paths are staged copies, even when a module is initially disabled.
- write_
machine_ id - Write the identity in the data home the binary daemon uses, not the caller’s.