README

The magical PHP CLI toolkit - add color, tables, progress bars & ASCII Art to your terminal!

Turn your boring terminal into a magical world!
Add colors, enchanting tables, spellbinding progress bars, and wizardly ASCII art banners to any PHP console application.

✨ Features

• 🌈 Colors & Styles Print colored and styled text in seconds
• 🪄 ASCII Art Wizard banners & magical terminal art
• 📊 Tables Clean, beautiful table rendering for your data
• ⏳ Progress Bars Show task progress with charm and multiple themes
• 🎩 Multiple Themes Wizard, Sorcerer, Dark, Gold & more
• 💎 Modern API Easy to use, works everywhere PHP runs

🚀 Installation

composer require wizardloop/wizardcli

🪄 Quick Example

use WizardCLI\WizardCLI;

require 'vendor/autoload.php';

$cli = new WizardCLI(['theme' => 'wizard']);

$cli->art("WizardCLI"); // Magic banner
$cli->color("Welcome to the magical CLI!", "magenta+bold");
$cli->table(["Name", "Spell"], [
    ["Merlin", "Invisibility"],
    ["Morgana", "Fireball"]
]);
$cli->progressBar(100, "Created By Wizard Loop | @WizardLoop");
for ($i = 1; $i <= 100; $i++) {
    usleep(40000);
    $cli->progressAdvance(); 
}
$cli->progressFinish();

🌟 More Examples

Progress Bar

$cli->progressBar(30, "Brewing potion");
for ($i = 1; $i <= 30; $i++) {
    usleep(40000);
    $cli->progressAdvance();
}
$cli->progressFinish();

ASCII Art

$cli->art("✨ Wizard CLI ✨");

Table

$cli->table(["Wizard", "Power"], [
    ["Gandalf", "Lightning"],
    ["Harry", "Expelliarmus"]
]);

See examples/ for more!

🧪 Run Tests

composer test

🛠️ Contributing

Pull requests, issues, and magical ideas are very welcome!
See CONTRIBUTING.md for details.

🧙‍♂️ Connect

• Telegram: wizardloop.t.me
• GitHub: WizardLoop

📄 License

MIT License
Made with 🪄 by WizardLoop

✨ Time for magic in your terminal! ✨