README.md

# 🚀 Go CLI Tool v3.0 - RSK World

A premium, powerful command-line interface tool built with Go. Features comprehensive file operations, text processing, cryptographic tools, system monitoring, and much more. Now with enhanced UI/UX, input validation, and advanced features!

## ✨ Key Features

- **🎨 Enhanced UI/UX**: Beautiful colorized output, stylized banners, progress indicators, and consistent error handling.
- **✅ Input Validation**: Robust validation for all inputs including file paths, URLs, and parameters.
- **🐚 Interactive Mode**: Dynamic REPL shell for persistent command execution.
- **📂 Advanced File Operations**: Create, Read, Delete, List, Copy, Move, Search, and detailed statistics.
- **🔍 File Search**: Recursively search for text content within files.
- **🔡 Text Alchemist**: Word counts, casing transformations, text reversal, and Base64 encoding/decoding.
- **🖥️ System Guardian**: Real-time monitoring dashboard with continuous updates and detailed system metrics.
- **🌐 Web & Net Explorer**: IP/DNS lookups and comprehensive HTTP content inspection.
- **🔒 Crypto Vault**: Secure SHA256 hashing for data integrity.
- **📦 Archive Manager**: Zip and Unzip archives with directory support.
- **🖼️ Media Tools**: Image metadata extraction and PNG conversion capabilities.
- **🔢 Data Maestro**: JSON pretty printing and minification.
- **🎲 Randomizer**: Secure password generation and proper UUID v4 creation.
- **📏 Advanced Unit Converter**: Temperature, length, weight, and data size conversions.

## 📥 Installation

```bash
# Requires Go 1.21+
go run main.go help
```

## 🛠️ Usage Examples

### 🐚 Interactive Mode
```bash
go run main.go shell
```

### 🖥️ Real-time Monitoring Dashboard
```bash
go run main.go mon
# Press Ctrl+C to exit
```

### 📂 Advanced File Operations
```bash
# Search for text in files
go run main.go file -search -query "TODO" -dir ./src

# Get detailed file statistics
go run main.go file -stats -name README.md

# List files with details
go run main.go file -list -dir .
```

### 🖼️ Image Processing
```bash
# Get image information
go run main.go img -info -name photo.jpg

# Convert image to PNG
go run main.go img -convert -name input.jpg -output output.png
```

### 📏 Advanced Conversions
```bash
# Temperature conversion
go run main.go conv -val 30 -c2f

# Data size conversion
go run main.go conv -val 1048576 -b2h
go run main.go conv -val 1.5 -h2b -unit GB
```

### 🌐 Web Operations
```bash
# Fetch URL content
go run main.go web -fetch -url https://api.github.com/users/octocat

# Get HTTP headers
go run main.go web -headers -url https://httpbin.org/get
```

### 🎲 Random Generation
```bash
# Generate secure password
go run main.go rand -pass -len 16

# Generate UUID v4
go run main.go rand -uuid
```

## 🚀 Recent Improvements v3.0

- **Fixed Critical Bugs**: Resolved duplicate switch cases and deprecated ioutil usage
- **Enhanced Error Handling**: Consistent, user-friendly error messages with UI package
- **Input Validation**: Comprehensive validation for file paths, URLs, and parameters
- **New File Features**: Added file search and detailed statistics functionality
- **Image Conversion**: Implemented PNG conversion for supported image formats
- **Improved Monitoring**: Continuous real-time dashboard with Ctrl+C graceful exit
- **Better UUID Generation**: Proper RFC 4122 compliant UUID v4 generation
- **Data Size Conversions**: Added bytes to human readable and vice versa
- **Code Modernization**: Updated to use modern Go standard library functions

## 👨‍💻 Author

**RSK World** - [https://rskworld.in/contact.php](https://rskworld.in/contact.php)
Email: support@rskworld.in
Year: 2026
Copyright (c) 2026 RSK World. All rights reserved.
MIT License.