fileboy 是一個(gè)文件變更監(jiān)聽(tīng)通知系統(tǒng)，使用 Go 編寫(xiě)。

適用于 Hot Reload （典型的如開(kāi)發(fā)go項(xiàng)目，無(wú)需每次手動(dòng)執(zhí)行 go build；又比如前端 node 打包） 或者 系統(tǒng)監(jiān)控的場(chǎng)景。

特性

• 極簡(jiǎn)的用法和配置
• 支持多平臺(tái)，Windows/Linux/MacOS
• 支持自定義文件監(jiān)聽(tīng)范圍，監(jiān)聽(tīng)指定文件夾/不監(jiān)聽(tīng)指定文件夾/指定后綴文件
• 支持自定義監(jiān)控事件（write/rename/remove/create/chmod）
• 支持設(shè)置多條命令
• 命令支持變量占位符
• 支持冗余任務(wù)丟棄，自定義冗余任務(wù)范圍
• 支持 http 通知
• 更多...

編譯環(huán)境

go version 1.13

更新日志

CHANGELOG

運(yùn)行

下載二進(jìn)制文件

Github:?download v1.12
Gitee:?dowmload v1.12

下載已經(jīng)編譯好的對(duì)應(yīng)平臺(tái)二進(jìn)制文件，重命名為fileboy, 加入系統(tǒng) Path 中即可。

源碼編譯

clone 該項(xiàng)目，進(jìn)入主目錄，運(yùn)行命令:

## 安裝依賴
go get -u gopkg.in/fsnotify/fsnotify.v1
go get -u gopkg.in/yaml.v2
## 編譯
go build
## 運(yùn)行
./fileboy

使用

fileboy 的正常運(yùn)行依賴于?filegirl.yaml?配置文件，因此首次在項(xiàng)目中使用需要初始化?filegirl.yaml。

• 進(jìn)入你想要 hot reload 的項(xiàng)目主目錄下；
• 運(yùn)行?fileboy init，會(huì)在該目錄下生成?filegirl.yaml文件；
• 查看?filegirl.yaml,修改為適合自己項(xiàng)目的配置項(xiàng)；
• 運(yùn)行?fileboy即可.

如果你定義了?command -> exec命令，想事先確認(rèn)是否能正常執(zhí)行，可以運(yùn)行?fileboy exec命令，系統(tǒng)會(huì)嘗試運(yùn)行你的自定義命令。
你可以使用?fileboy help查看使用幫助。

filegirl.yaml 配置文件說(shuō)明

# 主配置
core:
    # 配置版本號(hào)
    version: 1

# 監(jiān)控配置
monitor:
    # 要監(jiān)聽(tīng)的目錄
    # test1       監(jiān)聽(tīng)當(dāng)前目錄下 test1 目錄
    # test1/test2 監(jiān)聽(tīng)當(dāng)前目錄下 test1/test2 目錄
    # test1,*     監(jiān)聽(tīng)當(dāng)前目錄下 test1 目錄及其所有子目錄（遞歸）
    # .,*         監(jiān)聽(tīng)當(dāng)前目錄及其所有子目錄（遞歸）
    includeDirs:
        - .,*

    # 不監(jiān)聽(tīng)的目錄
    # .idea   忽略.idea目錄及其所有子目錄的監(jiān)聽(tīng)
    exceptDirs:
        - .idea
        - .git
        - .vscode
        - node_modules
        - vendor

    # 監(jiān)聽(tīng)文件的格式，此類文件更改會(huì)執(zhí)行 command 中的命令
    # .go   后綴為 .go 的文件更改，會(huì)執(zhí)行 command 中的命令
    # .*    所有的文件更改都會(huì)執(zhí)行 command 中的命令
    types:
        - .go

    # 監(jiān)聽(tīng)的事件類型，發(fā)生此類事件才執(zhí)行 command 中的命令
    # 沒(méi)有該配置默認(rèn)監(jiān)聽(tīng)所有事件
    # write   寫(xiě)入文件事件
    # rename  重命名文件事件
    # remove  移除文件事件
    # create  創(chuàng)建文件事件
    # chmod   更新文件權(quán)限事件(類unix)
    events:
        - write
        - rename
        - remove
        - create
        - chmod

# 命令
command:
    # 監(jiān)聽(tīng)的文件有更改會(huì)執(zhí)行的命令
    # 可以有多條命令，會(huì)依次執(zhí)行
    # 如有多條命令，每條命令都會(huì)等待上一條命令執(zhí)行完畢后才會(huì)執(zhí)行
    # 如遇交互式命令，允許外部獲取輸入
    # 支持變量占位符,運(yùn)行命令時(shí)會(huì)替換成實(shí)際值：
    #    {{file}}    文件名(如 a.txt 、test/test2/a.go)
    #    {{ext}}     文件后綴(如 .go)
    #    {{event}}   事件(上面的events, 如 write)
    #    {{changed}} 文件更新的本地時(shí)間戳(納秒,如 1537326690523046400)
    # 變量占位符使用示例：cp {{file}} /root/sync -rf  、 myCommand --{{ext}} {{changed}}
    exec:
        - go version
        - go env

    # 文件變更后命令在xx毫秒后才會(huì)執(zhí)行，單位為毫秒
    # 一個(gè)變更事件(A)如果在定義的延遲時(shí)間(t)內(nèi)，又有新的文件變更事件(B)，那么A會(huì)取消執(zhí)行。
    # B及以后的事件均依次類推，直到事件Z在t內(nèi)沒(méi)有新事件產(chǎn)生，Z 會(huì)執(zhí)行
    # 合理設(shè)置延遲時(shí)間，將有效減少冗余和重復(fù)任務(wù)的執(zhí)行
    # 如果不需要該特性，設(shè)置為 0
    delayMillSecond: 2000

# 通知器
notifier:
    # 文件更改會(huì)向該 url 發(fā)送請(qǐng)求（POST 一段 json 文本數(shù)據(jù)）
    # 觸發(fā)請(qǐng)求的時(shí)機(jī)和執(zhí)行 command 命令是一致的
    # 請(qǐng)求超時(shí) 15 秒
    # POST 格式:
    #    Content-Type: application/json;charset=UTF-8
    #    User-Agent: FileBoy Net Notifier v1.12
    #    Body: {"project_folder":"/project/path","file":"main.go","changed":1576567861913824940,"ext":".go","event":"write"}
    # 例: http://example.com/notifier/fileboy-listener
    # 不啟用通知，請(qǐng)留空 ""
    callUrl: ""

TODO

• ?命令支持變量占位符
• ?支持多命令
• ?支持監(jiān)聽(tīng)指定文件夾
• ?支持不監(jiān)聽(tīng)指定文件夾
• ?支持監(jiān)聽(tīng)指定后綴文件
• ?支持自定事件監(jiān)聽(tīng)
• ?支持 http 通知
• ?支持冗余任務(wù)丟棄
• ?支持 http 合并任務(wù)的通知