sonolus.py 0.10.2__py3-none-any.whl → 0.10.3__py3-none-any.whl

sonolus/build/cli.py

@@ -14,7 +14,7 @@ from sonolus.build.dev_server import run_server
 from sonolus.build.engine import no_gil, package_engine, validate_engine
 from sonolus.build.level import package_level_data
 from sonolus.build.project import build_project_to_collection, get_project_schema
-from sonolus.script.internal.context import ProjectContextState
+from sonolus.script.internal.context import ProjectContextState, RuntimeChecks
 from sonolus.script.internal.error import CompilationError
 from sonolus.script.project import BuildConfig, Project
 
@@ -128,9 +128,20 @@ def get_config(args: argparse.Namespace) -> BuildConfig:
         build_watch=build_watch,
         build_preview=build_preview,
         build_tutorial=build_tutorial,
+        runtime_checks=get_runtime_checks(args),
     )
 
 
+def get_runtime_checks(args: argparse.Namespace) -> RuntimeChecks:
+    if hasattr(args, "runtime_checks") and args.runtime_checks:
+        return {
+            "none": RuntimeChecks.NONE,
+            "terminate": RuntimeChecks.TERMINATE,
+            "notify": RuntimeChecks.NOTIFY_AND_TERMINATE,
+        }[args.runtime_checks]
+    return RuntimeChecks.NOTIFY_AND_TERMINATE if args.command == "dev" else RuntimeChecks.NONE
+
+
 def main():
     parser = argparse.ArgumentParser(description="Sonolus project build and development tools")
     subparsers = parser.add_subparsers(dest="command", required=True)
@@ -147,6 +158,12 @@ def main():
             "-O2", "--optimize-standard", action="store_true", help="Use standard optimization passes"
         )
 
+        parser.add_argument(
+            "--runtime-checks",
+            choices=["none", "terminate", "notify"],
+            help="Runtime error checking mode (default: none for build, notify for dev)",
+        )
+
         build_components = parser.add_argument_group("build components")
         build_components.add_argument("--play", action="store_true", help="Build play component")
         build_components.add_argument("--watch", action="store_true", help="Build watch component")

sonolus/build/dev_server.py

@@ -117,7 +117,7 @@ class RebuildCommand:
         print("Rebuilding...")
         try:
             start_time = perf_counter()
-            server_state.project_state = ProjectContextState(dev=True)
+            server_state.project_state = ProjectContextState.from_build_config(server_state.config)
             server_state.project = project_module.project
             build_collection(
                 server_state.project,
@@ -260,7 +260,7 @@ def run_server(
     from sonolus.build.cli import build_collection
 
     cache = CompileCache()
-    project_state = ProjectContextState(dev=True)
+    project_state = ProjectContextState.from_build_config(config)
 
     start_time = perf_counter()
     build_collection(project, build_dir, config, cache=cache, project_state=project_state)

sonolus/build/engine.py

@@ -76,7 +76,7 @@ def package_engine(
 
     config = config or BuildConfig()
     if project_state is None:
-        project_state = ProjectContextState()
+        project_state = ProjectContextState.from_build_config(config)
     configuration = build_engine_configuration(engine.options, engine.ui)
     if no_gil():
         # process_cpu_count is available in Python 3.13+
@@ -209,9 +209,11 @@ def package_engine(
 def validate_engine(
     engine: EngineData,
     config: BuildConfig | None = None,
+    project_state: ProjectContextState | None = None,
 ):
     config = config or BuildConfig()
-    project_state = ProjectContextState()
+    if project_state is None:
+        project_state = ProjectContextState.from_build_config(config)
 
     play_mode = engine.play if config.build_play else empty_play_mode()
     watch_mode = engine.watch if config.build_watch else empty_watch_mode()

sonolus/script/containers.py

@@ -183,7 +183,7 @@ class VarArray[T, Capacity](Record, ArrayLike[T]):
         assert self._size + len(values) <= len(self._array), "Array is full"
         i = 0
         while i < len(values):
-            self._array.set_unchecked(self._size + i, values[i])
+            self._array.set_unchecked(self._size + i, values.get_unchecked(i))
             i += 1
         self._size += len(values)
 

sonolus/script/debug.py

@@ -1,13 +1,13 @@
 from collections.abc import Callable, Sequence
 from contextvars import ContextVar
-from typing import Any, Literal, Never
+from typing import Any, Literal, Never, assert_never
 
 from sonolus.backend.mode import Mode
 from sonolus.backend.ops import Op
 from sonolus.backend.optimize.flow import cfg_to_mermaid
 from sonolus.backend.optimize.passes import CompilerPass, OptimizerConfig, run_passes
 from sonolus.backend.optimize.simplify import RenumberVars
-from sonolus.script.internal.context import ModeContextState, ProjectContextState, ctx, set_ctx
+from sonolus.script.internal.context import ModeContextState, ProjectContextState, RuntimeChecks, ctx, set_ctx
 from sonolus.script.internal.impl import meta_fn, validate_value
 from sonolus.script.internal.native import native_function
 from sonolus.script.internal.simulation_context import SimulationContext
@@ -18,12 +18,12 @@ debug_log_callback = ContextVar[Callable[[Num], None]]("debug_log_callback")
 
 @meta_fn
 def error(message: str | None = None) -> Never:  # type: ignore
-    """Raise an error, and if in a dev build, log a message and pause the game.
+    """Raise an error, and if runtime checks are set to notify, log a message and pause the game.
 
-    This function is used to raise an error during runtime.
-    When this happens, the game will pause in debug mode. The current callback will also immediately return 0.
+    This function is used to raise an error during runtime and terminate the current callback.
 
-    In non-dev builds, this function will terminate the current callback silently.
+    If runtime checks are set to notify (default in dev), this function will log a message and pause the game
+    before terminating.
 
     Args:
         message: The message to log.
@@ -32,9 +32,14 @@ def error(message: str | None = None) -> Never:  # type: ignore
     if not isinstance(message, str):
         raise ValueError("Expected a string")
     if ctx():
-        if ctx().project_state.dev:
-            debug_log(ctx().map_debug_message(message))
-            debug_pause()
+        match ctx().project_state.runtime_checks:
+            case RuntimeChecks.NOTIFY_AND_TERMINATE:
+                debug_log(ctx().map_debug_message(message))
+                debug_pause()
+            case RuntimeChecks.TERMINATE | RuntimeChecks.NONE:
+                pass
+            case _ as unreachable:
+                assert_never(unreachable)
         terminate()
     else:
         raise RuntimeError(message)
@@ -79,9 +84,9 @@ def debug_pause():
 
 @meta_fn
 def notify(message: str):
-    """Log a code that can be decoded by the dev server and pause the game if in debug mode and in a dev build.
+    """Log a code that can be decoded by the dev server and pause the game if runtime checks are set to notify.
 
-    Does nothing if not a dev build.
+    If runtime checks are not set to notify, this function will do nothing.
 
     Args:
         message: The message to log.
@@ -90,7 +95,7 @@ def notify(message: str):
     if not isinstance(message, str):
         raise ValueError("Expected a string")
     if ctx():
-        if ctx().project_state.dev:
+        if ctx().project_state.runtime_checks == RuntimeChecks.NOTIFY_AND_TERMINATE:
             debug_log(ctx().map_debug_message(message))
             debug_pause()
     else:
@@ -134,7 +139,7 @@ def require(value: int | float | bool, message: str | None = None):
 
 @meta_fn
 def assert_true(value: int | float | bool, message: str | None = None):
-    if ctx() and not ctx().project_state.dev:
+    if ctx() and ctx().project_state.runtime_checks == RuntimeChecks.NONE:
         return
     require(value, message)
 

sonolus/script/internal/context.py

@@ -4,8 +4,9 @@ from collections.abc import Iterable, Sequence
 from contextlib import contextmanager
 from contextvars import ContextVar
 from dataclasses import dataclass
+from enum import Enum
 from threading import Lock
-from typing import Any, Literal, Self
+from typing import TYPE_CHECKING, Any, Literal, Self
 
 from sonolus.backend.blocks import BlockData, PlayBlock
 from sonolus.backend.ir import IRConst, IRExpr, IRStmt
@@ -15,6 +16,9 @@ from sonolus.backend.place import Block, BlockPlace, TempBlock
 from sonolus.script.globals import _GlobalInfo, _GlobalPlaceholder
 from sonolus.script.internal.value import Value
 
+if TYPE_CHECKING:
+    from sonolus.script.project import BuildConfig
+
 _compiler_internal_ = True
 
 context_var: ContextVar[Context | None] = ContextVar("context_var", default=None)  # type: ignore
@@ -39,25 +43,53 @@ _disabled_debug_config = DebugConfig(
 debug_var = ContextVar("debug_var", default=_disabled_debug_config)
 
 
+class RuntimeChecks(Enum):
+    """Runtime error checking modes."""
+
+    NONE = "none"
+    """No runtime checks."""
+
+    TERMINATE = "terminate"
+    """Terminate on errors."""
+
+    NOTIFY_AND_TERMINATE = "notify_and_terminate"
+    """Log, debug pause, and terminate on errors."""
+
+
 class ProjectContextState:
     rom: ReadOnlyMemory
     const_mappings: dict[Any, int]
     debug_str_mappings: dict[str, int]
     lock: Lock
-    dev: bool
+    runtime_checks: RuntimeChecks
 
     def __init__(
         self,
         rom: ReadOnlyMemory | None = None,
         const_mappings: dict[Any, int] | None = None,
         debug_str_mappings: dict[str, int] | None = None,
-        dev: bool = False,
+        runtime_checks: RuntimeChecks = RuntimeChecks.NONE,
     ):
         self.rom = ReadOnlyMemory() if rom is None else rom
         self.const_mappings = {} if const_mappings is None else const_mappings
         self.debug_str_mappings = {} if debug_str_mappings is None else debug_str_mappings
         self.lock = Lock()
-        self.dev = dev
+        self.runtime_checks = runtime_checks
+
+    @classmethod
+    def from_build_config(
+        cls,
+        config: BuildConfig,
+        rom: ReadOnlyMemory | None = None,
+        const_mappings: dict[Any, int] | None = None,
+        debug_str_mappings: dict[str, int] | None = None,
+    ) -> Self:
+        return cls(
+            rom=rom,
+            const_mappings=const_mappings,
+            debug_str_mappings=debug_str_mappings,
+            runtime_checks=config.runtime_checks,
+        )
 
 
 class ModeContextState:

sonolus/script/project.py

@@ -10,6 +10,7 @@ from sonolus.backend.optimize import optimize
 from sonolus.backend.optimize.passes import CompilerPass
 from sonolus.script.archetype import ArchetypeSchema
 from sonolus.script.engine import Engine
+from sonolus.script.internal.context import RuntimeChecks
 from sonolus.script.level import ExternalLevelData, Level, LevelData
 
 
@@ -66,7 +67,7 @@ class Project:
         from sonolus.build.cli import run_server
 
         if config is None:
-            config = BuildConfig()
+            config = BuildConfig(runtime_checks=RuntimeChecks.NOTIFY_AND_TERMINATE)
 
         run_server(
             Path(build_dir) / "site",
@@ -145,3 +146,6 @@ class BuildConfig:
 
     override_resource_level_engines: bool = True
     """Whether to override any levels included in resources to use the engine of this project."""
+
+    runtime_checks: RuntimeChecks = RuntimeChecks.NONE
+    """Runtime error checking mode."""

sonolus/script/stream.py

@@ -6,6 +6,7 @@ from typing import cast, dataclass_transform
 from sonolus.backend.ir import IRConst, IRExpr, IRInstr, IRPureInstr
 from sonolus.backend.mode import Mode
 from sonolus.backend.ops import Op
+from sonolus.script.array_like import check_positive_index
 from sonolus.script.internal.context import ctx
 from sonolus.script.internal.descriptor import SonolusDescriptor
 from sonolus.script.internal.impl import meta_fn
@@ -508,7 +509,7 @@ class StreamGroup[T, Size](Record):
     def __getitem__(self, index: int) -> Stream[T]:
         """Get the stream at the given index."""
         _check_can_read_or_write_stream()
-        assert index in self
+        check_positive_index(index, self.size())
         # Size 0 elements still need 1 stream to preserve the key.
         t = self.type_var_value(T)
         return Stream[t](max(1, sizeof(self.element_type())) * index + self.offset)

{sonolus_py-0.10.2.dist-info → sonolus_py-0.10.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sonolus.py
-Version: 0.10.2
+Version: 0.10.3
 Summary: Sonolus engine development in Python
 Project-URL: Documentation, https://sonolus.py.qwewqa.xyz/
 Project-URL: Repository, https://github.com/qwewqa/sonolus.py

{sonolus_py-0.10.2.dist-info → sonolus_py-0.10.3.dist-info}/RECORD

@@ -26,11 +26,11 @@ sonolus/backend/optimize/passes.py,sha256=YyFKy6qCwcR_Ua2_SXpcBODfvBbm_ygVYcqloO
 sonolus/backend/optimize/simplify.py,sha256=wvhixe0SfditrGMh0nX0Wt0JR00JqAmz4BKBzMoBAVI,14701
 sonolus/backend/optimize/ssa.py,sha256=raQO0furQQRPYb8iIBKfNrJlj-_5wqtI4EWNfLZ8QFo,10834
 sonolus/build/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sonolus/build/cli.py,sha256=GQHzXGj55pqz84AnOKa21t74Nrbt7gUKfQe88gXIKtI,9357
+sonolus/build/cli.py,sha256=t6oK0SGU6fkxXVbGu6OuRIHDKD6u4SqXAShdPtatZ-8,10060
 sonolus/build/collection.py,sha256=6hniAzriPWBKUeGDkXabNXpbdHiHnqiK9shs6U1OExM,12748
 sonolus/build/compile.py,sha256=KOmncDKmGfgzC_FWB_LTxAl0s9w4wnaDe-luACMlCVs,8397
-sonolus/build/dev_server.py,sha256=EOnIgAkFZAKiCwhFqDyKMLkJfYtGdjlacqYWZ2F2mAU,9891
-sonolus/build/engine.py,sha256=No_q4O6PRMwxEPHvSlbaBKVe5CXJswWFZdR3xgfIuI8,14672
+sonolus/build/dev_server.py,sha256=tn6xzW2PqsKyc7k9p5hRzoFn4gavIWQwpF0MBcGIPnU,9936
+sonolus/build/engine.py,sha256=jMymxbBXu-ekv71uU8TF2KbFaHs3yGjyJAztd1SoRDs,14808
 sonolus/build/level.py,sha256=KLqUAtxIuIqrzeFURJA97rdqjA5pcvYSmwNZQhElaMQ,702
 sonolus/build/node.py,sha256=gnX71RYDUOK_gYMpinQi-bLWO4csqcfiG5gFmhxzSec,1330
 sonolus/build/project.py,sha256=Uuz82QtTNFdklrVJ_i7EPp8hSjyOxLU1xAeOloa6G00,8579
@@ -39,8 +39,8 @@ sonolus/script/archetype.py,sha256=ck_LR8z0ipVq3T9b735VwvQI2mxVUyjHylr4BFagXT8,4
 sonolus/script/array.py,sha256=0ZUI0alrwKztpQOpZodZPSPafu5cGwaiffBGQbY19LQ,13316
 sonolus/script/array_like.py,sha256=E6S4TW2muXgcyVkhUASQVt7JSYUkpvdJPgHz6YiSHNo,14708
 sonolus/script/bucket.py,sha256=yIod3DgX7Hv7RLe-4Cn81FcydvbkbdMt26FzpRj7oUI,7794
-sonolus/script/containers.py,sha256=qKIyTs5Q_UpQggR6s0AfgWQAvPv-IM2DW9s951koKSc,19303
-sonolus/script/debug.py,sha256=YOq06q5ahWI-uEG5naonOBWF62Qn_Af7JSV_Ra8Zr6E,7415
+sonolus/script/containers.py,sha256=Zomn9H0QJjWNAcbe17fj1c4zbM4D0s3vlIY1R0zf8rg,19317
+sonolus/script/debug.py,sha256=-Xbt1wYCwCgQOyRFdG73A8LxJLIw9qLs1N6B5FLbZYQ,7790
 sonolus/script/easing.py,sha256=2FUJI_nfp990P_armCcRqHm2329O985glJAhSC6tnxs,11379
 sonolus/script/effect.py,sha256=aOxhBmX6I8vUS-bE53YFNBEN3wwdmpraqZjLeCqbgIY,7920
 sonolus/script/engine.py,sha256=etI9dJsQ7V9YZICVNZg54WqpLijPxG8eTPHiV-_EiG8,10687
@@ -56,12 +56,12 @@ sonolus/script/options.py,sha256=05y_4j2kr8fzct5FLqmSp5ZAjnq6-slmNgtsh4fVEpg,945
 sonolus/script/particle.py,sha256=BuBM7fvLAj79upLf9yI4FyZhVUK7-H2dFj0D7UiYS7I,10458
 sonolus/script/pointer.py,sha256=FoOfyD93r0G5d_2BaKfeOT9SqkOP3hq6sqtOs_Rb0c8,1511
 sonolus/script/printing.py,sha256=mNYu9QWiacBBGZrnePZQMVwbbguoelUps9GiOK_aVRU,2096
-sonolus/script/project.py,sha256=4svmMWYihF7olmYSMS5uoSjlnzbd7Ip2zTRY86oL1L8,4629
+sonolus/script/project.py,sha256=YouKKm6Z9PpwbO9aSA2syZqFv_j1DShVGlENUT565Js,4831
 sonolus/script/quad.py,sha256=8lZ_5-eWeqePldNGBkNZTuOgS_IRb41URgGwSW4h2T0,14445
 sonolus/script/record.py,sha256=BrQ8k-O4WX9FT_EfoRmNnKC1BZM9gWydZ4R4swh3chc,13051
 sonolus/script/runtime.py,sha256=TjxcfIIPRH6oxlEjWfLHDj1oo7fPfwTBdwETfnhN7h4,33331
 sonolus/script/sprite.py,sha256=d_wqUn7oMbkLZMdvnyDZVBykycTtiwegcarWXMcZMUI,18408
-sonolus/script/stream.py,sha256=Fu02SNjH8j1FQ9_7ncacR9uRIhoWtAZR-sTi8qBT7rA,24707
+sonolus/script/stream.py,sha256=mamVG7umEsb51D9Kh6xifhDB7QSDBQHU7xWhJIsQvYY,24786
 sonolus/script/text.py,sha256=wxujIgKYcCfl2AD2_Im8g3vh0lDEHYwTSRZg9wsBPEU,13402
 sonolus/script/timing.py,sha256=DklMvuxcFg3MzXsecUo6Yhdk7pScOJ7STwXvAiTvLKM,3067
 sonolus/script/transform.py,sha256=4aS7-NNzX0v9KMXZ4gIGOaU1Cd-ok7DO_OvIBca0mGU,21418
@@ -72,7 +72,7 @@ sonolus/script/internal/__init__.py,sha256=T6rzLoiOUaiSQtaHMZ88SNO-ijSjSSv33TKtU
 sonolus/script/internal/builtin_impls.py,sha256=tpNbaH6fLICd8TYj9Hf_wrPSWk3RkhmSPVN9nqOuqj4,13372
 sonolus/script/internal/callbacks.py,sha256=vWzJG8uiJoEtsNnbeZPqOHogCwoLpz2D1MnHY2wVV8s,2801
 sonolus/script/internal/constant.py,sha256=3ycbGkDJVUwcrCZ96vLjAoAARgsvaqDM8rJ_YCrLrvo,4289
-sonolus/script/internal/context.py,sha256=C0VMHBRppsnwPDVPc03Lpz7tO9djQMB5ELdtpFPMdsk,18779
+sonolus/script/internal/context.py,sha256=56pPjiPy8ZaxY3t5iEufsOMEj6BSy31G-5SoYqS6tPo,19694
 sonolus/script/internal/descriptor.py,sha256=XRFey-EjiAm_--KsNl-8N0Mi_iyQwlPh68gDp0pKf3E,392
 sonolus/script/internal/dict_impl.py,sha256=alu_wKGSk1kZajNf64qbe7t71shEzD4N5xNIATH8Swo,1885
 sonolus/script/internal/error.py,sha256=ZNnsvQVQAnFKzcvsm6-sste2lo-tP5pPI8sD7XlAZWc,490
@@ -87,8 +87,8 @@ sonolus/script/internal/simulation_context.py,sha256=LGxLTvxbqBIhoe1R-SfwGajNIDw
 sonolus/script/internal/transient.py,sha256=y2AWABqF1aoaP6H4_2u4MMpNioC4OsZQCtPyNI0txqo,1634
 sonolus/script/internal/tuple_impl.py,sha256=DPNdmmRmupU8Ah4_XKq6-PdT336l4nt15_uCJKQGkkk,3587
 sonolus/script/internal/value.py,sha256=OngrCdmY_h6mV2Zgwqhuo4eYFad0kTk6263UAxctZcY,6963
-sonolus_py-0.10.2.dist-info/METADATA,sha256=07hKS146L3Ck4bScU9kbuWDHtIrExXvCIlygmvfxCbE,554
-sonolus_py-0.10.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-sonolus_py-0.10.2.dist-info/entry_points.txt,sha256=oTYspY_b7SA8TptEMTDxh4-Aj-ZVPnYC9f1lqH6s9G4,54
-sonolus_py-0.10.2.dist-info/licenses/LICENSE,sha256=JEKpqVhQYfEc7zg3Mj462sKbKYmO1K7WmvX1qvg9IJk,1067
-sonolus_py-0.10.2.dist-info/RECORD,,
+sonolus_py-0.10.3.dist-info/METADATA,sha256=EWdFrM6pQ7bZHXSFjPqFHb22IJCR8wwuSoX46zS6MRU,554
+sonolus_py-0.10.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sonolus_py-0.10.3.dist-info/entry_points.txt,sha256=oTYspY_b7SA8TptEMTDxh4-Aj-ZVPnYC9f1lqH6s9G4,54
+sonolus_py-0.10.3.dist-info/licenses/LICENSE,sha256=JEKpqVhQYfEc7zg3Mj462sKbKYmO1K7WmvX1qvg9IJk,1067
+sonolus_py-0.10.3.dist-info/RECORD,,