3 unstable releases

Uses old Rust 2015

0.2.1 Sep 1, 2018
0.2.0 Aug 23, 2018
0.1.0 Aug 21, 2018

#604 in Command-line interface

36 downloads per month

MIT/Apache

19KB
283 lines

lagraph

Crates.io

lagraph is a command-line utility that can be used to draw a ping graph over time.

Features

  • Bars drawn using Unicode or ASCII character, supporting "half characters" for increased precision
  • True-color output with configurable saturation
  • Setting ping interval and/or count
  • Optional short or long timestamp

Use cases

  • Monitoring your connection quality and stability over time.
    • This is especially useful when using Wi-Fi or mobile connections such as 4G.

Installation

Using cargo

If you already have Rust installed, you can use Cargo to build and install lagraph:

cargo install lagraph

Usage

Use lagraph --help for a full list of command-line options.

Examples

Ping an host at the default interval (0.5 seconds):

lagraph <host>

Ping an host every 5 seconds, displaying a short timestamp on the left:

lagraph -i 5 -t short <host>

Ping an host with a maximum displayable ping value of 100 milliseconds and remove colors from the output:

lagraph -M 100 -C none <host>

Setting true-color output by default

To use true-color output by default, you need to set the environment variable COLORTERM to truecolor. You can make this permanent by adding the following line to your shell startup file (such as ~/.bashrc or ~/.zshrc):

export COLORTERM="truecolor"

On Windows, this can be done using the following commands depending on your shell:

:: cmd.exe (Batch)
set COLORTERM=truecolor
# PowerShell
$env:COLORTERM="truecolor"

Note that not all terminals support true-color terminal output; see this gist for more information. Windows 10 supports true-color terminal output since the Creators Update (version 1703).

License

Copyright © 2018 Hugo Locurcio and contributors

Licensed (at your option) under the MIT or Apache 2.0 license.

Dependencies

~2.5MB
~31K SLoC