From fa9c881588e7572c1c269bfd670ceee103fcf67a Mon Sep 17 00:00:00 2001 From: jan iversen Date: Mon, 30 Sep 2024 13:17:41 +0200 Subject: [PATCH] Client doc, add common methods (base). --- doc/source/_static/examples.tgz | Bin 41841 -> 45644 bytes doc/source/_static/examples.zip | Bin 38438 -> 38378 bytes doc/source/client.rst | 18 ++++++++++++++++-- pymodbus/client/base.py | 31 +++++++++++++++++++++++++------ 4 files changed, 41 insertions(+), 8 deletions(-) diff --git a/doc/source/_static/examples.tgz b/doc/source/_static/examples.tgz index fe1e85615c6ad8348d6e4ed6689852e5e4189b95..15011cffdb7a5fc1f4b8c5a7f4e22fb3eb41d899 100644 GIT binary patch literal 45644 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 I&j6kS0MieKssI20 literal 41841 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 Yb3)bd0LYK$JDA3^WIk%cnBA-PKLCKHumAu6 diff --git a/doc/source/client.rst b/doc/source/client.rst index ec71e15b9..ae4a8404e 100644 --- a/doc/source/client.rst +++ b/doc/source/client.rst @@ -55,9 +55,9 @@ Pymodbus offers clients with transport different protocols and different framers - ASCII - RTU - RTU_OVER_TCP - - Socket + - SOCKET - TLS - * - Serial (RS-485) + * - SERIAL (RS-485) - Yes - Yes - No @@ -248,6 +248,20 @@ There are a client class for each type of communication and for asynchronous/syn - :mod:`AsyncModbusUdpClient` - :mod:`ModbusUdpClient` +Client common +^^^^^^^^^^^^^ +Some methods are common to all client: + +.. autoclass:: pymodbus.client.base.ModbusBaseClient + :members: + :member-order: bysource + :show-inheritance: + +.. autoclass:: pymodbus.client.base.ModbusBaseSyncClient + :members: + :member-order: bysource + :show-inheritance: + Client serial ^^^^^^^^^^^^^ .. autoclass:: pymodbus.client.AsyncModbusSerialClient diff --git a/pymodbus/client/base.py b/pymodbus/client/base.py index 26d7871b8..9123381fa 100644 --- a/pymodbus/client/base.py +++ b/pymodbus/client/base.py @@ -32,7 +32,10 @@ def __init__( on_connect_callback: Callable[[bool], None] | None, comm_params: CommParams | None = None, ) -> None: - """Initialize a client instance.""" + """Initialize a client instance. + + :meta private: + """ ModbusClientMixin.__init__(self) # type: ignore[arg-type] if comm_params: self.comm_params = comm_params @@ -99,13 +102,18 @@ def execute(self, request: ModbusRequest): :param request: The request to process :returns: The result of the request execution :raises ConnectionException: Check exception text. + + :meta private: """ if not self.ctx.transport: raise ConnectionException(f"Not connected[{self!s}]") return self.async_execute(request) async def async_execute(self, request) -> ModbusResponse: - """Execute requests asynchronously.""" + """Execute requests asynchronously. + + :meta private: + """ request.transaction_id = self.ctx.transaction.getNextTID() packet = self.ctx.framer.buildPacket(request) @@ -134,7 +142,10 @@ async def async_execute(self, request) -> ModbusResponse: return resp # type: ignore[return-value] def build_response(self, request: ModbusRequest): - """Return a deferred response for the current request.""" + """Return a deferred response for the current request. + + :meta private: + """ my_future: asyncio.Future = asyncio.Future() request.fut = my_future if not self.ctx.transport: @@ -179,7 +190,10 @@ def __init__( retries: int, comm_params: CommParams | None = None, ) -> None: - """Initialize a client instance.""" + """Initialize a client instance. + + :meta private: + """ ModbusClientMixin.__init__(self) # type: ignore[arg-type] if comm_params: self.comm_params = comm_params @@ -205,7 +219,7 @@ def __init__( # Client external interface # ----------------------------------------------------------------------- # def register(self, custom_response_class: ModbusResponse) -> None: - """Register a custom response class with the decoder (call **sync**). + """Register a custom response class with the decoder. :param custom_response_class: (optional) Modbus response class. :raises MessageRegisterException: Check exception text. @@ -231,6 +245,8 @@ def execute(self, request: ModbusRequest) -> ModbusResponse: :param request: The request to process :returns: The result of the request execution :raises ConnectionException: Check exception text. + + :meta private: """ if not self.connect(): raise ConnectionException(f"Failed to connect[{self!s}]") @@ -264,7 +280,10 @@ def recv(self, size: int | None) -> bytes: @classmethod def get_address_family(cls, address): - """Get the correct address family.""" + """Get the correct address family. + + :meta private: + """ try: _ = socket.inet_pton(socket.AF_INET6, address) except OSError: # not a valid ipv6 address