From 0a295cd254e2add318c0ea6c8f04946b931cfbff Mon Sep 17 00:00:00 2001 From: Nick Date: Sun, 15 Nov 2026 17:06:43 -0600 Subject: [PATCH 1/2] Treat absent UseNNUE with false setting as HCE-only engine --- src/tunex/engine.py | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/tunex/engine.py b/src/tunex/engine.py index 1559c73..1dbd66e 100644 --- a/src/tunex/engine.py +++ b/src/tunex/engine.py @@ -158,6 +158,11 @@ def ready(self) -> None: self._read_until(lambda line: line == "readyok", self.startup_timeout) def set_option(self, name: str, value: Any) -> None: + # Engines without a UseNNUE option are HCE-only. Do not send an + # unsupported setoption command when NNUE was explicitly disabled. + # Asking to ENABLE NNUE must still fail under strict validation. + if name == "UseNNUE" and "UseNNUE" not in self.options and value is False: + return if self.strict_options and self.options and name not in self.options: raise EngineError(f"{self.name} does not advertise UCI option {name!r}") if value is None: From fbb05d274ebf3c428cc6f50515c76651ff6be016 Mon Sep 17 00:00:00 2001 From: Nick Date: Sun, 15 Nov 2026 17:06:56 -0600 Subject: [PATCH 2/2] Add regression tests for HCE-only engines lacking UseNNUE --- tests/test_optional_usennue.py | 46 ++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 tests/test_optional_usennue.py diff --git a/tests/test_optional_usennue.py b/tests/test_optional_usennue.py new file mode 100644 index 0000000..5f3ea61 --- /dev/null +++ b/tests/test_optional_usennue.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +import unittest +from unittest.mock import MagicMock + +from tunex.engine import EngineError, UciEngine + + +class OptionalUseNnueTests(unittest.TestCase): + def make_engine(self, *, strict: bool = True) -> UciEngine: + engine = UciEngine("unused", name="HCE engine", strict_options=strict) + engine.options = {"Hash", "Threads"} + engine.send = MagicMock() + return engine + + def test_false_use_nnue_is_ignored_when_unadvertised(self): + engine = self.make_engine() + engine.set_option("UseNNUE", False) + engine.send.assert_not_called() + + def test_missing_use_nnue_true_is_rejected(self): + engine = self.make_engine() + with self.assertRaisesRegex(EngineError, "UseNNUE"): + engine.set_option("UseNNUE", True) + engine.send.assert_not_called() + + def test_missing_use_nnue_true_still_sent_when_non_strict(self): + engine = self.make_engine(strict=False) + engine.set_option("UseNNUE", True) + engine.send.assert_called_once_with("setoption name UseNNUE value true") + + def test_advertised_use_nnue_false_is_sent(self): + engine = self.make_engine() + engine.options.add("UseNNUE") + engine.set_option("UseNNUE", False) + engine.send.assert_called_once_with("setoption name UseNNUE value false") + + def test_other_missing_option_still_rejected(self): + engine = self.make_engine() + with self.assertRaisesRegex(EngineError, "UnknownOption"): + engine.set_option("UnknownOption", 1) + engine.send.assert_not_called() + + +if __name__ == "__main__": + unittest.main()