dirpulse
| Crates.io | dirpulse |
| lib.rs | dirpulse |
| version | 0.1.0 |
| created_at | 2025-12-25 15:36:35.773097+00 |
| updated_at | 2025-12-25 15:36:35.773097+00 |
| description | A CLI tool to analyze directory contents and report file statistics |
| homepage | |
| repository | https://github.com/bradleyd/dirpulse |
| max_upload_size | |
| id | 2004666 |
| size | 29,063 |
Bradley D Smith (bradleyd)
documentation
README
dirpulse
A CLI tool that analyzes directory contents and reports statistics about files, including size distribution, file types, and age.
Features
- Total file and directory counts with size summaries
- Top N largest files
- File extension breakdown
- File age distribution (fresh, aging, stale)
Installation
From crates.io
cargo install dirpulse
From source
git clone https://github.com/bradleyd/dirpulse
cd dirpulse
cargo install --path .
Usage
# Analyze current directory
dirpulse .
# Analyze a specific directory
dirpulse /path/to/directory
# Show top 20 largest files (default is 10)
dirpulse /path/to/directory -n 20
Example Output
┌──────────────────────────────────────────────────────────────────────────────────────────┐
│ dirpulse · /home/user/projects │
├──────────────────────────────────────────────────────────────────────────────────────────┤
│ 🔴 1.20 GB Stale, 📦 Largest: video.mp4 (800.00 MB), 📊 Top 10 = 45.20% │
└──────────────────────────────────────────────────────────────────────────────────────────┘
📁 1284 files · 89 directories · 4.50 GB total
── Top 10 Largest ────────────────────────────────────────────────────────────
1 800 MB video.mp4
2 450 MB backup.tar.gz
...
── Top 10 Extension ──────────────────────────────────────────────────────────
.rs 342 12.4 MB
.json 128 2.1 MB
...
── File Age ──────────────────────────────────────────────────────────────────
🟢 Fresh (< 30 days) 234 files 1.20 GB
🟡 Aging (30 days - 6 mo) 450 files 2.10 GB
🔴 Stale (> 6 months) 600 files 1.20 GB
License
MIT