algorhino-anemone 0.1.10__tar.gz → 0.1.11__tar.gz

{algorhino_anemone-0.1.10/src/algorhino_anemone.egg-info → algorhino_anemone-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: algorhino-anemone
-Version: 0.1.10
+Version: 0.1.11
 Summary: anemone searches trees
 Author-email: Victor Gabillon <victorgabillon@gmail.com>
 License-Expression: GPL-3.0-only
@@ -12,18 +12,18 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: valanga>=0.1.13
-Requires-Dist: atomheart>=0.1.6
+Requires-Dist: valanga>=0.1.14
+Requires-Dist: atomheart>=0.1.7
 Requires-Dist: rich
 Requires-Dist: sortedcollections>=2.1.0
 Requires-Dist: graphviz
 Provides-Extra: test
-Requires-Dist: pytest>=8.4.1; extra == "test"
+Requires-Dist: pytest>=9.0.2; extra == "test"
 Requires-Dist: coverage; extra == "test"
 Requires-Dist: pytest-cov>=6.0.0; extra == "test"
 Provides-Extra: lint
-Requires-Dist: ruff>=0.14.1; extra == "lint"
-Requires-Dist: pylint>=3.3.8; extra == "lint"
+Requires-Dist: ruff>=0.15.0; extra == "lint"
+Requires-Dist: pylint>=4.0.4; extra == "lint"
 Provides-Extra: typecheck
 Requires-Dist: mypy>=1.18.2; extra == "typecheck"
 Requires-Dist: pyright[nodejs]>=1.1.408; extra == "typecheck"

{algorhino_anemone-0.1.10 → algorhino_anemone-0.1.11}/pyproject.toml

@@ -1,11 +1,11 @@
 [build-system]
-requires = ["setuptools>=80.9.0"]
+requires = ["setuptools>=80.10.2"]
 build-backend = "setuptools.build_meta"
 
 
 [project]
 name = "algorhino-anemone"
-version = "0.1.10"
+version = "0.1.11"
 description = "anemone searches trees"
 keywords = ["tree", "search"]
 classifiers = [
@@ -14,8 +14,8 @@ classifiers = [
 ]
 requires-python = ">=3.13"
 dependencies = [
-    "valanga>=0.1.13",
-    "atomheart>=0.1.6",
+    "valanga>=0.1.14",
+    "atomheart>=0.1.7",
     "rich",
     "sortedcollections>=2.1.0",
     "graphviz",
@@ -32,14 +32,14 @@ authors = [
 
 [project.optional-dependencies]
 test = [
-  "pytest>=8.4.1",
+  "pytest>=9.0.2",
   "coverage",
   "pytest-cov>=6.0.0",
 ]
 
 lint = [
-  "ruff>=0.14.1",
-  "pylint>=3.3.8",
+  "ruff>=0.15.0",
+  "pylint>=4.0.4",
 ]
 
 typecheck = [
@@ -160,13 +160,21 @@ line-length = 88
 target-version = "py313"
 
 # Enable import sorting (alphabetical + group order)
-lint.select = ["I", "F", "E", "B", "TCH"]  # I = imports, F = pyflakes, E = pycodestyle, TCH = type-checking, B = black
+lint.select = ["I", "F", "E", "B", "TCH","UP","SIM", "RUF","RET","N","A",
+"ANN", "PERF", "TRY","LOG","RSE","ICN","TID","Q","W","D",
+"ISC","PIE","ERA","TD"]  # I = imports, F = pyflakes, E = pycodestyle, TCH = type-checking, B = black
 
 # Allow auto-fixing for imports and type-checking imports
-lint.fixable = ["I", "TCH", "F401"]
+lint.fixable = ["I", "TCH", "D","F401","UP","SIM","RET","RUF","E","TRY","PERF","RSE","ANN","PIE","ERA","TD"]
 
 # Ignore rules you don't care about
-lint.ignore = [ "E501"]
+lint.ignore = [ "E501",
+  "ANN401",
+  "TD003",
+  "TD002",
+  "D203",  # incompatible with D211
+  "D213",  # incompatible with D212
+    ]
 
 # Optional: add your first-party package to extend the known group
 [tool.ruff.lint.per-file-ignores]
@@ -265,19 +273,19 @@ description = "ruff + pylint (fast, no package build/install)"
 package = "skip"
 deps = [
   # runtime deps needed for pylint imports (match [project].dependencies)
-    "valanga>=0.1.13",
-    "atomheart>=0.1.6",
+    "valanga>=0.1.14",
+    "atomheart>=0.1.7",
   "rich",
   "sortedcollections>=2.1.0",
   "graphviz",
 
   # tools
-  "ruff>=0.14.1",
-  "pylint>=3.3.8",
+  "ruff>=0.15.0",
+  "pylint>=4.0.4",
 ]
 set_env = { PYTHONPATH = "{toxinidir}/src" }
 commands = [
-  ["python", "-m", "ruff", "check", "src", "tests"],
+  ["python", "-m", "ruff", "check", "src"],
   ["python", "-m", "ruff", "format", "--check", "src", "tests"],
   ["python", "-m", "pylint", "src/anemone"],
 ]
@@ -290,8 +298,8 @@ description = "mypy + pyright (fast, no package build/install)"
 package = "skip"
 deps = [
   # runtime deps for import resolution
-    "valanga>=0.1.13",
-    "atomheart>=0.1.6",
+    "valanga>=0.1.14",
+    "atomheart>=0.1.7",
   "rich",
   "sortedcollections>=2.1.0",
   "graphviz",

{algorhino_anemone-0.1.10 → algorhino_anemone-0.1.11/src/algorhino_anemone.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: algorhino-anemone
-Version: 0.1.10
+Version: 0.1.11
 Summary: anemone searches trees
 Author-email: Victor Gabillon <victorgabillon@gmail.com>
 License-Expression: GPL-3.0-only
@@ -12,18 +12,18 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: valanga>=0.1.13
-Requires-Dist: atomheart>=0.1.6
+Requires-Dist: valanga>=0.1.14
+Requires-Dist: atomheart>=0.1.7
 Requires-Dist: rich
 Requires-Dist: sortedcollections>=2.1.0
 Requires-Dist: graphviz
 Provides-Extra: test
-Requires-Dist: pytest>=8.4.1; extra == "test"
+Requires-Dist: pytest>=9.0.2; extra == "test"
 Requires-Dist: coverage; extra == "test"
 Requires-Dist: pytest-cov>=6.0.0; extra == "test"
 Provides-Extra: lint
-Requires-Dist: ruff>=0.14.1; extra == "lint"
-Requires-Dist: pylint>=3.3.8; extra == "lint"
+Requires-Dist: ruff>=0.15.0; extra == "lint"
+Requires-Dist: pylint>=4.0.4; extra == "lint"
 Provides-Extra: typecheck
 Requires-Dist: mypy>=1.18.2; extra == "typecheck"
 Requires-Dist: pyright[nodejs]>=1.1.408; extra == "typecheck"

{algorhino_anemone-0.1.10 → algorhino_anemone-0.1.11}/src/algorhino_anemone.egg-info/requires.txt

@@ -1,5 +1,5 @@
-valanga>=0.1.13
-atomheart>=0.1.6
+valanga>=0.1.14
+atomheart>=0.1.7
 rich
 sortedcollections>=2.1.0
 graphviz
@@ -15,15 +15,15 @@ sphinx-autodoc-typehints
 pre-commit
 
 [lint]
-ruff>=0.14.1
-pylint>=3.3.8
+ruff>=0.15.0
+pylint>=4.0.4
 
 [nn]
 algorhino-coral
 torch
 
 [test]
-pytest>=8.4.1
+pytest>=9.0.2
 coverage
 pytest-cov>=6.0.0
 

{algorhino_anemone-0.1.10 → algorhino_anemone-0.1.11}/src/anemone/__init__.py

@@ -1,5 +1,4 @@
-"""
-This module provides functionality for creating tree and value builders for the TreeAndValuePlayer.
+"""Provide functionality for creating tree and value builders for the TreeAndValuePlayer.
 
 The TreeAndValuePlayerArgs class represents the arguments for configuring the TreeAndValuePlayer.
 The create_tree_and_value_builders function is used to create the tree and value builders.

algorhino_anemone-0.1.11/src/anemone/basics.py

@@ -0,0 +1,6 @@
+"""Basic types and protocols for Anemone."""
+
+from typing import Annotated
+
+type Seed = Annotated[int, "seed"]
+type TreeDepth = Annotated[int, "Depth level of a node in a tree structure"]

{algorhino_anemone-0.1.10 → algorhino_anemone-0.1.11}/src/anemone/factory.py

@@ -1,11 +1,8 @@
-"""
-Module for creating Tree and Value Branch Selector objects.
-"""
+"""Module for creating Tree and Value Branch Selector objects."""
 
 from dataclasses import dataclass
-from queue import Queue
 from random import Random
-from typing import Literal, Type
+from typing import Literal
 
 from valanga import RepresentationFactory, StateModifications, TurnState
 from valanga.evaluator_types import EvaluatorInput
@@ -26,7 +23,6 @@ from anemone.nodes.algorithm_node.algorithm_node import AlgorithmNode
 from anemone.progress_monitor.progress_monitor import (
     AllStoppingCriterionArgs,
 )
-from anemone.utils.dataclass import IsDataclass
 
 from . import node_selector as node_selector_m
 from . import recommender_rule
@@ -40,9 +36,7 @@ TREE_AND_VALUE_LITERAL_STRING: Literal["TreeAndValue"] = "TreeAndValue"
 
 @dataclass
 class TreeAndValuePlayerArgs:
-    """
-    Dataclass for Tree and Value Player Arguments.
-    """
+    """Dataclass for Tree and Value Player Arguments."""
 
     node_selector: node_selector_m.AllNodeSelectorArgs
     opening_type: node_selector_m.OpeningType
@@ -53,7 +47,7 @@ class TreeAndValuePlayerArgs:
 
 
 def create_tree_and_value_branch_selector[StateT: TurnState](
-    state_type: Type[StateT],
+    state_type: type[StateT],
     args: TreeAndValuePlayerArgs,
     random_generator: Random,
     master_state_evaluator: MasterStateEvaluator,
@@ -61,15 +55,13 @@ def create_tree_and_value_branch_selector[StateT: TurnState](
         StateT, EvaluatorInput, StateModifications
     ]
     | None,
-    queue_progress_player: Queue[IsDataclass] | None,
 ) -> TreeAndValueBranchSelector[StateT]:
-    """Convenience constructor using the default minmax tree evaluation.
+    """Create a branch selector using the default minmax tree evaluation.
 
     This keeps the existing API stable, while allowing advanced users to inject a
     different tree-evaluation strategy via
     `create_tree_and_value_branch_selector_with_tree_eval_factory`.
     """
-
     node_tree_evaluation_factory: NodeTreeEvaluationFactory[StateT]
     node_tree_evaluation_factory = NodeTreeMinmaxEvaluationFactory[StateT]()
 
@@ -80,12 +72,11 @@ def create_tree_and_value_branch_selector[StateT: TurnState](
         master_state_evaluator=master_state_evaluator,
         state_representation_factory=state_representation_factory,
         node_tree_evaluation_factory=node_tree_evaluation_factory,
-        queue_progress_player=queue_progress_player,
     )
 
 
 def create_tree_and_value_branch_selector_with_tree_eval_factory[StateT: TurnState](
-    state_type: Type[StateT],
+    state_type: type[StateT],
     args: TreeAndValuePlayerArgs,
     random_generator: Random,
     master_state_evaluator: MasterStateEvaluator,
@@ -94,21 +85,21 @@ def create_tree_and_value_branch_selector_with_tree_eval_factory[StateT: TurnSta
     ]
     | None,
     node_tree_evaluation_factory: NodeTreeEvaluationFactory[StateT],
-    queue_progress_player: Queue[IsDataclass] | None,
 ) -> TreeAndValueBranchSelector[StateT]:
-    """
-    Create a TreeAndValueBranchSelector object with the given arguments.
+    """Create a TreeAndValueBranchSelector object with the given arguments.
 
     Args:
-        args (TreeAndValuePlayerArgs): The arguments for creating the TreeAndValueBranchSelector.
-        syzygy (SyzygyTable | None): The SyzygyTable object for tablebase endgame evaluation.
-        random_generator (random.Random): The random number generator.
+        state_type (type[StateT]): The state type for the search.
+        args (TreeAndValuePlayerArgs): Arguments for creating the selector.
+        random_generator (Random): The random number generator.
+        master_state_evaluator (MasterStateEvaluator): Evaluator for state values.
+        state_representation_factory (RepresentationFactory | None): Optional state representation factory.
+        node_tree_evaluation_factory (NodeTreeEvaluationFactory[StateT]): Factory for node tree evaluations.
 
     Returns:
         TreeAndValueBranchSelector: The created TreeAndValueBranchSelector object.
 
     """
-
     _ = state_type  # not used here
 
     node_evaluator: NodeDirectEvaluator[StateT] = create_node_evaluator(
@@ -155,7 +146,6 @@ def create_tree_and_value_branch_selector_with_tree_eval_factory[StateT: TurnSta
             node_selector_create=search_factory.create_node_selector_factory(),
             stopping_criterion_args=args.stopping_criterion,
             recommend_branch_after_exploration=args.recommender_rule,
-            queue_progress_player=queue_progress_player,
         )
     )
     return tree_branch_selector

algorhino_anemone-0.1.11/src/anemone/indices/__init__.py

@@ -0,0 +1 @@
+"""Index utilities for node exploration and index management."""

{algorhino_anemone-0.1.10 → algorhino_anemone-0.1.11}/src/anemone/indices/index_manager/__init__.py

@@ -1,5 +1,4 @@
-"""
-This module provides functionality for managing exploration index managers.
+"""Provide functionality for managing exploration index managers.
 
 The module includes the following functions and classes:
 - create_exploration_index_manager: A function to create an exploration index manager.
@@ -9,4 +8,4 @@ The module includes the following functions and classes:
 from .factory import create_exploration_index_manager
 from .node_exploration_manager import NodeExplorationIndexManager
 
-__all__ = ["create_exploration_index_manager", "NodeExplorationIndexManager"]
+__all__ = ["NodeExplorationIndexManager", "create_exploration_index_manager"]

{algorhino_anemone-0.1.10 → algorhino_anemone-0.1.11}/src/anemone/indices/index_manager/factory.py

@@ -1,6 +1,4 @@
-"""
-This module contains the factory function to create a node exploration index manager based on the given index computation
-"""
+"""Provide a factory for node exploration index managers."""
 
 from anemone.indices.index_manager.node_exploration_manager import (
     NodeExplorationIndexManager,
@@ -14,11 +12,20 @@ from anemone.indices.node_indices.index_types import (
 )
 
 
+class UnknownIndexComputationError(ValueError):
+    """Raised when an index computation type is not recognized."""
+
+    def __init__(self, index_computation: IndexComputationType) -> None:
+        """Initialize the error with the unsupported computation type."""
+        super().__init__(
+            f"player creator: can not find {index_computation} in {__name__}"
+        )
+
+
 def create_exploration_index_manager(
     index_computation: IndexComputationType | None = None,
 ) -> NodeExplorationIndexManager:
-    """
-    Creates a node exploration index manager based on the given index computation type.
+    """Create a node exploration index manager for the given index computation type.
 
     Args:
         index_computation (IndexComputationType | None): The type of index computation to be used.
@@ -43,8 +50,6 @@ def create_exploration_index_manager(
             case IndexComputationType.MIN_LOCAL_CHANGE:
                 node_exploration_manager = UpdateIndexLocalMinChange()
             case _:
-                raise ValueError(
-                    f"player creator: can not find {index_computation} in {__name__}"
-                )
+                raise UnknownIndexComputationError(index_computation)
 
     return node_exploration_manager