Add Time Trigger API and client (#153) (#161)

This change adds a timer trigger API, client, and implementation.  Users can trigger a function with a cron-compatible string. 

This change also moves the publisher interface and webhook-based publisher implementation out of kubewatcher and into a separate `publisher` package.

fission/main.go

@@ -72,6 +72,19 @@ func main() {
 		{Name: "list", Usage: "List HTTP triggers", Flags: []cli.Flag{}, Action: htList},
 	}
 
+	// timetriggers
+	ttNameFlag := cli.StringFlag{Name: "name", Usage: "Time Trigger name"}
+	ttCronFlag := cli.StringFlag{Name: "cron", Usage: "Time Trigger cron spec ('0 30 * * *', '@every 5m', '@hourly')"}
+	ttFnNameFlag := cli.StringFlag{Name: "function", Usage: "Function name"}
+	ttFnUidFlag := cli.StringFlag{Name: "uid", Usage: "Function UID (optional; uses latest if unspecified)"}
+	ttSubcommands := []cli.Command{
+		{Name: "create", Aliases: []string{"add"}, Usage: "Create Time trigger", Flags: []cli.Flag{ttNameFlag, ttFnNameFlag, ttFnUidFlag, ttCronFlag}, Action: ttCreate},
+		{Name: "get", Usage: "Get Time trigger", Flags: []cli.Flag{}, Action: ttGet},
+		{Name: "update", Usage: "Update Time trigger", Flags: []cli.Flag{ttNameFlag, ttCronFlag}, Action: ttUpdate},
+		{Name: "delete", Usage: "Delete Time trigger", Flags: []cli.Flag{ttNameFlag}, Action: ttDelete},
+		{Name: "list", Usage: "List Time triggers", Flags: []cli.Flag{}, Action: ttList},
+	}
+
 	// environments
 	envNameFlag := cli.StringFlag{Name: "name", Usage: "Environment name"}
 	envImageFlag := cli.StringFlag{Name: "image", Usage: "Environment image URL"}
@@ -101,6 +114,7 @@ func main() {
 	app.Commands = []cli.Command{
 		{Name: "function", Aliases: []string{"fn"}, Usage: "Create, update and manage functions", Subcommands: fnSubcommands},
 		{Name: "httptrigger", Aliases: []string{"ht", "route"}, Usage: "Manage HTTP triggers (routes) for functions", Subcommands: htSubcommands},
+		{Name: "timetrigger", Aliases: []string{"tt", "timer"}, Usage: "Manage Time triggers (timers) for functions", Subcommands: ttSubcommands},
 		{Name: "environment", Aliases: []string{"env"}, Usage: "Manage environments", Subcommands: envSubcommands},
 		{Name: "watch", Aliases: []string{"w"}, Usage: "Manage watches", Subcommands: wSubCommands},
 

fission/timetrigger.go

@@ -0,0 +1,122 @@
+/*
+Copyrigtt 2017 The Fission Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    tttp://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package main
+
+import (
+	"fmt"
+	"os"
+	"text/tabwriter"
+
+	"github.com/satori/go.uuid"
+	"github.com/urfave/cli"
+
+	"github.com/fission/fission"
+)
+
+func ttCreate(c *cli.Context) error {
+	client := getClient(c.GlobalString("server"))
+
+	name := c.String("name")
+	if len(name) == 0 {
+		name = uuid.NewV4().String()
+	}
+	fnName := c.String("function")
+	if len(fnName) == 0 {
+		fatal("Need a function name to create a trigger, use --function")
+	}
+	fnUid := c.String("uid")
+	cron := c.String("cron")
+	if len(cron) == 0 {
+		fatal("Need a cron spec like '0 30 * * *', '@every 1h30m', '@hourly', use --cron")
+	}
+
+	tt := &fission.TimeTrigger{
+		Metadata: fission.Metadata{
+			Name: name,
+		},
+		Cron: cron,
+		Function: fission.Metadata{
+			Name: fnName,
+			Uid:  fnUid,
+		},
+	}
+
+	_, err := client.TimeTriggerCreate(tt)
+	checkErr(err, "create Time trigger")
+
+	fmt.Printf("trigger '%v' created\n", name)
+	return err
+}
+
+func ttGet(c *cli.Context) error {
+	return nil
+}
+
+func ttUpdate(c *cli.Context) error {
+	client := getClient(c.GlobalString("server"))
+	ttName := c.String("name")
+	if len(ttName) == 0 {
+		fatal("Need name of trigger, use --name")
+	}
+
+	tt, err := client.TimeTriggerGet(&fission.Metadata{Name: ttName})
+	checkErr(err, "get Time trigger")
+
+	newCron := c.String("cron")
+	if len(newCron) != 0 {
+		tt.Cron = newCron
+	}
+
+	_, err = client.TimeTriggerUpdate(tt)
+	checkErr(err, "update Time trigger")
+
+	fmt.Printf("trigger '%v' updated\n", ttName)
+	return nil
+}
+
+func ttDelete(c *cli.Context) error {
+	client := getClient(c.GlobalString("server"))
+	ttName := c.String("name")
+	if len(ttName) == 0 {
+		fatal("Need name of trigger to delete, use --name")
+	}
+
+	err := client.TimeTriggerDelete(&fission.Metadata{Name: ttName})
+	checkErr(err, "delete trigger")
+
+	fmt.Printf("trigger '%v' deleted\n", ttName)
+	return nil
+}
+
+func ttList(c *cli.Context) error {
+	client := getClient(c.GlobalString("server"))
+
+	tts, err := client.TimeTriggerList()
+	checkErr(err, "list Time triggers")
+
+	w := tabwriter.NewWriter(os.Stdout, 0, 0, 1, ' ', 0)
+
+	fmt.Fprintf(w, "%v\t%v\t%v\t%v\n",
+		"NAME", "CRON", "FUNCTION_NAME", "FUNCTION_UID")
+	for _, tt := range tts {
+		fmt.Fprintf(w, "%v\t%v\t%v\t%v\n",
+			tt.Metadata.Name, tt.Cron, tt.Function.Name, tt.Function.Uid)
+	}
+	w.Flush()
+
+	return nil
+}