ls-rs

Crates.iols-rs
lib.rsls-rs
version0.1.4
created_at2025-07-21 14:49:09.094332+00
updated_at2025-08-29 11:08:28.245865+00
descriptionA Rust based colorful ls clone.
homepage
repositoryhttps://github.com/KushalMeghani1644/ls-rs
max_upload_size
id1762133
size59,762
Kushal Meghani (KushalMeghani1644)

documentation

README

ls-rs

A blazing-fast and colorful ls alternative written in Rust 🦀

Easily list directory contents with intuitive color coding, smart formatting, and robust error handling.

✨ Features

  • Color-coded output based on file type:
    • 🔵 Blue: Directories
    • 🔗 Cyan: Symlinks
    • 🟢 Green: Executable files
    • 🟡 Yellow: Image files (jpg, png, gif, etc.)
    • White: Regular files
  • Smart column layout that adapts to your terminal width
  • Hidden file support with -a/--all flag
  • Robust error handling with helpful error messages
  • Fast performance thanks to Rust's zero-cost abstractions
  • Cross-platform compatibility
  • Intuitive sorting: non-hidden files first, case-insensitive alphabetical order

🚀 Installation

From crates.io

cargo install ls-rs

From source

git clone https://github.com/KushalMeghani1644/ls-rs
cd ls-rs
cargo build --release

📖 Usage

# List current directory
ls-rs

# List specific directory
ls-rs /path/to/directory

# Show hidden files
ls-rs -a
ls-rs --all

# Show help
ls-rs -h
ls-rs --help

🎨 Color Scheme

File Type Color Example
Directory Blue Documents/
Symlink Cyan link -> target
Executable Green script.sh
Image Yellow photo.jpg
Regular file White readme.txt

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the GPLv3 License - see the LICENSE file for details.

Commit count: 22

cargo fmt