tcod-ecs 5.2.4__tar.gz → 5.3.0__tar.gz

{tcod_ecs-5.2.4 → tcod_ecs-5.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tcod-ecs
-Version: 5.2.4
+Version: 5.3.0
 Summary: A type-hinted Entity Component System based on Python dictionaries and sets.
 Author-email: Kyle Benesch <4b796c65+github@gmail.com>
 Requires-Python: >=3.8

{tcod_ecs-5.2.4 → tcod_ecs-5.3.0}/tcod/ecs/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '5.2.4'
-__version_tuple__ = version_tuple = (5, 2, 4)
+__version__ = version = '5.3.0'
+__version_tuple__ = version_tuple = (5, 3, 0)

{tcod_ecs-5.2.4 → tcod_ecs-5.3.0}/tcod/ecs/entity.py

@@ -77,7 +77,7 @@ class Entity:
     def world(self) -> Registry:
         """Deprecated alias for registry.
 
-        .. deprecated:: Unreleased
+        .. deprecated:: 5.1
             Use :any:`registry` instead.
         """
         if __debug__:

{tcod_ecs-5.2.4 → tcod_ecs-5.3.0}/tcod/ecs/query.py

@@ -336,7 +336,7 @@ class BoundQuery:
     def world(self) -> Registry:
         """Deprecated alias for registry.
 
-        .. deprecated:: Unreleased
+        .. deprecated:: 5.1
             Use :any:`registry` instead.
         """
         if __debug__:
@@ -404,6 +404,30 @@ class BoundQuery:
             & self._query,
         )
 
+    def any_of(
+        self,
+        components: Iterable[ComponentKey[object]] = (),
+        *,
+        tags: Iterable[object] = (),
+        relations: Iterable[_RelationQuery] = (),
+        traverse: Iterable[object] = (IsA,),
+        depth: int | None = None,
+    ) -> Self:
+        """Filter entities based on having at least one of the provided elements.
+
+        .. versionadded:: 5.3
+        """
+        _check_suspicious_tags(tags, stacklevel=2)
+        return self.__class__(
+            self.registry,
+            _QueryLogicalAnd(
+                all_of=frozenset(
+                    [_QueryLogicalOr(any_of=frozenset(self.__as_queries(components, tags, relations, traverse, depth)))]
+                )
+            )
+            & self._query,
+        )
+
     def __iter__(self) -> Iterator[Entity]:
         """Iterate over the matching entities."""
         return iter(self.get_entities())