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

sonolus/build/dev_server.py

@@ -57,7 +57,8 @@ DETAILED_HELP_TEXT = [
         description=[
             (
                 "Decode a debug message code to its original text with a stack trace. "
-                "Message codes are generated by assert statements, debug.error(), and debug.notify() calls. "
+                "Message codes are generated by assert statements and certain debug-related functions such as "
+                "debug.error() and debug.notify(). "
                 "The game is automatically paused when these are triggered in debug mode and the message code "
                 "can be found in the debug log."
             ),
@@ -189,7 +190,13 @@ def parse_dev_command(command_line: str) -> Command | None:
     subparsers.add_parser("quit", aliases=["q"])
 
     try:
-        args = parser.parse_args(shlex.split(command_line))
+        split_args = shlex.split(command_line)
+    except ValueError as e:
+        print(f"Error parsing command: {e}\n")
+        return None
+
+    try:
+        args = parser.parse_args(split_args)
         if args.cmd in {"rebuild", "r"}:
             return RebuildCommand()
         elif args.cmd in {"decode", "d"}:
@@ -223,11 +230,12 @@ def command_input_thread(command_queue: queue.Queue, prompt_event: threading.Eve
                     print(f"Unknown command. Available commands:\n{HELP_TEXT}")
                     # Show prompt again
                     prompt_event.set()
+            else:
+                prompt_event.set()
         except EOFError:
             break
         except Exception as e:
-            print(f"Error reading command: {e}")
-            break
+            print(f"Error reading command: {e}\n")
 
 
 def get_local_ips():
@@ -311,12 +319,12 @@ def run_server(
 
             try:
                 while True:
+                    cmd = command_queue.get()
                     try:
-                        cmd = command_queue.get(timeout=0.5)
                         cmd.execute(server_state)
-                        prompt_event.set()
-                    except queue.Empty:
-                        continue
+                    except Exception:
+                        print(f"{traceback.format_exc()}\n")
+                    prompt_event.set()
             except KeyboardInterrupt:
                 print("Exiting...")
                 sys.exit(0)

sonolus/script/array.py

@@ -30,6 +30,8 @@ class ArrayMeta(ABCMeta):
 class Array[T, Size](GenericValue, ArrayLike[T], metaclass=ArrayMeta):
     """A fixed size array of values.
 
+    Supports negative indexes.
+
     Usage:
         ```python
         array_1 = Array(1, 2, 3)

sonolus/script/containers.py

@@ -87,6 +87,8 @@ class Pair[T, U](Record):
 class VarArray[T, Capacity](Record, ArrayLike[T]):
     """An array with a variable size and fixed maximum capacity.
 
+    Supports negative indexes.
+
     Usage:
         ```python
         VarArray[T, Capacity].new()  # Create a new empty array
@@ -125,6 +127,8 @@ class VarArray[T, Capacity](Record, ArrayLike[T]):
     def __getitem__(self, item) -> T:
         """Return the element at the given index.
 
+        Supports negative indexes.
+
         The returned value continues to be part of the array.
         Future modifications to the array will affect the returned value.
 
@@ -310,6 +314,8 @@ class VarArray[T, Capacity](Record, ArrayLike[T]):
 class ArrayPointer[T](Record, ArrayLike[T]):
     """An array defined by a size and pointer to the first element.
 
+    Supports negative indexes.
+
     This is intended to be created internally and improper use may result in hard to debug issues.
 
     Usage:

sonolus/script/debug.py

@@ -106,11 +106,10 @@ def notify(message: str):
 def require(value: int | float | bool, message: str | None = None):
     """Require a condition to be true, or raise an error.
 
-    Similar to assert, but does not get stripped in non-dev builds.
+    Similar to assert, but will terminate the current callback even if runtime checks are set to none.
 
-    If in a dev build, this function will log a message and pause the game if the condition is false.
-
-    In non-dev builds, this function will terminate the current callback silently if the condition is false.
+    If runtime checks are set to notify (default in dev), this function will log a message and pause the game
+    before terminating.
 
     Args:
         value: The condition to check.

sonolus/script/effect.py

@@ -98,6 +98,8 @@ class ScheduledLoopedEffectHandle(Record):
 class EffectGroup(Record, ArrayLike[Effect]):
     """A group of effect clips.
 
+    Does not support negative indexes.
+
     Usage:
         ```python
         EffectGroup(start_id: int, size: int)

sonolus/script/particle.py

@@ -58,6 +58,8 @@ class ParticleHandle(Record):
 class ParticleGroup(Record, ArrayLike[Particle]):
     """A group of particle effects.
 
+    Does not support negative indexes.
+
     Usage:
         ```python
         ParticleGroup(start_id: int, size: int)

sonolus/script/sprite.py

@@ -126,6 +126,8 @@ class Sprite(Record):
 class SpriteGroup(Record, ArrayLike[Sprite]):
     """A group of sprites.
 
+    Does not support negative indexes.
+
     Usage:
         ```python
         SpriteGroup(start_id: int, size: int)

sonolus/script/stream.py

@@ -470,6 +470,8 @@ class Stream[T](Record):
 class StreamGroup[T, Size](Record):
     """Represents a group of streams.
 
+    Does not support negative indexes.
+
     Most users should use [`@streams`][sonolus.script.stream.streams] to declare stream groups rather than using this
     class directly.
 
@@ -507,7 +509,10 @@ class StreamGroup[T, Size](Record):
         return 0 <= item < self.size()
 
     def __getitem__(self, index: int) -> Stream[T]:
-        """Get the stream at the given index."""
+        """Get the stream at the given index.
+
+        Does not support negative indexes.
+        """
         _check_can_read_or_write_stream()
         check_positive_index(index, self.size())
         # Size 0 elements still need 1 stream to preserve the key.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sonolus.py
-Version: 0.10.3
+Version: 0.10.5
 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.3.dist-info → sonolus_py-0.10.5.dist-info}/RECORD

@@ -29,20 +29,20 @@ sonolus/build/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 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=tn6xzW2PqsKyc7k9p5hRzoFn4gavIWQwpF0MBcGIPnU,9936
+sonolus/build/dev_server.py,sha256=N2MaBaChiVnAPZJzlXRFGEIAHhELj4vDBAtuvgAF1qo,10172
 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
 sonolus/script/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sonolus/script/archetype.py,sha256=ck_LR8z0ipVq3T9b735VwvQI2mxVUyjHylr4BFagXT8,49631
-sonolus/script/array.py,sha256=0ZUI0alrwKztpQOpZodZPSPafu5cGwaiffBGQbY19LQ,13316
+sonolus/script/array.py,sha256=EbrNwl_WuJ0JjjkX0s_VJNXWqvYdm_ljTbyrDEMLGUY,13348
 sonolus/script/array_like.py,sha256=E6S4TW2muXgcyVkhUASQVt7JSYUkpvdJPgHz6YiSHNo,14708
 sonolus/script/bucket.py,sha256=yIod3DgX7Hv7RLe-4Cn81FcydvbkbdMt26FzpRj7oUI,7794
-sonolus/script/containers.py,sha256=Zomn9H0QJjWNAcbe17fj1c4zbM4D0s3vlIY1R0zf8rg,19317
-sonolus/script/debug.py,sha256=-Xbt1wYCwCgQOyRFdG73A8LxJLIw9qLs1N6B5FLbZYQ,7790
+sonolus/script/containers.py,sha256=nPjyyLmGnTxndMipqdfJ9CxmIT09wNLRQM7efagtZHI,19417
+sonolus/script/debug.py,sha256=yYg6EZt3NUOUeph1pu_5cA_2lxs8SZ91v76eOC1Sw-8,7747
 sonolus/script/easing.py,sha256=2FUJI_nfp990P_armCcRqHm2329O985glJAhSC6tnxs,11379
-sonolus/script/effect.py,sha256=aOxhBmX6I8vUS-bE53YFNBEN3wwdmpraqZjLeCqbgIY,7920
+sonolus/script/effect.py,sha256=SfJxSNF3RlPCRXnkt62ZlWhCXw3mmmRCsoMsvTErUP0,7960
 sonolus/script/engine.py,sha256=etI9dJsQ7V9YZICVNZg54WqpLijPxG8eTPHiV-_EiG8,10687
 sonolus/script/globals.py,sha256=nlXSNS4NRXsgQU2AJImVIs752h1WqsMnShSKgU011c4,10270
 sonolus/script/instruction.py,sha256=Dd-14D5Amo8nhPBr6DNyg2lpYw_rqZkT8Kix3HkfE7k,6793
@@ -53,15 +53,15 @@ sonolus/script/maybe.py,sha256=VYvTWgEfPzoXqI3i3zXhc4dz0pWBVoHmW8FtWH0GQvM,8194
 sonolus/script/metadata.py,sha256=ttRK27eojHf3So50KQJ-8yj3udZoN1bli5iD-knaeLw,753
 sonolus/script/num.py,sha256=9pahERQcIh16ytoDjJB3u3L6fH1Xh11Y99l8SYxkjMA,15927
 sonolus/script/options.py,sha256=05y_4j2kr8fzct5FLqmSp5ZAjnq6-slmNgtsh4fVEpg,9451
-sonolus/script/particle.py,sha256=BuBM7fvLAj79upLf9yI4FyZhVUK7-H2dFj0D7UiYS7I,10458
+sonolus/script/particle.py,sha256=3HbxehuW7Fdri3s8NenGxiwxVU7tVDH8SQ4VyCc0wMk,10498
 sonolus/script/pointer.py,sha256=FoOfyD93r0G5d_2BaKfeOT9SqkOP3hq6sqtOs_Rb0c8,1511
 sonolus/script/printing.py,sha256=mNYu9QWiacBBGZrnePZQMVwbbguoelUps9GiOK_aVRU,2096
 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=mamVG7umEsb51D9Kh6xifhDB7QSDBQHU7xWhJIsQvYY,24786
+sonolus/script/sprite.py,sha256=KhQNnq0wKm1tDMQTrlZIr0mL0jPCfojTORzsCK5qO1o,18448
+sonolus/script/stream.py,sha256=Yot99RLKqJN1XK3x5s_qeV-50qEtuG2U6zbEPWLyvW8,24879
 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
@@ -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.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,,
+sonolus_py-0.10.5.dist-info/METADATA,sha256=OQvnIBSfASxlv-XRLl2RWz4OyYvvO_4wRda1yDmh8h0,554
+sonolus_py-0.10.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sonolus_py-0.10.5.dist-info/entry_points.txt,sha256=oTYspY_b7SA8TptEMTDxh4-Aj-ZVPnYC9f1lqH6s9G4,54
+sonolus_py-0.10.5.dist-info/licenses/LICENSE,sha256=JEKpqVhQYfEc7zg3Mj462sKbKYmO1K7WmvX1qvg9IJk,1067
+sonolus_py-0.10.5.dist-info/RECORD,,