kazoe 0.2.1

Fast wc replacement
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

# kazoe

[![Crates.io](https://img.shields.io/crates/v/kazoe)](https://crates.io/crates/kazoe)
[![CI](https://github.com/ConeDjordjic/kazoe/actions/workflows/ci.yml/badge.svg)](https://github.com/ConeDjordjic/kazoe/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

Fast `wc` replacement.

Command: `kz`

## Install

```bash
cargo install kazoe
```

Or from source:
```bash
git clone https://github.com/ConeDjordjic/kazoe
cd kazoe
cargo install --path .
```

## Performance

1GB text file benchmarks:

```
Word count:     21x faster (48ms vs 1.0s)
All counts:     16x faster (63ms vs 1.0s)
Pattern match:  90x faster (32ms vs 2.9s)
Line count:     1.7x faster (32ms vs 56ms)
Multi-file:     23x faster (86ms vs 2.0s)
```

- Files < 512KB: sequential, similar to wc
- Files > 1GB: 15-90x faster

## Usage

```bash
kz file.txt              # lines, words, bytes
kz -l file.txt           # lines
kz -w file.txt           # words
kz -c file.txt           # bytes
kz -m file.txt           # characters (UTF-8)
kz -L file.txt           # max line length
kz -lwc file.txt         # combine flags
kz -w *.txt              # multiple files
cat file.txt | kz -w     # stdin
kz --pattern "foo" file  # count pattern
```

## Options

```
-l, --lines              line count
-w, --words              word count
-c, --bytes              byte count
-m, --chars              character count (UTF-8)
-L, --max-line-length    longest line
-r, --recursive          recurse directories
-v, --verbose            show warnings
--unique                 unique word count
--pattern <PAT>          count pattern occurrences
--stats                  show statistics (mean, median, std dev)
--histogram              line length distribution
--json                   JSON output
--timing                 show processing time
--progress               show progress
--fast                   skip UTF-8 validation
--code                   skip comments (// /* # -- """)
--markdown               skip code blocks
--exclude <PAT>          exclude files matching pattern
--encoding <ENC>         force encoding (auto-detects otherwise)
--files0-from <FILE>     read null-terminated filenames
--generate-completion    shell completions (bash/zsh/fish/powershell)
```

## Examples

```bash
# Recursive with exclusions
kz -r --exclude "*.min.js" --exclude "node_modules/*" src/

# Statistics
kz --stats file.txt

# JSON output with timing
kz --json --timing file.txt

# Code lines only (skip comments)
kz --code -l src/*.rs

# Markdown text only (skip code blocks)
kz --markdown -w README.md

# Force encoding
kz --encoding iso-8859-1 legacy.txt

# Progress for large operations
kz --progress -r ~/projects/
```

## Shell Completions

```bash
kz --generate-completion bash > ~/.local/share/bash-completion/completions/kz
kz --generate-completion zsh > ~/.zfunc/_kz
kz --generate-completion fish > ~/.config/fish/completions/kz.fish
```

## Implementation

- Parallel processing (Rayon, 1MB chunks)
- Memory-mapped I/O
- SIMD pattern matching (memchr)
- UTF-8 aware with proper chunk boundaries
- Unicode whitespace detection
- CRLF normalization
- Encoding detection and conversion
- Binary file detection

## License

MIT