LRPはgolang製のLive Reload Proxyです。
| OS | Status |
|---|---|
| Mac | OK |
| Windows | OK |
| Linux | ? |
- Live Reloadを簡単にしたい
- 特定の言語に依存せず、汎用的に使える
- 複数のプログラミング言語を考慮できる
- コンパイルが必要な言語は自動的に再コンパイルできる
- golangで何かを作ってみたかった
- 初golangアプリケーション
- 各Live Reloadツールのメリット・デメリットを検討した結果、機能をいいとこ取りすると便利になりそうだった
- BrowserSync
- 特定言語に依存していない
- プロキシサーバとして動く
- コマンドの起動を制御できない
- LiveReloadX
- 特定言語に依存していない
- staticが便利
- プロキシサーバとして動く
- コマンドの起動を制御できない
- goemon
- 特定言語に依存していない
- Yamlで定義できる
- コマンドの起動を制御できる
- プロキシサーバは含まれていなかったので、エクステンション等が必要
- BrowserSync
- プロキシサーバを経由してLive Reloadを行う
- Live Reload用のスクリプトファイルはプロキシサーバが自動的に付与する
- ブラウザのエクステンションを必要としない
- htmlに特定のスクリプトを差し込む必要がない
- Live Reload用のスクリプトファイルはプロキシサーバが自動的に付与する
- 設定をyamlで定義
- ファイル監視
- ファイル変更、ディレクトリ変更を検知してLive Reloadイベントを発火
- 除外設定も可能
- コマンド管理
- Live Reloadイベント発火時にコマンドのrestartが可能
- 標準出力のキーワードでLive Reloadイベントを発火
- 静的Webサーバ
- 任意のディレクトリを静的Webサーバとして公開可能
- 任意のディレクトリのファイルを優先させるスタブ機能として使用可能
- ポーリング機能は今のところない
- ローカルで動かすことを目的としているので優先度が低い
- 必要そうなら実装を検討する
go get -u github.com/oneut/lrp
lrp start
実行するためにはlrp.ymlの定義が必須です。
proxy:
scheme: "https"
host: "localhost:9000"
staticPath: ./
source:
scheme: "https"
host: "localhost:8080"
tasks:
web:
aggregateTimeout: 300
commands:
go:
executes:
- "go clean"
- "go build -o main"
- "./main"
needsRestart: true
monitor:
paths:
- ./view
js:
commands:
webpack:
executes:
- npm start --prefix ./public/assets
needsRestart: false
watchStdouts:
- bundle.js
test:
executes:
- npm test --prefix ./public/assets
needsRestart: true
monitor:
paths:
- ./public/assets
ignores:
- node_modules
Live Reloadのプロキシサーバを管理します。
URLスキームを定義できます。任意の設定です。デフォルトはhttpです。
proxy:
scheme: "https"
Live Reloadのプロキシサーバのドメイン、ホスト名、ポートを指定します。デフォルトは:9000です。
proxy:
host: ":9000"
proxy:
host: "localhost:9000"
プロキシサーバ経由で静的ファイルにアクセスできます。任意の設定です。
proxy:
staticPath: ./static
もし、proxy.staticPathとsource.hostで同じパスが存在した場合は、staticPathが優先されます。
そのため、Webサーバに対してアクセスさえできれば、一部のファイルだけstaticPathに存在するローカルファイルに差し替えることができます。
ブラウザの自動オープンを制御します。デフォルトは自動でブラウザがオープンします。
ブラウザを自動でオープンしたくない場合は、noneを設定してください。
proxy:
browserOpen: "none"
Live Reloadを行うWebサーバを管理します。
URLスキームを定義できます。任意の設定です。デフォルトはhttpです。
source:
scheme: "https"
Live Reloadを行うWebサーバのドメイン、ホスト名、ポートを指定します。 設定は任意です。
source:
host: ":8080"
source:
host: "localhost:8080"
source.hostを設定した場合、ブラウザにアクセスした時にはproxy.hostの値に自動的に置換されます。
プロキシを経由してアクセスしているサイトのHTMLデータを条件を指定して置換します。
複数の設定が可能です。
検索条件になるキーワードを指定します。
source:
host: "localhost:8080"
replaces:
- search: "//cdn.example.com"
replace: "//localhost:9000"
検索条件に対して置換されるキーワードを指定します
source:
host: "localhost:8080"
replaces:
- search: "//cdn.example.com"
replace: "//localhost:9000"
検索条件に正規表現の使用を指定します。デフォルトはfalseです。
source:
host: "localhost:8080"
replaces:
- search: "abc(.+)"
replace: "$1"
regexp: true
Live Reloadを行うタスクを管理します。タスク名は任意で設定できます。 タスクごとに実行するコマンドとファイル監視を設定します。 コマンドとファイル監視は、タスク単位で制御され、複数のタスクを設定できます。
tasks:
web:
aggregateTimeout: 300
commands:
go:
executes:
- "go clean"
- "go build -o main"
- "./main"
needsRestart: true
monitor:
paths:
- ./view
最初のファイルが変更されてからの遅延を設定できます。
この設定により、この期間に行われた他の変更を1回の再構築に集約できます。
設定はミリ秒単位です。デフォルトは300です。
tasks:
web:
aggregateTimeout: 300
Live Reloadを行う際のコマンドを管理できます。コマンド名は任意で設定でき、複数設定が可能です。 コマンドごとに再起動、標準出力の監視を行います。
tasks:
web:
commands:
go:
executes:
- "go clean"
- "go build -o main"
- "./main"
npm:
executes:
- npm start
実行したいコマンドを設定します。複数設定可能です。タスクは逐次処理です。
tasks:
web:
commands:
go:
executes:
- "go clean"
- "go build -o main"
- "./main"
ファイル監視で変更が起きた際にコマンドを再実行したい場合に設定します。デフォルトはfalseです。
tasks:
web:
commands:
go:
executes:
- "go clean"
- "go build -o main"
- "./main"
needsRestart: true
コマンド実行時の標準出力を監視します。
設定したキーワードによってLive Reloadイベントを発火します。
needsRestart=trueで再起動した際に、watchStdoutsで指定したキーワードがあると無限ループします。気をつけましょう。
tasks:
web:
commands:
npm:
executes:
- npm start
needsRestart: false
watchStdouts:
- bundle.js
ファイル監視を管理します。
tasks:
web:
monitor:
paths:
- ./view
ignores:
- node_modules
ファイルを監視するディレクトリを指定します。 ディレクトリは複数設定できます。
tasks:
web:
monitor:
paths:
- ./app
- ./views
除外するファイル、ディレクトリを指定します。 設定できるパターンは部分一致、パス指定が行なえます。 また、*、?等のワイルドカードが使えますが、実装を調整中です。
tasks:
web:
monitor:
paths:
- ./app
ignores:
- node_modules
- ./node_modules
- test
- リファクタリング
- ファイル分割したい
- ファイルや変数名の命名が雑
- テストを考慮した実装になっていない
- gRPCを使用した変更検知
write tcp 127.0.0.1:9000->127.0.0.1:49720: write: broken pipeがgo-livereloadのwebsocketで発生している・・・。- livereload自体を自作しないと制御できないので悩む
- monitor定義で、イベント発火したファイル名を動的に取得
- テストで特定ファイルのテスト実行が簡単にできそう
- 正規表現でマッチ出来たら良さそう
- README.mdを英語にする。
- 取得したHTMLの特定キーワードの置換処理