quizzy 0.3.1__tar.gz → 0.4.0__tar.gz

{quizzy-0.3.1 → quizzy-0.4.0}/CHANGELOG.md

@@ -1,6 +1,10 @@
 
 # Changelog
 
+## v0.4.0
+
+* Add `--serve` flag to serve the application in a browser
+
 ## v0.3.1
 
 * Fixed the lockfile for this version

{quizzy-0.3.1 → quizzy-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quizzy
-Version: 0.3.1
+Version: 0.4.0
 Summary: A Python TUI quiz app
 Author-email: Jonas Ehrlich <jonas.ehrlich@gmail.com>
 License-Expression: MIT
@@ -8,6 +8,7 @@ License-File: LICENSE
 Requires-Python: >=3.10
 Requires-Dist: pydantic>=2.10.3
 Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: textual-serve>=1.1.1
 Requires-Dist: textual>=1.0.0
 Description-Content-Type: text/markdown
 
@@ -63,7 +64,7 @@ uv run quizzy examples/quizzy.yaml
 Serve on a webserver using textual:
 
 ``` sh
-uv run textual serve "uv run quizzy examples/quizzy.yaml"
+uvx quizzy --serve examples/quizzy.yaml
 ```
 
 Run in development mode:

{quizzy-0.3.1 → quizzy-0.4.0}/README.md

@@ -50,7 +50,7 @@ uv run quizzy examples/quizzy.yaml
 Serve on a webserver using textual:
 
 ``` sh
-uv run textual serve "uv run quizzy examples/quizzy.yaml"
+uvx quizzy --serve examples/quizzy.yaml
 ```
 
 Run in development mode:

{quizzy-0.3.1 → quizzy-0.4.0}/pyproject.toml

@@ -1,12 +1,17 @@
 
 [project]
 name = "quizzy"
-version = "0.3.1"
+version = "0.4.0"
 description = "A Python TUI quiz app"
 authors = [{ name = "Jonas Ehrlich", email = "jonas.ehrlich@gmail.com" }]
 readme = "README.md"
 requires-python = ">=3.10"
-dependencies = ["pydantic>=2.10.3", "pyyaml>=6.0.2", "textual>=1.0.0"]
+dependencies = [
+    "pydantic>=2.10.3",
+    "pyyaml>=6.0.2",
+    "textual-serve>=1.1.1",
+    "textual>=1.0.0",
+]
 license = "MIT"
 
 [project.scripts]

quizzy-0.4.0/quizzy/__main__.py

@@ -0,0 +1,3 @@
+from quizzy.app import main
+
+main()

{quizzy-0.3.1 → quizzy-0.4.0}/quizzy/app.py

@@ -2,22 +2,18 @@ from __future__ import annotations
 
 import argparse
 import pathlib
+import shlex
+import sys
+from typing import NoReturn
 
 from textual import app, binding, containers, log, message, reactive, screen, widgets
+from textual_serve import server
 
 from quizzy import __version__, models
 
 NoCorrectAnswerType = type("NoCorrectAnswerType", (object,), {})
 NoCorrectAnswer = NoCorrectAnswerType()
 
-
-def get_arg_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(prog=__name__.split(".")[0], description="A terminal quiz app")
-    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
-    parser.add_argument("quizfile", type=pathlib.Path, help="Quiz file")
-    return parser
-
-
 QuestionScreenResult = models.Team | NoCorrectAnswerType | None
 
 
@@ -230,12 +226,9 @@ class QuestionBoard(containers.HorizontalGroup):
 class QuizzyApp(app.App[None]):
     CSS_PATH = "quizzy.tcss"
 
-    def __init__(self) -> None:
+    def __init__(self, config: models.Config) -> None:
         super().__init__()
-        parser = get_arg_parser()
-        namespace = parser.parse_args()
-
-        self.config = models.load_config(namespace.quizfile)
+        self.config = config
         self.scoreboard_widget = Scoreboard(self.config.teams)
 
     def compose(self) -> app.ComposeResult:
@@ -248,3 +241,33 @@ class QuizzyApp(app.App[None]):
 
     def on_mount(self) -> None:
         self.theme = "textual-light"
+
+
+def get_arg_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog=__name__.split(".")[0], description="A terminal quiz app")
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+
+    serve_group = parser.add_argument_group("Serve options")
+    serve_group.add_argument("--serve", action="store_true", help="Serve the app through the browser")
+    serve_group.add_argument("--host", default="localhost", help="Host to serve the app on")
+    serve_group.add_argument("--port", type=int, default=8000, help="Port to serve the app on")
+
+    parser.add_argument("quizfile", type=pathlib.Path, help="Quiz file")
+    return parser
+
+
+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()
+    else:
+        config = models.load_config(namespace.quizfile)
+        app = QuizzyApp(config)
+        app.run()
+    sys.exit(0)

{quizzy-0.3.1 → quizzy-0.4.0}/uv.lock

@@ -840,12 +840,13 @@ wheels = [
 
 [[package]]
 name = "quizzy"
-version = "0.3.1"
+version = "0.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "pydantic" },
     { name = "pyyaml" },
     { name = "textual" },
+    { name = "textual-serve" },
 ]
 
 [package.dev-dependencies]
@@ -863,6 +864,7 @@ requires-dist = [
     { name = "pydantic", specifier = ">=2.10.3" },
     { name = "pyyaml", specifier = ">=6.0.2" },
     { name = "textual", specifier = ">=1.0.0" },
+    { name = "textual-serve", specifier = ">=1.1.1" },
 ]
 
 [package.metadata.requires-dev]

quizzy-0.3.1/quizzy/__main__.py

@@ -1,9 +0,0 @@
-from quizzy.app import QuizzyApp
-
-
-def main() -> None:
-    QuizzyApp().run()
-
-
-if __name__ == "__main__":
-    main()