// Mgmt // Copyright (C) James Shubin and the project contributors // Written by James Shubin and the project contributors // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program. If not, see . // // Additional permission under GNU GPL version 3 section 7 // // If you modify this program, or any covered work, by linking or combining it // with embedded mcl code and modules (and that the embedded mcl code and // modules which link with this program, contain a copy of their source code in // the authoritative form) containing parts covered by the terms of any other // license, the licensors of this program grant you additional permission to // convey the resulting work. Furthermore, the licensors of this program grant // the original author, James Shubin, additional permission to update this // additional permission if he deems it necessary to achieve the goals of this // additional permission. package structs import ( "context" "fmt" "github.com/purpleidea/mgmt/lang/interfaces" "github.com/purpleidea/mgmt/lang/types" "github.com/purpleidea/mgmt/pgraph" "github.com/purpleidea/mgmt/util/errwrap" ) const ( // ExprIfFuncName is the unique name identifier for this function. ExprIfFuncName = "exprif" // ExprIfFuncArgNameCondition is the name for the edge which connects // the input condition to ExprIfFunc. ExprIfFuncArgNameCondition = "condition" ) // ExprIfFunc is a function that passes through the value of the correct branch // based on the conditional value it gets. type ExprIfFunc struct { interfaces.Textarea Type *types.Type // this is the type of the if expression output we hold EdgeName string // name of the edge used ThenGraph *pgraph.Graph ElseGraph *pgraph.Graph ThenFunc interfaces.Func ElseFunc interfaces.Func OutputVertex interfaces.Func init *interfaces.Init last *bool // last value received to use for diff } // String returns a simple name for this function. This is needed so this struct // can satisfy the pgraph.Vertex interface. func (obj *ExprIfFunc) String() string { return ExprIfFuncName } // Validate tells us if the input struct takes a valid form. func (obj *ExprIfFunc) Validate() error { if obj.Type == nil { return fmt.Errorf("must specify a type") } if obj.EdgeName == "" { return fmt.Errorf("must specify an edge name") } if obj.ThenFunc == nil { return fmt.Errorf("must specify a then func") } if obj.ElseFunc == nil { return fmt.Errorf("must specify an else func") } t1 := obj.ThenFunc.Info().Sig.Out t2 := obj.ElseFunc.Info().Sig.Out if err := t1.Cmp(t2); err != nil { return errwrap.Wrapf(err, "types of exprif branches must match") } if obj.OutputVertex == nil { return fmt.Errorf("the output vertex is missing") } return nil } // Info returns some static info about itself. func (obj *ExprIfFunc) Info() *interfaces.Info { var typ *types.Type if obj.Type != nil { // don't panic if called speculatively typ = &types.Type{ Kind: types.KindFunc, // function type Map: map[string]*types.Type{ ExprIfFuncArgNameCondition: types.TypeBool, // conditional must be a boolean }, Ord: []string{ExprIfFuncArgNameCondition}, // conditional Out: obj.Type, // result type must match } } return &interfaces.Info{ Pure: true, Memo: false, // TODO: ??? Sig: typ, Err: obj.Validate(), } } // Init runs some startup code for this if expression function. func (obj *ExprIfFunc) Init(init *interfaces.Init) error { obj.init = init return nil } func (obj *ExprIfFunc) replaceSubGraph(b bool) error { // delete the old subgraph if err := obj.init.Txn.Reverse(); err != nil { return errwrap.Wrapf(err, "could not Reverse") } var f interfaces.Func if b { obj.init.Txn.AddGraph(obj.ThenGraph) f = obj.ThenFunc } else { obj.init.Txn.AddGraph(obj.ElseGraph) f = obj.ElseFunc } // create the new subgraph edgeName := OutputFuncArgName edge := &interfaces.FuncEdge{Args: []string{edgeName}} obj.init.Txn.AddVertex(f) obj.init.Txn.AddEdge(f, obj.OutputVertex, edge) return obj.init.Txn.Commit() } // Call this func and return the value if it is possible to do so at this time. func (obj *ExprIfFunc) Call(ctx context.Context, args []types.Value) (types.Value, error) { if len(args) < 1 { return nil, fmt.Errorf("not enough args") } value := args[0] b := value.Bool() if obj.last == nil || *obj.last != b { obj.last = &b // store new result if err := obj.replaceSubGraph(b); err != nil { return nil, errwrap.Wrapf(err, "could not replace subgraph") } return nil, interfaces.ErrInterrupt } // send dummy value to the output return types.NewNil(), nil // dummy value } // Cleanup runs after that function was removed from the graph. func (obj *ExprIfFunc) Cleanup(ctx context.Context) error { return obj.init.Txn.Reverse() }