revil-O/platypush
1
0
Fork 0
forked from platypush/platypush
Code Pull requests Activity

Fixed a broken docstring reference.

Browse source
This commit is contained in:
Fabio Manganiello 2023-10-10 22:18:36 +02:00
parent ff07623803
commit 1b6e9b4df9
Signed by untrusted user: blacklight
GPG key ID: D90FBA7F76362774
1 changed files with 26 additions and 26 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

52
platypush/plugins/zigbee/mqtt/__init__.py
View file

@ -536,7 +536,7 @@ class ZigbeeMqttPlugin(
Get the list of devices registered to the service. Get the list of devices registered to the service.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
:return: List of paired devices. Example output: :return: List of paired devices. Example output:
@ -716,7 +716,7 @@ class ZigbeeMqttPlugin(
:param permit: Set to True to allow joins, False otherwise. :param permit: Set to True to allow joins, False otherwise.
:param timeout: Allow/disallow joins only for this amount of time. :param timeout: Allow/disallow joins only for this amount of time.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
if timeout: if timeout:
@ -742,7 +742,7 @@ class ZigbeeMqttPlugin(
the back of the bulb is pressed). the back of the bulb is pressed).
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
self.publish( self.publish(
@ -760,7 +760,7 @@ class ZigbeeMqttPlugin(
:param level: Possible values: 'debug', 'info', 'warn', 'error'. :param level: Possible values: 'debug', 'info', 'warn', 'error'.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(
@ -781,7 +781,7 @@ class ZigbeeMqttPlugin(
:param option: Option name. :param option: Option name.
:param value: New value. :param value: New value.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(
@ -807,7 +807,7 @@ class ZigbeeMqttPlugin(
internal database, but the device is likely to connect again when internal database, but the device is likely to connect again when
restarted unless it's factory reset (default: False). restarted unless it's factory reset (default: False).
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(
@ -824,7 +824,7 @@ class ZigbeeMqttPlugin(
:param device: Display name of the device. :param device: Display name of the device.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(
@ -844,7 +844,7 @@ class ZigbeeMqttPlugin(
:param device: Display name of the device. :param device: Display name of the device.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(
@ -864,7 +864,7 @@ class ZigbeeMqttPlugin(
specified then the rename will affect the last device that joined specified then the rename will affect the last device that joined
the network. the network.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
if name == device: if name == device:
@ -988,7 +988,7 @@ class ZigbeeMqttPlugin(
:param property: Name of the property that should be retrieved (default: :param property: Name of the property that should be retrieved (default:
all). all).
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
:return: Key->value map of the device properties. :return: Key->value map of the device properties.
""" """
@ -1033,7 +1033,7 @@ class ZigbeeMqttPlugin(
:param devices: If set, then only the status of these devices (by :param devices: If set, then only the status of these devices (by
friendly name) will be retrieved (default: retrieve all). friendly name) will be retrieved (default: retrieve all).
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
:return: Key->value map of the device properties: :return: Key->value map of the device properties:
@ -1129,7 +1129,7 @@ class ZigbeeMqttPlugin(
:param values: If you want to set multiple values, then pass this :param values: If you want to set multiple values, then pass this
mapping instead of ``property``+``value``. mapping instead of ``property``+``value``.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
msg = (values or {}).copy() msg = (values or {}).copy()
@ -1186,7 +1186,7 @@ class ZigbeeMqttPlugin(
format. format.
:param data: Value to set for the property. :param data: Value to set for the property.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
dev, prop = self._ieee_address_and_property(device) dev, prop = self._ieee_address_and_property(device)
@ -1206,7 +1206,7 @@ class ZigbeeMqttPlugin(
:param device: Address or friendly name of the device. :param device: Address or friendly name of the device.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
:return: :return:
@ -1240,7 +1240,7 @@ class ZigbeeMqttPlugin(
:param device: Address or friendly name of the device. :param device: Address or friendly name of the device.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(
@ -1256,7 +1256,7 @@ class ZigbeeMqttPlugin(
Get the groups registered on the device. Get the groups registered on the device.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._get_network_info(**kwargs).get('groups', []) return self._get_network_info(**kwargs).get('groups', [])
@ -1267,7 +1267,7 @@ class ZigbeeMqttPlugin(
Get the information, configuration and state of the network. Get the information, configuration and state of the network.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
:return: Example: :return: Example:
@ -1406,7 +1406,7 @@ class ZigbeeMqttPlugin(
:param name: Display name of the group. :param name: Display name of the group.
:param id: Optional numeric ID (default: auto-generated). :param id: Optional numeric ID (default: auto-generated).
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
payload = ( payload = (
@ -1442,7 +1442,7 @@ class ZigbeeMqttPlugin(
:param property: Name of the property to retrieve (default: all :param property: Name of the property to retrieve (default: all
available properties) available properties)
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
msg = {} msg = {}
@ -1480,7 +1480,7 @@ class ZigbeeMqttPlugin(
:param property: Name of the property that should be set. :param property: Name of the property that should be set.
:param value: New value of the property. :param value: New value of the property.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
properties = self._run_request( properties = self._run_request(
@ -1504,7 +1504,7 @@ class ZigbeeMqttPlugin(
:param name: New name. :param name: New name.
:param group: Current name of the group to rename. :param group: Current name of the group to rename.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
if name == group: if name == group:
@ -1532,7 +1532,7 @@ class ZigbeeMqttPlugin(
:param name: Display name of the group. :param name: Display name of the group.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(
@ -1550,7 +1550,7 @@ class ZigbeeMqttPlugin(
:param group: Display name of the group. :param group: Display name of the group.
:param device: Display name of the device to be added. :param device: Display name of the device to be added.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(
@ -1573,7 +1573,7 @@ class ZigbeeMqttPlugin(
specified then all the devices registered to the specified group specified then all the devices registered to the specified group
will be removed. will be removed.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
remove_suffix = '_all' if device is None else '' remove_suffix = '_all' if device is None else ''
@ -1609,7 +1609,7 @@ class ZigbeeMqttPlugin(
:param target: Name of the target device. You can also bind a specific :param target: Name of the target device. You can also bind a specific
device endpoint - for example ``MyLight/state``. device endpoint - for example ``MyLight/state``.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(
@ -1629,7 +1629,7 @@ class ZigbeeMqttPlugin(
:param target: Name of the target device. You can also bind a specific :param target: Name of the target device. You can also bind a specific
device endpoint - for example ``MyLight/state``. device endpoint - for example ``MyLight/state``.
:param kwargs: Extra arguments to be passed to :param kwargs: Extra arguments to be passed to
:meth:`platypush.plugins.mqtt.MqttPlugin.publish`` (default: query :meth:`platypush.plugins.mqtt.MqttPlugin.publish` (default: query
the default configured device). the default configured device).
""" """
return self._run_request( return self._run_request(