trianglengin 2.0.2__cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl → 2.0.3__cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl

trianglengin/game_interface.py

@@ -8,6 +8,7 @@ import numpy as np
 from .config import EnvConfig
 
 try:
+    # Keep the alias for clarity within this file
     import trianglengin.trianglengin_cpp as cpp_module
 except ImportError as e:
     raise ImportError(
@@ -127,6 +128,19 @@ class GameState:
         # C++ returns double, cast might be redundant but safe for mypy
         return cast("float", self._cpp_state.get_score())
 
+    def get_outcome(self) -> float:
+        """
+        Returns the final outcome of the game if it's over, otherwise 0.0.
+        Required by MCTS implementations like trimcts.
+        """
+        if self.is_over():
+            # In this game, the final score is the outcome.
+            # Adjust if a different outcome definition is needed (e.g., +1 win, -1 loss).
+            return self.game_score()
+        else:
+            # MCTS typically expects 0 for non-terminal states during simulation.
+            return 0.0
+
     def valid_actions(self, force_recalculate: bool = False) -> set[int]:
         """
         Returns a set of valid encoded action indices for the current state.

{trianglengin-2.0.2.dist-info → trianglengin-2.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trianglengin
-Version: 2.0.2
+Version: 2.0.3
 Summary: High-performance C++/Python engine for a triangle puzzle game.
 Author-email: "Luis Guilherme P. M." <lgpelin92@gmail.com>
 License-Expression: MIT
@@ -40,7 +40,7 @@ Dynamic: license-file
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 
-# Triangle Engine (`trianglengin`) v2
+# Triangle Engine (`trianglengin`) v2.0.3
 <img src="bitmap.png" alt="trianglengin logo" width="300"/>
 
 **Version 2 introduces a high-performance C++ core for the game logic.**
@@ -78,7 +78,7 @@ The primary goal is to provide a self-contained, installable library with a high
 
 ```bash
 # For standard use (once published or built):
-pip install trianglengin
+pip install trianglengin>=2.0.3
 
 # Building from source (requires compiler and CMake):
 git clone https://github.com/lguibr/trianglengin.git
@@ -233,7 +233,7 @@ trianglengin/
 ## Core Components (v2)
 
 - **`trianglengin.cpp` (C++ Core)**: Implements the high-performance game logic (state, grid, shapes, rules). Not directly imported in Python.
-- **`trianglengin.game_interface.GameState` (Python Wrapper)**: The primary Python class for interacting with the game engine. It holds a reference to the C++ game state object and provides methods like `step`, `reset`, `is_over`, `valid_actions`, `get_shapes`, `get_grid_data_np`.
+- **`trianglengin.game_interface.GameState` (Python Wrapper)**: The primary Python class for interacting with the game engine. It holds a reference to the C++ game state object and provides methods like `step`, `reset`, `is_over`, `valid_actions`, `get_shapes`, `get_grid_data_np`, **`get_outcome`**.
 - **`trianglengin.config.EnvConfig`**: Python Pydantic model for core environment configuration. Passed to C++ core during initialization.
 - **`trianglengin.utils`**: General Python utility functions and types. ([`src/trianglengin/utils/README.md`](src/trianglengin/utils/README.md))
 

{trianglengin-2.0.2.dist-info → trianglengin-2.0.3.dist-info}/RECORD

@@ -1,11 +1,5 @@
-trianglengin-2.0.2.dist-info/WHEEL,sha256=EJ8ft41aGbRGrnsw1f2-TxvNl17T3GyIFIGrRksXEJ8,147
-trianglengin-2.0.2.dist-info/RECORD,,
-trianglengin-2.0.2.dist-info/top_level.txt,sha256=YsSWmp_2zM23wRc5TRERHpVCgQuVYieYHDTpnwVQC7Y,13
-trianglengin-2.0.2.dist-info/entry_points.txt,sha256=kQEqO_U-MEpMEC0xwOPSucBzQIq2Ny7XwCtFSruZhvY,57
-trianglengin-2.0.2.dist-info/METADATA,sha256=Io9O5zLlg5f3wzujuWaJaZWqkVP_6XyOQbj7xtDoiNw,12036
-trianglengin-2.0.2.dist-info/licenses/LICENSE,sha256=So3rgoJp-HgoxkclxZLIBC3pmmTwshN4tUO8KiQ6akc,1077
 trianglengin/trianglengin_cpp.cpython-37m-i386-linux-gnu.so,sha256=ou1cGulbl7wisMNHFCawlKGmEO_HwINvT_fgCG_68q4,342556
-trianglengin/game_interface.py,sha256=0aCePxmhLJOdlPGHU_JOuu-lsBZVfOs0vK5eke-bxv0,8730
+trianglengin/game_interface.py,sha256=ijfBH08DU2sHyMH6XZmQbFQZDPGsKlkk3gk3AUt3fmU,9304
 trianglengin/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 trianglengin/__init__.py,sha256=4INnGvOYIjzOyCew7lhX6Irc8_H7QVxWc5jopt9TCZ4,919
 trianglengin/trianglengin_cpp.cpython-313-i386-linux-gnu.so,sha256=ou1cGulbl7wisMNHFCawlKGmEO_HwINvT_fgCG_68q4,342556
@@ -57,3 +51,9 @@ trianglengin/ui/visualization/core/__init__.py,sha256=26XCOn_jywwQ0YszGP6rEgFJIq
 trianglengin/ui/visualization/core/fonts.py,sha256=d9kQqdilPK0pTvXhv2oVJAbVT4pmWfjKxXfEir7Avdg,2016
 trianglengin/ui/visualization/core/visualizer.py,sha256=gWY4_vZGEzTokl6Z7xMeGvdrpJMl4YdZnfoT4bgBYW4,8860
 trianglengin/core/__init__.py,sha256=zMo_rn4wzVGzrevzZM4u4rkLwicZQeDqmXbnk9fI008,460
+trianglengin-2.0.3.dist-info/WHEEL,sha256=EJ8ft41aGbRGrnsw1f2-TxvNl17T3GyIFIGrRksXEJ8,147
+trianglengin-2.0.3.dist-info/RECORD,,
+trianglengin-2.0.3.dist-info/top_level.txt,sha256=YsSWmp_2zM23wRc5TRERHpVCgQuVYieYHDTpnwVQC7Y,13
+trianglengin-2.0.3.dist-info/entry_points.txt,sha256=kQEqO_U-MEpMEC0xwOPSucBzQIq2Ny7XwCtFSruZhvY,57
+trianglengin-2.0.3.dist-info/METADATA,sha256=JQjjqC7xfHqrYAoSZx-07pFzVN4hb1SmyDFPvHG_Lvo,12066
+trianglengin-2.0.3.dist-info/licenses/LICENSE,sha256=So3rgoJp-HgoxkclxZLIBC3pmmTwshN4tUO8KiQ6akc,1077