control

package

v0.1.6 Latest Latest Go to latest Published: Oct 26, 2026 License: MIT Imports: 15 Imported by: 0

Details

Package control coordinates graceful shutdown between servef processes.

This section is empty.

This section is empty.

func DefaultDirectory() (string, error)

DefaultDirectory returns the per-user directory for control records.

type Instance struct {
	// contains filtered or unexported fields
}

Instance is a registered servef process.

func (i *Instance) Close() error

Close removes this instance's control record.

func (i *Instance) Handler(next http.Handler) http.Handler

Handler wraps next with authenticated status and shutdown handling.

func (i *Instance) StopRequested() <-chan struct{}

StopRequested reports authenticated shutdown requests.

type Registry struct {
	// contains filtered or unexported fields
}

Registry stores private control records for running servef processes.

func NewRegistry(directory string) Registry

NewRegistry constructs a registry rooted at directory.

func (r Registry) Lookup(host string, port int) (Remote, error)

Lookup returns the registered process for host and port.

func (r Registry) Register(host string, port int) (*Instance, error)

Register creates a private control record for a running server.

type Remote struct {
	// contains filtered or unexported fields
}

Remote is a registered servef process controlled over HTTP.

func (r Remote) Running(ctx context.Context) bool

Running reports whether the registered process responds as servef.

func (r Remote) Stop(ctx context.Context) error

Stop asks the registered process to shut down gracefully.