embodiscope 0.0.1a0__py3-none-any.whl

embodiscope/__init__.py

@@ -0,0 +1,6 @@
+"""Small utilities for embodied policy evaluation."""
+
+from .metrics import SuccessSummary, summarize_successes
+
+__version__ = "0.0.1a0"
+__all__ = ["SuccessSummary", "summarize_successes", "__version__"]

embodiscope/metrics.py

@@ -0,0 +1,35 @@
+"""Aggregate binary episode outcomes without external dependencies."""
+
+from collections.abc import Iterable
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class SuccessSummary:
+    """Episode counts and success rate; the rate is None for zero episodes."""
+
+    episodes: int
+    successes: int
+
+    @property
+    def failures(self) -> int:
+        return self.episodes - self.successes
+
+    @property
+    def success_rate(self) -> float | None:
+        return self.successes / self.episodes if self.episodes else None
+
+
+def summarize_successes(outcomes: Iterable[bool]) -> SuccessSummary:
+    """Count episodes and successes in one pass.
+
+    Accepts actual booleans only, so strings such as "false" cannot silently
+    count as successful episodes. An empty iterable yields a None success rate.
+    """
+    episodes = successes = 0
+    for outcome in outcomes:
+        if type(outcome) is not bool:
+            raise TypeError("Each episode outcome must be a bool (True or False).")
+        episodes += 1
+        successes += int(outcome)
+    return SuccessSummary(episodes=episodes, successes=successes)

embodiscope-0.0.1a0.dist-info/METADATA

@@ -0,0 +1,44 @@
+Metadata-Version: 2.5
+Name: embodiscope
+Version: 0.0.1a0
+Summary: Small utilities for embodied policy evaluation — early development release
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# EmbodiScope
+
+Small, dependency-free utilities for embodied policy evaluation.
+
+## Status
+
+This is an early development release with a deliberately small API. The project
+name and API are provisional. This release provides episode success statistics;
+it does not include model inference, benchmark runners, or simulator integrations.
+
+## Install
+
+```sh
+pip install --pre embodiscope
+```
+
+## Summarize episode outcomes
+
+```python
+from embodiscope import summarize_successes
+
+summary = summarize_successes([True, False, True, True])
+print(summary.episodes)      # 4
+print(summary.successes)     # 3
+print(summary.failures)      # 1
+print(summary.success_rate)  # 0.75
+```
+
+The function consumes any iterable of booleans in one pass. Non-boolean values
+raise `TypeError`, avoiding accidental truthiness of strings such as `"false"`.
+For zero episodes, `success_rate` is `None`, distinguishing missing observations
+from a measured zero success rate.

embodiscope-0.0.1a0.dist-info/RECORD

@@ -0,0 +1,5 @@
+embodiscope/__init__.py,sha256=rVcB4xuuGCpo48SrBisw_NWHbFzjdqquj8Jh8bHc3TM,204
+embodiscope/metrics.py,sha256=-ksL90xseSfzuhLCIfELTYoILIXS0I52ha5VTEAYDZ4,1120
+embodiscope-0.0.1a0.dist-info/METADATA,sha256=qQ2dMMBBTSUYIm35LwlsSVw_-FFYZ0RtBzHyDxcaRi0,1416
+embodiscope-0.0.1a0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+embodiscope-0.0.1a0.dist-info/RECORD,,

embodiscope-0.0.1a0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any