diff --git a/src/ska_tango_base/base/base_device.py b/src/ska_tango_base/base/base_device.py index 0ba6d69d49dbe1054161b35cf74fb7e689411aca..28321e604ed3d1b70a9e87b12c65b8c5addec33b 100644 --- a/src/ska_tango_base/base/base_device.py +++ b/src/ska_tango_base/base/base_device.py @@ -208,26 +208,43 @@ class LoggingUtils: """ Parse syslog URL and extract address and socktype parameters for SysLogHandler. - :param url: - Universal resource locator string for syslog target. Three types are supported: - file path, remote UDP server, remote TCP server. - - Output to a file: 'file://<path to file>' - Example: 'file:///dev/log' will write to '/dev/log' - - Output to remote server over UDP: 'udp://<hostname>:<port>' - Example: 'udp://syslog.com:514' will send to host 'syslog.com' on UDP port 514 - - Output to remote server over TCP: 'tcp://<hostname>:<port>' - Example: 'tcp://rsyslog.com:601' will send to host 'rsyslog.com' on TCP port 601 - For backwards compatibility, if the protocol prefix is missing, the type is - interpreted as file. This is deprecated. - - Example: '/dev/log' is equivalent to 'file:///dev/log' - - :return: (address, socktype) + :param url: Universal resource locator string for syslog target. + Three types are supported: file path, remote UDP server, + remote TCP server. + + - Output to a file: 'file://<path to file>'. For example, + 'file:///dev/log' will write to '/dev/log'. + + - Output to remote server over UDP: + 'udp://<hostname>:<port>'. For example, + 'udp://syslog.com:514' will send to host 'syslog.com' on + UDP port 514 + + - Output to remote server over TCP: + 'tcp://<hostname>:<port>'. For example, + 'tcp://rsyslog.com:601' will send to host 'rsyslog.com' on + TCP port 601 + + For backwards compatibility, if the protocol prefix is + missing, the type is interpreted as file. This is + deprecated. For example, '/dev/log' is equivalent to + 'file:///dev/log'. + + :return: An (address, socktype) tuple. + For file types: - - address is the file path as as string + + - the address is the file path as as string + - socktype is None + For UDP and TCP: - - address is tuple of (hostname, port), with hostname a string, and port an integer. - - socktype is socket.SOCK_DGRAM for UDP, or socket.SOCK_STREAM for TCP. + + - the address is tuple of (hostname, port), with hostname a + string, and port an integer. + + - socktype is socket.SOCK_DGRAM for UDP, or + socket.SOCK_STREAM for TCP. :raises LoggingTargetError: for invalid url string """ @@ -1443,7 +1460,7 @@ class SKABaseDevice(Device): Enable remote debugging of this device. To modify behaviour for this command, modify the do() method of - the command class: :class:`.DebugDeviceCommand`. + the command class: :py:class:`.DebugDeviceCommand`. """ command = self.get_command_object("DebugDevice") return command() diff --git a/src/ska_tango_base/subarray/reference_component_manager.py b/src/ska_tango_base/subarray/reference_component_manager.py index 4d93d591a8aa6547045ba434e0f7c8e5dc88b7e6..497170c009d434135e931f2843dd32fe2d7ad5a4 100644 --- a/src/ska_tango_base/subarray/reference_component_manager.py +++ b/src/ska_tango_base/subarray/reference_component_manager.py @@ -142,7 +142,7 @@ class ReferenceSubarrayComponentManager( :return: whether this resource pool contains the specified resources - :rtype bool + :rtype: bool """ return resources in self._resources diff --git a/tests/test_base_device.py b/tests/test_base_device.py index c7a9ae03361fa47f79d7ef1b02c6d030b23a0b1b..8aa55f9e805aaabe1492ad67f1bf84ca8f31c5bc 100644 --- a/tests/test_base_device.py +++ b/tests/test_base_device.py @@ -718,7 +718,7 @@ class TestSKABaseDevice_commands: Return a factory that constructs a command object for a given class. :returns: a factory that constructs a command object for a given - class + class """ def _command_factory(command):