hwatch

hwatch - 替代 watch 命令。

描述

hwatch 是一个替代的 watch 命令。它会记录命令执行的结果，并可以显示其历史和差异。

特性

• 当发生差异时，可以保留历史记录，并在以后进行检查。
• 可以检查历史记录中的差异。显示方法可以实时更改。
• 可以将执行结果作为日志（json 格式）输出。
• 提供自定义键盘映射。
• 支持 ANSI 颜色代码。
• 执行结果可以滚动。
• 不仅作为 TUI 应用程序，还可以将差异输出到标准输出。
• 如果发生差异，可以执行指定的额外命令。

安装

macOS (brew)

brew install hwatch

macOS (MacPorts)

sudo port install hwatch

Arch Linux (AUR)

paru -S hwatch

Cargo Install

cargo install hwatch

使用方法

命令

    $ hwatch --help
    A modern alternative to the watch command, records the differences in execution results and can check this differences at after.

    Usage: hwatch [OPTIONS] [command]...

    Arguments:
      [command]...

    Options:
      -b, --batch                         output exection results to stdout
      -B, --beep                          beep if command has a change result
          --border                        Surround each pane with a border frame
          --with-scrollbar                When the border option is enabled, display scrollbar on the right side of watch pane.
          --mouse                         enable mouse wheel support. With this option, copying text with your terminal may be harder. Try holding the Shift key.
      -c, --color                         interpret ANSI color and style sequences
      -r, --reverse                       display text upside down.
      -C, --compress                      Compress data in memory.
      -t, --no-title                      hide the UI on start. Use `t` to toggle it.
      -N, --line-number                   show line number
          --no-help-banner                hide the "Display help with h key" message
      -x, --exec                          Run the command directly, not through the shell. Much like the `-x` option of the watch command.
      -O, --diff-output-only              Display only the lines with differences during `line` diff and `word` diff.
      -A, --aftercommand <after_command>  Executes the specified command if the output changes. Information about changes is stored in json format in environment variable ${HWATCH_DATA}.
      -l, --logfile [<logfile>]           logging file
      -s, --shell <shell_command>         shell to use at runtime. can  also insert the command to the location specified by {COMMAND}. [default: "sh -c"]
      -n, --interval <interval>           seconds to wait between updates [default: 2]
      -L, --limit <limit>                 Set the number of history records to keep. only work in watch mode. Set `0` for unlimited recording. (default: 5000) [default: 5000]
          --tab-size <tab_size>           Specifying tab display size [default: 4]
      -d, --differences [<differences>]   highlight changes between updates [possible values: none, watch, line, word]
      -o, --output [<output>]             Select command output. [default: output] [possible values: output, stdout, stderr]
      -K, --keymap <keymap>               Add keymap
      -h, --help                          Print help
      -V, --version                       Print version

快捷键

Watch 模式快捷键（默认）。

自定义按键绑定

可以使用-K选项自定义按键绑定。格式为keybind=function。

hwatch -K ctrl-p=history_pane_up -K ctrl-n=history_pane_down command...

可以指定的按键绑定函数如下。

配置

如果您始终想使用某些命令行选项，您可以在HWATCH环境变量中设置它们。例如，如果您使用bash，您可以将以下内容添加到您的.bashrc

export HWATCH="--no-title --color --no-help-banner --border --with-scrollbar"

示例

间隔10秒

使用-n选项指定命令执行间隔。

hwatch -n 3 command...

日志输出

命令执行结果可以以json格式输出为日志。

hwatch -n 3 -l hwatch_log.json command...

当您检查json日志时，您可以使用此脚本轻松检查。

使用shell函数

如果您想定期执行shell函数，您可以使用以下方式指定要执行的shell命令-s。

# bash
hwatch -n 3 -s 'bash -c "source ~/.bashrc"; {COMMAND}' command...

# zsh
hwatch -n 3 -s 'zsh -c "source ~/.zshrc"; {COMMAND}' command...

ANSI颜色代码

如果您想以ANSI颜色代码查看输出，请启用颜色模式。

要启用颜色模式，请使用带有 -c 选项的 hwatch 运行。或者，您可以在执行过程中使用 C 键来启用/禁用颜色模式。

hwatch -n 3 -c command...

diff 查看器

要启用颜色模式，请使用带有 - 选项的 hwatch 运行。

hwatch -n 3 -d command...

hwatch -b command...