sonolus.py 0.6.1__py3-none-any.whl → 0.6.3__py3-none-any.whl

sonolus/script/array_like.py

@@ -16,7 +16,7 @@ from sonolus.script.values import copy
 # Note: we don't use Range in this file because Range itself inherits from ArrayLike
 
 
-class ArrayLike[T](Sequence):
+class ArrayLike[T](Sequence[T]):
     """Mixin for array-like objects.
 
     Inheritors must implement `__len__`, `__getitem__`, and `__setitem__`.
@@ -190,7 +190,7 @@ class ArrayLike[T](Sequence):
             key: A one-argument ordering function to use for comparison.
             reverse: If `True`, sort in descending order, otherwise sort in ascending order.
         """
-        if len(self) < 15 or key is not None:
+        if key is not None or len(self) < 15:
             if key is None:
                 key = _identity  # type: ignore
             # May be worth adding a block sort variant for better performance on large arrays in the future

sonolus/script/containers.py

@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import Self
+
 from sonolus.backend.visitor import compile_and_call
 from sonolus.script.array import Array
 from sonolus.script.array_like import ArrayLike, get_positive_index
@@ -102,7 +104,7 @@ class VarArray[T, Capacity](Record, ArrayLike[T]):
     _array: Array[T, Capacity]
 
     @classmethod
-    def new(cls):
+    def new(cls) -> Self:
         """Create a new empty array."""
         element_type = cls.type_var_value(T)
         capacity = cls.type_var_value(Capacity)
@@ -380,7 +382,7 @@ class ArraySet[T, Capacity](Record):
     _values: VarArray[T, Capacity]
 
     @classmethod
-    def new(cls):
+    def new(cls) -> Self:
         """Create a new empty set."""
         element_type = cls.type_var_value(T)
         capacity = cls.type_var_value(Capacity)
@@ -394,7 +396,7 @@ class ArraySet[T, Capacity](Record):
         """Return whether the given value is present in the set."""
         return value in self._values
 
-    def __iter__(self):
+    def __iter__(self) -> SonolusIterator[T]:
         """Return an iterator over the values in the set."""
         return self._values.__iter__()
 
@@ -457,7 +459,7 @@ class ArrayMap[K, V, Capacity](Record):
     _array: Array[_ArrayMapEntry[K, V], Capacity]
 
     @classmethod
-    def new(cls):
+    def new(cls) -> Self:
         """Create a new empty map."""
         key_type = cls.type_var_value(K)
         value_type = cls.type_var_value(V)
@@ -489,7 +491,7 @@ class ArrayMap[K, V, Capacity](Record):
         """Return an iterator over the key-value pairs in the map."""
         return _ArrayMapEntryIterator(self, 0)
 
-    def __iter__(self):
+    def __iter__(self) -> SonolusIterator[K]:
         """Return an iterator over the keys in the map."""
         return self.keys()
 

sonolus/script/effect.py

@@ -21,6 +21,7 @@ class Effect(Record):
     id: int
     """Effect ID."""
 
+    @property
     def is_available(self) -> bool:
         """Return whether the effect clip is available."""
         return _has_effect_clip(self.id)

sonolus/script/globals.py

@@ -239,6 +239,7 @@ def level_memory[T](cls: type[T]) -> T:
     ([`preprocess`][sonolus.script.archetype.PlayArchetype.preprocess],
     [`update_sequential`][sonolus.script.archetype.PlayArchetype.update_sequential],
     [`touch`][sonolus.script.archetype.PlayArchetype.touch]).
+    Compared to level data, it allows modification during gameplay, but prevents some optimizations.
 
     Usage:
         ```python
@@ -246,7 +247,7 @@ def level_memory[T](cls: type[T]) -> T:
         class LevelMemory:
             variable: int
 
-        variable = level_data(Array[int, 10])
+        variable = level_memory(Array[int, 10])
 
         def f():
             LevelMemory.variable = 1
@@ -269,6 +270,8 @@ def level_data[T](cls: type[T]) -> T:
     """Define level data.
 
     Level data may only be modified during [`preprocess`][sonolus.script.archetype.PlayArchetype.preprocess].
+    Compared to level memory, it enables some optimizations during gameplay, so it's recommended to use it
+    if mutation is only needed during preprocessing.
 
     Usage:
         ```python

sonolus/script/internal/builtin_impls.py

@@ -84,7 +84,7 @@ def _zip(*iterables, strict: bool = False):
     from sonolus.backend.visitor import compile_and_call
     from sonolus.script.containers import Pair
 
-    if validate_value(strict)._as_py_():
+    if validate_value(strict)._as_py_():  # type: ignore
         raise NotImplementedError("Strict zipping is not supported")
 
     if not iterables:

sonolus/script/particle.py

@@ -15,6 +15,7 @@ class Particle(Record):
 
     id: int
 
+    @property
     def is_available(self) -> bool:
         """Check if the particle effect is available."""
         return _has_particle_effect(self.id)

{sonolus_py-0.6.1.dist-info → sonolus_py-0.6.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sonolus.py
-Version: 0.6.1
+Version: 0.6.3
 Summary: Sonolus engine development in Python
 License-File: LICENSE
 Requires-Python: >=3.12

{sonolus_py-0.6.1.dist-info → sonolus_py-0.6.3.dist-info}/RECORD

@@ -36,14 +36,14 @@ sonolus/build/project.py,sha256=eHh4ioOjaFtt26bcefUuDZhMhFw8NXnjRTYPiEInQV8,6505
 sonolus/script/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sonolus/script/archetype.py,sha256=DMtg-wWId6UAoh1L_jbMq4EMwLuY6tPY29wVoB8oD6A,47279
 sonolus/script/array.py,sha256=9uOUHZIDMyMT9q3APcXJWXWt97yG-AZoRlxwrvSY6SU,12367
-sonolus/script/array_like.py,sha256=jFOfXkniTLrIK4ER6HO_tUyKn_TvwjyM4B3SDd9cUS8,9678
+sonolus/script/array_like.py,sha256=hUDdDaP306kflVv9YomdHIMXogrVjxsBXCrLvB9QpuE,9681
 sonolus/script/bucket.py,sha256=SNqnfLGpnO_u-3LFFazdgzNk332OdDUIlmZHsuoVZuE,7674
-sonolus/script/containers.py,sha256=WX0qRnr6gNtn3C0q7MwMyrzvY-C0Bd1tzLGxSkUwL9U,18680
+sonolus/script/containers.py,sha256=L3rzPfN1cDb2m02k9qRyjnGxJx07X3q3MccCaL5tNJ8,18773
 sonolus/script/debug.py,sha256=Vi97opuk9fMB5bdpzPCBpa2oZeTff7FQ4WzdeDE5trk,4557
 sonolus/script/easing.py,sha256=txf0OPFP5v7cOFDvJKCyKLK-d2uKIOu56ntLEHfD9QI,11377
-sonolus/script/effect.py,sha256=OedYn0uOgYdZIGeJ6dATBSo5MSD21_v1Uvgoe6yVr9U,5964
+sonolus/script/effect.py,sha256=RQdsABqfi3sIku1jJDwyeD81devVyBhWQ47HIjfiMy0,5978
 sonolus/script/engine.py,sha256=etI9dJsQ7V9YZICVNZg54WqpLijPxG8eTPHiV-_EiG8,10687
-sonolus/script/globals.py,sha256=USwh_TuyZh1qORPVLk6x9qe3ca9iLhf5gnqT773gVvY,10007
+sonolus/script/globals.py,sha256=nlXSNS4NRXsgQU2AJImVIs752h1WqsMnShSKgU011c4,10270
 sonolus/script/instruction.py,sha256=Dd-14D5Amo8nhPBr6DNyg2lpYw_rqZkT8Kix3HkfE7k,6793
 sonolus/script/interval.py,sha256=dj6F2wn5uP6I6_mcZn-wIREgRUQbsLzhvhzB0oEyAdU,11290
 sonolus/script/iterator.py,sha256=_ICY_yX7FG0Zbgs3NhVnaIBdVDpAeXjxJ_CQtq30l7Y,3774
@@ -52,7 +52,7 @@ sonolus/script/maybe.py,sha256=VYvTWgEfPzoXqI3i3zXhc4dz0pWBVoHmW8FtWH0GQvM,8194
 sonolus/script/metadata.py,sha256=ttRK27eojHf3So50KQJ-8yj3udZoN1bli5iD-knaeLw,753
 sonolus/script/num.py,sha256=924kWWZusW7oaWuvtQzdAMzkb4ZItWSJwNj3W9XrqZU,16041
 sonolus/script/options.py,sha256=XVN-mL7Rwhd2Tu9YysYq9YDGpH_LazdmhqzSYE6nR3Q,9455
-sonolus/script/particle.py,sha256=m6VLH_05zKQIyiqyVyD6z0sbzjOYhRuZwgPY82u-BOo,8389
+sonolus/script/particle.py,sha256=RTfamg_ZTq7-qJ6j9paduNVUHCkw3hzkBK1QUbwwN7I,8403
 sonolus/script/pointer.py,sha256=FoOfyD93r0G5d_2BaKfeOT9SqkOP3hq6sqtOs_Rb0c8,1511
 sonolus/script/printing.py,sha256=mNYu9QWiacBBGZrnePZQMVwbbguoelUps9GiOK_aVRU,2096
 sonolus/script/project.py,sha256=BDGaae3lXWQqZgY3lF3_27VSSk_oGEA4sbN-gQFlhAM,4157
@@ -68,7 +68,7 @@ sonolus/script/ui.py,sha256=DYPGWIjHj1IFPxW1zaEuIUQx0b32FJPXtiwCvrtJ6oo,7528
 sonolus/script/values.py,sha256=6iJG6h4IDlbcK8FH4GENSHOQc7C_7fCGa34wM80qToA,1629
 sonolus/script/vec.py,sha256=oVx5C5zGj8gX37F7y1FEJOrTYzb7EWfQWQuKU8KGLdc,7486
 sonolus/script/internal/__init__.py,sha256=T6rzLoiOUaiSQtaHMZ88SNO-ijSjSSv33TKtUwu-Ms8,136
-sonolus/script/internal/builtin_impls.py,sha256=lu0Je_DD7xGjgF766sf0S0EiBEHiKuyre-2arI-ysZA,13170
+sonolus/script/internal/builtin_impls.py,sha256=R1h3IOlWzolPfc9yoma2cBN0F5cBhj_JNP-TTdKoBlc,13186
 sonolus/script/internal/callbacks.py,sha256=vWzJG8uiJoEtsNnbeZPqOHogCwoLpz2D1MnHY2wVV8s,2801
 sonolus/script/internal/constant.py,sha256=3ycbGkDJVUwcrCZ96vLjAoAARgsvaqDM8rJ_YCrLrvo,4289
 sonolus/script/internal/context.py,sha256=jto68tBpmF3As_h22tNVNP7ctJjt4S0HySF_DbFhbok,17361
@@ -86,8 +86,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.6.1.dist-info/METADATA,sha256=OMfsfCDRgKYqEstwDRS406iyVIZR6yofrkS3VOP7kVg,302
-sonolus_py-0.6.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-sonolus_py-0.6.1.dist-info/entry_points.txt,sha256=oTYspY_b7SA8TptEMTDxh4-Aj-ZVPnYC9f1lqH6s9G4,54
-sonolus_py-0.6.1.dist-info/licenses/LICENSE,sha256=JEKpqVhQYfEc7zg3Mj462sKbKYmO1K7WmvX1qvg9IJk,1067
-sonolus_py-0.6.1.dist-info/RECORD,,
+sonolus_py-0.6.3.dist-info/METADATA,sha256=HQELwglqS5CrpBjb6LhWu_Me95xkfIPothRlru-QuWI,302
+sonolus_py-0.6.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sonolus_py-0.6.3.dist-info/entry_points.txt,sha256=oTYspY_b7SA8TptEMTDxh4-Aj-ZVPnYC9f1lqH6s9G4,54
+sonolus_py-0.6.3.dist-info/licenses/LICENSE,sha256=JEKpqVhQYfEc7zg3Mj462sKbKYmO1K7WmvX1qvg9IJk,1067
+sonolus_py-0.6.3.dist-info/RECORD,,