README
¶
SYNOPSIS
supervises [options] "command ..." "..."
DESCRIPTION
Minimal command line supervisor.
BUILDING
go install codeberg.org/msantos/supervises/cmd/supervises@latest
Source
cd cmd/supervises
CGO_ENABLED=0 go build -trimpath -ldflags "-s -w"
EXAMPLES
supervises 'nc -vnl 7070' 'nc -vnl 7071' 'nc -vnl 7072'
SIGILS
-
@: run in shell
supervises @'nc -l 8080 >nc.log' -
=: discard stdout/stderr
# equivalent to: supervises @'nc -l 8080 >/dev/null 2>&1' supervises ='nc -l 8080' -
=1: discard stdout
# equivalent to: supervises @'nc -l 8080 >/dev/null' supervises =1'nc -l 8080' -
=2: discard stderr
# equivalent to: supervises @'nc -l 8080 2>/dev/null' supervises =2'nc -l 8080'
OPTIONS
help : Display usage
signal int : signal sent to subprocesses on exit (default 9)
verbose : Enable debug messages
errexit : retries apply to tasks exiting with a non-0 status
retry-count int : retry limit before exiting (0: no limit)
retry-period duration : time interval for retries (0: no limit)
retry-wait duration : retry backoff interval (default 1s)
Documentation
¶
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
Functions ¶
This section is empty.
Types ¶
type Cmd ¶
type Opt ¶
type Opt struct {
// contains filtered or unexported fields
}
func (*Opt) Supervise ¶
Example ¶
package main
import (
"context"
"errors"
"fmt"
"os"
"time"
"codeberg.org/msantos/supervises"
)
func main() {
ctx, cancel := context.WithTimeout(context.Background(), 1*time.Second)
defer cancel()
s := supervises.New(ctx)
cmds, err := s.Cmd("@echo test123; exec sleep 10", "cat")
if err != nil {
fmt.Fprintln(os.Stderr, err)
return
}
err = s.Supervise(cmds...)
var ee *supervises.ExitError
if !errors.As(err, &ee) {
fmt.Fprintln(os.Stderr, err.Error())
return
}
}
Output: test123
type Option ¶
type Option func(*Opt)
func WithCancelFunc ¶
WithCancelFunc sets the function to reap cancelled subprocesses.
func WithCancelSignal ¶
WithCancelSignal sets the signal sent to subprocesses on exit.
func WithNotifySignals ¶
WithNotifySignals sets trapped signals by the supervisor.
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.