Minor typing fixes, refactor launcher into its own package

Author: Tremeschin

.github/workflows/website.yml

@@ -18,12 +18,9 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - uses: astral-sh/setup-uv@v7
-
-      - run: ln readme.md website/index.md
-      - run: uvx zensical build
-
+      - run:  ln readme.md website/index.md
+      - run:  uvx zensical build
+      - run:  mv site _site
       - uses: actions/upload-pages-artifact@v4
-        with:
-          path: site
-
       - uses: actions/deploy-pages@v4
+

examples/basic/demo.py

@@ -19,34 +19,34 @@ class Assets:
     @staticmethod
     def street() -> Path:
         import pooch
-        return pooch.retrieve(
+        return Path(pooch.retrieve(
             url="https://w.wallhaven.cc/full/e7/wallhaven-e778vr.jpg",
             known_hash="xxh128:60f452b021f2ccb1e4a06d54bd27959d",
             path=shaderflow.directories.user_data_path,
             progressbar=True,
-        )
+        ))
 
     @staticmethod
     def ethereal() -> Path:
         import pooch
-        return pooch.retrieve(
+        return Path(pooch.retrieve(
             url="https://w.wallhaven.cc/full/ex/wallhaven-ex6kmr.jpg",
             known_hash="xxh128:86ceea1b29cae24b2c3b58d1c6a58c27",
             path=shaderflow.directories.user_data_path,
             progressbar=True,
-        )
+        ))
 
     @staticmethod
     def chungus() -> Path:
         """Big Buck Bunny video (CC BY-SA 3.0)"""
         import pooch
-        return pooch.retrieve(
+        return Path(pooch.retrieve(
             url="https://download.blender.org/demo/movies/BBB/bbb_sunflower_1080p_60fps_normal.mp4.zip",
             known_hash="xxh128:497645dbba6435312c9e5779c9c4cb70",
             path=shaderflow.directories.user_data_path,
             processor=pooch.Unzip(),
             progressbar=True,
-        )[0]
+        )[0])
 
 # ---------------------------------------------------------------------------- #
 
@@ -65,7 +65,7 @@ def build(self):
 # ---------------------------------------------------------------------------- #
 
 class MultiShader(ShaderScene):
-    """Basic scene with two shaders acting together, main shader referencing the child"""
+    """Basic scene with two shaders acting together"""
 
     def build(self):
         self.child = ShaderProgram(scene=self, name="child")
@@ -91,7 +91,7 @@ def build(self):
 # ---------------------------------------------------------------------------- #
 
 class Multipass(ShaderScene):
-    """Many Layers ('Buffers') done on a single shader"""
+    """Multi layers done on a single shader"""
 
     def build(self):
         ShaderTexture(scene=self, name="background").from_image(Assets.street())
@@ -101,7 +101,7 @@ def build(self):
 # ---------------------------------------------------------------------------- #
 
 class MotionBlur(ShaderScene):
-    """Poor's man Motion Blur. If you dislike the effect, definitely don't run this"""
+    """Poor's man Motion Blur"""
 
     def build(self):
         ShaderTexture(scene=self, name="background").from_image(Assets.street())

pyproject.toml

@@ -19,6 +19,7 @@ dependencies = [
     "numpy-quaternion",
     "numpy",
     "ordered-set~=4.1",
+    "parsenaut",
     "pillow",
     "platformdirs~=4.0",
     "pooch~=1.0",

shaderflow/__init__.py

@@ -2,10 +2,10 @@
 
 from importlib.metadata import metadata
 
-__meta__:   dict = metadata(__package__)
-__about__:   str = __meta__.get("Summary")
-__author__:  str = __meta__.get("Author")
-__version__: str = __meta__.get("Version")
+__meta__    = metadata(str(__package__))
+__about__   = __meta__.get("Summary")
+__author__  = __meta__.get("Author")
+__version__ = __meta__.get("Version")
 
 from pathlib import Path
 

shaderflow/__main__.py

@@ -1,12 +1,13 @@
 import sys
 
+from parsenaut._cyclopts import Launcher
+
 import shaderflow
-from shaderflow.launcher import SceneLauncher
 
 
 def main():
-    app = SceneLauncher()
-    app.common(package=shaderflow.package)
+    app = Launcher(keyword="Scene")
+    app.smart(package=shaderflow.package)
     app.cli(sys.argv[1:])
 
 if __name__ == "__main__":

shaderflow/frametimer.py

@@ -25,7 +25,7 @@ def update(self):
         while len(self.frametimes) > self.length:
             self.frametimes.popleft()
 
-    def percent(self, percent: float=1) -> float:
+    def percent(self, percent: float=1) -> np.ndarray:
         cut = int(len(self.frametimes) * (percent/100))
         return np.sort(self.frametimes)[-cut:]
 

shaderflow/launcher.py

@@ -16,6 +16,7 @@
 from cyclopts import App as Cyclopts
 from cyclopts import Parameter
 from imgui_bundle import imgui
+from parsenaut._cyclopts import Launcher
 
 import shaderflow
 from shaderflow import logger
@@ -30,7 +31,6 @@
 from shaderflow.scheduler import Scheduler
 from shaderflow.shader import ShaderProgram
 from shaderflow.temp.imgui_window import ModernglWindowRenderer
-from shaderflow.utils import CycloUtils
 from shaderflow.variable import ShaderVariable, Uniform
 
 if TYPE_CHECKING:
@@ -209,7 +209,7 @@ def __attrs_post_init__(self) -> None:
         self.ffmpeg.cli_vcodecs(self.cli)
         self.ffmpeg.cli_acodecs(self.cli)
         self.cli.command(self.main)
-        CycloUtils.chain(self.cli)
+        Launcher.chain(self.cli)
 
     # -------------------------------------------------------------------------|
     # Temporal

shaderflow/scene.py

@@ -11,6 +11,7 @@ icon: material/file-document-edit
     - Move website to tremeschin.com domain
     - Fix `Scene.resolution = (w, h)` using positionals in `Scene.resize`
     - Simplify remove `scene._scale` field in favor of `.main()` or `.resize()` argument
+    - Refactor scene launcher and cyclopts utils in own package [`parsenaut`](https://pypi.org/project/parsenaut/)
 
 ### 📦 v0.10.0 <small>March 12, 2026</small> {#v0.10.0}