Clean client directory structure for async. (#1010)

Author: janiversen

README.rst

@@ -5,14 +5,14 @@ PyModbus - A Python Modbus Stack
 .. image:: https://github.com/riptideio/pymodbus/actions/workflows/ci.yml/badge.svg?branch=dev
    :target: https://github.com/riptideio/pymodbus/actions/workflows/ci.yml
 .. image:: https://badges.gitter.im/Join%20Chat.svg
-   :target: https://gitter.im/pymodbus_dev/Lobby 
+   :target: https://gitter.im/pymodbus_dev/Lobby
 .. image:: https://readthedocs.org/projects/pymodbus/badge/?version=latest
    :target: https://pymodbus.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status
 .. image:: https://pepy.tech/badge/pymodbus
-   :target: https://pepy.tech/project/pymodbus 
+   :target: https://pepy.tech/project/pymodbus
    :alt: Downloads
-   
+
 ------------------------------------------------------------
 Supported versions
 ------------------------------------------------------------
@@ -87,7 +87,7 @@ base operating system will allow (*allow* in this case means how many Virtual IP
 
 For more information please browse the project documentation:
 
-https://riptideio.github.io/pymodbus/ 
+https://riptideio.github.io/pymodbus/
 or
 https://readthedocs.org/docs/pymodbus/en/latest/index.html
 
@@ -97,8 +97,8 @@ Example Code
 
 For those of you that just want to get started fast, here you go::
 
-    from pymodbus.client.sync import ModbusTcpClient
-    
+    from pymodbus.client import ModbusTcpClient
+
     client = ModbusTcpClient('127.0.0.1')
     client.write_coil(1, True)
     result = client.read_coils(1,1)
@@ -134,7 +134,7 @@ If you think, that something in the code is broken/not running well, please `ope
 ------------------------------------------------------------
 Pymodbus REPL (Read Evaluate Print Loop)
 ------------------------------------------------------------
-Pymodbus REPL comes with many handy features such as payload decoder 
+Pymodbus REPL comes with many handy features such as payload decoder
 to directly retrieve the values in desired format and supports all
 the diagnostic function codes directly .
 
@@ -158,7 +158,7 @@ This will install a base version of pymodbus.
 To install pymodbus with options run:
 
     pip install -U pymodbus[<option>,...]
-    
+
 Available options are:
 
 - **repl**, installs pymodbus REPL.
@@ -181,8 +181,8 @@ Otherwise you can pull the trunk source and install from there::
     git clone git://github.com/riptideio/pymodbus.git
     cd pymodbus
     pip install -r requirements.txt
-    
-    
+
+
 To get latest release (for now v2.5.3 with Python 2.7 support)::
 
     git checkout master
@@ -193,12 +193,12 @@ To get bleeding edge::
 
 To get a specific version:
 
-    git checkout tags/vX.Y.Z -b vX.Y.Z    
+    git checkout tags/vX.Y.Z -b vX.Y.Z
 
 Then::
    pip install -r requirements.txt
    pip install -e .
-   
+
 This installs pymodbus in your virtual environment with pointers directly to the pymodbus directory, so any change you make is immediately available as if installed.
 
 Either method will install all the required dependencies
@@ -212,7 +212,7 @@ The repository contains a number of important branches and tags.
   * **master** is where are releases are kept.
   * All releases are tagged with **vX.Y.Z** (e.g. v2.5.3)
   * All prereleases are tagged with **vX.Y.ZrcQ** (e.g. v3.0.0.0rc1)
- 
+
 If a maintenance release of an old version is needed (e.g. v2.5.4),
 the release tag is used to create a branch with the same name,
 and maintenance development is merged here.

doc/source/library/pymodbus.client.asynchronous.rst

@@ -1,32 +1,82 @@
 pymodbus\.client package
 ========================
 
-Pymodbus offers a :mod:`synchronous client <pymodbus.client.sync>`, and async clients based on :mod:`asyncio <pymodbus.client.asynchronous>`.
+Pymodbus offers a :mod:`synchronous client <pymodbus.client>`, and async clients based on :mod:`asyncio <pymodbus.client.asynchronous>`.
 
-Each client shares a :mod:`common client mixin <pymodbus.client.common>` which offers simple methods for reading and writing.
+Each client shares a :mod:`client mixin <pymodbus.client.helper_sync>` which offers simple methods for reading and writing.
 
-Subpackages
------------
+Submodules
+----------
 
-.. toctree::
+pymodbus\.client\.helper_sync module
+------------------------------------
 
-    pymodbus.client.asynchronous
+.. automodule:: pymodbus.client.helper_sync
+    :members:
+    :undoc-members:
+    :show-inheritance:
 
-Submodules
-----------
+pymodbus\.client\.ModbusSerialClient module
+-------------------------------------------
 
-pymodbus\.client\.common module
--------------------------------
+.. automodule:: pymodbus.client.sync_serial
+    :members:
+    :undoc-members:
+    :show-inheritance:
 
-.. automodule:: pymodbus.client.common
+pymodbus\.client\.ModbusTCPClient module
+----------------------------------------
+
+.. automodule:: pymodbus.client.sync_tcp
     :members:
     :undoc-members:
     :show-inheritance:
 
-pymodbus\.client\.sync module
------------------------------
+pymodbus\.client\.ModbusTLSClient module
+----------------------------------------
+
+.. automodule:: pymodbus.client.sync_tls
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+pymodbus\.client\.ModbusUDPClient module
+----------------------------------------
+
+.. automodule:: pymodbus.client.sync_udp
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+pymodbus\.client\.AsyncModbusUDPClient module
+---------------------------------------------
+
+.. automodule:: pymodbus.client.async_udp
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+pymodbus\.client\.AsyncModbusTLSClient module
+---------------------------------------------
+
+.. automodule:: pymodbus.client.async_tls
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+pymodbus\.client\.AsyncModbusSerialClient module
+------------------------------------------------
+
+.. automodule:: pymodbus.client.async_serial
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+pymodbus\.client\.AsyncModbusTCPClient module
+---------------------------------------------
 
-.. automodule:: pymodbus.client.sync
+.. automodule:: pymodbus.client.async_tcp
     :members:
     :undoc-members:
     :show-inheritance:

doc/source/library/pymodbus.client.rst

@@ -28,10 +28,12 @@
 # --------------------------------------------------------------------------- #
 # import the various client implementations
 # --------------------------------------------------------------------------- #
-from pymodbus.client.asynchronous.serial import AsyncModbusSerialClient
-from pymodbus.client.asynchronous.tcp import AsyncModbusTCPClient
-from pymodbus.client.asynchronous.tls import AsyncModbusTLSClient
-from pymodbus.client.asynchronous.udp import AsyncModbusUDPClient
+from pymodbus.client import (
+    AsyncModbusUDPClient,
+    AsyncModbusTLSClient,
+    AsyncModbusSerialClient,
+    AsyncModbusTCPClient,
+)
 from pymodbus.transaction import (
     ModbusAsciiFramer,
     ModbusBinaryFramer,

examples/client_async.py

@@ -26,7 +26,7 @@
 # --------------------------------------------------------------------------- #
 # import the various client implementations
 # --------------------------------------------------------------------------- #
-from pymodbus.client.sync import (
+from pymodbus.client import (
     ModbusSerialClient,
     ModbusTcpClient,
     ModbusTlsClient,

examples/client_sync.py

@@ -17,7 +17,7 @@
 # --------------------------------------------------------------------------- #
 # import the modbus client and the framers
 # --------------------------------------------------------------------------- #
-from pymodbus.client.sync import ModbusTcpClient as ModbusClient
+from pymodbus.client import ModbusTcpClient as ModbusClient
 from pymodbus.transaction import ModbusSocketFramer as ModbusFramer
 
 # from pymodbus.transaction import ModbusRtuFramer as ModbusFramer

examples/common/changing_framers.py

@@ -13,7 +13,7 @@
 import struct
 
 from pymodbus.bit_read_message import ReadCoilsRequest
-from pymodbus.client.sync import ModbusTcpClient as ModbusClient
+from pymodbus.client import ModbusTcpClient as ModbusClient
 
 # --------------------------------------------------------------------------- #
 # import the various server implementations

examples/common/custom_message.py

@@ -9,7 +9,7 @@
 from collections import OrderedDict
 import logging
 
-from pymodbus.client.sync import ModbusTcpClient as ModbusClient
+from pymodbus.client import ModbusTcpClient as ModbusClient
 from pymodbus.constants import Endian
 from pymodbus.payload import BinaryPayloadBuilder, BinaryPayloadDecoder
 

examples/common/payload_client.py

@@ -15,7 +15,7 @@
 from threading import Lock, Thread as tWorker
 from time import time
 
-from pymodbus.client.sync import ModbusTcpClient
+from pymodbus.client import ModbusTcpClient
 
 try:
     from multiprocessing import Process as mWorker, log_to_stderr

examples/common/performance.py

@@ -11,7 +11,7 @@
 import ssl
 import asyncio
 
-from pymodbus.client.asynchronous.tls import AsyncModbusTLSClient
+from pymodbus.client import AsyncModbusTLSClient
 
 # -------------------------------------------------------------------------- #
 # the TLS detail security can be set in SSLContext which is the context here