🎓 Console Quiz Application

            "Console-based quiz app with categories, leaderboard, timer & color themes 🌈✨"

An interactive command-line quiz game built with Python! Test your knowledge in different categories like Python and General Knowledge.

---

🏄 Features

• Multiple choice questions (MCQs)
• ⏱ Timed input with countdown inputimeout
• 🌈 Colorful console design using colorama
• ✅ Feedback on correct/incorrect answers
• 📂 File handling to persist scores and leaderboard
• 🏆 Leaderboard storing top scores per category 🧠 Multiple categories: Python & General Knowledge
• 🔧 Command-line support using argparse (CLI)
• Highlights player name on leaderboard if in top 3

---

---

💡 Usage

🎮 Run interactively:

python quiz.py

⚙️ Run with command-line arguments:

python quiz.py --name "Alice" --category "Python"

When using --name and --category, the quiz starts immediately without extra prompts.

---

📷 Screenshots

Main Banner

📊 Score Storage

All scores are saved to scores.txt after each quiz attempt.
To see how the format works without affecting actual data, refer to:

👉 scores_preview.txt

To use it, rename to `scores.txt` locally. It is `.gitignored` to avoid uploading real user data

---

📁 File Structure

quiz-app-pract/
├── quiz.py                    # Main Python file
├── scores.txt                 # Persistent leaderboard data ----- #ignored
├── python_questions.txt       # Category: Python
├── general_knowledge_questions.txt  # Category: GK
├── .gitignore
├── README.md
└── requirements.txt           # List of dependencies (optional)

---

📜 License

This project is licensed under the MIT License. See [LICENSE](LICENSE) for more information.

🌱 Development

If you want to experiment or add new features:

1. Create a new branch:

git checkout -b feature/new-mode

2. Make your changes, commit, and push:

git add .
git commit -m "Add new game mode"
git push origin feature/new-mode

3. Create a pull request on GitHub to merge your changes.

---

🙌 Contributions

Ideas, suggestions, and contributions are welcome! You can fork this repo, improve features, or open issues if you find bugs.

---

Happy Quizzing! 🎉

👩‍💻 Made with ❤️ by garima