slmp-connect-python 0.8.0__tar.gz → 1.0.0__tar.gz

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0}/MANIFEST.in

@@ -1,2 +1,2 @@
-prune tests
-prune internal_docs
+prune tests
+prune internal_docs

{slmp_connect_python-0.8.0/slmp_connect_python.egg-info → slmp_connect_python-1.0.0}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: slmp-connect-python
-Version: 0.8.0
+Version: 1.0.0
 Summary: SLMP Connect Python: client library for MELSEC SLMP binary communication
 Author: fa-yoshinobu
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/fa-yoshinobu/plc-comm-slmp-python
 Project-URL: Repository, https://github.com/fa-yoshinobu/plc-comm-slmp-python
 Project-URL: Issues, https://github.com/fa-yoshinobu/plc-comm-slmp-python/issues
-Keywords: slmp,melsec,mitsubishi,plc,3e,4e,binary
-Classifier: Development Status :: 3 - Alpha
+Keywords: slmp,melsec,plc,3e,4e,binary
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
@@ -33,14 +33,9 @@ Requires-Dist: twine>=5.1; extra == "dev"
 Dynamic: license-file
 
 [![CI](https://github.com/fa-yoshinobu/plc-comm-slmp-python/actions/workflows/ci.yml/badge.svg)](https://github.com/fa-yoshinobu/plc-comm-slmp-python/actions/workflows/ci.yml)
-[![Documentation](https://img.shields.io/badge/docs-GitHub_Pages-blue.svg)](https://fa-yoshinobu.github.io/plc-comm-docs-site/slmp/python/GETTING_STARTED/)
 [![PyPI](https://img.shields.io/pypi/v/slmp-connect-python.svg)](https://pypi.org/project/slmp-connect-python/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Static Analysis: Ruff](https://img.shields.io/badge/Lint-Ruff-black.svg)](https://github.com/astral-sh/ruff)
-[![Release](https://img.shields.io/github/v/release/fa-yoshinobu/plc-comm-slmp-python?label=release)](https://github.com/fa-yoshinobu/plc-comm-slmp-python/releases/latest)
-[![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white)](https://www.python.org/)
-[![MkDocs](https://img.shields.io/badge/MkDocs-526CFE?logo=materialformkdocs&logoColor=white)](https://www.mkdocs.org/)
 
 # MELSEC SLMP for Python
 

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0}/README.md

@@ -1,25 +1,20 @@
 [![CI](https://github.com/fa-yoshinobu/plc-comm-slmp-python/actions/workflows/ci.yml/badge.svg)](https://github.com/fa-yoshinobu/plc-comm-slmp-python/actions/workflows/ci.yml)
-[![Documentation](https://img.shields.io/badge/docs-GitHub_Pages-blue.svg)](https://fa-yoshinobu.github.io/plc-comm-docs-site/slmp/python/GETTING_STARTED/)
 [![PyPI](https://img.shields.io/pypi/v/slmp-connect-python.svg)](https://pypi.org/project/slmp-connect-python/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Static Analysis: Ruff](https://img.shields.io/badge/Lint-Ruff-black.svg)](https://github.com/astral-sh/ruff)
-[![Release](https://img.shields.io/github/v/release/fa-yoshinobu/plc-comm-slmp-python?label=release)](https://github.com/fa-yoshinobu/plc-comm-slmp-python/releases/latest)
-[![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white)](https://www.python.org/)
-[![MkDocs](https://img.shields.io/badge/MkDocs-526CFE?logo=materialformkdocs&logoColor=white)](https://www.mkdocs.org/)
-
-# MELSEC SLMP for Python
-
-Python library for MELSEC SLMP (Binary 3E/4E) PLC communication.
-
-## Supported PLC profiles
-
-The maintained profile table is in [PLC profiles](docsrc/user/PROFILES.md). Choose one exact canonical PLC profile from that table.
-
-## Supported device types
-
-The maintained device and range tables are in [Supported registers](docsrc/user/SUPPORTED_REGISTERS.md). Use that page for supported device families, address syntax, and profile-specific notes.
-
+
+# MELSEC SLMP for Python
+
+Python library for MELSEC SLMP (Binary 3E/4E) PLC communication.
+
+## Supported PLC profiles
+
+The maintained profile table is in [PLC profiles](docsrc/user/PROFILES.md). Choose one exact canonical PLC profile from that table.
+
+## Supported device types
+
+The maintained device and range tables are in [Supported registers](docsrc/user/SUPPORTED_REGISTERS.md). Use that page for supported device families, address syntax, and profile-specific notes.
+
 ## Installation
 
 ```bash
@@ -43,24 +38,24 @@ asyncio.run(main())
 
 ## Documentation
 
-| Page | Use it for |
-| --- | --- |
-| [Full documentation site](https://fa-yoshinobu.github.io/plc-comm-docs-site/) | Unified docs for all PLC communication libraries. |
-| [Getting started](docsrc/user/GETTING_STARTED.md) | Install the package, connect to your PLC, and run your first SLMP read/write. |
-| [Usage guide](docsrc/user/USAGE_GUIDE.md) | Use the high-level API and common SLMP workflows. |
-| [Supported registers](docsrc/user/SUPPORTED_REGISTERS.md) | Check supported device families, address syntax, and numbering rules. |
-| [PLC profiles](docsrc/user/PROFILES.md) | Choose the canonical MELSEC profile and frame behavior. |
-| [Examples](samples/README.md) | Run maintained Python samples. |
+| Page | Use it for |
+| --- | --- |
+| [Full documentation site](https://fa-yoshinobu.github.io/plc-comm-docs-site/) | Unified docs for all PLC communication libraries. |
+| [Getting started](docsrc/user/GETTING_STARTED.md) | Install the package, connect to your PLC, and run your first SLMP read/write. |
+| [Usage guide](docsrc/user/USAGE_GUIDE.md) | Use the high-level API and common SLMP workflows. |
+| [Supported registers](docsrc/user/SUPPORTED_REGISTERS.md) | Check supported device families, address syntax, and numbering rules. |
+| [PLC profiles](docsrc/user/PROFILES.md) | Choose the canonical MELSEC profile and frame behavior. |
+| [Examples](samples/README.md) | Run maintained Python samples. |
+
+## Hardware verified
 
-## Hardware verified
-
-Live-device verification is maintained in [Latest communication verification](docsrc/user/LATEST_COMMUNICATION_VERIFICATION.md).
-See that page for verified PLC models, transports, dates, limitations, and retained validation notes.
+Live-device verification is maintained in [Latest communication verification](docsrc/user/LATEST_COMMUNICATION_VERIFICATION.md).
+See that page for verified PLC models, transports, dates, limitations, and retained validation notes.
 
 ## License and registry
 
-| Item | Value |
-| --- | --- |
-| License | [MIT](LICENSE) |
-| Registry | [PyPI](https://pypi.org/project/slmp-connect-python/) |
-| Package | `slmp-connect-python` |
+| Item | Value |
+| --- | --- |
+| License | [MIT](LICENSE) |
+| Registry | [PyPI](https://pypi.org/project/slmp-connect-python/) |
+| Package | `slmp-connect-python` |

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0}/pyproject.toml

@@ -1,112 +1,111 @@
-[build-system]
-requires = ["setuptools>=69", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "slmp-connect-python"
-version = "0.8.0"
-description = "SLMP Connect Python: client library for MELSEC SLMP binary communication"
-readme = "README.md"
-requires-python = ">=3.10"
-dependencies = []
-authors = [{ name = "fa-yoshinobu" }]
-license = "MIT"
-
-license-files = ["LICENSE"]
-keywords = ["slmp", "melsec", "mitsubishi", "plc", "3e", "4e", "binary"]
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Programming Language :: Python :: 3.14",
-    "Topic :: Software Development :: Libraries :: Python Modules",
-    "Topic :: System :: Networking",
-]
-
-[project.urls]
-Homepage = "https://github.com/fa-yoshinobu/plc-comm-slmp-python"
-Repository = "https://github.com/fa-yoshinobu/plc-comm-slmp-python"
-Issues = "https://github.com/fa-yoshinobu/plc-comm-slmp-python/issues"
-
-[project.optional-dependencies]
-dev = [
-    "build>=1.2",
-    "mypy>=1.10",
-    "pre-commit>=3.7",
-    "pytest>=8.0",
-    "pytest-asyncio>=0.23",
-    "pytest-cov>=5.0",
-    "ruff>=0.6",
-    "twine>=5.1",
-]
-
-[project.scripts]
-slmp-connection-check = "slmp.cli:connection_check_main"
-slmp-device-range-probe = "slmp.cli:device_range_probe_main"
-slmp-register-boundary-probe = "slmp.cli:register_boundary_probe_main"
-slmp-other-station-check = "slmp.cli:other_station_check_main"
-slmp-open-items-recheck = "slmp.cli:open_items_recheck_main"
-slmp-g-hg-extended-device-recheck = "slmp.cli:g_hg_extended_device_recheck_main"
-slmp-g-hg-extended-device-coverage = "slmp.cli:g_hg_extended_device_coverage_main"
-slmp-extended-device-recheck = "slmp.cli:extended_device_recheck_main"
-slmp-pending-live-verification = "slmp.cli:pending_live_verification_main"
-slmp-init-model-docs = "slmp.cli:init_model_docs_main"
-slmp-manual-label-verification = "slmp.cli:manual_label_verification_main"
-slmp-read-soak = "slmp.cli:read_soak_main"
-slmp-mixed-read-load = "slmp.cli:mixed_read_load_main"
-slmp-tcp-concurrency = "slmp.cli:tcp_concurrency_main"
-slmp-regression-suite = "slmp.cli:regression_suite_main"
-
-[tool.setuptools.packages.find]
-include = ["slmp*"]
-exclude = ["tests*", "scripts*", "internal_docs*"]
-
-[tool.setuptools]
-include-package-data = true
-exclude-package-data = { "*" = ["TODO.md", ".pre-commit-config.yaml"] }
-
-[tool.setuptools.package-data]
-slmp = ["py.typed"]
-
-[tool.ruff]
-line-length = 120
-target-version = "py310"
-
-[tool.ruff.lint]
-select = ["E", "F", "I", "B", "UP"]
-
-[tool.ruff.lint.per-file-ignores]
-"slmp/error_codes.py" = ["E501"]
-
-[tool.ruff.lint.isort]
-known-first-party = ["slmp"]
-
-[tool.mypy]
-files = ["slmp"]
-warn_unused_configs = true
-disallow_untyped_defs = true
-check_untyped_defs = true
-disallow_incomplete_defs = true
-no_implicit_optional = true
-warn_redundant_casts = true
-warn_unused_ignores = true
-warn_return_any = true
-strict_equality = true
-
-[tool.coverage.run]
-source = ["slmp"]
-branch = true
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-asyncio_mode = "auto"
-
-[tool.coverage.report]
-show_missing = true
-
-
-
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "slmp-connect-python"
+version = "1.0.0"
+description = "SLMP Connect Python: client library for MELSEC SLMP binary communication"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = []
+authors = [{ name = "fa-yoshinobu" }]
+license = "MIT"
+
+license-files = ["LICENSE"]
+keywords = ["slmp", "melsec", "plc", "3e", "4e", "binary"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Networking",
+]
+
+[project.urls]
+Homepage = "https://github.com/fa-yoshinobu/plc-comm-slmp-python"
+Repository = "https://github.com/fa-yoshinobu/plc-comm-slmp-python"
+Issues = "https://github.com/fa-yoshinobu/plc-comm-slmp-python/issues"
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.2",
+    "mypy>=1.10",
+    "pre-commit>=3.7",
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-cov>=5.0",
+    "ruff>=0.6",
+    "twine>=5.1",
+]
+
+[project.scripts]
+slmp-connection-check = "slmp.cli:connection_check_main"
+slmp-device-range-probe = "slmp.cli:device_range_probe_main"
+slmp-register-boundary-probe = "slmp.cli:register_boundary_probe_main"
+slmp-other-station-check = "slmp.cli:other_station_check_main"
+slmp-open-items-recheck = "slmp.cli:open_items_recheck_main"
+slmp-g-hg-extended-device-recheck = "slmp.cli:g_hg_extended_device_recheck_main"
+slmp-g-hg-extended-device-coverage = "slmp.cli:g_hg_extended_device_coverage_main"
+slmp-extended-device-recheck = "slmp.cli:extended_device_recheck_main"
+slmp-pending-live-verification = "slmp.cli:pending_live_verification_main"
+slmp-init-model-docs = "slmp.cli:init_model_docs_main"
+slmp-manual-label-verification = "slmp.cli:manual_label_verification_main"
+slmp-read-soak = "slmp.cli:read_soak_main"
+slmp-mixed-read-load = "slmp.cli:mixed_read_load_main"
+slmp-tcp-concurrency = "slmp.cli:tcp_concurrency_main"
+slmp-regression-suite = "slmp.cli:regression_suite_main"
+
+[tool.setuptools.packages.find]
+include = ["slmp*"]
+exclude = ["tests*", "scripts*", "internal_docs*"]
+
+[tool.setuptools]
+include-package-data = true
+exclude-package-data = { "*" = ["TODO.md", ".pre-commit-config.yaml"] }
+
+[tool.setuptools.package-data]
+slmp = ["py.typed"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]
+
+[tool.ruff.lint.per-file-ignores]
+"slmp/error_codes.py" = ["E501"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["slmp"]
+
+[tool.mypy]
+files = ["slmp"]
+warn_unused_configs = true
+disallow_untyped_defs = true
+check_untyped_defs = true
+disallow_incomplete_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_return_any = true
+strict_equality = true
+
+[tool.coverage.run]
+source = ["slmp"]
+branch = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.coverage.report]
+show_missing = true
+
+

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0}/slmp/__init__.py

@@ -1,206 +1,206 @@
-"""SLMP client library with high-level helpers as the recommended user surface.
-
-The primary user-facing entry points are:
-
-- ``read_typed`` / ``write_typed``
-- ``read_words_single_request`` / ``read_dwords_single_request``
-- ``read_words_chunked`` / ``read_dwords_chunked``
-- ``write_bit_in_word``
-- ``read_named`` / ``write_named``
-- ``poll``
-"""
-
-__version__ = "0.8.0"
-
-from .async_client import AsyncSlmpClient
-from .client import SlmpClient
-from .constants import Command, FrameType, ModuleIONo, PLCSeries
-from .core import (
-    DEVICE_CODES,
-    BlockReadResult,
-    CpuOperationState,
-    CpuOperationStatus,
-    DeviceBlockResult,
-    DeviceRef,
-    ExtensionSpec,
-    LabelArrayReadPoint,
-    LabelArrayReadResult,
-    LabelArrayWritePoint,
-    LabelRandomReadResult,
-    LabelRandomWritePoint,
-    LongTimerResult,
-    MonitorResult,
-    RandomReadResult,
-    SlmpPlcProfile,
-    SlmpResponse,
-    SlmpTarget,
-    SlmpTraceFrame,
-    TypeNameInfo,
-    decode_cpu_operation_state,
-    parse_device,
-    parse_extended_device,
-)
-from .device_ranges import (
-    SlmpDeviceRangeCatalog,
-    SlmpDeviceRangeCategory,
-    SlmpDeviceRangeEntry,
-    SlmpDeviceRangeNotation,
-    build_device_range_catalog_for_plc_profile,
-    normalize_plc_profile,
-    plc_profile_label,
-    read_device_range_catalog_for_plc_profile,
-    read_device_range_catalog_for_plc_profile_sync,
-)
-from .error_codes import (
-    SlmpEndCodeLanguage,
-    get_end_code_message,
-    get_end_code_name,
-    is_remote_password_end_code,
-)
-from .errors import (
-    SlmpBoundaryBehaviorWarning,
-    SlmpError,
-    SlmpPracticalPathWarning,
-    SlmpUnsupportedDeviceError,
-)
-from .utils import (
-    QueuedAsyncSlmpClient,
-    SlmpAddress,
-    SlmpConnectionOptions,
-    format_address,
-    normalize_address,
-    open_and_connect,
-    open_and_connect_sync,
-    parse_address,
-    poll,
-    poll_sync,
-    read_bits,
-    read_bits_sync,
-    read_dwords,
-    read_dwords_chunked,
-    read_dwords_chunked_sync,
-    read_dwords_single_request,
-    read_dwords_single_request_sync,
-    read_dwords_sync,
-    read_named,
-    read_named_sync,
-    read_typed,
-    read_typed_sync,
-    read_words,
-    read_words_chunked,
-    read_words_chunked_sync,
-    read_words_single_request,
-    read_words_single_request_sync,
-    read_words_sync,
-    try_parse_address,
-    write_bit_in_word,
-    write_bit_in_word_sync,
-    write_bits,
-    write_bits_sync,
-    write_dwords_chunked,
-    write_dwords_chunked_sync,
-    write_dwords_single_request,
-    write_dwords_single_request_sync,
-    write_named,
-    write_named_sync,
-    write_typed,
-    write_typed_sync,
-    write_words_chunked,
-    write_words_chunked_sync,
-    write_words_single_request,
-    write_words_single_request_sync,
-)
-
-__all__ = [
-    "AsyncSlmpClient",
-    "BlockReadResult",
-    "Command",
-    "CpuOperationState",
-    "CpuOperationStatus",
-    "DEVICE_CODES",
-    "DeviceBlockResult",
-    "DeviceRef",
-    "ExtensionSpec",
-    "FrameType",
-    "LabelArrayReadPoint",
-    "LabelArrayReadResult",
-    "LabelArrayWritePoint",
-    "LabelRandomReadResult",
-    "LabelRandomWritePoint",
-    "LongTimerResult",
-    "ModuleIONo",
-    "MonitorResult",
-    "PLCSeries",
-    "QueuedAsyncSlmpClient",
-    "SlmpConnectionOptions",
-    "SlmpEndCodeLanguage",
-    "SlmpAddress",
-    "RandomReadResult",
-    "SlmpClient",
-    "SlmpBoundaryBehaviorWarning",
-    "SlmpError",
-    "SlmpPlcProfile",
-    "SlmpPracticalPathWarning",
-    "SlmpUnsupportedDeviceError",
-    "SlmpResponse",
-    "SlmpTarget",
-    "SlmpTraceFrame",
-    "TypeNameInfo",
-    "decode_cpu_operation_state",
-    "format_address",
-    "get_end_code_message",
-    "get_end_code_name",
-    "is_remote_password_end_code",
-    "SlmpDeviceRangeCatalog",
-    "SlmpDeviceRangeCategory",
-    "SlmpDeviceRangeEntry",
-    "SlmpDeviceRangeNotation",
-    "normalize_address",
-    "normalize_plc_profile",
-    "open_and_connect",
-    "open_and_connect_sync",
-    "parse_address",
-    "parse_extended_device",
-    "parse_device",
-    "poll",
-    "poll_sync",
-    "read_bits",
-    "read_bits_sync",
-    "read_dwords",
-    "read_dwords_chunked",
-    "read_dwords_chunked_sync",
-    "read_dwords_single_request",
-    "read_dwords_single_request_sync",
-    "read_dwords_sync",
-    "read_named",
-    "read_named_sync",
-    "read_typed",
-    "read_typed_sync",
-    "read_device_range_catalog_for_plc_profile",
-    "read_device_range_catalog_for_plc_profile_sync",
-    "read_words",
-    "read_words_chunked",
-    "read_words_chunked_sync",
-    "read_words_single_request",
-    "read_words_single_request_sync",
-    "read_words_sync",
-    "write_bit_in_word",
-    "write_bit_in_word_sync",
-    "write_bits",
-    "write_bits_sync",
-    "write_dwords_chunked",
-    "write_dwords_chunked_sync",
-    "write_dwords_single_request",
-    "write_dwords_single_request_sync",
-    "write_named",
-    "write_named_sync",
-    "write_typed",
-    "write_typed_sync",
-    "write_words_chunked",
-    "write_words_chunked_sync",
-    "write_words_single_request",
-    "write_words_single_request_sync",
-    "try_parse_address",
-    "build_device_range_catalog_for_plc_profile",
-    "plc_profile_label",
-]
+"""SLMP client library with high-level helpers as the recommended user surface.
+
+The primary user-facing entry points are:
+
+- ``read_typed`` / ``write_typed``
+- ``read_words_single_request`` / ``read_dwords_single_request``
+- ``read_words_chunked`` / ``read_dwords_chunked``
+- ``write_bit_in_word``
+- ``read_named`` / ``write_named``
+- ``poll``
+"""
+
+__version__ = "0.8.0"
+
+from .async_client import AsyncSlmpClient
+from .client import SlmpClient
+from .constants import Command, FrameType, ModuleIONo, PLCSeries
+from .core import (
+    DEVICE_CODES,
+    BlockReadResult,
+    CpuOperationState,
+    CpuOperationStatus,
+    DeviceBlockResult,
+    DeviceRef,
+    ExtensionSpec,
+    LabelArrayReadPoint,
+    LabelArrayReadResult,
+    LabelArrayWritePoint,
+    LabelRandomReadResult,
+    LabelRandomWritePoint,
+    LongTimerResult,
+    MonitorResult,
+    RandomReadResult,
+    SlmpPlcProfile,
+    SlmpResponse,
+    SlmpTarget,
+    SlmpTraceFrame,
+    TypeNameInfo,
+    decode_cpu_operation_state,
+    parse_device,
+    parse_extended_device,
+)
+from .device_ranges import (
+    SlmpDeviceRangeCatalog,
+    SlmpDeviceRangeCategory,
+    SlmpDeviceRangeEntry,
+    SlmpDeviceRangeNotation,
+    build_device_range_catalog_for_plc_profile,
+    normalize_plc_profile,
+    plc_profile_label,
+    read_device_range_catalog_for_plc_profile,
+    read_device_range_catalog_for_plc_profile_sync,
+)
+from .error_codes import (
+    SlmpEndCodeLanguage,
+    get_end_code_message,
+    get_end_code_name,
+    is_remote_password_end_code,
+)
+from .errors import (
+    SlmpBoundaryBehaviorWarning,
+    SlmpError,
+    SlmpPracticalPathWarning,
+    SlmpUnsupportedDeviceError,
+)
+from .utils import (
+    QueuedAsyncSlmpClient,
+    SlmpAddress,
+    SlmpConnectionOptions,
+    format_address,
+    normalize_address,
+    open_and_connect,
+    open_and_connect_sync,
+    parse_address,
+    poll,
+    poll_sync,
+    read_bits,
+    read_bits_sync,
+    read_dwords,
+    read_dwords_chunked,
+    read_dwords_chunked_sync,
+    read_dwords_single_request,
+    read_dwords_single_request_sync,
+    read_dwords_sync,
+    read_named,
+    read_named_sync,
+    read_typed,
+    read_typed_sync,
+    read_words,
+    read_words_chunked,
+    read_words_chunked_sync,
+    read_words_single_request,
+    read_words_single_request_sync,
+    read_words_sync,
+    try_parse_address,
+    write_bit_in_word,
+    write_bit_in_word_sync,
+    write_bits,
+    write_bits_sync,
+    write_dwords_chunked,
+    write_dwords_chunked_sync,
+    write_dwords_single_request,
+    write_dwords_single_request_sync,
+    write_named,
+    write_named_sync,
+    write_typed,
+    write_typed_sync,
+    write_words_chunked,
+    write_words_chunked_sync,
+    write_words_single_request,
+    write_words_single_request_sync,
+)
+
+__all__ = [
+    "AsyncSlmpClient",
+    "BlockReadResult",
+    "Command",
+    "CpuOperationState",
+    "CpuOperationStatus",
+    "DEVICE_CODES",
+    "DeviceBlockResult",
+    "DeviceRef",
+    "ExtensionSpec",
+    "FrameType",
+    "LabelArrayReadPoint",
+    "LabelArrayReadResult",
+    "LabelArrayWritePoint",
+    "LabelRandomReadResult",
+    "LabelRandomWritePoint",
+    "LongTimerResult",
+    "ModuleIONo",
+    "MonitorResult",
+    "PLCSeries",
+    "QueuedAsyncSlmpClient",
+    "SlmpConnectionOptions",
+    "SlmpEndCodeLanguage",
+    "SlmpAddress",
+    "RandomReadResult",
+    "SlmpClient",
+    "SlmpBoundaryBehaviorWarning",
+    "SlmpError",
+    "SlmpPlcProfile",
+    "SlmpPracticalPathWarning",
+    "SlmpUnsupportedDeviceError",
+    "SlmpResponse",
+    "SlmpTarget",
+    "SlmpTraceFrame",
+    "TypeNameInfo",
+    "decode_cpu_operation_state",
+    "format_address",
+    "get_end_code_message",
+    "get_end_code_name",
+    "is_remote_password_end_code",
+    "SlmpDeviceRangeCatalog",
+    "SlmpDeviceRangeCategory",
+    "SlmpDeviceRangeEntry",
+    "SlmpDeviceRangeNotation",
+    "normalize_address",
+    "normalize_plc_profile",
+    "open_and_connect",
+    "open_and_connect_sync",
+    "parse_address",
+    "parse_extended_device",
+    "parse_device",
+    "poll",
+    "poll_sync",
+    "read_bits",
+    "read_bits_sync",
+    "read_dwords",
+    "read_dwords_chunked",
+    "read_dwords_chunked_sync",
+    "read_dwords_single_request",
+    "read_dwords_single_request_sync",
+    "read_dwords_sync",
+    "read_named",
+    "read_named_sync",
+    "read_typed",
+    "read_typed_sync",
+    "read_device_range_catalog_for_plc_profile",
+    "read_device_range_catalog_for_plc_profile_sync",
+    "read_words",
+    "read_words_chunked",
+    "read_words_chunked_sync",
+    "read_words_single_request",
+    "read_words_single_request_sync",
+    "read_words_sync",
+    "write_bit_in_word",
+    "write_bit_in_word_sync",
+    "write_bits",
+    "write_bits_sync",
+    "write_dwords_chunked",
+    "write_dwords_chunked_sync",
+    "write_dwords_single_request",
+    "write_dwords_single_request_sync",
+    "write_named",
+    "write_named_sync",
+    "write_typed",
+    "write_typed_sync",
+    "write_words_chunked",
+    "write_words_chunked_sync",
+    "write_words_single_request",
+    "write_words_single_request_sync",
+    "try_parse_address",
+    "build_device_range_catalog_for_plc_profile",
+    "plc_profile_label",
+]

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0}/slmp/async_client.py

@@ -30,6 +30,7 @@ from .core import (
     _raise_response_error,
     _require_explicit_plc_profile_for_xy,
     _resolve_connection_profile,
+    _resolve_port,
     build_device_modification_flags,
     decode_cpu_operation_state,
     decode_response,
@@ -72,7 +73,7 @@ class AsyncSlmpClient:
     def __init__(
         self,
         host: str,
-        port: int = 5000,
+        port: int | None = None,
         *,
         transport: str = "tcp",
         timeout: float = 3.0,
@@ -93,10 +94,10 @@ class AsyncSlmpClient:
         explicit family.
         """
         self.host = host
-        self.port = port
         self.transport_type = transport.lower()
         if self.transport_type not in {"tcp", "udp"}:
             raise ValueError("transport must be 'tcp' or 'udp'")
+        self.port = _resolve_port(port, self.transport_type)
         self.timeout = timeout
         if not _allow_manual_profile:
             if plc_profile is None:

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0}/slmp/cli.py

@@ -41,6 +41,7 @@ from .core import (
     SlmpTarget,
     SlmpTraceFrame,
     TypeNameInfo,
+    _resolve_port,
     decode_device_words,
     encode_device_spec,
     pack_bit_values,
@@ -58,7 +59,7 @@ class SlmpClient(_StandardSlmpClient):
     def __init__(
         self,
         host: str,
-        port: int = 5000,
+        port: int | None = None,
         *,
         transport: str = "tcp",
         timeout: float = 3.0,
@@ -915,18 +916,18 @@ def _render_compatibility_matrix_markdown(
 
 def _default_regression_help_scripts() -> tuple[str, ...]:
     return (
-        "slmp_connection_check.py",
-        "slmp_device_range_probe.py",
-        "slmp_register_boundary_probe.py",
-        "slmp_init_model_docs.py",
-        "slmp_other_station_check.py",
-        "slmp_open_items_recheck.py",
-        "slmp_pending_live_verification.py",
-        "slmp_manual_label_verification.py",
-        "slmp_special_device_probe.py",
-        "slmp_read_soak.py",
-        "slmp_mixed_read_load.py",
-        "slmp_tcp_concurrency.py",
+        "slmp_connection_check.py",
+        "slmp_device_range_probe.py",
+        "slmp_register_boundary_probe.py",
+        "slmp_init_model_docs.py",
+        "slmp_other_station_check.py",
+        "slmp_open_items_recheck.py",
+        "slmp_pending_live_verification.py",
+        "slmp_manual_label_verification.py",
+        "slmp_special_device_probe.py",
+        "slmp_read_soak.py",
+        "slmp_mixed_read_load.py",
+        "slmp_tcp_concurrency.py",
         "slmp_extended_device_device_recheck.py",
         "slmp_g_hg_extended_device_recheck.py",
         "slmp_g_hg_extended_device_coverage.py",
@@ -1151,9 +1152,9 @@ class ExtendedDeviceWordProbeSpec:
     direct_memory_specification: int
 
 
-@dataclass(frozen=True)
-class LatencySummary:
-    """Summary statistics for request latency."""
+@dataclass(frozen=True)
+class LatencySummary:
+    """Summary statistics for request latency."""
 
     count: int
     avg_ms: float
@@ -1774,20 +1775,20 @@ def _write_scaffold_file(path: Path, content: str, *, force: bool) -> bool:
     return True
 
 
-def _parse_manual_verdict(text: str) -> str | None:
-    lowered = text.strip().lower()
-    if lowered in {"y", "yes"}:
+def _parse_manual_verdict(text: str) -> str | None:
+    lowered = text.strip().lower()
+    if lowered in {"y", "yes"}:
         return "OK"
     if lowered in {"n", "no"}:
         return "NG"
-    if lowered in {"s", "skip"}:
-        return "SKIP"
-    return None
-
-
-def _parse_positive_int_list(text: str) -> tuple[int, ...]:
-    parts = [part.strip() for part in text.split(",")]
-    if not parts or any(not part for part in parts):
+    if lowered in {"s", "skip"}:
+        return "SKIP"
+    return None
+
+
+def _parse_positive_int_list(text: str) -> tuple[int, ...]:
+    parts = [part.strip() for part in text.split(",")]
+    if not parts or any(not part for part in parts):
         raise ValueError(f"comma-separated positive integer list expected: {text!r}")
     values = tuple(_int_auto(part) for part in parts)
     if any(value <= 0 for value in values):
@@ -1811,12 +1812,12 @@ def _render_model_docs_readme(*, series: str, model: str, folder_name: str) -> s
             f"- Model: `{model}`",
             "- Host: fill in when the target is assigned",
             "- Primary SLMP ports: fill in when the target is assigned",
-            "",
-            "## Expected Files",
-            "",
-            "- `read_soak_latest.md`",
-            "  - repeated single-command read soak result",
-            "- `mixed_read_load_latest.md`",
+            "",
+            "## Expected Files",
+            "",
+            "- `read_soak_latest.md`",
+            "  - repeated single-command read soak result",
+            "- `mixed_read_load_latest.md`",
             "  - mixed 0401/0403/0406 read load result",
             "- `tcp_concurrency_latest.md`",
             "  - practical multi-client TCP read concurrency result",
@@ -1923,13 +1924,13 @@ def _render_model_other_station_targets_example() -> str:
             "remote_station_01,0x00,0x01,0x03FF,0x00",
             "remote_station_02,0x00,0x02,0x03FF,0x00",
             "",
-        ]
-    )
-
-
-def _initialize_model_docs(
-    *,
-    root: Path,
+        ]
+    )
+
+
+def _initialize_model_docs(
+    *,
+    root: Path,
     series: str,
     model: str,
     force: bool = False,
@@ -1937,12 +1938,12 @@ def _initialize_model_docs(
     folder_name = f"{_sanitize_report_component(series)}_{_sanitize_report_component(model)}"
     model_dir = root / folder_name
     created: list[Path] = []
-    skipped: list[Path] = []
-    files: list[tuple[Path, str]] = [
-        (model_dir / "README.md", _render_model_docs_readme(series=series, model=model, folder_name=folder_name)),
-        (model_dir / "current_plc_boundary_specs_example.txt", _render_model_boundary_specs_example()),
-        (
-            model_dir / "current_register_boundary_focus_specs_example.txt",
+    skipped: list[Path] = []
+    files: list[tuple[Path, str]] = [
+        (model_dir / "README.md", _render_model_docs_readme(series=series, model=model, folder_name=folder_name)),
+        (model_dir / "current_plc_boundary_specs_example.txt", _render_model_boundary_specs_example()),
+        (
+            model_dir / "current_register_boundary_focus_specs_example.txt",
             _render_model_register_boundary_specs_example(),
         ),
         (model_dir / "other_station_targets_example.txt", _render_model_other_station_targets_example()),
@@ -2265,7 +2266,7 @@ def connection_check_main(argv: Sequence[str] | None = None) -> int:
     """Perform SLMP binary connection check."""
     parser = argparse.ArgumentParser(description="SLMP binary connection check")
     parser.add_argument("--host", required=True, help="PLC IP address or host name")
-    parser.add_argument("--port", type=int, default=5000, help="SLMP port (default: 5000)")
+    parser.add_argument("--port", type=int, default=None, help="SLMP port (default: 1025 for TCP, 1035 for UDP)")
     parser.add_argument("--transport", choices=("tcp", "udp"), default="tcp")
     parser.add_argument("--timeout", type=float, default=3.0)
     parser.add_argument("--series", choices=("ql", "iqr"), default="ql")
@@ -2341,6 +2342,7 @@ def connection_check_main(argv: Sequence[str] | None = None) -> int:
         help="use indirect specification flag (@)",
     )
     args = parser.parse_args(list(argv) if argv is not None else None)
+    args.port = _resolve_port(args.port, args.transport)
 
     target = SlmpTarget(
         network=args.network,
@@ -4238,8 +4240,8 @@ def pending_live_verification_main(argv: Sequence[str] | None = None) -> int:
     return 0
 
 
-def manual_label_verification_main(argv: Sequence[str] | None = None) -> int:
-    """Perform interactive manual label write verification with restore."""
+def manual_label_verification_main(argv: Sequence[str] | None = None) -> int:
+    """Perform interactive manual label write verification with restore."""
     parser = argparse.ArgumentParser(
         description=(
             "Write temporary values to explicit label tags, let a human verify the effect, "

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0}/slmp/client.py

@@ -29,6 +29,7 @@ from .core import (
     _raise_response_error,
     _require_explicit_plc_profile_for_xy,
     _resolve_connection_profile,
+    _resolve_port,
     build_device_modification_flags,
     decode_cpu_operation_state,
     decode_response,
@@ -60,7 +61,7 @@ class SlmpClient:
     def __init__(
         self,
         host: str,
-        port: int = 5000,
+        port: int | None = None,
         *,
         transport: str = "tcp",
         timeout: float = 3.0,
@@ -78,7 +79,7 @@ class SlmpClient:
 
         Args:
             host: PLC IP address.
-            port: PLC port number. Defaults to 5000.
+            port: PLC port number. Defaults to 1025 for TCP and 1035 for UDP.
             transport: Transport protocol ('tcp' or 'udp'). Defaults to 'tcp'.
             timeout: Socket timeout in seconds. Defaults to 3.0.
             plc_profile: Canonical high-level PLC profile. The standard client
@@ -90,10 +91,10 @@ class SlmpClient:
             trace_hook: Optional callback for tracing requests and responses.
         """
         self.host = host
-        self.port = port
         self.transport = transport.lower()
         if self.transport not in {"tcp", "udp"}:
             raise ValueError("transport must be 'tcp' or 'udp'")
+        self.port = _resolve_port(port, self.transport)
         self.timeout = timeout
         if not _allow_manual_profile:
             if plc_profile is None:

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0}/slmp/core.py

@@ -39,6 +39,24 @@ from .errors import (
     SlmpUnsupportedDeviceError,
 )
 
+DEFAULT_TCP_PORT = 1025
+DEFAULT_UDP_PORT = 1035
+
+
+def _default_port_for_transport(transport: str) -> int:
+    normalized = transport.lower()
+    if normalized == "tcp":
+        return DEFAULT_TCP_PORT
+    if normalized == "udp":
+        return DEFAULT_UDP_PORT
+    raise ValueError("transport must be 'tcp' or 'udp'")
+
+
+def _resolve_port(port: int | None, transport: str) -> int:
+    if port is None:
+        return _default_port_for_transport(transport)
+    return port
+
 
 @dataclass(frozen=True)
 class SlmpTarget:

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0}/slmp/utils.py

@@ -17,6 +17,7 @@ from .core import (
     _require_explicit_plc_profile_for_xy,
     _resolve_connection_profile,
     _resolve_plc_profile_defaults,
+    _resolve_port,
     _validate_direct_dword_read_device,
     parse_device,
 )
@@ -68,14 +69,15 @@ class SlmpConnectionOptions:
 
     The options object is the recommended input for :func:`open_and_connect`
     and :func:`open_and_connect_sync`. It keeps transport-level settings and
-    protocol-level defaults together so maintained documentation can point users to
+    protocol-level defaults together so maintained documentation can point users to
     one explicit connection entry point.
 
     Attributes:
         host: PLC hostname or IP address.
         plc_profile: Canonical high-level PLC profile. This is the only
             application-level PLC selector for the recommended helper layer.
-        port: TCP or UDP port used by the SLMP endpoint.
+        port: TCP or UDP port used by the SLMP endpoint. Defaults to
+            ``1025`` for TCP and ``1035`` for UDP when omitted.
         transport: Transport name such as ``"tcp"`` or ``"udp"``.
         timeout: Socket timeout in seconds.
         default_target: Optional routing target applied to requests.
@@ -90,7 +92,7 @@ class SlmpConnectionOptions:
 
     host: str
     plc_profile: object
-    port: int = 5000
+    port: int | None = None
     transport: str = "tcp"
     timeout: float = 3.0
     default_target: SlmpTarget | None = None
@@ -105,6 +107,8 @@ class SlmpConnectionOptions:
     def __post_init__(self) -> None:
         if self.plc_profile is None:
             raise ValueError("plc_profile is required. Use an explicit canonical PLC profile such as 'melsec:iq-r'.")
+        transport = self.transport.lower()
+        port = _resolve_port(self.port, transport)
         (
             normalized_plc_profile,
             plc_series,
@@ -117,6 +121,8 @@ class SlmpConnectionOptions:
             frame_type=None,
             address_profile=None,
         )
+        object.__setattr__(self, "transport", transport)
+        object.__setattr__(self, "port", port)
         object.__setattr__(self, "plc_profile", normalized_plc_profile)
         object.__setattr__(self, "plc_series", plc_series)
         object.__setattr__(self, "frame_type", frame_type)

{slmp_connect_python-0.8.0 → slmp_connect_python-1.0.0/slmp_connect_python.egg-info}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: slmp-connect-python
-Version: 0.8.0
+Version: 1.0.0
 Summary: SLMP Connect Python: client library for MELSEC SLMP binary communication
 Author: fa-yoshinobu
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/fa-yoshinobu/plc-comm-slmp-python
 Project-URL: Repository, https://github.com/fa-yoshinobu/plc-comm-slmp-python
 Project-URL: Issues, https://github.com/fa-yoshinobu/plc-comm-slmp-python/issues
-Keywords: slmp,melsec,mitsubishi,plc,3e,4e,binary
-Classifier: Development Status :: 3 - Alpha
+Keywords: slmp,melsec,plc,3e,4e,binary
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
@@ -33,14 +33,9 @@ Requires-Dist: twine>=5.1; extra == "dev"
 Dynamic: license-file
 
 [![CI](https://github.com/fa-yoshinobu/plc-comm-slmp-python/actions/workflows/ci.yml/badge.svg)](https://github.com/fa-yoshinobu/plc-comm-slmp-python/actions/workflows/ci.yml)
-[![Documentation](https://img.shields.io/badge/docs-GitHub_Pages-blue.svg)](https://fa-yoshinobu.github.io/plc-comm-docs-site/slmp/python/GETTING_STARTED/)
 [![PyPI](https://img.shields.io/pypi/v/slmp-connect-python.svg)](https://pypi.org/project/slmp-connect-python/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Static Analysis: Ruff](https://img.shields.io/badge/Lint-Ruff-black.svg)](https://github.com/astral-sh/ruff)
-[![Release](https://img.shields.io/github/v/release/fa-yoshinobu/plc-comm-slmp-python?label=release)](https://github.com/fa-yoshinobu/plc-comm-slmp-python/releases/latest)
-[![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white)](https://www.python.org/)
-[![MkDocs](https://img.shields.io/badge/MkDocs-526CFE?logo=materialformkdocs&logoColor=white)](https://www.mkdocs.org/)
 
 # MELSEC SLMP for Python