# rgrc - Rusty Generic Colouriser
[](https://www.rust-lang.org/)
[](https://opensource.org/licenses/MIT)
A fast, Rust-based command-line tool that colorizes the output of other commands using regex-based rules with advanced count/replace functionality, similar to the classic `grc` (Generic Colouriser) utility.
**Latest Features**: Full implementation of count/replace functionality with backreference support, advanced matching controls (once/more/stop), and optimized performance with intelligent caching.
## Features
- 🚀 **High Performance**: Written in Rust with optimized regex-based colorization
- 🎨 **Rich Colorization**: Supports ANSI colors, styles, and attributes with count/replace functionality
- 🔧 **Flexible Configuration**: Compatible with grc/grcat configuration files
- 🐚 **Shell Integration**: Generates aliases for popular commands
- 📖 **Comprehensive**: Supports 80+ pre-configured commands
- ⚡ **Advanced Matching**: Regex-based rules with intelligent caching, pattern optimization, and advanced count/replace controls
- 🔄 **Text Transformation**: Replace matched text with backreference support for output modification
## Quick Start
### Installation
#### From Source
```bash
git clone https://github.com/lazywalker/rgrc.git
cd rgrc
make release
sudo make install
```
#### Using Cargo
```bash
cargo install rgrc
```
### Basic Usage
```bash
# Colorize ping output
rgrc ping -c 4 google.com
# Colorize ls output
rgrc ls -la
# Colorize any command
rgrc df -h
```
### Generate Shell Aliases
```bash
# Show aliases for supported commands
rgrc --aliases
# Generate aliases for all known commands
rgrc --all-aliases
# Add to your shell profile
echo 'eval "$(rgrc --aliases)"' >> ~/.bashrc
```
## Configuration
### Configuration Files
rgrc reads configuration from multiple locations:
```
~/.rgrc # User-specific config
~/.config/rgrc/rgrc.conf # XDG config location
/usr/local/etc/rgrc.conf # System-wide config
/etc/rgrc.conf # Fallback system config
```
### grcat Compatibility
rgrc is fully compatible with grc/grcat configuration files:
```
~/.config/rgrc/ # rgrc-specific configs
~/.local/share/rgrc/ # User share directory
/usr/local/share/rgrc/ # Local share directory
/usr/share/rgrc/ # System share directory
~/.config/grc/ # grc compatibility
~/.local/share/grc/ # grc compatibility
/usr/local/share/grc/ # grc compatibility
/usr/share/grc/ # grc compatibility
```
### Supported Commands
rgrc comes with pre-configured colorization rules for 80+ commands:
**System Monitoring**: `df`, `free`, `ps`, `top`, `vmstat`, `iostat`
**Network Tools**: `ping`, `traceroute`, `netstat`, `ss`, `ip`, `curl`
**Development**: `gcc`, `make`, `docker`, `kubectl`, `git`
**File Operations**: `ls`, `find`, `du`, `mount`, `fdisk`
**And many more...**
## Command Line Options
```
Usage: rgrc [OPTIONS] COMMAND [ARGS...]
Options:
--help Show help message
--aliases Generate shell aliases for supported commands
--all-aliases Generate aliases for all known commands
--except=CMD,... Exclude commands from alias generation
## Examples
### Basic Colorization
```bash
# Colorize ping output
rgrc ping -c 4 8.8.8.8
# Colorize disk usage
rgrc df -h
# Colorize compilation output
rgrc make
# Colorize Docker commands
rgrc docker ps
rgrc docker logs mycontainer
```
### Advanced Usage
```bash
# Force color output
rgrc --color=on ls -la
# Disable colors
rgrc --color=off ps aux
# Generate aliases for specific commands
# Exclude certain commands from aliases
rgrc --all-aliases --except=docker,kubectl
```
### Shell Integration
```bash
# Bash
echo 'eval "$(rgrc --aliases)"' >> ~/.bashrc
# Zsh
echo 'eval "$(rgrc --aliases)"' >> ~/.zshrc
# Fish
rgrc --aliases > ~/.config/fish/conf.d/rgrc.fish
```
## Configuration Examples
### Custom Command Configuration
Create `~/.config/rgrc/conf.mycommand`:
```
regexp=^ERROR
colours=red,bold
regexp=^WARNING
colours=yellow
regexp=^INFO
colours=green
```
### Advanced Matching Control
Use `count` and `replace` fields for sophisticated pattern matching:
```
# Match only once per line
regexp=^\s*#
colours=cyan
count=once
# Replace matched text
replace=\1:
# Stop processing after first match
regexp=^FATAL
colours=red,bold
count=stop
```
**Count Options:**
- `once`: Match only the first occurrence per line
- `more`: Match all occurrences (default)
- `stop`: Match first occurrence and stop processing the line
**Replace Field:**
- Supports backreferences (`\1`, `\2`, etc.)
- Empty string removes matched text
- Can transform output content
### Extending Existing Commands
Add rules to `~/.rgrc`:
```
# Custom rules for existing commands
regexp=^CUSTOM
colours=blue,underline
```
## Performance
- **Optimized Processing**: High-performance single-threaded colorization with intelligent caching and match result reuse
- **Zero-copy Operations**: Efficient memory usage with minimal allocations and streaming I/O
- **Regex Optimization**: Uses fancy-regex with advanced pattern matching, backtracking control, and result caching
- **ANSI Optimization**: Merges adjacent styles using run-length encoding to reduce escape sequences
- **Count/Replace Support**: Advanced matching control with text substitution capabilities and line reprocessing
- **Parallel Processing**: Optional multi-threaded processing for large inputs with automatic fallback
## Development
### Building from Source
```bash
# Clone repository
git clone https://github.com/lazywalker/rgrc.git
cd rgrc
# Build debug version
cargo build
# Build release version
cargo build --release
# Run tests
cargo test
# Generate documentation
cargo doc --open
```
### Project Structure
```
rgrc/
├── src/
│ ├── main.rs # CLI entry point
│ ├── lib.rs # Core library
│ ├── grc.rs # Configuration parsing
│ └── colorizer.rs # Colorization engine
├── doc/
│ └── rgrc.1.md # Manual page (markdown)
├── share/ # Pre-configured rules
├── etc/ # Shell completions
└── tests/ # Test files
```
### Contributing
1. Fork the repository
2. Create a feature branch: `git checkout -b feature-name`
3. Make your changes and add tests
4. Run tests: `cargo test`
5. Submit a pull request
## Compatibility
- **Operating Systems**: Linux, macOS, Windows (with WSL)
- **Shells**: Bash, Zsh, Fish, and others supporting ANSI escape sequences
- **Terminals**: Any ANSI-compatible terminal with 256-color support
- **grc Compatibility**: Drop-in replacement for grc with enhanced count/replace functionality and improved performance
- **Configuration Files**: Fully compatible with existing grc/grcat configuration files and directory structures
## License
MIT License - see [LICENSE](LICENSE) file for details.
## Credits
- Inspired by the original `grc` (Generic Colouriser) by Radovan Garabík, `grc-rs` by Lars Christensen
- Built with [Rust](https://www.rust-lang.org/) and [console](https://crates.io/crates/console)
## Related Projects
- [grc](https://github.com/garabik/grc) - Original Generic Colouriser (Python)
- [grc-rs](https://github.com/larsch/grc-rs) - Generic Colouriser in Rust (Rust)
- [lolcat](https://github.com/busyloop/lolcat) - Rainbow coloring tool
- [bat](https://github.com/sharkdp/bat) - A cat clone with syntax highlighting