python-snap7 3.1.2__tar.gz → 3.2.0__tar.gz

python_snap7-3.2.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: python-snap7
+Version: 3.2.0
+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-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/>`_.

python_snap7-3.2.0/README.rst

@@ -0,0 +1,51 @@
+.. 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/>`_.

{python_snap7-3.1.2 → python_snap7-3.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-snap7"
-version = "3.1.2"
+version = "3.2.0"
 description = "Pure Python S7 communication library for Siemens PLCs"
 readme = "README.rst"
 authors = [
@@ -37,12 +37,13 @@ cli = ["rich", "click" ]
 demo = ["psutil", "rich", "click"]
 doc = ["sphinx", "sphinx_rtd_theme"]
 discovery = ["pnio-dcp"]
+ppi = ["pyserial>=3.5"]
 
 [tool.setuptools.package-data]
 snap7 = ["py.typed"]
 
 [tool.setuptools.packages.find]
-include = ["snap7*"]
+include = ["snap7*", "s7*"]
 
 [project.scripts]
 snap7-server = "snap7.server:mainloop"
@@ -60,8 +61,14 @@ markers =[
     "partner",
     "routing",
     "server",
-    "util"
+    "util",
+    "conformance: protocol conformance tests"
     ]
+asyncio_mode = "auto"
+
+[[tool.uv.index]]
+name = "pypi"
+url = "https://pypi.org/simple"
 
 [tool.mypy]
 ignore_missing_imports = true
@@ -69,6 +76,9 @@ strict = true
 # https://github.com/python/mypy/issues/2427#issuecomment-1419206807
 disable_error_code = ["method-assign", "attr-defined"]
 
+[tool.coverage.report]
+fail_under = 75
+
 [tool.ruff]
 output-format = "full"
 line-length = 130

python_snap7-3.2.0/python_snap7.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: python-snap7
+Version: 3.2.0
+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-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/>`_.

{python_snap7-3.1.2 → python_snap7-3.2.0}/python_snap7.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ python_snap7.egg-info/dependency_links.txt
 python_snap7.egg-info/entry_points.txt
 python_snap7.egg-info/requires.txt
 python_snap7.egg-info/top_level.txt
+s7/__init__.py
 snap7/__init__.py
 snap7/async_client.py
 snap7/cli.py
@@ -22,7 +23,9 @@ snap7/log.py
 snap7/logo.py
 snap7/optimizer.py
 snap7/partner.py
+snap7/ppi.py
 snap7/py.typed
+snap7/rate_limiter.py
 snap7/s7protocol.py
 snap7/szl.py
 snap7/tags.py
@@ -33,29 +36,37 @@ 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_conformance.py
+tests/test_connection.py
+tests/test_coverage_gaps.py
 tests/test_datatypes.py
 tests/test_demo.py
 tests/test_discovery.py
+tests/test_error.py
 tests/test_finalize.py
 tests/test_hypothesis.py
+tests/test_lean_regressions.py
 tests/test_logging.py
 tests/test_logo_client.py
+tests/test_logo_reconnect_options.py
 tests/test_mainloop.py
 tests/test_multipacket.py
 tests/test_optimizer.py
 tests/test_partner.py
+tests/test_ppi.py
 tests/test_property.py
+tests/test_rate_limiter.py
 tests/test_reconnect.py
 tests/test_routing.py
 tests/test_s7protocol.py
 tests/test_server.py
+tests/test_server_cli.py
 tests/test_stress.py
 tests/test_tags.py
 tests/test_typed_access.py

{python_snap7-3.1.2 → python_snap7-3.2.0}/python_snap7.egg-info/requires.txt

@@ -15,6 +15,9 @@ pnio-dcp
 sphinx
 sphinx_rtd_theme
 
+[ppi]
+pyserial>=3.5
+
 [test]
 pytest
 pytest-asyncio

{python_snap7-3.1.2 → python_snap7-3.2.0}/python_snap7.egg-info/top_level.txt

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

python_snap7-3.2.0/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

{python_snap7-3.1.2 → python_snap7-3.2.0}/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",