Bump SLMP Python to 0.1.12

Author: fa-yoshinobu

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## 0.1.12 - 2026-04-27
+
+### Changed
+- Bumped the library revision for the cross-library SLMP parity release. The Python route guards from `0.1.11` are unchanged and remain aligned with the updated shared verification suite.
+- Kept the CLI's internal manual-profile client type-checkable under the repository mypy settings.
+
 ## 0.1.11 - 2026-04-27
 
 ### Changed

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "slmp-connect-python"
-version = "0.1.11"
+version = "0.1.12"
 description = "SLMP Connect Python: client library for Mitsubishi SLMP binary communication"
 readme = "README.md"
 requires-python = ">=3.10"

slmp/__init__.py

@@ -10,7 +10,7 @@
 - ``poll``
 """
 
-__version__ = "0.1.11"
+__version__ = "0.1.12"
 
 from .async_client import AsyncSlmpClient
 from .client import SlmpClient

slmp/async_client.py

@@ -133,9 +133,7 @@ def __init__(
                     "plc_family is required for the standard AsyncSlmpClient route "
                     "unless you explicitly opt into a low-level frame/profile path."
                 )
-            if plc_family is not None and any(
-                value is not None for value in (plc_series, frame_type, device_family)
-            ):
+            if plc_family is not None and any(value is not None for value in (plc_series, frame_type, device_family)):
                 raise ValueError(
                     "plc_family is the only supported PLC selector for the standard AsyncSlmpClient route."
                 )

slmp/cli.py

@@ -50,10 +50,40 @@
 from .errors import SlmpPracticalPathWarning
 
 
-def SlmpClient(*args: object, **kwargs: object) -> _StandardSlmpClient:
-    """Internal low-level constructor for CLI probe commands."""
-    kwargs["_allow_manual_profile"] = True
-    return _StandardSlmpClient(*args, **kwargs)
+class SlmpClient(_StandardSlmpClient):
+    """Internal low-level client for CLI probe commands."""
+
+    def __init__(
+        self,
+        host: str,
+        port: int = 5000,
+        *,
+        transport: str = "tcp",
+        timeout: float = 3.0,
+        plc_family: object | None = None,
+        plc_series: PLCSeries | str | None = None,
+        frame_type: FrameType | str | None = None,
+        default_target: SlmpTarget | None = None,
+        monitoring_timer: int = 0x0010,
+        raise_on_error: bool = True,
+        trace_hook: Callable[[SlmpTraceFrame], None] | None = None,
+        device_family: object | None = None,
+    ) -> None:
+        super().__init__(
+            host,
+            port,
+            transport=transport,
+            timeout=timeout,
+            plc_family=plc_family,
+            plc_series=plc_series,
+            frame_type=frame_type,
+            default_target=default_target,
+            monitoring_timer=monitoring_timer,
+            raise_on_error=raise_on_error,
+            trace_hook=trace_hook,
+            device_family=device_family,
+            _allow_manual_profile=True,
+        )
 
 
 def _int_auto(text: str) -> int:
@@ -1698,7 +1728,7 @@ def _resolve_report_output(
 
 
 def _probe_device_read_with_series(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     device: str,
     points: int,
@@ -1796,7 +1826,7 @@ def _compatibility_subprobe(
 
 
 def _compatibility_request_subprobe(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     name: str,
     command: int | Command,
@@ -1812,7 +1842,7 @@ def _compatibility_request_subprobe(
 
 
 def _compatibility_probe_direct_word_write_restore(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     device: str,
     preferred_write_value: int,
@@ -1831,7 +1861,7 @@ def _compatibility_probe_direct_word_write_restore(
 
 
 def _compatibility_probe_direct_bit_write_restore(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     device: str,
     series: PLCSeries,
@@ -1846,7 +1876,7 @@ def _compatibility_probe_direct_bit_write_restore(
 
 
 def _compatibility_probe_random_word_write_restore(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     devices: Sequence[str],
     preferred_write_value: int,
@@ -1868,7 +1898,7 @@ def _compatibility_probe_random_word_write_restore(
 
 
 def _compatibility_probe_random_bit_write_restore(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     devices: Sequence[str],
     series: PLCSeries,
@@ -1890,7 +1920,7 @@ def _compatibility_probe_random_bit_write_restore(
 
 
 def _compatibility_probe_block_write_restore(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     word_device: str | None,
     bit_device: str | None,
@@ -1943,7 +1973,7 @@ def _compatibility_probe_block_write_restore(
 
 
 def _compatibility_probe_memory_write_restore(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     head_address: int,
     preferred_write_value: int,
@@ -1962,7 +1992,7 @@ def _compatibility_probe_memory_write_restore(
 
 def _compatibility_run_command(
     spec: CompatibilityCommandSpec,
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     series: PLCSeries,
     args: argparse.Namespace,
@@ -2246,7 +2276,7 @@ def _block_read_mixed_detail() -> str:
     raise ValueError(f"unsupported compatibility command code: {spec.code}")
 
 
-def _probe_sm400_series(client: SlmpClient) -> tuple[PLCSeries, list[bool]]:
+def _probe_sm400_series(client: _StandardSlmpClient) -> tuple[PLCSeries, list[bool]]:
     series, values = _probe_device_read_with_series(
         client,
         device="SM400",
@@ -2435,7 +2465,7 @@ def _format_manual_value(kind: str, value: int | bool) -> str:
     return f"0x{int(value):04X} ({int(value)})"
 
 
-def _read_manual_row_value(client: SlmpClient, row: DeviceMatrixRow, *, series: str) -> int | bool:
+def _read_manual_row_value(client: _StandardSlmpClient, row: DeviceMatrixRow, *, series: str) -> int | bool:
     code = row.device_code.upper()
     number = parse_device(row.device).number
     if code == "LTC":
@@ -2458,7 +2488,7 @@ def _read_manual_row_value(client: SlmpClient, row: DeviceMatrixRow, *, series:
 
 
 def _write_manual_row_value(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     row: DeviceMatrixRow,
     value: int | bool,
     *,
@@ -2826,7 +2856,7 @@ def _trace_hook(trace: SlmpTraceFrame) -> None:
 
 
 def _run_extended_device_word_probe(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     item_name: str,
     device: str,
@@ -2872,7 +2902,7 @@ def _run_extended_device_word_probe(
 
 
 def _run_extended_device_word_span_probe(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     item_name: str,
     device: str,
@@ -2983,7 +3013,7 @@ def _format_counter(counter: dict[str, int] | Sequence[tuple[str, int]]) -> str:
 
 
 def _raw_device_read(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     device: str,
     points: int,
@@ -3002,7 +3032,7 @@ def _raw_device_read(
 
 
 def _raw_device_write(
-    client: SlmpClient,
+    client: _StandardSlmpClient,
     *,
     device: str,
     values: Sequence[int | bool],

slmp/client.py

@@ -132,12 +132,8 @@ def __init__(
                     "plc_family is required for the standard SlmpClient route "
                     "unless you explicitly opt into a low-level frame/profile path."
                 )
-            if plc_family is not None and any(
-                value is not None for value in (plc_series, frame_type, device_family)
-            ):
-                raise ValueError(
-                    "plc_family is the only supported PLC selector for the standard SlmpClient route."
-                )
+            if plc_family is not None and any(value is not None for value in (plc_series, frame_type, device_family)):
+                raise ValueError("plc_family is the only supported PLC selector for the standard SlmpClient route.")
         (
             self.plc_family,
             self.plc_series,

slmp/core.py

@@ -1087,8 +1087,7 @@ def _validate_direct_read_device(ref: DeviceRef, *, points: int, bit_unit: bool)
         )
     if not bit_unit and ref.code in _RANDOM_DWORD_ONLY_DIRECT_CODES:
         raise ValueError(
-            f"Direct word read is not supported for {ref.code}. "
-            "Use read_typed/read_named for 32-bit access."
+            f"Direct word read is not supported for {ref.code}. Use read_typed/read_named for 32-bit access."
         )
 
 
@@ -1100,8 +1099,7 @@ def _validate_direct_write_device(ref: DeviceRef, *, bit_unit: bool) -> None:
         )
     if not bit_unit and (ref.code in _LT_LST_CURRENT_CODES or ref.code in _DWORD_ONLY_DIRECT_CODES):
         raise ValueError(
-            f"Direct word write is not supported for {ref.code}. "
-            "Use write_typed/write_named for 32-bit access."
+            f"Direct word write is not supported for {ref.code}. Use write_typed/write_named for 32-bit access."
         )
 
 
@@ -1121,8 +1119,7 @@ def _validate_random_read_devices(word_refs: Sequence[DeviceRef], dword_refs: Se
         )
     if any(ref.code in _LC_CONTACT_CODES for ref in (*word_refs, *dword_refs)):
         raise ValueError(
-            "Read Random (0x0403) does not support LCS/LCC. "
-            "Use read_typed/read_named so direct bit read is selected."
+            "Read Random (0x0403) does not support LCS/LCC. Use read_typed/read_named so direct bit read is selected."
         )
     if any(ref.code in _LT_LST_CURRENT_CODES or ref.code in _DWORD_ONLY_DIRECT_CODES for ref in word_refs):
         raise ValueError(
@@ -1145,11 +1142,7 @@ def _validate_block_read_devices(
 ) -> None:
     all_refs = tuple(ref for ref, _ in (*word_blocks, *bit_blocks))
     invalid_long_block = next(
-        (
-            (ref, points)
-            for ref, points in word_blocks
-            if ref.code in _LT_LST_CURRENT_BLOCK_CODES and points % 4 != 0
-        ),
+        ((ref, points) for ref, points in word_blocks if ref.code in _LT_LST_CURRENT_BLOCK_CODES and points % 4 != 0),
         None,
     )
     if invalid_long_block is not None:
@@ -1165,15 +1158,13 @@ def _validate_block_read_devices(
         )
     if any(ref.code in _LC_CONTACT_CODES for ref in all_refs):
         raise ValueError(
-            "Read Block (0x0406) does not support LCS/LCC. "
-            "Use read_typed/read_named so direct bit read is selected."
+            "Read Block (0x0406) does not support LCS/LCC. Use read_typed/read_named so direct bit read is selected."
         )
 
 
 def _validate_block_write_devices(word_refs: Sequence[DeviceRef], bit_refs: Sequence[DeviceRef]) -> None:
     if any(
-        ref.code in _LT_LST_CURRENT_CODES or ref.code in _DWORD_ONLY_DIRECT_CODES
-        for ref in (*word_refs, *bit_refs)
+        ref.code in _LT_LST_CURRENT_CODES or ref.code in _DWORD_ONLY_DIRECT_CODES for ref in (*word_refs, *bit_refs)
     ):
         raise ValueError(
             "Write Block (0x1406) does not support LTN/LSTN/LCN/LZ as word or bit blocks. "

slmp/utils.py

@@ -1034,7 +1034,6 @@ async def read_words_chunked(
     semantics are acceptable to the caller.
     """
 
-
     effective_max = (max_per_request // 2) * 2
     if effective_max <= 0:
         raise ValueError("max_per_request must be at least 2")
@@ -1082,7 +1081,6 @@ async def write_words_chunked(
     caller.
     """
 
-
     effective_max = (max_per_request // 2) * 2
     if effective_max <= 0:
         raise ValueError("max_per_request must be at least 2")
@@ -1108,7 +1106,6 @@ async def write_dwords_chunked(
     intact inside one request.
     """
 
-
     if max_dwords_per_request <= 0:
         raise ValueError("max_dwords_per_request must be at least 1")
 
@@ -1230,7 +1227,6 @@ def read_words_chunked_sync(
 ) -> list[int]:
     """Synchronously read contiguous 16-bit values across multiple aligned requests."""
 
-
     effective_max = (max_per_request // 2) * 2
     if effective_max <= 0:
         raise ValueError("max_per_request must be at least 2")
@@ -1270,7 +1266,6 @@ def write_words_chunked_sync(
 ) -> None:
     """Synchronously write contiguous 16-bit values across multiple aligned requests."""
 
-
     effective_max = (max_per_request // 2) * 2
     if effective_max <= 0:
         raise ValueError("max_per_request must be at least 2")
@@ -1292,7 +1287,6 @@ def write_dwords_chunked_sync(
 ) -> None:
     """Synchronously write contiguous unsigned 32-bit values across multiple aligned requests."""
 
-
     if max_dwords_per_request <= 0:
         raise ValueError("max_dwords_per_request must be at least 1")
 

tests/test_async_client.py

@@ -7,6 +7,7 @@
 try:
     import pytest
 except ModuleNotFoundError:  # pragma: no cover - lets unittest discovery import this module without pytest
+
     class _RaisesContext(AbstractContextManager):
         def __init__(self, expected_exception: type[BaseException], match: str | None = None) -> None:
             self._expected_exception = expected_exception

tests/test_device_vectors.py

@@ -7,9 +7,7 @@
 from slmp.constants import PLCSeries
 from slmp.core import encode_device_spec
 
-_SHARED_SPEC_DIR = (
-    Path(__file__).resolve().parents[2] / "plc-comm-slmp-cross-verify" / "specs" / "shared"
-)
+_SHARED_SPEC_DIR = Path(__file__).resolve().parents[2] / "plc-comm-slmp-cross-verify" / "specs" / "shared"
 _VECTORS = json.loads((_SHARED_SPEC_DIR / "device_spec_vectors.json").read_text(encoding="utf-8"))["vectors"]