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