ngrv

Crates.iongrv
lib.rsngrv
version
sourcesrc
created_at2025-03-27 03:04:12.292735+00
updated_at2025-03-27 03:04:12.292735+00
descriptionA terminal-based pipe viewer similar to `pv(1)`
homepage
repositoryhttps://github.com/sorairolake/ngrv
max_upload_size
id1607476
Cargo.toml error:TOML parse error at line 24, column 1 | 24 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
Shun Sakai (sorairolake)

documentation

README

ngrv

CI Version MSRV License

ngrv (nagare viewer, 流れビューアー) is a terminal-based tool for monitoring the progress of data through a pipeline written in Rust. It is inspired by pv(1) and can be used for similar purposes, but is not intended as a drop-in replacement for it.

Installation

From source

cargo install ngrv

From binaries

The release page contains pre-built binaries for Linux, macOS and Windows.

How to build

Please see BUILD.adoc.

Usage

Basic usage

To watch the progress of compressing a .gz file:

ngrv archive.tar | gzip > archive.tar.gz

A similar example that read a .tar archive from standard input:

cat archive.tar | ngrv -s 4GiB | gzip > archive.tar.gz

[!TIP] If any inputs are not files or the size of the file cannot be queried, the progress bar will not be shown unless -s is specified.

Generate shell completion

--generate-completion option generates shell completions to standard output.

The following shells are supported:

  • bash
  • elvish
  • fish
  • nushell
  • powershell
  • zsh

Example:

ngrv --generate-completion bash > ngrv.bash

Command-line options

Please see the following:

Source code

The upstream repository is available at https://github.com/sorairolake/ngrv.git.

Changelog

Please see CHANGELOG.adoc.

Contributing

Please see CONTRIBUTING.adoc.

Acknowledgment

This program is inspired by pv.

License

Copyright (C) 2025 Shun Sakai (see AUTHORS.adoc)

  1. This program is distributed under the terms of the GNU General Public License v3.0 or later.
  2. Some files are distributed under the terms of the Creative Commons Attribution 4.0 International Public License.

This project is compliant with version 3.3 of the REUSE Specification. See copyright notices of individual files for more details on copyright and licensing information.

Commit count: 0

cargo fmt