#数据流 #grep #数据流 #命令行 #交互式 #实时 #模式

程序 sigrs

交互式 grep(用于流式处理)

4 个版本

0.1.3 2024年8月5日
0.1.2 2024年6月2日
0.1.1 2024年5月30日
0.1.0 2024年5月25日

命令行工具 中排名 104

Download history 140/week @ 2024-05-20 458/week @ 2024-05-27 76/week @ 2024-06-03 21/week @ 2024-06-10 2/week @ 2024-06-17 154/week @ 2024-08-05

每月下载 154

MIT 许可证

37KB
842 代码行

sig

ci

交互式 grep

sig.gif sig_archived.gif

特性

  • 交互式 grep(用于流式处理)
    • sig 允许用户交互式地搜索(流式)数据,实时更新结果。
  • 重新执行命令
    • 如果指定了 --cmd 而不是将数据管道输入到 sig,则命令会在初始尝试和重试时执行。
    • 此功能旨在解决用户在调整搜索条件时数据流过的问题。换句话说,即使数据已经过去,再次执行命令也可以检索数据以重新评估。
  • 存档模式
    • 在存档模式下,由于通过管道接收的流式数据没有寻址能力,因此无法在不退出进程的情况下向后搜索。因此,在 sig 中,保存了最新的 N 条流式数据条目,可以根据任何给定时刻的键输入切换到可以基于这些 N 条条目进行 grep 搜索的模式。
    • 此外,通过以这种方式启动,还可以搜索诸如文件之类的静态数据。
      • 类似于 ugrep-Q 选项。

安装

Homebrew

brew install ynqa/tap/sigrs

Cargo

cargo install sigrs

Arch Linux

pacman -S sig

Nix (flakes)

将其添加到您的 flake 中作为输入

inputs = {
  sig.url = 'github:ynqa/sig/<optional-ref>'
}

创建一个包含它的 shell

nix shell github:ynqa/sig

或直接运行它

cat README.md | nix run github:ynqa/sig -- --archived

Nix (经典)

获取源代码并使用它,例如在您的 shell 中

let
  # At the time of writing this, pkgs need to be unstable for the package to build properly
  # (requires Rust 1.74, stable has 1.73)
  pkgs = import <nixpkgs-unstable> {};

  sig = pkgs.callPackage (pkgs.fetchFromGitHub {
    owner = "ynqa";
    repo = "sig";
    rev = "<revision, e.g. master/v0.1.0/etc.>";
    hash = ""; # Build first, put proper hash in place
  }) {};
in
  pkgs.mkShell {
    packages = [sig];
  }

示例

stern --context kind-kind etcd |& sig
# or
sig --cmd "stern --context kind-kind etcd" # this is able to retry command by ctrl+r.

存档模式

cat README.md |& sig -a
# or
sig -a --cmd "cat README.md"

快捷键

操作
Ctrl + C 退出 sig
Ctrl + R 如果指定了 --cmd,则重试命令
Ctrl + F 进入存档模式
将光标向左移动一个字符
将光标向右移动一个字符
Ctrl + A 将光标移动到过滤器的开头
Ctrl + E 将光标移动到过滤器的末尾
退格键 删除光标位置处的过滤器字符
Ctrl + U 删除过滤器中的所有字符

(存档模式)

操作
Ctrl + C 退出存档模式
将光标向左移动一个字符
将光标向右移动一个字符
Ctrl + A 将光标移动到过滤器的开头
Ctrl + E 将光标移动到过滤器的末尾
退格键 删除光标位置处的过滤器字符
Ctrl + U 删除过滤器中的所有字符

用法

Interactive grep (for streaming)

Usage: sig [OPTIONS]

Examples:

$ stern --context kind-kind etcd |& sig
Or the method to retry command by pressing ctrl+r:
$ sig --cmd "stern --context kind-kind etcd"

Archived mode:
$ cat README.md |& sig -a
Or
$ sig -a --cmd "cat README.md"

Options:
      --retrieval-timeout <RETRIEVAL_TIMEOUT_MILLIS>
          Timeout to read a next line from the stream in milliseconds. [default: 10]
      --render-interval <RENDER_INTERVAL_MILLIS>
          Interval to render a line in milliseconds. [default: 10]
  -q, --queue-capacity <QUEUE_CAPACITY>
          Queue capacity to store lines. [default: 1000]
  -a, --archived
          Archived mode to grep through static data.
  -i, --ignore-case
          Case insensitive search.
      --cmd <CMD>
          Command to execute on initial and retries.
  -h, --help
          Print help (see more with '--help')
  -V, --version
          Print version

依赖

~16–27MB
~442K SLoC