132 lines
4.5 KiB
Python
132 lines
4.5 KiB
Python
"""
|
|
Support for monitoring the Transmission BitTorrent client API.
|
|
|
|
For more details about this platform, please refer to the documentation at
|
|
https://home-assistant.io/components/sensor.transmission/
|
|
"""
|
|
import logging
|
|
from datetime import timedelta
|
|
|
|
from homeassistant.const import CONF_HOST, CONF_PASSWORD, CONF_USERNAME
|
|
from homeassistant.helpers.entity import Entity
|
|
from homeassistant.util import Throttle
|
|
|
|
REQUIREMENTS = ['transmissionrpc==0.11']
|
|
SENSOR_TYPES = {
|
|
'current_status': ['Status', None],
|
|
'download_speed': ['Down Speed', 'MB/s'],
|
|
'upload_speed': ['Up Speed', 'MB/s']
|
|
}
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
_THROTTLED_REFRESH = None
|
|
|
|
|
|
# pylint: disable=unused-argument
|
|
def setup_platform(hass, config, add_devices, discovery_info=None):
|
|
"""Setup the Transmission sensors."""
|
|
import transmissionrpc
|
|
from transmissionrpc.error import TransmissionError
|
|
|
|
host = config.get(CONF_HOST)
|
|
username = config.get(CONF_USERNAME, None)
|
|
password = config.get(CONF_PASSWORD, None)
|
|
port = config.get('port', 9091)
|
|
|
|
name = config.get("name", "Transmission")
|
|
if not host:
|
|
_LOGGER.error('Missing config variable %s', CONF_HOST)
|
|
return False
|
|
|
|
transmission_api = transmissionrpc.Client(
|
|
host, port=port, user=username, password=password)
|
|
try:
|
|
transmission_api.session_stats()
|
|
except TransmissionError:
|
|
_LOGGER.exception("Connection to Transmission API failed.")
|
|
return False
|
|
|
|
# pylint: disable=global-statement
|
|
global _THROTTLED_REFRESH
|
|
_THROTTLED_REFRESH = Throttle(timedelta(seconds=1))(
|
|
transmission_api.session_stats)
|
|
|
|
dev = []
|
|
for variable in config['monitored_variables']:
|
|
if variable not in SENSOR_TYPES:
|
|
_LOGGER.error('Sensor type: "%s" does not exist', variable)
|
|
else:
|
|
dev.append(TransmissionSensor(
|
|
variable, transmission_api, name))
|
|
|
|
add_devices(dev)
|
|
|
|
|
|
class TransmissionSensor(Entity):
|
|
"""representation of a Transmission sensor."""
|
|
|
|
def __init__(self, sensor_type, transmission_client, client_name):
|
|
"""Initialize the sensor."""
|
|
self._name = SENSOR_TYPES[sensor_type][0]
|
|
self.transmission_client = transmission_client
|
|
self.type = sensor_type
|
|
self.client_name = client_name
|
|
self._state = None
|
|
self._unit_of_measurement = SENSOR_TYPES[sensor_type][1]
|
|
|
|
@property
|
|
def name(self):
|
|
"""Return the name of the sensor."""
|
|
return self.client_name + ' ' + self._name
|
|
|
|
@property
|
|
def state(self):
|
|
"""Return the state of the sensor."""
|
|
return self._state
|
|
|
|
@property
|
|
def unit_of_measurement(self):
|
|
"""Return the unit of measurement of this entity, if any."""
|
|
return self._unit_of_measurement
|
|
|
|
def refresh_transmission_data(self):
|
|
"""Call the throttled Transmission refresh method."""
|
|
from transmissionrpc.error import TransmissionError
|
|
|
|
if _THROTTLED_REFRESH is not None:
|
|
try:
|
|
_THROTTLED_REFRESH()
|
|
except TransmissionError:
|
|
_LOGGER.exception(
|
|
self.name + " Connection to Transmission API failed."
|
|
)
|
|
|
|
def update(self):
|
|
"""Get the latest data from Transmission and updates the state."""
|
|
self.refresh_transmission_data()
|
|
if self.type == 'current_status':
|
|
if self.transmission_client.session:
|
|
upload = self.transmission_client.session.uploadSpeed
|
|
download = self.transmission_client.session.downloadSpeed
|
|
if upload > 0 and download > 0:
|
|
self._state = 'Up/Down'
|
|
elif upload > 0 and download == 0:
|
|
self._state = 'Seeding'
|
|
elif upload == 0 and download > 0:
|
|
self._state = 'Downloading'
|
|
else:
|
|
self._state = 'Idle'
|
|
else:
|
|
self._state = 'Unknown'
|
|
|
|
if self.transmission_client.session:
|
|
if self.type == 'download_speed':
|
|
mb_spd = float(self.transmission_client.session.downloadSpeed)
|
|
mb_spd = mb_spd / 1024 / 1024
|
|
self._state = round(mb_spd, 2 if mb_spd < 0.1 else 1)
|
|
elif self.type == 'upload_speed':
|
|
mb_spd = float(self.transmission_client.session.uploadSpeed)
|
|
mb_spd = mb_spd / 1024 / 1024
|
|
self._state = round(mb_spd, 2 if mb_spd < 0.1 else 1)
|