Go to file
alessio fb1ebdfe4f #88 fixed 2017-09-18 03:05:00 +02:00
server open in browser with server flag 2017-09-18 00:31:52 +02:00
settings bin flag to install 2017-09-05 19:39:52 +02:00
style Fix broken color codes on Windows 2017-08-30 23:58:04 -07:00
watcher #87 fixed 2017-09-18 03:04:03 +02:00
.gitignore ignore .realize 2017-08-31 09:42:23 +02:00
.travis.yml go 1.9 2017-08-27 12:35:49 +02:00
Gopkg.lock dep updated 2017-08-30 01:56:00 +02:00
Gopkg.toml dep updated 2017-04-26 16:09:23 +02:00
LICENSE realize dev 2016-07-12 10:18:02 +02:00
README.md features link 2017-08-11 21:50:19 +02:00
realize.go #88 fixed 2017-09-18 03:05:00 +02:00
realize_test.go no conf method removed 2017-09-18 00:15:21 +02:00

README.md

Realize

GoDoc TeamCity CodeBetter AUR Join the chat at https://gitter.im/tockins/realize Go Report Card OpenCollective OpenCollective

Realize is the Go tool that is focused to speed up and improve developers workflow.

Automate the most recurring operations needed for development, define what you need only one time, integrate additional tools of third party, define custom cli commands and reload projects at each file change without stop to write code.

Various operations can be programmed for each project, which can be executed at startup, at stop, and at each file change.

Wiki

Features

  • Two watcher types: file system and polling
  • Logs and errors files
  • Projects setup step by step
  • After/Before custom commands
  • Custom environment variables
  • Multiple projects at the same time
  • Custom arguments to pass at each project
  • Docker support (only with polling watcher)
  • Live reload on file change (extensions and paths customizable)
  • Support for most go commands (install, build, run, vet, test, fmt and much more)
  • Web panel for a smart control of the workflow

v 1.5

  • Use cases
  • Tests
  • Watch gopath dependencies
  • Web panel, download logs
  • Multiple configurations (dev, production)
  • Support to ignore paths and files in gititnore
  • Input redirection (wait for an input and redirect)

Installation

Run this to get/install:

$ go get github.com/tockins/realize

Commands available

  • Run

    From project/projects root execute:

    $ realize run
    

    It will create a realize.yaml file if it doesn't exist already, add 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 test
    --open                      -> Open in default browser
    

    Examples:

    $ 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

    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
    
  • Init

    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

    Remove a project by its name

    $ realize remove --name="myname"
    
  • List

    Projects list in cli

    $ realize list
    
  • Color reference

    • Blue: outputs of the project
    • Red: errors
    • Magenta: times or changed files
    • Green: successfully completed action
  • Config sample

    For more examples check Realize Examples

    settings:
     legacy:
       status: true           // enable polling watcher instead fsnotifiy
       interval: 10s          // polling interval
      resources:              // files names
        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
      environment:            // env variables available at startup
        test: test
        myvar: value
      commands:               // go commands supported
        vet: true
        fmt: true
        test: false
        generate: false
        bin:
          status: true
        build:
          status: false
          args:                // additional params for the command
            - -race
        run: true
      args:                    // arguments to pass at the project
        - --myarg
      watcher:
        preview: false         // watched files preview
        paths:                 // watched paths 
        - /
        ignore_paths:          // ignored paths 
        - vendor
        exts:                  // watched extensions
        - .go
        scripts:               // custom scripts
        - type: before         // type (after/before)
          command: ./ls -l     // command
          changed: true        // relaunch when a file change
          startup: true        // launch at start
        - type: after
          command: ./ls
          changed: true
      streams:                 // save logs/errors/outputs on files
         file_out: false
         file_log: false
         file_err: false    
             ```
    
    

Support us and suggest an improvement

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]