features: ["asciinema"]

🚻👀 vwc

Like wc, but with a live preview output to stderr if it's a tty.

▶️ installing

$ pipx install vwc    # or uvx
$ echo "hey" | vwc -l
1

For faster counting of large streams, install the optional Numba scanner:

pipx install 'vwc[fast]'

The scanner handles line, word, and byte counts in chunks, so progress can appear while a stream contains a very long line. Character and maximum-line-length counts continue through the regular path.

✅ To Do

• Detect platform and mirror it
• Integration tests
  • Create runner
  • Containers
    • GNU
    • BusyBox
    • BSD
  • Coverage
    • Prove it: merge .coverage from containers
    • Write more tests
• Performance tune
  • Evaluate options
    • numba
      • fast on large files
      • slower on small ones, even with cache
      • bulky af
      • difficult to install
    • Cython
      • requires pre-built wheels
      • can we execute without compiler?
    • pypy
      • is this still as good as it used to be?
      • is it more available?
  • Implement one or more of them
  • Add to test suite
• Record asciinema video(s)

💣 Known bugs

• Needs to get text length from a proper API
• BusyBox closes stdin on first ctrl+d, gnu does not
• Performance is terrible since dropping Numba bloat

⚖️ License

WTFP with one additional clause:

• ⛔ Don't blame me

Links

• 🏠 home
• 🐱 github
• 🐍 pypi
• 📖 pydoc