Expand description
Stage-1 control/introspection API for the server.
§Scope (5.0.0)
Per the brief (§4.3, §5.3, §7), the server crate exposes:
- A minimal handle the embedder can hold.
- A “state” enum the embedder can poll.
- A reload-hint type.
Critically, the server does not restart itself. When a config edit would need the listener rebuilt, the server-side code only emits a hint; an external control layer (GUI / supervisor) decides whether to restart. That’s the brief’s §7 rule and the shape here reflects it.
Implementation of actual shutdown / reload wiring is stage-2 work. In 5.0.0 these types exist with placeholder methods so downstream code can start coding against them.
Structs§
- Server
Control - Small control surface for the embedder.
- Server
Handle - Handle an embedder holds to interact with a running server.
Enums§
- Reload
Hint - How much of the server needs to restart after a config change.
- Server
State - What the server is doing right now.