python-snap7 3.0.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

{python_snap7-3.0.0.dist-info → python_snap7-3.1.0.dist-info}/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,32 @@
+python_snap7-3.1.0.dist-info/licenses/LICENSE,sha256=PIihE_yP-8gc-ff9ikvQQPOa0biOCZ6Bc-6h3G3xRUQ,1097
+snap7/__init__.py,sha256=jWGpca2kG7gskQbcM5qoflWEyMMEJ7655kM0KxVVLaA,980
+snap7/async_client.py,sha256=IIWtZ1nwblUZY1Zn0zyLmVQUnp33K0cxl8xVu887Fgs,43911
+snap7/cli.py,sha256=Td7z1O0gV7t-w9umUaX91MHGw-HuXYEDHKgtUO-9d3Q,13755
+snap7/client.py,sha256=ZKDM20dZ55EP-kEyncqjdq8oxB7M5ckgXtKrmFsN8Iw,95429
+snap7/client_base.py,sha256=2fKWy7eczyr-tdGQswH_USTdDdeIrdyTTQ_1F8LRAyU,7435
+snap7/connection.py,sha256=Aeo5ckyFEUR5cpJO88LZENzGitdKlkWdx7LB2tyQkXA,17643
+snap7/datatypes.py,sha256=zJgPasEV79_H4qHabivIxYX50j74pNg64apBppAKI2Y,11205
+snap7/demo.py,sha256=JWSKLj2QPIXeSFTZSXuADAJzWVKls712MUZnuqwNkNs,17376
+snap7/discovery.py,sha256=LONPYg83b2quKXht6y_GTTArdxitjD8DoGyaHfe9B1w,3964
+snap7/error.py,sha256=ToGa85aJ64lwdM5gPweqPZJD7xrgFSw2NK36VOYmXUg,21210
+snap7/log.py,sha256=XX4UyPgByz3EhTc39BTGY454fHvYmiJAX4v-a-gkIEY,4968
+snap7/logo.py,sha256=lFhHELR8r3OAPRnJ_3crE0LpPxzBM2Qn5goD77HlskU,7084
+snap7/optimizer.py,sha256=Bu4zWCfdeA5GG3sWwjYOLkp0tWEfNbAXvbe_RldlYVM,9383
+snap7/partner.py,sha256=HxaTYfojsf5Z170R4cAYFzoMSwqCOF42qPCkOaxbUkU,37916
+snap7/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+snap7/s7protocol.py,sha256=a-obZR5fLzHS1wHpZ88N37XxzYjKiS2JgK8SFi5qTjQ,57360
+snap7/szl.py,sha256=VPKNz8MCU7ok_Run-JVuwHKJSeGY-Wcj93SJu56tgtw,3898
+snap7/tags.py,sha256=Qh8dm6rDWcVnYhbSB_htrmqIAXsmWQWcDS8-wXqN_zE,27033
+snap7/type.py,sha256=-ad6v8vQP21DvWFtHCaSlk-BllFGPKOtbhprqKdOlJ0,9391
+snap7/server/__init__.py,sha256=I4Tk3IwPjQLVokrp3lOgGLoTwLRTNY6mTrWGSOHOrAM,100283
+snap7/server/__main__.py,sha256=OdOgyMmFThjSe2jSgvlbkquGYnZcBW6wubs2ldhNSOE,1206
+snap7/util/__init__.py,sha256=d6n2oy7tNYke1ia0TUyWz_ni3l0XN1qvilM5sW0T-Es,1874
+snap7/util/db.py,sha256=geesYS2oyOuTADOJa2me1p1rqJVzPuLTCfye6JIeav0,27120
+snap7/util/getters.py,sha256=-rsgcczCYzc1Z_t98Q9_2LriQQipYji9T-VIsg_2lWs,24393
+snap7/util/setters.py,sha256=wi8MrABiGbnsqSj1NYjK5aTtcRVS0NbAHQXP6lLjAVg,27454
+snap7/util/symbols.py,sha256=L1dY7I1-HZ5Odtv6ZqGBeLppb3E5hjL64MyATT7XyEw,16454
+python_snap7-3.1.0.dist-info/METADATA,sha256=TiHXRRAXn75UcFn9PpNAzDbXQmetvpYH0cDZ8Vvkogk,4652
+python_snap7-3.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+python_snap7-3.1.0.dist-info/entry_points.txt,sha256=IPZyYr1lKyavXXpAc4xO505afTGwTY8GmNFuy5lsSiM,75
+python_snap7-3.1.0.dist-info/top_level.txt,sha256=VpFXm1w5_73qgJEIN_5OzQWINHyYJBtNoOW4DMoizgw,6
+python_snap7-3.1.0.dist-info/RECORD,,

{python_snap7-3.0.0.dist-info → python_snap7-3.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.1)
+Generator: setuptools (83.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

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

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

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",