Enable dumping of the API using stubgen

Author: ctrueden

.gitignore

@@ -6,6 +6,7 @@
 /.pytest_cache/
 /.venv/
 /.vscode/
+/api/
 /build/
 /dist/
 /eggs/

bin/api.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+uv run stubgen --include-private -p appose -o api/
+uv run stubgen --include-private -o api tests/*.py
+
+# Strip leading import statements -- not needed for
+# API comparison with other Appose implementations.
+find api -name '*.pyi' | while read pyi
+do
+  mv "$pyi" "$pyi.original"
+  sed '/^\(from\|import\) /d' "$pyi.original" > "$pyi"
+done

pyproject.toml

@@ -35,6 +35,7 @@ dependencies = [
 [dependency-groups]
 dev = [
     "build",
+    "mypy",
     "pytest",
     "ruff",
     "toml",

src/appose/service.py

@@ -310,7 +310,7 @@ def __init__(
         inputs: Args | None = None,
         queue: str | None = None,
     ) -> None:
-        self.uuid = uuid4().hex
+        self.uuid: str = uuid4().hex
         self.service = service
         self.script = script
         self.inputs: Args = {}