python-snap7 3.0.0__tar.gz → 3.1.0__tar.gz

{python_snap7-3.0.0/python_snap7.egg-info → python_snap7-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-snap7
-Version: 3.0.0
+Version: 3.1.0
 Summary: Pure Python S7 communication library for Siemens PLCs
 Author-email: Gijs Molenaar <gijsmolenaar@gmail.com>
 License: MIT
@@ -23,8 +23,10 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"
 Requires-Dist: pytest-html; extra == "test"
+Requires-Dist: hypothesis; extra == "test"
 Requires-Dist: mypy; extra == "test"
 Requires-Dist: types-setuptools; extra == "test"
 Requires-Dist: ruff; extra == "test"
@@ -35,9 +37,15 @@ Requires-Dist: uv; extra == "test"
 Provides-Extra: cli
 Requires-Dist: rich; extra == "cli"
 Requires-Dist: click; extra == "cli"
+Provides-Extra: demo
+Requires-Dist: psutil; extra == "demo"
+Requires-Dist: rich; extra == "demo"
+Requires-Dist: click; extra == "demo"
 Provides-Extra: doc
 Requires-Dist: sphinx; extra == "doc"
 Requires-Dist: sphinx_rtd_theme; extra == "doc"
+Provides-Extra: discovery
+Requires-Dist: pnio-dcp; extra == "discovery"
 Dynamic: license-file
 
 About
@@ -54,34 +62,63 @@ Python-snap7 is tested with Python 3.10+, on Windows, Linux and OS X.
 The full documentation is available on `Read The Docs <https://python-snap7.readthedocs.io/en/latest/>`_.
 
 
-Version 3.0 - Pure Python Rewrite
-==================================
+Quick Start
+===========
 
-Version 3.0 is a ground-up rewrite of python-snap7. The library no longer wraps the
-C snap7 shared library — instead, the entire S7 protocol stack (TPKT, COTP, and S7)
-is now implemented in pure Python. This is a **breaking change** from all previous
-versions.
+Connect to any S7 PLC::
 
-**Why this matters:**
+   import snap7
 
-* **Portability**: No more platform-specific shared libraries (`.dll`, `.so`, `.dylib`).
-  python-snap7 now works on any platform that runs Python — including ARM, Alpine Linux,
-  and other environments where the C library was difficult or impossible to install.
-* **Easier installation**: Just ``pip install python-snap7``. No native dependencies,
-  no compiler toolchains, no manual library setup.
-* **Easier to extend**: New features and protocol support can be added directly in Python.
+   client = snap7.Client()
+   client.connect("192.168.1.10", 0, 1)
+   data = client.db_read(1, 0, 4)
+   client.disconnect()
+
+No native libraries or platform-specific dependencies are required.
+
+Async support::
+
+   import asyncio
+   import snap7
+
+   async def main():
+       async with snap7.AsyncClient() as client:
+           await client.connect("192.168.1.10", 0, 1)
+           data = await client.db_read(1, 0, 4)
 
-**If you experience issues with 3.0:**
+   asyncio.run(main())
 
-1. Please report them on the `issue tracker <https://github.com/gijzelaerr/python-snap7/issues>`_
-   with a clear description of the problem and the version you are using
-   (``python -c "import snap7; print(snap7.__version__)"``).
-2. As a workaround, you can pin to the last pre-3.0 release::
 
-       $ pip install "python-snap7<3"
+What's New in 3.1
+=================
 
-   The latest stable pre-3.0 release is version 2.1.0. Documentation for pre-3.0
-   versions is available at `Read The Docs <https://python-snap7.readthedocs.io/en/v2/>`_.
+* **AsyncClient** for ``asyncio`` support
+* **Tag API** -- read/write by name: ``client.read_tag("DB1.DBD0:REAL")``
+  with PLC4X and nodeS7 dialect support
+* **Multi-variable read optimizer** -- merges scattered reads into minimal
+  PDU exchanges
+* **S7 routing** -- connect to PLCs on remote subnets via a gateway PLC
+* **Heartbeat monitoring** and auto-reconnect with exponential backoff
+* **Structured logging** with PLC connection context
+* **PROFINET DCP** network discovery
+* **CLI tools** for PLC interaction (``pip install "python-snap7[cli]"``)
+* Numerous bug fixes -- see `CHANGES.md <https://github.com/gijzelaerr/python-snap7/blob/master/CHANGES.md>`_
+  for the full list
+
+
+Version 3.0 -- Pure Python Rewrite
+====================================
+
+Version 3.0 was a ground-up rewrite of python-snap7. The library no longer wraps
+the C snap7 shared library -- instead, the entire S7 protocol stack (TPKT, COTP,
+and S7) is implemented in pure Python.
+
+* **Portability**: No more platform-specific shared libraries (``.dll``, ``.so``, ``.dylib``).
+  Works on any platform that runs Python -- including ARM, Alpine Linux, and other
+  environments where the C library was difficult or impossible to install.
+* **Easier installation**: Just ``pip install python-snap7``. No native dependencies,
+  no compiler toolchains, no manual library setup.
+* **Easier to extend**: New features and protocol support can be added directly in Python.
 
 
 Installation

python_snap7-3.1.0/README.rst

@@ -0,0 +1,81 @@
+About
+=====
+
+Python-snap7 is a pure Python S7 communication library for interfacing with Siemens S7 PLCs.
+
+The name "python-snap7" is historical — the library originally started as a Python wrapper
+around the `Snap7 <http://snap7.sourceforge.net/>`_ C library. As of version 3.0, the C
+library is no longer used, but the name is kept for backwards compatibility.
+
+Python-snap7 is tested with Python 3.10+, on Windows, Linux and OS X.
+
+The full documentation is available on `Read The Docs <https://python-snap7.readthedocs.io/en/latest/>`_.
+
+
+Quick Start
+===========
+
+Connect to any S7 PLC::
+
+   import snap7
+
+   client = snap7.Client()
+   client.connect("192.168.1.10", 0, 1)
+   data = client.db_read(1, 0, 4)
+   client.disconnect()
+
+No native libraries or platform-specific dependencies are required.
+
+Async support::
+
+   import asyncio
+   import snap7
+
+   async def main():
+       async with snap7.AsyncClient() as client:
+           await client.connect("192.168.1.10", 0, 1)
+           data = await client.db_read(1, 0, 4)
+
+   asyncio.run(main())
+
+
+What's New in 3.1
+=================
+
+* **AsyncClient** for ``asyncio`` support
+* **Tag API** -- read/write by name: ``client.read_tag("DB1.DBD0:REAL")``
+  with PLC4X and nodeS7 dialect support
+* **Multi-variable read optimizer** -- merges scattered reads into minimal
+  PDU exchanges
+* **S7 routing** -- connect to PLCs on remote subnets via a gateway PLC
+* **Heartbeat monitoring** and auto-reconnect with exponential backoff
+* **Structured logging** with PLC connection context
+* **PROFINET DCP** network discovery
+* **CLI tools** for PLC interaction (``pip install "python-snap7[cli]"``)
+* Numerous bug fixes -- see `CHANGES.md <https://github.com/gijzelaerr/python-snap7/blob/master/CHANGES.md>`_
+  for the full list
+
+
+Version 3.0 -- Pure Python Rewrite
+====================================
+
+Version 3.0 was a ground-up rewrite of python-snap7. The library no longer wraps
+the C snap7 shared library -- instead, the entire S7 protocol stack (TPKT, COTP,
+and S7) is implemented in pure Python.
+
+* **Portability**: No more platform-specific shared libraries (``.dll``, ``.so``, ``.dylib``).
+  Works on any platform that runs Python -- including ARM, Alpine Linux, and other
+  environments where the C library was difficult or impossible to install.
+* **Easier installation**: Just ``pip install python-snap7``. No native dependencies,
+  no compiler toolchains, no manual library setup.
+* **Easier to extend**: New features and protocol support can be added directly in Python.
+
+
+Installation
+============
+
+Install using pip::
+
+   $ pip install python-snap7
+
+No native libraries or platform-specific dependencies are required — python-snap7 is a pure Python package that works on all platforms.

{python_snap7-3.0.0 → python_snap7-3.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-snap7"
-version = "3.0.0"
+version = "3.1.0"
 description = "Pure Python S7 communication library for Siemens PLCs"
 readme = "README.rst"
 authors = [
@@ -32,9 +32,11 @@ Homepage = "https://github.com/gijzelaerr/python-snap7"
 Documentation = "https://python-snap7.readthedocs.io/en/latest/"
 
 [project.optional-dependencies]
-test = ["pytest", "pytest-cov", "pytest-html", "mypy", "types-setuptools", "ruff", "tox", "tox-uv", "types-click", "uv"]
+test = ["pytest", "pytest-asyncio", "pytest-cov", "pytest-html", "hypothesis", "mypy", "types-setuptools", "ruff", "tox", "tox-uv", "types-click", "uv"]
 cli = ["rich", "click" ]
+demo = ["psutil", "rich", "click"]
 doc = ["sphinx", "sphinx_rtd_theme"]
+discovery = ["pnio-dcp"]
 
 [tool.setuptools.package-data]
 snap7 = ["py.typed"]
@@ -44,6 +46,7 @@ include = ["snap7*"]
 
 [project.scripts]
 snap7-server = "snap7.server:mainloop"
+s7 = "snap7.cli:main"
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
@@ -51,9 +54,11 @@ markers =[
     "client",
     "common",
     "e2e: end-to-end tests requiring a real PLC connection",
+    "hypothesis: property-based tests using Hypothesis",
     "logo",
     "mainloop",
     "partner",
+    "routing",
     "server",
     "util"
     ]

{python_snap7-3.0.0 → python_snap7-3.1.0/python_snap7.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-snap7
-Version: 3.0.0
+Version: 3.1.0
 Summary: Pure Python S7 communication library for Siemens PLCs
 Author-email: Gijs Molenaar <gijsmolenaar@gmail.com>
 License: MIT
@@ -23,8 +23,10 @@ Description-Content-Type: text/x-rst
 License-File: LICENSE
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"
 Requires-Dist: pytest-html; extra == "test"
+Requires-Dist: hypothesis; extra == "test"
 Requires-Dist: mypy; extra == "test"
 Requires-Dist: types-setuptools; extra == "test"
 Requires-Dist: ruff; extra == "test"
@@ -35,9 +37,15 @@ Requires-Dist: uv; extra == "test"
 Provides-Extra: cli
 Requires-Dist: rich; extra == "cli"
 Requires-Dist: click; extra == "cli"
+Provides-Extra: demo
+Requires-Dist: psutil; extra == "demo"
+Requires-Dist: rich; extra == "demo"
+Requires-Dist: click; extra == "demo"
 Provides-Extra: doc
 Requires-Dist: sphinx; extra == "doc"
 Requires-Dist: sphinx_rtd_theme; extra == "doc"
+Provides-Extra: discovery
+Requires-Dist: pnio-dcp; extra == "discovery"
 Dynamic: license-file
 
 About
@@ -54,34 +62,63 @@ Python-snap7 is tested with Python 3.10+, on Windows, Linux and OS X.
 The full documentation is available on `Read The Docs <https://python-snap7.readthedocs.io/en/latest/>`_.
 
 
-Version 3.0 - Pure Python Rewrite
-==================================
+Quick Start
+===========
 
-Version 3.0 is a ground-up rewrite of python-snap7. The library no longer wraps the
-C snap7 shared library — instead, the entire S7 protocol stack (TPKT, COTP, and S7)
-is now implemented in pure Python. This is a **breaking change** from all previous
-versions.
+Connect to any S7 PLC::
 
-**Why this matters:**
+   import snap7
 
-* **Portability**: No more platform-specific shared libraries (`.dll`, `.so`, `.dylib`).
-  python-snap7 now works on any platform that runs Python — including ARM, Alpine Linux,
-  and other environments where the C library was difficult or impossible to install.
-* **Easier installation**: Just ``pip install python-snap7``. No native dependencies,
-  no compiler toolchains, no manual library setup.
-* **Easier to extend**: New features and protocol support can be added directly in Python.
+   client = snap7.Client()
+   client.connect("192.168.1.10", 0, 1)
+   data = client.db_read(1, 0, 4)
+   client.disconnect()
+
+No native libraries or platform-specific dependencies are required.
+
+Async support::
+
+   import asyncio
+   import snap7
+
+   async def main():
+       async with snap7.AsyncClient() as client:
+           await client.connect("192.168.1.10", 0, 1)
+           data = await client.db_read(1, 0, 4)
 
-**If you experience issues with 3.0:**
+   asyncio.run(main())
 
-1. Please report them on the `issue tracker <https://github.com/gijzelaerr/python-snap7/issues>`_
-   with a clear description of the problem and the version you are using
-   (``python -c "import snap7; print(snap7.__version__)"``).
-2. As a workaround, you can pin to the last pre-3.0 release::
 
-       $ pip install "python-snap7<3"
+What's New in 3.1
+=================
 
-   The latest stable pre-3.0 release is version 2.1.0. Documentation for pre-3.0
-   versions is available at `Read The Docs <https://python-snap7.readthedocs.io/en/v2/>`_.
+* **AsyncClient** for ``asyncio`` support
+* **Tag API** -- read/write by name: ``client.read_tag("DB1.DBD0:REAL")``
+  with PLC4X and nodeS7 dialect support
+* **Multi-variable read optimizer** -- merges scattered reads into minimal
+  PDU exchanges
+* **S7 routing** -- connect to PLCs on remote subnets via a gateway PLC
+* **Heartbeat monitoring** and auto-reconnect with exponential backoff
+* **Structured logging** with PLC connection context
+* **PROFINET DCP** network discovery
+* **CLI tools** for PLC interaction (``pip install "python-snap7[cli]"``)
+* Numerous bug fixes -- see `CHANGES.md <https://github.com/gijzelaerr/python-snap7/blob/master/CHANGES.md>`_
+  for the full list
+
+
+Version 3.0 -- Pure Python Rewrite
+====================================
+
+Version 3.0 was a ground-up rewrite of python-snap7. The library no longer wraps
+the C snap7 shared library -- instead, the entire S7 protocol stack (TPKT, COTP,
+and S7) is implemented in pure Python.
+
+* **Portability**: No more platform-specific shared libraries (``.dll``, ``.so``, ``.dylib``).
+  Works on any platform that runs Python -- including ARM, Alpine Linux, and other
+  environments where the C library was difficult or impossible to install.
+* **Easier installation**: Just ``pip install python-snap7``. No native dependencies,
+  no compiler toolchains, no manual library setup.
+* **Easier to extend**: New features and protocol support can be added directly in Python.
 
 
 Installation

{python_snap7-3.0.0 → python_snap7-3.1.0}/python_snap7.egg-info/SOURCES.txt

@@ -9,14 +9,23 @@ python_snap7.egg-info/entry_points.txt
 python_snap7.egg-info/requires.txt
 python_snap7.egg-info/top_level.txt
 snap7/__init__.py
+snap7/async_client.py
+snap7/cli.py
 snap7/client.py
+snap7/client_base.py
 snap7/connection.py
 snap7/datatypes.py
+snap7/demo.py
+snap7/discovery.py
 snap7/error.py
+snap7/log.py
 snap7/logo.py
+snap7/optimizer.py
 snap7/partner.py
 snap7/py.typed
 snap7/s7protocol.py
+snap7/szl.py
+snap7/tags.py
 snap7/type.py
 snap7/server/__init__.py
 snap7/server/__main__.py
@@ -24,14 +33,30 @@ snap7/util/__init__.py
 snap7/util/db.py
 snap7/util/getters.py
 snap7/util/setters.py
+snap7/util/symbols.py
 tests/test_api_surface.py
+tests/test_async_client.py
 tests/test_behavioral_compatibility.py
+tests/test_cli.py
 tests/test_client.py
 tests/test_client_e2e.py
 tests/test_datatypes.py
+tests/test_demo.py
+tests/test_discovery.py
+tests/test_finalize.py
+tests/test_hypothesis.py
+tests/test_logging.py
 tests/test_logo_client.py
 tests/test_mainloop.py
 tests/test_multipacket.py
+tests/test_optimizer.py
 tests/test_partner.py
+tests/test_property.py
+tests/test_reconnect.py
+tests/test_routing.py
+tests/test_s7protocol.py
 tests/test_server.py
+tests/test_stress.py
+tests/test_tags.py
+tests/test_typed_access.py
 tests/test_util.py

{python_snap7-3.0.0 → python_snap7-3.1.0}/python_snap7.egg-info/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
+s7 = snap7.cli:main
 snap7-server = snap7.server:mainloop

{python_snap7-3.0.0 → python_snap7-3.1.0}/python_snap7.egg-info/requires.txt

@@ -3,14 +3,24 @@
 rich
 click
 
+[demo]
+psutil
+rich
+click
+
+[discovery]
+pnio-dcp
+
 [doc]
 sphinx
 sphinx_rtd_theme
 
 [test]
 pytest
+pytest-asyncio
 pytest-cov
 pytest-html
+hypothesis
 mypy
 types-setuptools
 ruff

{python_snap7-3.0.0 → python_snap7-3.1.0}/snap7/__init__.py

@@ -8,19 +8,30 @@ Siemens S7 PLCs without requiring the native Snap7 C library.
 from importlib.metadata import version, PackageNotFoundError
 
 from .client import Client
+from .async_client import AsyncClient
 from .server import Server
 from .partner import Partner
 from .logo import Logo
 from .util.db import Row, DB
+from .tags import NodeS7Tag, PLC4XTag, Tag, from_browse, load_csv, load_json, load_tia_xml, parse_tag
 from .type import Area, Block, WordLen, SrvEvent, SrvArea
 
 __all__ = [
     "Client",
+    "AsyncClient",
     "Server",
     "Partner",
     "Logo",
     "Row",
     "DB",
+    "Tag",
+    "PLC4XTag",
+    "NodeS7Tag",
+    "parse_tag",
+    "load_csv",
+    "load_json",
+    "load_tia_xml",
+    "from_browse",
     "Area",
     "Block",
     "WordLen",