pc - Change Calculator for the Terminal

pc is a lightweight, blazing-fast tool that simplifies both the calculation and the understanding of differences between numbers. It allows you to quickly evaluate performance changes and offers meaningful human-formatted output, all within the convenience of your terminal.

✨ Features

• 🔥 Fashionable Output: Human readable, colorful, and easy to understand
• 🎯 Always Accurate: Calculates percent change correctly every time
• 🚀 Blazing Fast: Don't wait, get your results instantly
• ❤️ Zig-Powered: Crafted with love using Zig

🛠️ Usage

💻 Basic Calculation

Compute percentage changes and differences effortlessly:

❯ pc 18024 19503 11124 12321 340200 424212 1000000000
↑    8.21%  1.08x  [ 17.60KiB → 19.05KiB ]
↓   -43.0%  0.57x  [  19.0KiB → 10.9KiB  ]
↑    10.8%  1.11x  [  10.9KiB → 12.0KiB  ]
↑    2661%  27.6x  [    12KiB → 332KiB   ]
↑    24.7%  1.25x  [ 332.2KiB → 414.3KiB ]
↑  235631%  2357x  [   414KiB → 954MiB   ]

🎓 Friendly Sizes by Default

Large numbers are automatically translated into familiar sizes like GiB, MiB, KiB:

❯ pc 1124122523 2421252122
↑  115.4%  2.15x  [ 1.0GiB → 2.3GiB ]

Need raw numbers? Use the -r option:

❯ pc 1124122523 2421252122 -r
↑  115.4%  2.15x  [ 1124122496 → 2421252096 ]

🔀 Flexibility with Delimiters

By default, pc tokenizes the input with the default delimiters ( \n\t\r,;:|). Use the --delimiters or -d option to specify additional delimiters:

❯ echo "15@20@3 6" | pc -d "@"
↑  33.3%  1.33x  [ 15 → 20 ]
↓   -85%  0.15x  [ 20 → 3  ]
↑   100%     2x  [  3 → 6  ]

📐 Fixed Calculation

Use the --fixed or -f flags to evaluate changes relative to a specific reference point in your series. You can specify positive or negative indices to choose the reference number.

Evaluate changes relative to the first number (default):

❯ pc 1 2 3 4 -f
↑  100%  2x  [ 1 → 2 ]
↑  200%  3x  [ 1 → 3 ]
↑  300%  4x  [ 1 → 4 ]

Or choose a different reference point (one-based):

❯ pc 1 2 3 4 -f 2
↓  -50%  0.50x  [ 2 → 1 ]
↑   50%  1.50x  [ 2 → 3 ]
↑  100%     2x  [ 2 → 4 ]

Or index from the end of the series with negative numbers:

❯ pc 1 2 3 4 -f -1
↓  -75%  0.25x  [ 4 → 1 ]
↓  -50%  0.50x  [ 4 → 2 ]
↓  -25%  0.75x  [ 4 → 3 ]

📄 Output Formats

Specify the output format with the --format option. Currently, pc supports the following formats:

• Human-readable (default)
• JSON
• CSV

JSON Output

❯ pc 18024 19503 --format json | jq
[
  {
    "percent": 8.20572566986084,
    "times": 1.082057237625122,
    "prev": 18024,
    "cur": 19503
  }
]

CSV Output

❯ pc 18024 19503 --format csv
percent,times,prev,cur
8.20572566986084,1.082057237625122,18024,19503

For the full command list, simply run:

pc --help

📥 Installation

Prebuilt Binaries Available

Find them on the releases page.

Supported Releases

• Linux: aarch64-linux-pc, riscv64-linux-pc, x86_64-linux-pc
• macOS: aarch64-macos-pc
• Windows: x86_64-windows-pc.exe

Installation Example for Linux (x86_64)

wget -O pc https://github.com/cgbur/pc/releases/latest/download/x86_64-linux-pc
chmod +x pc
mv pc ~/.local/bin/pc

Replace the file name in the URL with the corresponding one for other Linux architectures.

Build from Source

To build from source, you'll need Zig:

git clone https://github.com/cgbur/pc.git
cd pc
zig build -Doptimize=ReleaseSafe
cp zig-out/bin/pc ~/.local/bin/pc

📝 Future Plans

• Think of more features to add