gramlab 0.1.0a1__py3-none-any.whl

gramlab/README.md

@@ -0,0 +1,6 @@
+# Python core and SDK
+
+Reserved for independently written MIT-licensed simulation, Bot API transport, scenario control
+and reporting code. The package exports the experimental typed scenario-authoring interface;
+`runtime.py` implements its Linux process boundary. No stable simulator interface exists yet. Keep Android-derived
+classes and generated client-derived code outside this boundary.

gramlab/__init__.py

@@ -0,0 +1,36 @@
+"""GramLab's experimental scenario-authoring interface."""
+
+from gramlab.scenario import Scenario, ScenarioError
+from gramlab.scenario_flow import (
+    Bot,
+    BotState,
+    BotStatus,
+    Callback,
+    Capture,
+    Conversation,
+    InlineAction,
+    InlineButton,
+    InteractionReceipt,
+    Message,
+    ScenarioFlowError,
+    ScenarioWaitTimeout,
+    User,
+)
+
+__all__ = [
+    "Bot",
+    "BotState",
+    "BotStatus",
+    "Callback",
+    "Capture",
+    "Conversation",
+    "InlineAction",
+    "InlineButton",
+    "InteractionReceipt",
+    "Message",
+    "Scenario",
+    "ScenarioError",
+    "ScenarioFlowError",
+    "ScenarioWaitTimeout",
+    "User",
+]

gramlab/__main__.py

@@ -0,0 +1,46 @@
+"""Public command entry point; consumer code is only executed inside the runtime."""
+
+import argparse
+import os
+import sys
+from pathlib import Path
+
+from gramlab.runner import run
+from gramlab.runtime import RuntimeProfile
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(prog="gramlab")
+    commands = parser.add_subparsers(dest="command", required=True)
+    execute = commands.add_parser("run", help="Run a declared scenario and bots offline")
+    execute.add_argument("manifest", type=Path)
+    execute.add_argument("--output", type=Path, required=True, help="Fresh run directory")
+    execute.add_argument("--profile", type=Path, default=os.environ.get("GRAMLAB_RUNTIME_PROFILE"))
+    execute.add_argument(
+        "--android-profile", type=Path, default=os.environ.get("GRAMLAB_ANDROID_RUNTIME_PROFILE")
+    )
+    execute.add_argument("--android-apk", type=Path, default=os.environ.get("GRAMLAB_ANDROID_APK"))
+    execute.add_argument("--bridge-version", type=int, choices=(3, 4, 5, 6), default=3)
+    args = parser.parse_args()
+    if args.profile is None:
+        parser.error("Enter the provisioned Nix shell or supply --profile")
+    try:
+        outcome = run(
+            args.manifest,
+            args.output,
+            profile=RuntimeProfile.load(args.profile),
+            android_profile=RuntimeProfile.load(args.android_profile)
+            if args.android_profile
+            else None,
+            android_apk=args.android_apk,
+            bridge_version=args.bridge_version,
+        )
+    except (OSError, ValueError, KeyError, TypeError) as error:
+        print(f"gramlab: cannot prepare run ({type(error).__name__}): {error}", file=sys.stderr)
+        return 2
+    print(f"{outcome}: {args.output / 'report.html'}")
+    return 0 if outcome == "passed" else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())