lang: Initial implementation of the mgmt language

This is an initial implementation of the mgmt language. It is a
declarative (immutable) functional, reactive, domain specific
programming language. It is intended to be a language that is:

* safe
* powerful
* easy to reason about

With these properties, we hope this language, and the mgmt engine will
allow you to model the real-time systems that you'd like to automate.

This also includes a number of other associated changes. Sorry for the
large size of this patch.

examples/lib/libmgmt-subgraph0.go

@@ -16,8 +16,20 @@ import (
 	"github.com/purpleidea/mgmt/resources"
 
 	errwrap "github.com/pkg/errors"
+	"github.com/urfave/cli"
 )
 
+// XXX: this has not been updated to latest GAPI/Deploy API. Patches welcome!
+
+const (
+	// Name is the name of this frontend.
+	Name = "libmgmt"
+)
+
+func init() {
+	gapi.Register(Name, func() gapi.GAPI { return &MyGAPI{} }) // register
+}
+
 // MyGAPI implements the main GAPI interface.
 type MyGAPI struct {
 	Name     string // graph name
@@ -38,6 +50,39 @@ func NewMyGAPI(data gapi.Data, name string, interval uint) (*MyGAPI, error) {
 	return obj, obj.Init(data)
 }
 
+// Cli takes a cli.Context, and returns our GAPI if activated. All arguments
+// should take the prefix of the registered name. On activation, if there are
+// any validation problems, you should return an error. If this was not
+// activated, then you should return a nil GAPI and a nil error.
+func (obj *MyGAPI) Cli(c *cli.Context, fs resources.Fs) (*gapi.Deploy, error) {
+	if s := c.String(obj.Name); c.IsSet(obj.Name) {
+		if s != "" {
+			return nil, fmt.Errorf("input is not empty")
+		}
+
+		return &gapi.Deploy{
+			Name: obj.Name,
+			Noop: c.GlobalBool("noop"),
+			Sema: c.GlobalInt("sema"),
+			GAPI: &MyGAPI{
+			// TODO: add properties here...
+			},
+		}, nil
+	}
+	return nil, nil // we weren't activated!
+}
+
+// CliFlags returns a list of flags used by this deploy subcommand.
+func (obj *MyGAPI) CliFlags() []cli.Flag {
+	return []cli.Flag{
+		cli.StringFlag{
+			Name:  obj.Name,
+			Value: "",
+			Usage: "run",
+		},
+	}
+}
+
 // Init initializes the MyGAPI struct.
 func (obj *MyGAPI) Init(data gapi.Data) error {
 	if obj.initialized {
@@ -87,7 +132,7 @@ func (obj *MyGAPI) subGraph() (*pgraph.Graph, error) {
 // Graph returns a current Graph.
 func (obj *MyGAPI) Graph() (*pgraph.Graph, error) {
 	if !obj.initialized {
-		return nil, fmt.Errorf("libmgmt: MyGAPI is not initialized")
+		return nil, fmt.Errorf("%s: MyGAPI is not initialized", Name)
 	}
 
 	g, err := pgraph.NewGraph(obj.Name)
@@ -142,7 +187,7 @@ func (obj *MyGAPI) Next() chan gapi.Next {
 		defer close(ch) // this will run before the obj.wg.Done()
 		if !obj.initialized {
 			next := gapi.Next{
-				Err:  fmt.Errorf("libmgmt: MyGAPI is not initialized"),
+				Err:  fmt.Errorf("%s: MyGAPI is not initialized", Name),
 				Exit: true, // exit, b/c programming error?
 			}
 			ch <- next
@@ -171,7 +216,7 @@ func (obj *MyGAPI) Next() chan gapi.Next {
 				return
 			}
 
-			log.Printf("libmgmt: Generating new graph...")
+			log.Printf("%s: Generating new graph...", Name)
 			select {
 			case ch <- gapi.Next{}: // trigger a run
 			case <-obj.closeChan:
@@ -185,7 +230,7 @@ func (obj *MyGAPI) Next() chan gapi.Next {
 // Close shuts down the MyGAPI.
 func (obj *MyGAPI) Close() error {
 	if !obj.initialized {
-		return fmt.Errorf("libmgmt: MyGAPI is not initialized")
+		return fmt.Errorf("%s: MyGAPI is not initialized", Name)
 	}
 	close(obj.closeChan)
 	obj.wg.Wait()
@@ -197,19 +242,19 @@ func (obj *MyGAPI) Close() error {
 func Run() error {
 
 	obj := &mgmt.Main{}
-	obj.Program = "libmgmt" // TODO: set on compilation
-	obj.Version = "0.0.1"   // TODO: set on compilation
-	obj.TmpPrefix = true    // disable for easy debugging
+	obj.Program = Name    // TODO: set on compilation
+	obj.Version = "0.0.1" // TODO: set on compilation
+	obj.TmpPrefix = true  // disable for easy debugging
 	//prefix := "/tmp/testprefix/"
 	//obj.Prefix = &p // enable for easy debugging
 	obj.IdealClusterSize = -1
 	obj.ConvergedTimeout = -1
 	obj.Noop = false // FIXME: careful!
 
-	obj.GAPI = &MyGAPI{ // graph API
-		Name:     "libmgmt", // TODO: set on compilation
-		Interval: 60 * 10,   // arbitrarily change graph every 15 seconds
-	}
+	//obj.GAPI = &MyGAPI{ // graph API
+	//	Name:     Name, // TODO: set on compilation
+	//	Interval: 60 * 10,   // arbitrarily change graph every 15 seconds
+	//}
 
 	if err := obj.Init(); err != nil {
 		return err