280 lines
16 KiB
Markdown
280 lines
16 KiB
Markdown
## Realize
|
|
|
|
[](https://godoc.org/github.com/tockins/realize)
|
|
[](https://travis-ci.org/tockins/realize)
|
|
[](https://raw.githubusercontent.com/tockins/realize/v1/LICENSE)
|
|
[](https://github.com/tockins/realize-examples)
|
|
[](https://gitter.im/tockins/realize?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
[](https://goreportcard.com/report/github.com/tockins/realize)
|
|
[](#backers)
|
|
[](#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 your work pipeline, integrate additional tools of third party, define custom cli commands and reload projects at each changed without stop to write code.
|
|
|
|
<p align="center">
|
|
<img src="http://i.imgur.com/KpMSLnE.png">
|
|
</p>
|
|
|
|
|
|
#### Features
|
|
|
|
- Highly customizable
|
|
- Setup step by step
|
|
- Live reload
|
|
- Support for multiple projects
|
|
- Save logs on files
|
|
- Web panel for a smart view
|
|
- Build, install, run, test, fmt, generate, vet and much more
|
|
- Watch custom paths and specific file extensions
|
|
- Multiple watching methods (Polling, File watcher)
|
|
- Docker support
|
|
|
|
v 1.5
|
|
|
|
- [ ] 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)
|
|
|
|
#### Wiki
|
|
|
|
- [Getting Started](#installation)
|
|
- [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
|
|
- [Config sample](#config-sample) - Sample config file
|
|
- [Support](#support-us-and-suggest-an-improvement)
|
|
- [Backers and Sponsors](#backers)
|
|
|
|
#### Installation
|
|
Run this to get/install:
|
|
```
|
|
$ go get github.com/tockins/realize
|
|
```
|
|
#### Commands
|
|
|
|
- ##### 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 // legacy watch status
|
|
interval: 10s // polling interval
|
|
resources: // files names related to streams
|
|
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
|
|
test: test
|
|
myvar: value
|
|
commands:
|
|
vet: true
|
|
fmt: true
|
|
test: false
|
|
generate: false
|
|
bin:
|
|
status: true
|
|
build:
|
|
status: false
|
|
args:
|
|
- -race
|
|
run: true
|
|
args:
|
|
- --myarg
|
|
watcher:
|
|
preview: false // watched files preview
|
|
paths: // watched paths
|
|
- /
|
|
ignore_paths: // ignored paths
|
|
- vendor
|
|
exts: // watched extensions
|
|
- .go
|
|
scripts:
|
|
- type: before // type
|
|
command: ./ls -l // command
|
|
changed: true // relaunch when a file changes
|
|
startup: true // launch at start
|
|
- type: after
|
|
command: ./ls
|
|
changed: true
|
|
streams: // enable/disable streams
|
|
cli_out: true
|
|
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>
|