Interactive grep
- Interactive grep (for streaming)
- sig allows users to interactively search through (streaming) data, updating results in real-time.
- Archived mode
- In Archived mode, since there is no seeking capability for streaming data received through a pipe, it is not possible to search backwards without exiting the process. Therefore, in sig, the latest N entries of streaming data are saved, and it is possible to switch to a mode where you can grep through these N entries based on key inputs at any given moment.
- Additionally, by starting in this mode, it is also possible to grep through static data such as files.
brew install ynqa/tap/sigrs
cargo install sigrs
Add it as an input to your flake:
inputs = {
sig.url = 'github:ynqa/sig/<optional-ref>'
}
Create a shell with it:
nix shell github:ynqa/sig
Or run it directly:
cat README.md | nix run github:ynqa/sig -- --archived
Fetch the source and use it, e.g. in your 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];
}
Key | Action |
---|---|
Ctrl + C | Exit sig |
Ctrl + F | Enter Archived mode |
← | Move the cursor one character to the left |
→ | Move the cursor one character to the right |
Ctrl + A | Move the cursor to the start of the filter |
Ctrl + E | Move the cursor to the end of the filter |
Backspace | Delete a character of filter at the cursor position |
Ctrl + U | Delete all characters of filter |
(Archived mode)
Key | Action |
---|---|
Ctrl + C | Exit Archived mode |
← | Move the cursor one character to the left |
→ | Move the cursor one character to the right |
Ctrl + A | Move the cursor to the start of the filter |
Ctrl + E | Move the cursor to the end of the filter |
Backspace | Delete a character of filter at the cursor position |
Ctrl + U | Delete all characters of filter |
Interactive grep (for streaming)
Usage: sig [OPTIONS]
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 log line in milliseconds. [default: 10]
-q, --queue-capacity <QUEUE_CAPACITY>
Queue capacity to store the logs. [default: 1000]
--archived
Archived mode to grep through static data.
-h, --help
Print help (see more with '--help')
-V, --version
Print version