The new version of the urfave/cli library is moving to generics, and it's completely unclear to me why this is an improvement. Their new API is very complicated to understand, which for me, defeats the purpose of golang. In parallel, I needed to do some upcoming cli API refactoring, so this was a good time to look into new libraries. After a review of the landscape, I found the alexflint/go-arg library which has a delightfully elegant API. It does have a few rough edges, but it's otherwise very usable, and I think it would be straightforward to add features and fix issues. Thanks Alex!
230 lines
5.3 KiB
Go
230 lines
5.3 KiB
Go
// libmgmt example
|
|
package main
|
|
|
|
import (
|
|
"fmt"
|
|
"log"
|
|
"os"
|
|
"os/signal"
|
|
"strconv"
|
|
"sync"
|
|
"syscall"
|
|
"time"
|
|
|
|
"github.com/purpleidea/mgmt/engine"
|
|
"github.com/purpleidea/mgmt/gapi"
|
|
mgmt "github.com/purpleidea/mgmt/lib"
|
|
"github.com/purpleidea/mgmt/pgraph"
|
|
)
|
|
|
|
// XXX: this has not been updated to latest GAPI/Deploy API. Patches welcome!
|
|
|
|
const (
|
|
// Name is the name of this frontend.
|
|
Name = "libmgmt"
|
|
)
|
|
|
|
// MyGAPI implements the main GAPI interface.
|
|
type MyGAPI struct {
|
|
Name string // graph name
|
|
Count uint // number of resources to create
|
|
Interval uint // refresh interval, 0 to never refresh
|
|
|
|
data *gapi.Data
|
|
initialized bool
|
|
closeChan chan struct{}
|
|
wg sync.WaitGroup // sync group for tunnel go routines
|
|
}
|
|
|
|
// NewMyGAPI creates a new MyGAPI struct and calls Init().
|
|
func NewMyGAPI(data *gapi.Data, name string, interval uint, count uint) (*MyGAPI, error) {
|
|
obj := &MyGAPI{
|
|
Name: name,
|
|
Count: count,
|
|
Interval: interval,
|
|
}
|
|
return obj, obj.Init(data)
|
|
}
|
|
|
|
// Cli takes an *Info struct, and returns our deploy if activated, and if there
|
|
// are any validation problems, you should return an error. If there is no
|
|
// deploy, then you should return a nil deploy and a nil error.
|
|
func (obj *MyGAPI) Cli(info *gapi.CliInfo) (*gapi.Deploy, error) {
|
|
//fs := info.Fs // copy files from local filesystem *into* this fs...
|
|
//debug := info.Debug
|
|
//logf := func(format string, v ...interface{}) {
|
|
// info.Logf(Name+": "+format, v...)
|
|
//}
|
|
|
|
return &gapi.Deploy{
|
|
Name: obj.Name,
|
|
Noop: info.Flags.Noop,
|
|
Sema: info.Flags.Sema,
|
|
GAPI: &MyGAPI{},
|
|
}, nil
|
|
}
|
|
|
|
// Init initializes the MyGAPI struct.
|
|
func (obj *MyGAPI) Init(data *gapi.Data) error {
|
|
if obj.initialized {
|
|
return fmt.Errorf("already initialized")
|
|
}
|
|
if obj.Name == "" {
|
|
return fmt.Errorf("the graph name must be specified")
|
|
}
|
|
obj.data = data // store for later
|
|
obj.closeChan = make(chan struct{})
|
|
obj.initialized = true
|
|
return nil
|
|
}
|
|
|
|
// Graph returns a current Graph.
|
|
func (obj *MyGAPI) Graph() (*pgraph.Graph, error) {
|
|
if !obj.initialized {
|
|
return nil, fmt.Errorf("%s: MyGAPI is not initialized", Name)
|
|
}
|
|
|
|
g, err := pgraph.NewGraph(obj.Name)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
var vertex pgraph.Vertex
|
|
for i := uint(0); i < obj.Count; i++ {
|
|
n, err := engine.NewNamedResource("noop", fmt.Sprintf("noop%d", i))
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
g.AddVertex(n)
|
|
if i > 0 {
|
|
g.AddEdge(vertex, n, &engine.Edge{Name: fmt.Sprintf("e%d", i)})
|
|
}
|
|
vertex = n // save
|
|
}
|
|
|
|
//g, err := config.NewGraphFromConfig(obj.data.Hostname, obj.data.World, obj.data.Noop)
|
|
return g, nil
|
|
}
|
|
|
|
// Next returns nil errors every time there could be a new graph.
|
|
func (obj *MyGAPI) Next() chan gapi.Next {
|
|
ch := make(chan gapi.Next)
|
|
obj.wg.Add(1)
|
|
go func() {
|
|
defer obj.wg.Done()
|
|
defer close(ch) // this will run before the obj.wg.Done()
|
|
if !obj.initialized {
|
|
next := gapi.Next{
|
|
Err: fmt.Errorf("%s: MyGAPI is not initialized", Name),
|
|
Exit: true, // exit, b/c programming error?
|
|
}
|
|
ch <- next
|
|
}
|
|
startChan := make(chan struct{}) // start signal
|
|
close(startChan) // kick it off!
|
|
|
|
ticker := make(<-chan time.Time)
|
|
if obj.data.NoStreamWatch || obj.Interval <= 0 {
|
|
ticker = nil
|
|
} else {
|
|
// arbitrarily change graph every interval seconds
|
|
t := time.NewTicker(time.Duration(obj.Interval) * time.Second)
|
|
defer t.Stop()
|
|
ticker = t.C
|
|
}
|
|
for {
|
|
select {
|
|
case <-startChan: // kick the loop once at start
|
|
startChan = nil // disable
|
|
// pass
|
|
case <-ticker:
|
|
// pass
|
|
case <-obj.closeChan:
|
|
return
|
|
}
|
|
|
|
log.Printf("%s: Generating new graph...", Name)
|
|
select {
|
|
case ch <- gapi.Next{}: // trigger a run
|
|
case <-obj.closeChan:
|
|
return
|
|
}
|
|
}
|
|
}()
|
|
return ch
|
|
}
|
|
|
|
// Close shuts down the MyGAPI.
|
|
func (obj *MyGAPI) Close() error {
|
|
if !obj.initialized {
|
|
return fmt.Errorf("%s: MyGAPI is not initialized", Name)
|
|
}
|
|
close(obj.closeChan)
|
|
obj.wg.Wait()
|
|
obj.initialized = false // closed = true
|
|
return nil
|
|
}
|
|
|
|
// Run runs an embedded mgmt server.
|
|
func Run(count uint) error {
|
|
|
|
obj := &mgmt.Main{}
|
|
obj.Program = "libmgmt" // TODO: set on compilation
|
|
obj.Version = "0.0.1" // TODO: set on compilation
|
|
obj.TmpPrefix = true
|
|
obj.IdealClusterSize = -1
|
|
obj.ConvergedTimeout = -1
|
|
obj.Noop = true
|
|
|
|
//obj.GAPI = &MyGAPI{ // graph API
|
|
// Name: "libmgmt", // TODO: set on compilation
|
|
// Count: count, // number of vertices to add
|
|
// Interval: 15, // arbitrarily change graph every 15 seconds
|
|
//}
|
|
|
|
if err := obj.Init(); err != nil {
|
|
return err
|
|
}
|
|
|
|
// install the exit signal handler
|
|
exit := make(chan struct{})
|
|
defer close(exit)
|
|
go func() {
|
|
signals := make(chan os.Signal, 1)
|
|
signal.Notify(signals, os.Interrupt) // catch ^C
|
|
//signal.Notify(signals, os.Kill) // catch signals
|
|
signal.Notify(signals, syscall.SIGTERM)
|
|
|
|
select {
|
|
case sig := <-signals: // any signal will do
|
|
if sig == os.Interrupt {
|
|
log.Println("Interrupted by ^C")
|
|
obj.Exit(nil)
|
|
return
|
|
}
|
|
log.Println("Interrupted by signal")
|
|
obj.Exit(fmt.Errorf("killed by %v", sig))
|
|
return
|
|
case <-exit:
|
|
return
|
|
}
|
|
}()
|
|
|
|
return obj.Run()
|
|
}
|
|
|
|
func main() {
|
|
log.Printf("Hello!")
|
|
var count uint = 1 // default
|
|
if len(os.Args) == 2 {
|
|
if i, err := strconv.Atoi(os.Args[1]); err == nil && i > 0 {
|
|
count = uint(i)
|
|
}
|
|
}
|
|
if err := Run(count); err != nil {
|
|
fmt.Println(err)
|
|
os.Exit(1)
|
|
return
|
|
}
|
|
log.Printf("Goodbye!")
|
|
}
|