Dich0tomy/sig

Interactive grep (for streaming)

sig

Interactive grep

Features

• 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.

Installation

Homebrew

brew install ynqa/tap/sigrs

Cargo

cargo install sigrs

Nix (flakes)

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

Nix (classic)

Fetch the source and use it, e.g. in your shell:

let
  pkgs = import <nixpkgs> {};

  sig = pkgs.callPackage (pkgs.fetchFromGitHub {
    owner = "ynqa";
    repo = "sig";
    rev = "v0.1.0";
    hash = "sha256-KHXBeQFmuA3YO9AN5dkY/fl/z2RdbR6AqSSEGUNrxt4=";
  }) {};
in
  pkgs.mkShell {
    packages = [sig];
  }

Keymap

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

Usage

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