Initial import

.gitignore

@@ -0,0 +1,6 @@
+*~
+*.swp
+*.swo
+*.tmp
+*.out
+.DS_Store

LICENSE

@@ -0,0 +1,29 @@
+The Isomorphic Go Project
+Copyright (c) Wirecog, LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+   * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+   * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+   * Neither the name of Wirecog, LLC. nor the names of its contributors
+may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

Readme.md

@@ -0,0 +1,57 @@
+<p align="center"><a href="http://isomorphicgo.org" target="_blank"><img src="https://github.com/isomorphicgo/isogoapp/blob/master/static/images/isomorphic_go_logo.png"></a></p>
+
+# Kick
+
+A lightweight mechanism to provide an *instant kickstart* to a Go web server instance, upon the modification of a Go source file within a particular project directory (including any subdirectories).
+
+An *instant kickstart* consists of a recompilation of the Go code and a restart of the web server instance.
+
+Kick comes with the ability to take both the `go` and `gopherjs` commands into consideration when performing the *instant kickstart*.
+
+## Installation
+
+Before installing Kick, it is recommended, to install the barebones [isogoapp](https://github.com/isomorphicgo/isogoapp) first – since it will provide you an example of how to use kick.
+
+### Get Kick
+`go get -u github.com/isomorphicgo/kick`
+
+## Usage
+
+### Getting Help
+
+Issue the `help` flag to get help on using the kick command:
+
+`kick --help`
+
+### Running Kick
+
+Example (using GopherJS):
+
+`kick --appPath=$ISOGO_APP_ROOT --mainSourceFile=isogoapp.go --gopherjsAppPath=$ISOGO_APP_ROOT/client`
+
+The `appPath` flag specifies the project directory where the Go application resides.
+
+The `mainSourceFile` flag specifies the Go source file that implements the main function.
+
+The `gopherjsAppPath` flag specifies the directory to the GopherJS client-side application. This flag is optional.
+
+If your Go project is not using GopherJS, you can feel free to omit the `gopherjsAppPath` flag.
+
+### Verify That Kick Is Functioning
+
+Assuming that you've installed the [isogoapp](https://github.com/isomorphicgo/isogo), and you have issued the kick command to run the web server instance:
+
+Access the [test page](http://localhost:8080) for the `isogoapp` using your web browser.
+
+Open up the `client.go` source file in the `$ISOGO_APP_ROOT/client` directory. Change the message that is passed to the `SetInnerHTML()` function call.
+
+Refresh your web browser. You should see your change reflected.
+
+In the command line prompt where you issued the kick command, take note of the "Recompiling and Restarting" message. This is kick's way of telling you that an *instant kickstart* was performed.
+
+
+## The Isomorphic Go Project
+More information on the benefits of Isomorphic Go applications can be found at the [Isomorphic Go Website](http://isomorphicgo.org).
+
+## License
+Kick is licensed under the BSD License. Read the [LICENSE](https://github.com/isomorphicgo/kick/blob/master/LICENSE) file for more information.

kick.go

@@ -0,0 +1,178 @@
+package main
+
+import (
+	"flag"
+	"fmt"
+	"log"
+	"os"
+	"os/exec"
+	"os/signal"
+	"path/filepath"
+	"syscall"
+
+	"github.com/fsnotify/fsnotify"
+)
+
+var appPath string
+var mainSourceFile string
+var gopherjsAppPath string
+
+func start() *exec.Cmd {
+
+	if gopherjsAppPath != "" {
+
+		cwd, err := os.Getwd()
+		if err != nil {
+			log.Fatal("Encountered an error while attempting to get the cwd: ", err)
+		} else {
+			os.Chdir(gopherjsAppPath)
+			gjsCommand := exec.Command("gopherjs", "build")
+			gjsCommand.Start()
+			os.Chdir(cwd)
+		}
+	}
+
+	cmd := exec.Command("go", "run", appPath+"/"+mainSourceFile)
+	cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true}
+	cmd.Start()
+	return cmd
+
+}
+
+func stop(cmd *exec.Cmd) {
+	pgid, err := syscall.Getpgid(cmd.Process.Pid)
+	if err == nil {
+		syscall.Kill(-pgid, 15)
+	}
+}
+
+func restart(cmd *exec.Cmd) *exec.Cmd {
+	var newCommand *exec.Cmd
+	stop(cmd)
+	newCommand = start()
+	return newCommand
+
+}
+
+func initializeWatcher(shouldRestart chan bool, dirList []string) {
+
+	watcher, err := fsnotify.NewWatcher()
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer watcher.Close()
+
+	done := make(chan bool)
+	go func() {
+		for {
+			select {
+			case event := <-watcher.Events:
+
+				if event.Op == fsnotify.Write || event.Op == fsnotify.Rename {
+					if filepath.Ext(event.Name) == ".go" {
+						shouldRestart <- true
+					}
+				}
+
+			case err := <-watcher.Errors:
+				if err != nil {
+					log.Println("error:", err)
+				}
+			}
+		}
+	}()
+
+	err = watcher.Add(appPath)
+	if err != nil {
+		log.Fatal(err)
+	}
+	// watch subdirectories also
+	for _, element := range dirList {
+		watcher.Add(element)
+	}
+
+	<-done
+
+}
+
+func pathExists(path string) (bool, error) {
+	_, err := os.Stat(path)
+	if err == nil {
+		return true, nil
+	}
+	if os.IsNotExist(err) {
+		return false, nil
+	}
+	return true, err
+}
+
+func main() {
+
+	flag.StringVar(&appPath, "appPath", "", "The path to your Go project")
+	flag.StringVar(&mainSourceFile, "mainSourceFile", "", "The Go source file with the main func()")
+	flag.StringVar(&gopherjsAppPath, "gopherjsAppPath", "", "The path to your GopherJS project (optional)")
+	flag.Parse()
+
+	// Exit if no appPath is supplied
+	if appPath == "" {
+		fmt.Println("You must supply the appPath parameter")
+		os.Exit(1)
+	}
+
+	if appPathExists, appPathErr := pathExists(appPath); appPathExists != true || appPathErr != nil {
+		fmt.Println("The path you specified to your Go application project does not exist.")
+		os.Exit(1)
+	}
+
+	if mainSourceFile == "" {
+		fmt.Println("You must supply the mainSourceFile parameter")
+		os.Exit(1)
+	}
+
+	if sourceFileExists, sourceFilePathErr := pathExists(appPath + "/" + mainSourceFile); sourceFileExists != true || sourceFilePathErr != nil {
+		fmt.Println("The path to the main source file you provided does not exist.")
+		os.Exit(1)
+	}
+
+	if gopherjsAppPath != "" {
+		if gopherjsFileExists, gopherjsFileErr := pathExists(gopherjsAppPath); gopherjsFileExists != true || gopherjsFileErr != nil {
+			fmt.Println("The path you specified to the GopherJS application project does not exist.")
+			os.Exit(1)
+		}
+	}
+
+	dirList := []string{}
+	filepath.Walk(appPath, func(path string, f os.FileInfo, err error) error {
+
+		if f.IsDir() == true {
+			dirList = append(dirList, path)
+		}
+		return nil
+	})
+
+	shouldRestart := make(chan bool, 1)
+
+	go initializeWatcher(shouldRestart, dirList)
+
+	interrupt := make(chan os.Signal, 1)
+	signal.Notify(interrupt, os.Interrupt)
+
+	cmd := start()
+
+	for {
+
+		select {
+
+		case <-interrupt:
+			stop(cmd)
+			os.Exit(0)
+
+		case <-shouldRestart:
+			fmt.Println("Recompiling and Restarting")
+			cmd = restart(cmd)
+
+		}
+
+	}
+
+}