realize/README.md at 297e867d52e7df7d829a2c9462006cbe67590f6a

4.8 KiB

Raw Blame History

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

4.8 KiB Raw Blame History