# xwc
`xwc` is a small `wc`-style command line tool for counting lines, bytes, and optionally words.
By default it prints line and byte counts with headings:
```console
$ printf 'one two\nthree\n' | xwc
lines bytes
2 14
```
## Usage
```console
$ xwc [OPTIONS] [FILE]...
```
When no files are provided, `xwc` reads from standard input. Use `-` as a file argument to read from standard input alongside file paths.
Options:
- `-l`, `--lines`: print only the newline count.
- `-c`, `--bytes`: print only the byte count.
- `-w`, `--words`: print only the word count.
- `-W`, `--include-words`: include the word count in the default output columns (slower).
- `-h`, `--human-readable`: print byte counts with human-readable units and use the `size` heading.
- `-j`, `--jobs <N>`: set the worker count for multiple input files. By default, `xwc` starts parallel counting after 3 input files.
- `--glob <PATTERN>`: add files matching a glob pattern. Can be used more than once.
- `--help`: print help.
Examples:
```console
$ xwc Cargo.toml src/main.rs
lines bytes file
8 174 Cargo.toml
420 10324 src/main.rs
428 10498 total
$ xwc --include-words Cargo.toml
lines words bytes file
8 24 174 Cargo.toml
$ xwc -hc Cargo.toml
174B Cargo.toml
$ xwc --glob 'src/*.rs'
lines bytes file
216 5266 src/lib.rs
613 15509 src/main.rs
829 20775 total
```
## Development
Run the binary through Cargo:
```console
$ cargo run -- [OPTIONS] [FILE]...
```
Or use the Just proxy recipe:
```console
$ just xwc --include-words Cargo.toml
```
Common development recipes:
```console
$ just fmt
$ just check
$ just test-no-coverage
```