git.giacomolli.uk - onehouse/blob - doc/driver.rst

   1 ##################
   2  Driver framework
   3 ##################
   4
   5 ``driver.Driver`` supplies ``Run`` and a nonblocking ``Refresh``
   6 request. The runner starts an explicit list, forwards broker reconnect
   7 notifications, and waits for cleanup. A driver returns errors without
   8 logging. The runner logs failures and cancels peers. Cancellation and
   9 closed transports are expected stops only after the worker context
  10 stops. A joined independent failure remains a failure.
  11
  12 ``cmd/onehouse`` supplies an empty driver list. It waits for SIGINT or
  13 SIGTERM and finishes cleanup before exit. No integration or broker runs.
  14
  15 Tests use fake drivers. They do not verify a broker or a physical
  16 device.