Realize

A Golang build system with file watchers, output streams and live reload. Run, build and watch file changes with custom paths

Features

• Build, Install, Test, Fmt and Run at the same time
• Live reload on file changes (re-build, re-install and re-run)
• Watch custom paths
• Watch specific file extensions
• Multiple projects support
• Output streams
• Execution times
• Highly customizable
• Fast run

Installation and usage

• Run this for get/install it:

  $ go get github.com/tockins/realize
  

• From the root of a project/projects:

  $ realize add 
  

  If not exists already, It will create a realize.config.yaml file.

  You can even pass custom parameters for add a project. This is a list of the supported fields:

  --name="Project Name"  -> Name, if not specified takes the working directory name
  --path="server"        -> Base Path, if not specified takes the working directory name    
  --build                -> Go build, if not specified takes "false"    
  --bin                  -> Go intall, if not specified takes "true"    
  --run                  -> Go run, if not specified takes "true"  
  --fmt                  -> Go fmt, if not specified takes "true"  
  

  Add a project whenever you want.

  $ realize add
  

  $ realize add --path="mypath"
  

  $ realize add --name="My Project" --build
  

  $ realize add --name="My Project" --path="/projects/package" --build
  

  $ realize add --name="My Project" --path="projects/package" --build --run
  

• Remove a project by his name

  $ realize remove --name="Project Name"
  

• Lists all projects

  $ realize list
  

• Build, Run and watch file changes. Realize will re-build and re-run your projects on each changes

  $ realize run 
  

  Fast run launches a project from his working directory without a config file

  $ realize run --fast
  

  

Config file example

• For more examples check Realize Examples

  version: "1.0"
  projects:
     - app_name: App One     -> name
       app_path: one         -> root path
       app_run: true         -> enable/disable go run (require app_bin)
       app_bin: true         -> enable/disable go install
       app_build: false      -> enable/disable go build
       app_fmt: true         -> enable/disable go fmt
       app_watcher:
         preview: true       -> prints the observed files on startup
         paths:              -> paths to observe for live reload
         - /
         ignore_paths:       -> paths to ignore
         - vendor
         - bin
         exts:               -> file extensions to observe for live reload
         - .go
     - app_name: App Two     -> another project
       app_path: two
       app_run: true
       app_build: true
       app_bin: true
       app_watcher:
         paths:
         - /
         ignore_paths:
         - vendor
         - bin
         exts:
         - .go 
  

Next releases

#####Milestone 1.0

• Cli start, remove, add, list, run
• Remove duplicate projects
• Support for multiple projects
• Watcher files preview
• Support for directories with duplicates names
• Go test support
• Go fmt support
• Cli fast run
• Execution times for build/install
• Go doc
• Support for server start/stop
• Stream projects output
• Cli feedback

Milestone 1.1

• Test under windows
• Unit test

Contacts

• Chat with us Gitter

• Alessio Pracchia

• Daniele Conventi