2016-08-17 14:56:06 +00:00
|
|
|
## Realize
|
2016-07-12 08:18:02 +00:00
|
|
|
|
2016-08-17 19:34:20 +00:00
|
|
|
[![AUR](https://img.shields.io/aur/license/yaourt.svg?maxAge=2592000?style=flat-square)](https://raw.githubusercontent.com/tockins/realize/v1/LICENSE)
|
2016-08-17 20:22:55 +00:00
|
|
|
[![Build Status](http://img.shields.io/travis/labstack/echo.svg?style=flat-square)](https://travis-ci.org/tockins/realize)
|
2016-08-17 19:34:20 +00:00
|
|
|
|
2016-08-17 20:43:19 +00:00
|
|
|
A Golang file watchers with live reload. Run, build and watch file changes with custom paths
|
2016-07-24 23:02:18 +00:00
|
|
|
|
2016-08-17 19:34:20 +00:00
|
|
|
#### Features
|
|
|
|
|
2016-08-17 19:38:00 +00:00
|
|
|
- Build, Install and Run in the same time
|
2016-08-17 19:34:20 +00:00
|
|
|
- Live reload on file changes (re-build, re-install and re-run)
|
|
|
|
- Watch custom paths
|
|
|
|
- Watch specific file extensions
|
2016-08-17 20:45:14 +00:00
|
|
|
- Multiple projects support
|
2016-08-17 19:34:20 +00:00
|
|
|
|
2016-08-17 14:56:06 +00:00
|
|
|
#### Installation and usage
|
|
|
|
|
|
|
|
- Run this for get/install it:
|
2016-08-17 15:11:35 +00:00
|
|
|
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
2016-08-17 21:05:20 +00:00
|
|
|
$ go get github.com/tockins/realize
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
|
|
|
- From the root of your project/projects:
|
2016-08-17 14:57:41 +00:00
|
|
|
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
2016-08-17 21:06:29 +00:00
|
|
|
$ realize start
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
|
|
|
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.
|
|
|
|
|
|
|
|
```
|
2016-08-17 21:06:29 +00:00
|
|
|
$ realize start --name="Project Name" --main="main.go" --base="/"
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
|
|
|
- Add another project whenever you want
|
2016-08-17 14:57:41 +00:00
|
|
|
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
2016-08-17 21:06:29 +00:00
|
|
|
$ realize add --name="Project Name" --main="main.go" --base="/"
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
|
|
|
- Remove a project by his name
|
2016-08-17 14:57:41 +00:00
|
|
|
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
2016-08-17 21:06:29 +00:00
|
|
|
$ realize remove --name="Project Name"
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
|
|
|
- Lists all projects
|
2016-08-17 14:57:41 +00:00
|
|
|
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
2016-08-17 21:06:29 +00:00
|
|
|
$ realize list
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
|
|
|
- Build, Run and watch file changes. Realize will re-build and re-run your projects on each changes
|
2016-08-17 14:57:41 +00:00
|
|
|
|
2016-08-17 14:56:06 +00:00
|
|
|
```
|
|
|
|
realize run
|
|
|
|
```
|
|
|
|
|
2016-08-17 20:55:31 +00:00
|
|
|
#### 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
|
|
|
|
|
2016-08-17 14:56:06 +00:00
|
|
|
#### To do
|
2016-08-17 20:50:18 +00:00
|
|
|
- [x] Cli start, remove, add, list, run
|
2016-07-24 23:02:18 +00:00
|
|
|
- [x] Remove duplicate projects
|
2016-08-17 20:50:18 +00:00
|
|
|
- [x] Support for multiple projects
|
2016-08-04 20:01:08 +00:00
|
|
|
- [x] Watcher files preview
|
2016-08-14 15:22:48 +00:00
|
|
|
- [x] Support for directories with duplicates names
|
|
|
|
- [ ] Unit test
|
2016-08-17 20:45:38 +00:00
|
|
|
- [ ] Go doc
|
2016-08-17 14:56:06 +00:00
|
|
|
- [x] Support for server start/stop
|
2016-08-17 20:50:18 +00:00
|
|
|
- [x] Stream projects output
|
2016-08-17 14:56:06 +00:00
|
|
|
- [x] Cli feedback
|
|
|
|
|
|
|
|
|