python-snap7 3.1.2__py3-none-any.whl → 3.2.1__py3-none-any.whl

python_snap7-3.2.1.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: python-snap7
+Version: 3.2.1
+Summary: Pure Python S7 communication library for Siemens PLCs
+Author-email: Gijs Molenaar <gijsmolenaar@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/gijzelaerr/python-snap7
+Project-URL: Documentation, https://python-snap7.readthedocs.io/en/latest/
+Keywords: snap7,s7,siemens,plc
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Topic :: System :: Hardware
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Manufacturing
+Classifier: Operating System :: POSIX
+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
+Requires-Python: >=3.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-bdd<9,>=8.1; 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"
+Requires-Dist: tox; extra == "test"
+Requires-Dist: tox-uv; extra == "test"
+Requires-Dist: types-click; extra == "test"
+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"
+Provides-Extra: ppi
+Requires-Dist: pyserial>=3.5; extra == "ppi"
+Dynamic: license-file
+
+.. image:: https://img.shields.io/pypi/v/python-snap7.svg
+   :target: https://pypi.org/project/python-snap7/
+
+.. image:: https://img.shields.io/pypi/pyversions/python-snap7.svg
+   :target: https://pypi.org/project/python-snap7/
+
+.. image:: https://img.shields.io/github/license/gijzelaerr/python-snap7.svg
+   :target: https://github.com/gijzelaerr/python-snap7/blob/master/LICENSE
+
+.. image:: https://github.com/gijzelaerr/python-snap7/actions/workflows/test.yml/badge.svg
+   :target: https://github.com/gijzelaerr/python-snap7/actions/workflows/test.yml
+
+.. image:: https://readthedocs.org/projects/python-snap7/badge/
+   :target: https://python-snap7.readthedocs.io/en/latest/
+
+
+python-snap7
+============
+
+python-snap7 is a pure-Python library for communicating with Siemens S7 PLCs
+using the classic S7 protocol. It supports S7-300 and S7-400 controllers, as
+well as S7-1200 and S7-1500 controllers with PUT/GET access enabled. It
+supports Python 3.10+ on Windows, Linux, and macOS without native dependencies.
+
+Installation
+============
+
+Install from PyPI::
+
+   pip install python-snap7
+
+Quick start
+===========
+
+::
+
+   from s7 import Client
+
+   client = Client()
+   client.connect("192.168.1.10", 0, 1)
+   data = client.db_read(1, 0, 4)
+   client.disconnect()
+
+The ``s7`` package is the recommended import. The ``snap7`` package name is
+also available for backwards compatibility.
+
+Documentation
+=============
+
+Read the full documentation at
+`python-snap7.readthedocs.io <https://python-snap7.readthedocs.io/en/latest/>`_.
+
+The safe volunteer hardware-test procedure is in
+`Real-PLC acceptance testing <doc/real-plc-testing.rst>`_.

python_snap7-3.2.1.dist-info/RECORD

@@ -0,0 +1,34 @@
+python_snap7-3.2.1.dist-info/licenses/LICENSE,sha256=PIihE_yP-8gc-ff9ikvQQPOa0biOCZ6Bc-6h3G3xRUQ,1097
+s7/__init__.py,sha256=q6E4rA1BDx36PPkJS55xv7XCxwlaQeEK6HNotFjLeYo,1096
+snap7/__init__.py,sha256=2NAAE1oaSSd7DqPl0dx7jNXtsM2PRBWRm9X-bkmgC6U,1275
+snap7/async_client.py,sha256=yPyqzD4WH3544hKV4aDHt48r8LSWKsbFcVBZxtQOcYQ,52571
+snap7/cli.py,sha256=L1B7NMAemDcl93JUSqJV3Ls_CN2ghlG75nTMD08JkMs,13787
+snap7/client.py,sha256=MWnqsxjjdSSAloluSqAXtmfpokyJEKezJj77e_SqR6I,107985
+snap7/client_base.py,sha256=tNZs_MA8FGit8pg9axNoljH1kFToDI1HIzXC8WQLYHs,11324
+snap7/connection.py,sha256=Qjis-ICK6E74_YfoJuy2_lgDqfSYs4ULux1FShJVvtw,18834
+snap7/datatypes.py,sha256=Gqu1XDuKkQI76n4TYrFrhm0RlPz4XNA5GKA-GJJXJDU,12042
+snap7/demo.py,sha256=JWSKLj2QPIXeSFTZSXuADAJzWVKls712MUZnuqwNkNs,17376
+snap7/discovery.py,sha256=LONPYg83b2quKXht6y_GTTArdxitjD8DoGyaHfe9B1w,3964
+snap7/error.py,sha256=S5BquFFSL1NpgdytIpOD_FzhN6gOCngSkxJVZT4rxdw,21323
+snap7/log.py,sha256=XX4UyPgByz3EhTc39BTGY454fHvYmiJAX4v-a-gkIEY,4968
+snap7/logo.py,sha256=0h-EZ5K86Qddna_lryBn6xLXLVwnznYJuMGuevzH6bI,9192
+snap7/optimizer.py,sha256=Bu4zWCfdeA5GG3sWwjYOLkp0tWEfNbAXvbe_RldlYVM,9383
+snap7/partner.py,sha256=HxaTYfojsf5Z170R4cAYFzoMSwqCOF42qPCkOaxbUkU,37916
+snap7/ppi.py,sha256=p0fVelfUQOT3QH5uuWOjpDxA5IyT3gx5FzCMaYYEuWQ,16070
+snap7/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+snap7/rate_limiter.py,sha256=dnXCOJLWmszo8oskbFM0om0gPC4LHHCOr-Nt22tImeU,4151
+snap7/s7protocol.py,sha256=BLuI6h3Cfbr4R55-v20fYMlKCY6ASbtxdJOC5T0JyaI,69396
+snap7/szl.py,sha256=a9NhH7Lyp8SXJ2_kvyyV-14srIxm3tXnAnclBy5alDk,7998
+snap7/tags.py,sha256=TmbNRHNWZVe3Yl_1L5WXE3Qb0lxIEW-veoCRGt0giZQ,26987
+snap7/type.py,sha256=EiXqU0ayYYxlM-5fUcPL7psgL1EGNNqAa7JXH4QlAnU,9752
+snap7/server/__init__.py,sha256=0XqMGlqblhVNmILT_Ddm-yxTw1r19bfFrr-VuPLEDnI,112468
+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=pMsiCz0soMV7Q-VDPBdFG5eHzcFESZtKPw6mxj4S5ko,25370
+snap7/util/setters.py,sha256=BpFqVxxUbhqarV6Gzt4ZuxycHljtDYsONCr6e9G33Ms,27226
+python_snap7-3.2.1.dist-info/METADATA,sha256=-oAcJHaF7AZL-10-rfF1c73I5E-JElaLi-azSxq76zg,3662
+python_snap7-3.2.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_snap7-3.2.1.dist-info/entry_points.txt,sha256=IPZyYr1lKyavXXpAc4xO505afTGwTY8GmNFuy5lsSiM,75
+python_snap7-3.2.1.dist-info/top_level.txt,sha256=PTgDoDG45QNL2XIE9RM7S_ZCdWQjtMMuXNyrI2UdnbU,9
+python_snap7-3.2.1.dist-info/RECORD,,

{python_snap7-3.1.2.dist-info → python_snap7-3.2.1.dist-info}/top_level.txt

@@ -1 +1,2 @@
+s7
 snap7

s7/__init__.py

@@ -0,0 +1,52 @@
+"""Alias for the ``snap7`` package.
+
+``s7`` re-exports everything from ``snap7`` so that either name works::
+
+    from s7 import Client          # same as: from snap7 import Client
+    from s7.type import Area       # same as: from snap7.type import Area
+
+Both import names are supported; ``s7`` is recommended for new code.
+"""
+
+import importlib
+import sys
+
+import snap7 as snap7  # noqa: F401
+
+from snap7 import *  # noqa: F403
+from snap7 import __all__ as __all__, __version__ as __version__
+
+_SUBMODULES = [
+    "async_client",
+    "cli",
+    "client",
+    "client_base",
+    "connection",
+    "datatypes",
+    "demo",
+    "discovery",
+    "error",
+    "log",
+    "logo",
+    "optimizer",
+    "partner",
+    "ppi",
+    "rate_limiter",
+    "s7protocol",
+    "server",
+    "szl",
+    "tags",
+    "type",
+    "util",
+]
+
+for _name in _SUBMODULES:
+    _fqn = f"s7.{_name}"
+    if _fqn not in sys.modules:
+        try:
+            _mod = importlib.import_module(f"snap7.{_name}")
+            sys.modules[_fqn] = _mod
+        except ImportError:
+            pass
+
+del _name, _fqn, _mod, _SUBMODULES

snap7/__init__.py

@@ -1,8 +1,15 @@
 """
-The Snap7 Python library.
+The snap7 compatibility package.
 
-Pure Python implementation of the S7 protocol for communicating with
-Siemens S7 PLCs without requiring the native Snap7 C library.
+Pure Python implementation of the classic S7 protocol for communicating with
+Siemens S7 PLCs. This package is kept for backwards compatibility. For new
+projects, use the ``s7`` package instead::
+
+    from s7 import Client
+
+    client = Client()
+    client.connect("192.168.1.10", 0, 1)
+    data = client.db_read(1, 0, 4)
 """
 
 from importlib.metadata import version, PackageNotFoundError
@@ -11,16 +18,19 @@ from .client import Client
 from .async_client import AsyncClient
 from .server import Server
 from .partner import Partner
+from .ppi import PPIArea, PPIClient
 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
+from .type import Area, Block, ForceEntry, WordLen, SrvEvent, SrvArea
 
 __all__ = [
     "Client",
     "AsyncClient",
     "Server",
     "Partner",
+    "PPIClient",
+    "PPIArea",
     "Logo",
     "Row",
     "DB",
@@ -34,6 +44,7 @@ __all__ = [
     "from_browse",
     "Area",
     "Block",
+    "ForceEntry",
     "WordLen",
     "SrvEvent",
     "SrvArea",