realize/README.md

102 lines
2.4 KiB
Markdown
Raw Normal View History

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
```
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
2016-08-17 14:57:41 +00:00
2016-08-17 14:56:06 +00:00
```
realize add --name="Project Name" --main="main.go" --base="/"
```
- Remove a project by his name
2016-08-17 14:57:41 +00:00
2016-08-17 14:56:06 +00:00
```
realize remove --name="Project Name"
```
- Lists all projects
2016-08-17 14:57:41 +00:00
2016-08-17 14:56:06 +00:00
```
realize list
```
- 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