slmp-connect-python 0.1.4__tar.gz → 0.1.6__tar.gz

{slmp_connect_python-0.1.4 → slmp_connect_python-0.1.6}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 fa-yoshinobu
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 fa-yoshinobu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

slmp_connect_python-0.1.6/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: slmp-connect-python
+Version: 0.1.6
+Summary: SLMP Connect Python: client library for Mitsubishi 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
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: pre-commit>=3.7; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+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-slmp-python/)
+[![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)
+
+# SLMP Protocol for Python
+
+![Illustration](https://raw.githubusercontent.com/fa-yoshinobu/plc-comm-slmp-python/main/docsrc/assets/melsec.png)
+
+High-level SLMP helpers for Mitsubishi PLC communication over Binary 3E and 4E frames.
+
+This repository treats the high-level helper layer as the recommended user surface:
+
+- `SlmpConnectionOptions`
+- `open_and_connect` / `open_and_connect_sync`
+- `AsyncSlmpClient`
+- `QueuedAsyncSlmpClient`
+- `SlmpClient`
+- `normalize_address`
+- `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`
+
+## Installation
+
+```bash
+pip install slmp-connect-python
+```
+
+The latest release lives at <https://pypi.org/project/slmp-connect-python/>, where wheel and tarball downloads and metadata are available.
+
+## Quick Start
+
+Recommended async path:
+
+```python
+import asyncio
+
+from slmp import SlmpConnectionOptions, open_and_connect, read_named, write_typed
+
+
+async def main() -> None:
+    options = SlmpConnectionOptions(
+        host="192.168.250.100",
+        port=1025,
+        plc_series="iqr",
+        frame_type="4e",
+    )
+    async with await open_and_connect(options) as client:
+        before = await read_named(client, ["D100", "D200:F", "D50.3"])
+        print("before:", before)
+
+        await write_typed(client, "D100", "U", 42)
+
+        after = await read_named(client, ["D100", "D200:F", "D50.3"])
+        print("after:", after)
+
+
+asyncio.run(main())
+```
+
+Choose the connection profile explicitly:
+
+- `plc_series="iqr", frame_type="4e"` for iQ-R / iQ-F targets
+- `plc_series="ql", frame_type="3e"` for Q / L targets
+
+## Supported PLC Registers
+
+Start with these public high-level families first:
+
+- word devices: `D`, `SD`, `R`, `ZR`, `TN`, `CN`
+- bit devices: `M`, `X`, `Y`, `SM`, `B`
+- typed forms: `D200:F`, `D300:L`, `D100:S`
+- mixed snapshot forms: `D50.3`, `D100`, `D200:F`
+- current-value long families: `LTN`, `LSTN`, `LCN`
+
+See the full public table in [Supported PLC Registers](docsrc/user/SUPPORTED_REGISTERS.md).
+
+## Public Documentation
+
+- [Getting Started](docsrc/user/GETTING_STARTED.md)
+- [Supported PLC Registers](docsrc/user/SUPPORTED_REGISTERS.md)
+- [Latest Communication Verification](docsrc/user/LATEST_COMMUNICATION_VERIFICATION.md)
+- [User Guide](docsrc/user/USER_GUIDE.md)
+- [Samples](docsrc/user/SAMPLES.md)
+- [Error Codes](docsrc/user/ERROR_CODES.md)
+
+Maintainer-only notes and retained evidence live under `internal_docs/`.
+
+## High-Level API Guide
+
+### Address Normalization
+
+```python
+from slmp import normalize_address
+
+print(normalize_address("x20"))   # X20
+print(normalize_address("d200"))  # D200
+```
+
+### Single Typed Values
+
+```python
+from slmp import read_typed, write_typed
+
+temperature = await read_typed(client, "D200", "F")
+counter = await read_typed(client, "D300", "L")
+await write_typed(client, "D100", "U", 1234)
+```
+
+Use `.bit` notation only with word devices such as `D50.3`.
+Address bit devices directly as `M1000`, `M1001`, `X20`, or `Y20`.
+
+## Development
+
+```bash
+run_ci.bat
+build_docs.bat
+release_check.bat
+```
+
+## License
+
+Distributed under the [MIT License](LICENSE).

slmp_connect_python-0.1.6/README.md

@@ -0,0 +1,129 @@
+[![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-slmp-python/)
+[![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)
+
+# SLMP Protocol for Python
+
+![Illustration](https://raw.githubusercontent.com/fa-yoshinobu/plc-comm-slmp-python/main/docsrc/assets/melsec.png)
+
+High-level SLMP helpers for Mitsubishi PLC communication over Binary 3E and 4E frames.
+
+This repository treats the high-level helper layer as the recommended user surface:
+
+- `SlmpConnectionOptions`
+- `open_and_connect` / `open_and_connect_sync`
+- `AsyncSlmpClient`
+- `QueuedAsyncSlmpClient`
+- `SlmpClient`
+- `normalize_address`
+- `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`
+
+## Installation
+
+```bash
+pip install slmp-connect-python
+```
+
+The latest release lives at <https://pypi.org/project/slmp-connect-python/>, where wheel and tarball downloads and metadata are available.
+
+## Quick Start
+
+Recommended async path:
+
+```python
+import asyncio
+
+from slmp import SlmpConnectionOptions, open_and_connect, read_named, write_typed
+
+
+async def main() -> None:
+    options = SlmpConnectionOptions(
+        host="192.168.250.100",
+        port=1025,
+        plc_series="iqr",
+        frame_type="4e",
+    )
+    async with await open_and_connect(options) as client:
+        before = await read_named(client, ["D100", "D200:F", "D50.3"])
+        print("before:", before)
+
+        await write_typed(client, "D100", "U", 42)
+
+        after = await read_named(client, ["D100", "D200:F", "D50.3"])
+        print("after:", after)
+
+
+asyncio.run(main())
+```
+
+Choose the connection profile explicitly:
+
+- `plc_series="iqr", frame_type="4e"` for iQ-R / iQ-F targets
+- `plc_series="ql", frame_type="3e"` for Q / L targets
+
+## Supported PLC Registers
+
+Start with these public high-level families first:
+
+- word devices: `D`, `SD`, `R`, `ZR`, `TN`, `CN`
+- bit devices: `M`, `X`, `Y`, `SM`, `B`
+- typed forms: `D200:F`, `D300:L`, `D100:S`
+- mixed snapshot forms: `D50.3`, `D100`, `D200:F`
+- current-value long families: `LTN`, `LSTN`, `LCN`
+
+See the full public table in [Supported PLC Registers](docsrc/user/SUPPORTED_REGISTERS.md).
+
+## Public Documentation
+
+- [Getting Started](docsrc/user/GETTING_STARTED.md)
+- [Supported PLC Registers](docsrc/user/SUPPORTED_REGISTERS.md)
+- [Latest Communication Verification](docsrc/user/LATEST_COMMUNICATION_VERIFICATION.md)
+- [User Guide](docsrc/user/USER_GUIDE.md)
+- [Samples](docsrc/user/SAMPLES.md)
+- [Error Codes](docsrc/user/ERROR_CODES.md)
+
+Maintainer-only notes and retained evidence live under `internal_docs/`.
+
+## High-Level API Guide
+
+### Address Normalization
+
+```python
+from slmp import normalize_address
+
+print(normalize_address("x20"))   # X20
+print(normalize_address("d200"))  # D200
+```
+
+### Single Typed Values
+
+```python
+from slmp import read_typed, write_typed
+
+temperature = await read_typed(client, "D200", "F")
+counter = await read_typed(client, "D300", "L")
+await write_typed(client, "D100", "U", 1234)
+```
+
+Use `.bit` notation only with word devices such as `D50.3`.
+Address bit devices directly as `M1000`, `M1001`, `X20`, or `Y20`.
+
+## Development
+
+```bash
+run_ci.bat
+build_docs.bat
+release_check.bat
+```
+
+## License
+
+Distributed under the [MIT License](LICENSE).

{slmp_connect_python-0.1.4 → slmp_connect_python-0.1.6}/pyproject.toml

@@ -1,118 +1,117 @@
-[build-system]
-requires = ["setuptools>=69", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "slmp-connect-python"
-version = "0.1.4"
-description = "SLMP Connect Python: client library for Mitsubishi SLMP binary communication"
-readme = "README.md"
-requires-python = ">=3.10"
-dependencies = []
-authors = [{ name = "fa-yoshinobu" }]
-
-license-files = ["LICENSE"]
-keywords = ["slmp", "melsec", "mitsubishi", "plc", "3e", "4e", "binary"]
-classifiers = [
-    "License :: OSI Approved :: MIT License",
-    "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-compatibility-probe = "slmp.cli:compatibility_probe_main"
-slmp-compatibility-matrix-render = "slmp.cli:compatibility_matrix_render_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-device-access-matrix-sync = "slmp.cli:device_access_matrix_sync_main"
-slmp-manual-write-verification = "slmp.cli:manual_write_verification_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*", "docsrc/maintainer*", "docsrc/validation*"]
-
-[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.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 = "0.1.6"
+description = "SLMP Connect Python: client library for Mitsubishi 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-compatibility-probe = "slmp.cli:compatibility_probe_main"
+slmp-compatibility-matrix-render = "slmp.cli:compatibility_matrix_render_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-device-access-matrix-sync = "slmp.cli:device_access_matrix_sync_main"
+slmp-manual-write-verification = "slmp.cli:manual_write_verification_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.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.1.4 → slmp_connect_python-0.1.6}/setup.cfg

@@ -1,4 +1,4 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[egg_info]
+tag_build = 
+tag_date = 0
+