286 lines
17 KiB
Markdown
286 lines
17 KiB
Markdown
## Realize
|
|
|
|
[![GoDoc](https://img.shields.io/badge/documentation-godoc-blue.svg)](https://godoc.org/github.com/tockins/realize)
|
|
[![TeamCity CodeBetter](https://travis-ci.org/tockins/realize.svg?branch=v1)](https://travis-ci.org/tockins/realize)
|
|
[![AUR](https://img.shields.io/aur/license/yaourt.svg?maxAge=2592000?style=flat-square)](https://raw.githubusercontent.com/tockins/realize/v1/LICENSE)
|
|
[![](https://img.shields.io/badge/realize-examples-yellow.svg)](https://github.com/tockins/realize-examples)
|
|
[![Join the chat at https://gitter.im/tockins/realize](https://badges.gitter.im/tockins/realize.svg)](https://gitter.im/tockins/realize?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/tockins/realize)](https://goreportcard.com/report/github.com/tockins/realize)
|
|
[![OpenCollective](https://opencollective.com/realize/backers/badge.svg)](#backers)
|
|
[![OpenCollective](https://opencollective.com/realize/sponsors/badge.svg)](#sponsors)
|
|
|
|
<p align="center">
|
|
<img src="http://i.imgur.com/pkMDtrl.png" width="350px">
|
|
</p>
|
|
|
|
#### 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.
|
|
|
|
|
|
<p align="center">
|
|
<img src="http://i.imgur.com/KpMSLnE.png">
|
|
</p>
|
|
|
|
|
|
#### Wiki
|
|
|
|
- [Features list](#features)
|
|
- [Getting Started](#installation)
|
|
- [Config sample](#config-sample) - Sample config file
|
|
- [Run cmd](#run) - Run a project
|
|
- [Add cmd](#add) - Add a new project
|
|
- [Init cmd](#init) - Make a custom config step by step
|
|
- [Remove cmd](#remove) - Remove a project
|
|
- [List cmd](#list) - List the projects
|
|
- [Support](#support-us-and-suggest-an-improvement)
|
|
- [Backers and Sponsors](#backers)
|
|
|
|
#### 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](https://github.com/tockins/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
|
|
- Chat with us [Gitter](https://gitter.im/tockins/realize)
|
|
- Suggest a new [Feature](https://github.com/tockins/realize/issues/new)
|
|
|
|
#### Backers
|
|
|
|
Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/realize#backer)]
|
|
|
|
<a href="https://opencollective.com/realize/backer/0/website" target="_blank"><img src="https://opencollective.com/realize/backer/0/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/1/website" target="_blank"><img src="https://opencollective.com/realize/backer/1/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/2/website" target="_blank"><img src="https://opencollective.com/realize/backer/2/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/3/website" target="_blank"><img src="https://opencollective.com/realize/backer/3/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/4/website" target="_blank"><img src="https://opencollective.com/realize/backer/4/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/5/website" target="_blank"><img src="https://opencollective.com/realize/backer/5/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/6/website" target="_blank"><img src="https://opencollective.com/realize/backer/6/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/7/website" target="_blank"><img src="https://opencollective.com/realize/backer/7/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/8/website" target="_blank"><img src="https://opencollective.com/realize/backer/8/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/9/website" target="_blank"><img src="https://opencollective.com/realize/backer/9/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/10/website" target="_blank"><img src="https://opencollective.com/realize/backer/10/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/11/website" target="_blank"><img src="https://opencollective.com/realize/backer/11/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/12/website" target="_blank"><img src="https://opencollective.com/realize/backer/12/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/13/website" target="_blank"><img src="https://opencollective.com/realize/backer/13/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/14/website" target="_blank"><img src="https://opencollective.com/realize/backer/14/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/15/website" target="_blank"><img src="https://opencollective.com/realize/backer/15/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/16/website" target="_blank"><img src="https://opencollective.com/realize/backer/16/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/17/website" target="_blank"><img src="https://opencollective.com/realize/backer/17/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/18/website" target="_blank"><img src="https://opencollective.com/realize/backer/18/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/19/website" target="_blank"><img src="https://opencollective.com/realize/backer/19/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/20/website" target="_blank"><img src="https://opencollective.com/realize/backer/20/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/21/website" target="_blank"><img src="https://opencollective.com/realize/backer/21/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/22/website" target="_blank"><img src="https://opencollective.com/realize/backer/22/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/23/website" target="_blank"><img src="https://opencollective.com/realize/backer/23/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/24/website" target="_blank"><img src="https://opencollective.com/realize/backer/24/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/25/website" target="_blank"><img src="https://opencollective.com/realize/backer/25/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/26/website" target="_blank"><img src="https://opencollective.com/realize/backer/26/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/27/website" target="_blank"><img src="https://opencollective.com/realize/backer/27/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/28/website" target="_blank"><img src="https://opencollective.com/realize/backer/28/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/backer/29/website" target="_blank"><img src="https://opencollective.com/realize/backer/29/avatar.svg"></a>
|
|
|
|
|
|
#### Sponsors
|
|
|
|
Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/realize#sponsor)]
|
|
|
|
<a href="https://opencollective.com/realize/sponsor/0/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/0/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/1/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/1/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/2/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/2/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/3/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/3/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/4/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/4/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/5/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/5/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/6/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/6/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/7/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/7/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/8/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/8/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/9/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/9/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/10/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/10/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/11/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/11/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/12/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/12/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/13/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/13/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/14/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/14/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/15/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/15/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/16/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/16/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/17/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/17/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/18/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/18/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/19/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/19/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/20/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/20/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/21/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/21/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/22/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/22/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/23/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/23/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/24/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/24/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/25/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/25/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/26/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/26/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/27/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/27/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/28/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/28/avatar.svg"></a>
|
|
<a href="https://opencollective.com/realize/sponsor/29/website" target="_blank"><img src="https://opencollective.com/realize/sponsor/29/avatar.svg"></a>
|