Skip to content

HaikuTeam/PollCompileDaemon

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Compile Daemon for Go with Polling

Watches your .go files in a directory and invokes go build if a file changed. Nothing more.

This project a fork from CompileDaemon that changes the underlying file watcher to use polling instead of file system events.

Usage:

$ ./PollCompileDaemon -directory=yourproject/

Installation

You can use the go tool to install PollCompileDaemon:

go get github.com/HaikuTeam/PollCompileDaemon

Command Line Options

Option Default Description
actions
-build=… go build Specify the command to run when rebuilding is required.
-command=… none Specify the command to run after a succesful build. The default is to run nothing. This command is issued with the working directory set to -directory.
file selection
-directory=… . Which directory to watch.
-recursive=… true Recurse down the specified directory
-exclude-dir=… none Do not watch directories matching this glob pattern, e.g. ".git". You may have multiples of this flag.
-exclude=… none Exclude files matching this glob pattern, e.g. ".#*" ignores emacs temporary files. You may have multiples of this flag.
-include=… none Include files whose last path component matches this glob pattern. You may have multiples of this flag.
-pattern=… (.+\.go|.+\.c)$ A regular expression which matches the files to watch. The default watches .go and .c files.
misc
-color=_ false Colorize the output of the daemon's status messages.
-log-prefix=_ true Prefix all child process output with stdout/stderr labels and log timestamps.
-graceful-kill=_ false On supported platforms, send the child process a SIGTERM to allow it to exit gracefully if possible.

Examples

In its simplest form, the defaults will do. With the current working directory set to the source directory you can simply…

$ PollCompileDaemon

… and it will recompile your code whenever you save a source file.

If you want it to also run your program each time it builds you might add…

$ PollCompileDaemon -command="./MyProgram -my-options"

… and it will also keep a copy of your program running. Killing the old one and starting a new one each time you build.

You may find that you need to exclude some directories and files from monitoring, such as a .git repository or emacs temporary files…

$ PollCompileDaemon -exclude-dir=.git -exclude=".#*" …

If you want to monitor files other than .go and .c files you might…

$ PollCompileDaemon -include=Makefile -include="*.less" -include="*.tmpl"

Notes

Too many open files

If you get an error for too many open files, you might wish to exclude your .git, .hg, or similar VCS directories using -exclude-dir=…. This is common on OS X and BSD platforms where each watched file consumes a file descriptor.

If you still have too many open files, then you need to raise your process's file limit using the ulimit command. Something like ulimit -n 1024 will probably take care of it. There is also a sysctl based limit which you may reach and need to adjust.

Project Details

Credits

CompileDaemon was written by githubnemo.

Code and documentation was contributed by jimstudt.

License

PollCompileDaemon is licensed under the BSD Two Clause License

About

Very simple compile daemon for Go

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 100.0%