quizzy 0.4.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

quizzy/app.py

@@ -189,7 +189,7 @@ class QuestionButton(widgets.Button):
         def wait_for_result(team: QuestionScreenResult) -> None:
             if team is None:
                 return
-            # First, disable the button to prevent multiple clicks
+
             self.disabled = True
             self.question.answered = True
             if isinstance(team, NoCorrectAnswerType):
@@ -244,8 +244,17 @@ class QuizzyApp(app.App[None]):
 
 
 def get_arg_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(prog=__name__.split(".")[0], description="A terminal quiz app")
+    parser = argparse.ArgumentParser(
+        prog=__name__.split(".")[0],
+        description="A quiz app to run in the terminal or the browser",
+        epilog=(
+            "When an unfinished quiz is closed, the state is saved to a timestamped quiz file in the current working "
+            "directory."
+        ),
+    )
+
     parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    parser.add_argument("--dump-state-on-exit", action="store_true", help="Dump game state on exit")
 
     serve_group = parser.add_argument_group("Serve options")
     serve_group.add_argument("--serve", action="store_true", help="Serve the app through the browser")
@@ -256,18 +265,43 @@ def get_arg_parser() -> argparse.ArgumentParser:
     return parser
 
 
+def serve_app(host: str, port: int) -> None:
+    """Serve the app through textual-serve.
+
+    :param host: Host to serve the app on
+    :param port: Port to serve the app on
+    """
+    # The --serve flag is set, drop it from the args and serve the app instead through textual-serve
+    args = list(sys.argv)
+    args.remove("--serve")
+
+    server.Server(shlex.join(args), host=host, port=port).serve()
+
+
+def run_app(quiz_file: pathlib.Path, dump_state_on_exit: bool = False) -> None:
+    """Run the app in the terminal.
+
+    :param quizfile: File to use for this quiz
+    """
+    try:
+        config = models.load_config(quiz_file)
+    except Exception as e:
+        print(f"Error loading quiz file: {e}", file=sys.stderr)
+        sys.exit(1)
+    app = QuizzyApp(config)
+    try:
+        app.run()
+    finally:
+        if dump_state_on_exit:
+            models.dump_config_if_not_finished(config)
+
+
 def main() -> NoReturn:
     parser = get_arg_parser()
     namespace = parser.parse_args()
 
     if namespace.serve:
-        # The --serve flag is set, drop it from the args and serve the app instead through textual-serve
-        args = list(sys.argv)
-        args.remove("--serve")
-
-        server.Server(shlex.join(args), host=namespace.host, port=namespace.port).serve()
+        serve_app(namespace.host, namespace.port)
     else:
-        config = models.load_config(namespace.quizfile)
-        app = QuizzyApp(config)
-        app.run()
+        run_app(namespace.quizfile, namespace.dump_state_on_exit)
     sys.exit(0)

quizzy/models.py

@@ -1,8 +1,11 @@
 from __future__ import annotations
 
+import datetime
+import json
 import pathlib
-from typing import Self
+from typing import Annotated, Any, Self
 
+import pydantic
 import yaml
 from pydantic import Field, model_validator
 from pydantic.dataclasses import dataclass
@@ -21,12 +24,20 @@ class Team:
         return self.name
 
 
+def is_multiple_of_100(v: int) -> int:
+    if v % 100 != 0:
+        raise ValueError("Value must be a multiple of 100")
+    return v
+
+
 @dataclass
 class Question:
-    question: str
-    answer: str
-    value: int = Field(gt=0)
-    answered: bool = False
+    question: str = Field(description="The question to ask. Markdown is supported.")
+    answer: str = Field(description="The answer to the question. Markdown is supported.")
+    value: Annotated[int, pydantic.AfterValidator(is_multiple_of_100)] = Field(
+        gt=0, description="The value of the question in points. Must be a multiple of 100."
+    )
+    answered: bool = Field(default=False, description="Whether the question has been answered already.")
 
     def __str__(self) -> str:
         return self.question
@@ -34,8 +45,8 @@ class Question:
 
 @dataclass
 class Category:
-    name: str
-    questions: list[Question] = Field(max_length=5)
+    name: str = Field(description="The name of the category.")
+    questions: list[Question] = Field(max_length=5, description="The questions in this category.")
 
     @model_validator(mode="after")
     def sort_questions(self) -> Self:
@@ -47,13 +58,46 @@ class Category:
 
 @dataclass
 class Config:
-    categories: list[Category] = Field(max_length=5)
-    teams: list[Team] = Field(default=[Team("Team 1"), Team("Team 2")])
-    # TODO: Support random questions
+    categories: list[Category] = Field(max_length=5, description="The categories in the quiz.")
+    teams: list[Team] = Field(default=[Team("Team 1"), Team("Team 2")], description="The teams in the quiz.")
 
+    def is_finished(self) -> bool:
+        for category in self.categories:
+            for question in category.questions:
+                if not question.answered:
+                    return False
+        return True
 
-def load_config(path: pathlib.Path) -> Config:
+
+def _get_dict(path: pathlib.Path) -> dict[str, Any]:
+    """Get the dictionary from a file.
+
+    :param path: Path of the file to load.
+    :raises ValueError: Raised if the file format is not supported.
+    :return: Dictionary with the contents of the file.
+    """
     with path.open() as f:
-        raw = yaml.safe_load(f)
+        if path.suffix == ".json":
+            return json.load(f)
+        if path.suffix in {".yml", ".yaml"}:
+            return yaml.safe_load(f)
+        raise ValueError(f"Unsupported file format: {path.suffix}")
 
+
+def load_config(path: pathlib.Path) -> Config:
+    raw = _get_dict(path)
     return Config(**raw)
+
+
+def dump_config_if_not_finished(config: Config) -> None:
+    """Dump the config if any of the questions is not answered yet.
+
+    :param config: _description_
+    """
+    if config.is_finished():
+        return
+    p = pathlib.Path() / f"quizzy-run-{datetime.datetime.now().strftime('%Y%m%d-%H%M%S')}.json"
+    print(f"This quiz is not finished yet. Saving current state to '{p}'.")
+    print("This file can be re-used later.")
+    with p.open("wb") as f:
+        f.write(pydantic.TypeAdapter(Config).dump_json(config))

{quizzy-0.4.0.dist-info → quizzy-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quizzy
-Version: 0.4.0
+Version: 0.6.0
 Summary: A Python TUI quiz app
 Author-email: Jonas Ehrlich <jonas.ehrlich@gmail.com>
 License-Expression: MIT
@@ -16,7 +16,7 @@ Description-Content-Type: text/markdown
 
 A quiz app using [textual](https://textual.textualize.io/).
 
-![Question board](assets/question-board.png)
+![Question board](assets/game.gif)
 
 ## Configuration and Questions
 

quizzy-0.6.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+quizzy/__init__.py,sha256=IILIKzO2OO60Rhsh3SqhdKHDf7XI_RLRwzztBGZZmHY,78
+quizzy/__main__.py,sha256=GiZpRpqbaOVG0pDtJswF_VsLByVFP2VMhHgm0Lm0LWw,36
+quizzy/app.py,sha256=gO5aGchsu9PLjepdrgcaglHbo2Wc_1B-AFOszpjU--A,11086
+quizzy/models.py,sha256=CxWOvAi5TbZZK76-aKRIPZhrDbHNM4U3tcrZaQ7xCJs,3189
+quizzy/quizzy.tcss,sha256=VcPEGQ1J7oGatPf3kB-Hzo9AHQdrI7cOV8hDT_l9-3A,1810
+quizzy-0.6.0.dist-info/METADATA,sha256=ffwK69fcadxDA5KDfIcdO_OMfKedgPT9y6s6jZ5ASVU,1598
+quizzy-0.6.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+quizzy-0.6.0.dist-info/entry_points.txt,sha256=2RiVMgcS4h7TM59u9dyBQFm53cG6Eyekmb8fqZ5rXHM,48
+quizzy-0.6.0.dist-info/licenses/LICENSE,sha256=JWN3MACgsucm6y_rlL_2MUzst0-wNh-Wab3XkxtfVzM,1070
+quizzy-0.6.0.dist-info/RECORD,,

quizzy-0.4.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-quizzy/__init__.py,sha256=IILIKzO2OO60Rhsh3SqhdKHDf7XI_RLRwzztBGZZmHY,78
-quizzy/__main__.py,sha256=GiZpRpqbaOVG0pDtJswF_VsLByVFP2VMhHgm0Lm0LWw,36
-quizzy/app.py,sha256=K1f0_wzcoAsTHbu4VPxKqIdb-j5rrLawWkR1Ez9PD-s,10173
-quizzy/models.py,sha256=JrAc2IvtXByIKNg_lX7uQMK19zwi2WsYcNbttXccbOs,1265
-quizzy/quizzy.tcss,sha256=VcPEGQ1J7oGatPf3kB-Hzo9AHQdrI7cOV8hDT_l9-3A,1810
-quizzy-0.4.0.dist-info/METADATA,sha256=lk2-Z9mhWOUrVla4dbrC5VmFshu4Z8KXIMmbjhYww44,1608
-quizzy-0.4.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-quizzy-0.4.0.dist-info/entry_points.txt,sha256=2RiVMgcS4h7TM59u9dyBQFm53cG6Eyekmb8fqZ5rXHM,48
-quizzy-0.4.0.dist-info/licenses/LICENSE,sha256=JWN3MACgsucm6y_rlL_2MUzst0-wNh-Wab3XkxtfVzM,1070
-quizzy-0.4.0.dist-info/RECORD,,