A Go build system with file watchers, output streams and live reload. Run, build and watch file changes with custom paths
- Highly customizable
- Config your project Step by Step
- Build, Install, Test, Fmt, Generate and Run at the same time
- Live reload on file changes (re-build, re-install...)
- Watch custom paths and specific file extensions
- Watch by FsNotify or by polling
- Support for multiple projects
- Output streams and error logs (support for save on a file)
- Web Panel (projects list, config settings, logs)
v 1.5
- Watch dependencies options
- Input redirection (wait for an input and redirect)
- Web panel full support
- Multiple configurations
- GoMobile support ?
- Ignore path and files in gititnore ?
-
Run cmd - Run a project
-
Add cmd - Add a new project
-
Init cmd - Make a custom config step by step
-
Remove cmd - Remove a project
-
List cmd - List the projects
Run this to get/install:
$ go get github.com/tockins/realize
-
From project/projects root execute:
$ realize runIt will create a realize.yaml file if it doesn't exist already, adds the working directory as project and run the pipeline.
The Run command supports the following custom parameters:
--name="name" -> Run by name on existing configuration --path="realize/server" -> Custom Path, if not specified takes the working directory name --build -> Enable go build --no-run -> Disable go run --no-install -> Disable go install --no-config -> Ignore an existing config / skip the creation of a new one --server -> Enable the web server --legacy -> Enable legacy watch instead of Fsnotify watch --generate -> Enable go generate --test -> Enable go testExamples:
$ realize run $ realize run --path="mypath" $ realize run --name="My Project" --build $ realize run --path="realize" --no-run --no-config $ realize run --path="/Users/alessio/go/src/github.com/tockins/realize-examples/coin/"If you want, you can specify additional arguments for your project.
The additional arguments must go after the params
Run can run a project from its working directory without make a config file (--no-config).
$ realize run --path="/print/printer" --no-run yourParams --yourFlags // right $ realize run yourParams --yourFlags --path="/print/printer" --no-run // wrong -
Add a project to an existing config file or create a new one without run the pipeline.
"Add" supports the same parameters of the "Run" command.
$ realize add -
Like add, but with this command you can create a configuration step by step and customize each option.
Init is the only command that supports a complete customization of all the options supported
$ realize init -
Remove a project by its name
$ realize remove --name="myname" -
Projects list in cli
$ realize list -
- Blue: outputs of the project
- Red: errors
- Magenta: times or changed files
- Green: successfully completed action
-
For more examples check Realize Examples
``` settings: legacy: status: true // legacy watch status interval: 10s // polling interval resources: // files names related to streams outputs: outputs.log logs: logs.log errors: errors.log server: status: false // server status open: false // open browser at start host: localhost // server host port: 5001 // server port projects: - name: coin path: coin // project path commands: vet: true fmt: true test: false generate: false bin: status: true build: status: false args: - -race run: true args: - --myarg watcher: preview: false // watched files preview paths: // watched paths - / ignore_paths: // ignored paths - vendor exts: // watched extensions - .go scripts: - type: before // type command: ./ls -l // command changed: true // relaunch when a file changes startup: true // launch at start - type: after command: ./ls changed: true streams: // enable/disable streams cli_out: true file_out: false file_log: false file_err: false ```