Skip to content

Latest commit

ย 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
ย 
ย 
ย 
ย 
ย 
ย 

README.md

๐Ÿง  Quiz Application โ€“ Python CLI

๐ŸŽฏ A fun and interactive command-line quiz game built using Python. Challenge yourself with multiple-choice questions, track your score, and receive personalized feedback based on your performance.

๐ŸŒŸ Features

  • โœจ Multiple-Choice Questions โ€“ Every question has 4 possible answers.
  • โœจ Score Tracking โ€“ Calculates and displays your total score.
  • โœจ Performance Feedback โ€“ Get motivational results at the end.
  • โœจ Question Navigation โ€“ Option to move to the next question.
  • โœจ Restart Capability โ€“ Replay the quiz anytime.
  • โœจ Extendable โ€“ Easily add new questions.

๐Ÿ› ๏ธ Tech Stack

Language: Python 3.x

Core Concepts:

  • Classes & Objects
  • Encapsulation
  • User Input Handling
  • Score Calculation

CLI-based User Interface

โšก Installation & Setup

1๏ธโƒฃ Clone the repository:

git clone https://github.com/your-username/quiz-app.git
cd quiz-app

2๏ธโƒฃ Run the program:

python quiz_app.py

โœ… Thatโ€™s it โ€“ your quiz app is ready!

๐ŸŽฎ How to Play

  • The app will display a question with 4 options.
  • Enter your answer (e.g., Paris or 3).
  • After each question, decide whether to continue or stop.
  • At the end, see your score, percentage, and feedback.

๐Ÿ“– Example Gameplay

Question 1: What is the capital of France?
1. London
2. Berlin
3. Paris
4. Madrid
Your answer: 3
Do you want to go to the next question? (y/n): y

Question 2: Which planet is known as the Red Planet?
1. Venus
2. Mars
3. Jupiter
4. Saturn
Your answer: Mars
Do you want to go to the next question? (y/n): y

๐ŸŽ‰ Results Example:

Quiz Completed! ๐ŸŽ‰

You scored 4 out of 5 (80.00%)

Excellent! You are a quiz master! ๐ŸŒŸ

๐Ÿ“‚ Project Structure

quiz-app/
โ”‚โ”€โ”€ quiz_app.py      # Main program file
โ”‚โ”€โ”€ README.md        # Documentation

๐Ÿš€ Future Enhancements

  • ๐Ÿ”น Add timer per question โณ
  • ๐Ÿ”น Randomize question order ๐ŸŽฒ
  • ๐Ÿ”น Load questions from JSON/CSV file ๐Ÿ“‚
  • ๐Ÿ”น Add categories & difficulty levels ๐ŸŽฏ
  • ๐Ÿ”น Create a GUI version (Tkinter / PyQt) ๐Ÿ–ฅ๏ธ
  • ๐Ÿ”น Build a Web App version with Flask/Django ๐ŸŒ

๐Ÿ™Œ Contribution

Contributions are welcome! ๐Ÿš€

Fork the repo ๐Ÿด

Create a new branch ๐ŸŒฑ

Add features / fix bugs ๐Ÿ› ๏ธ

Submit a pull request ๐Ÿ”„

๐Ÿ‘จโ€๐Ÿ’ป Author

Crafted with โค๏ธ by Mantra Patil

๐Ÿ’ก Learning is fun โ€“ keep quizzing yourself!