Skip to content

README.md

Latest commit

 

History

History
60 lines (40 loc) · 1.31 KB

README.md

File metadata and controls

60 lines (40 loc) · 1.31 KB

🈶 Japanese Kana Quiz (CLI)

A simple command-line Japanese Kana quiz built using Python.
This project helps practice both Hiragana and Katakana by testing your romaji knowledge with real-time feedback and scoring.

🚀 Features

  • Main menu navigation:
    • h → Hiragana quiz
    • k → Katakana quiz
    • q → Quit program
  • Random Hiragana and Katakana questions
  • Includes dakuten / handakuten characters (e.g., が / ぱ, ガ / パ)
  • Instant feedback (correct / incorrect)
  • Score tracking
  • Accuracy calculation
  • Input validation (prevents empty answers)
  • Option to quit quiz anytime (q returns to menu)
  • Colored terminal output using colorama

⚒️ Requirements

  • Python 3.x
  • colorama

Install dependency:

pip install colorama

🧠 What I Learned

  • Using dictionaries for mapping data
  • "Random" Module
  • Loop-based program flow (while True)
  • Function-based code reuse for multiple quiz modes
  • Building a simple CLI menu system
  • Input handling and validation
  • Score tracking and accuracy calculation
  • Improving CLI UX using colors

⚠️ Limitations

  • CLI only (no GUI)

📌 Project Level

Beginner → Early Intermediate

⭐️ This project is part of my Python and Japanese learning journey.💙💙💙