eulumdat-quiz

Python bindings for the eulumdat-rs photometric knowledge quiz engine.

195 multiple-choice questions across 16 categories covering EULUMDAT, IES, photometric calculations, BUG ratings, color science, and more. Fully translated into 8 languages.

Installation

pip install eulumdat-quiz

Command-Line Quiz

After installation, you can run the quiz directly from the command line:

# Text-based interactive quiz
eulumdat-quiz

# Or via Python module
python -m eulumdat_quiz

# Launch the TUI version (requires: cargo install eulumdat-tui-quiz)
python -m eulumdat_quiz --tui

Quick Start

import eulumdat_quiz as quiz

# Browse the question bank
print(f"Total questions: {quiz.QuizBank.total_count()}")
for cat, count in quiz.QuizBank.categories():
    print(f"  {cat.label()}: {count} questions")

# Create a quiz session
config = quiz.QuizConfig(
    categories=[quiz.Category.Symmetry, quiz.Category.BugRating],
    difficulty=quiz.Difficulty.Beginner,
    num_questions=5,
)
session = quiz.QuizSession(config)

# Run through questions
while not session.is_finished():
    q = session.current_question()
    print(f"\n{q.text}")
    for i, opt in enumerate(q.options):
        print(f"  {chr(65+i)}) {opt}")

    choice = int(input("Answer (0-3): "))
    result = session.answer(choice)
    if result.is_correct:
        print("Correct!")
    else:
        print(f"Wrong! Correct answer: {chr(65 + result.correct_index)}")
    print(f"Explanation: {result.explanation}")

# Show final score
score = session.score()
print(f"\nScore: {score.correct}/{score.total} ({score.percentage():.0f}%)")

i18n Support

All questions and UI strings are available in 8 languages.

import eulumdat_quiz as quiz

# Load German translations
locale = quiz.QuizLocale.for_code("de")
print(locale.ui_title())  # "Photometrisches Wissensquiz"

# Get translated question
q = session.current_question()
translated = locale.question(q.id)
if translated:
    print(translated.text)
    for opt in translated.options:
        print(f"  - {opt}")

Supported languages: English, Deutsch, 简体中文, Français, Español, Italiano, Русский, Português (Brasil)

Categories

License

AGPL-3.0-or-later