Skip to content

Module and Context

Documented releasev0.2.0/Stable main branch

ModuleType describes a kind of module. Module is an instance started from that type. Each instance has a unique registered name and centrally allocated MID; its OS PID is a different identity.

The inherited Context is the module’s entry to Bus, Param, Log and RPC. It is attached by the framework, not freely constructed by the user.

  • FrameworkLoop: the framework runs the default pump loop after startup.
  • Manual: the module supplies its main loop and owns how it calls pumpOnce or pumpLoop.

Callbacks run on the pump caller. The heartbeat runs independently; expensive callbacks still delay other callbacks on that pump. Shutdown and Context revocation remain part of the framework lifecycle.

See the pinned Module System contract before choosing a mode or adding threads.