realize/README.md

2.4 KiB

Realize

AUR Build Status

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

Features

  • Build, Install and Run in 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

Installation and usage

  • Run this for get/install it:

    $ go get github.com/tockins/realize/...
    
  • From the root of your project/projects:

    realize start 
    

    Will create a realize.config.yaml file with a sample project.

    You can pass additional parameters for your first project, such as the project name, the main file name and the base path.

    realize start --name="Project Name" --main="main.go" --base="/"
    
  • Add another project whenever you want

    realize add --name="Project Name" --main="main.go" --base="/"
    
  • 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 
    

Config file example

version: "1.0"
projects:
    - app_name: App One
      app_path: one
      app_main: main.go
      app_run: true
      app_bin: true
      app_watcher:
        paths:
        - /
        ignore_paths:
        - vendor
        - bin
        exts:
        - .go
    - app_name: App Two
      app_path: two
      app_main: main.go
      app_run: true
      app_build: true
      app_bin: true
      app_watcher:
        preview: true
        paths:
        - /
        ignore_paths:
        - vendor
        - bin
        exts:
        - .go

To do

  • Cli start, remove, add, list, run
  • Remove duplicate projects
  • Support for multiple projects
  • Watcher files preview
  • Support for directories with duplicates names
  • Unit test
  • Go doc
  • Support for server start/stop
  • Stream projects output
  • Cli feedback