summaryrefslogtreecommitdiff
path: root/sleekxmpp/plugins/xep_0325
diff options
context:
space:
mode:
Diffstat (limited to 'sleekxmpp/plugins/xep_0325')
-rw-r--r--sleekxmpp/plugins/xep_0325/__init__.py18
-rw-r--r--sleekxmpp/plugins/xep_0325/control.py569
-rw-r--r--sleekxmpp/plugins/xep_0325/device.py125
-rw-r--r--sleekxmpp/plugins/xep_0325/stanza/__init__.py12
-rw-r--r--sleekxmpp/plugins/xep_0325/stanza/base.py13
-rw-r--r--sleekxmpp/plugins/xep_0325/stanza/control.py527
6 files changed, 0 insertions, 1264 deletions
diff --git a/sleekxmpp/plugins/xep_0325/__init__.py b/sleekxmpp/plugins/xep_0325/__init__.py
deleted file mode 100644
index 01c38dce..00000000
--- a/sleekxmpp/plugins/xep_0325/__init__.py
+++ /dev/null
@@ -1,18 +0,0 @@
-"""
- SleekXMPP: The Sleek XMPP Library
- Implementation of xeps for Internet of Things
- http://wiki.xmpp.org/web/Tech_pages/IoT_systems
- Copyright (C) 2013 Sustainable Innovation, Joachim.lindborg@sust.se, bjorn.westrom@consoden.se
- This file is part of SleekXMPP.
-
- See the file LICENSE for copying permission.
-"""
-
-from sleekxmpp.plugins.base import register_plugin
-
-from sleekxmpp.plugins.xep_0325.control import XEP_0325
-from sleekxmpp.plugins.xep_0325 import stanza
-
-register_plugin(XEP_0325)
-
-xep_0325=XEP_0325
diff --git a/sleekxmpp/plugins/xep_0325/control.py b/sleekxmpp/plugins/xep_0325/control.py
deleted file mode 100644
index 11e7a045..00000000
--- a/sleekxmpp/plugins/xep_0325/control.py
+++ /dev/null
@@ -1,569 +0,0 @@
-"""
- SleekXMPP: The Sleek XMPP Library
- Implementation of xeps for Internet of Things
- http://wiki.xmpp.org/web/Tech_pages/IoT_systems
- Copyright (C) 2013 Sustainable Innovation, Joachim.lindborg@sust.se, bjorn.westrom@consoden.se
- This file is part of SleekXMPP.
-
- See the file LICENSE for copying permission.
-"""
-
-import logging
-import time
-from threading import Thread, Timer, Lock
-
-from sleekxmpp.xmlstream.handler import Callback
-from sleekxmpp.xmlstream.matcher import StanzaPath
-from sleekxmpp.plugins.base import BasePlugin
-from sleekxmpp.plugins.xep_0325 import stanza
-from sleekxmpp.plugins.xep_0325.stanza import Control
-
-
-log = logging.getLogger(__name__)
-
-
-class XEP_0325(BasePlugin):
-
- """
- XEP-0325: IoT Control
-
-
- Actuators are devices in sensor networks that can be controlled through
- the network and act with the outside world. In sensor networks and
- Internet of Things applications, actuators make it possible to automate
- real-world processes.
- This plugin implements a mechanism whereby actuators can be controlled
- in XMPP-based sensor networks, making it possible to integrate sensors
- and actuators of different brands, makes and models into larger
- Internet of Things applications.
-
- Also see <http://xmpp.org/extensions/xep-0325.html>
-
- Configuration Values:
- threaded -- Indicates if communication with sensors should be threaded.
- Defaults to True.
-
- Events:
- Sensor side
- -----------
- Control Event:DirectSet -- Received a control message
- Control Event:SetReq -- Received a control request
-
- Client side
- -----------
- Control Event:SetResponse -- Received a response to a
- control request, type result
- Control Event:SetResponseError -- Received a response to a
- control request, type error
-
- Attributes:
- threaded -- Indicates if command events should be threaded.
- Defaults to True.
- sessions -- A dictionary or equivalent backend mapping
- session IDs to dictionaries containing data
- relevant to a request's session. This dictionary is used
- both by the client and sensor side. On client side, seqnr
- is used as key, while on sensor side, a session_id is used
- as key. This ensures that the two will not collide, so
- one instance can be both client and sensor.
- Sensor side
- -----------
- nodes -- A dictionary mapping sensor nodes that are serviced through
- this XMPP instance to their device handlers ("drivers").
- Client side
- -----------
- last_seqnr -- The last used sequence number (integer). One sequence of
- communication (e.g. -->request, <--accept, <--fields)
- between client and sensor is identified by a unique
- sequence number (unique between the client/sensor pair)
-
- Methods:
- plugin_init -- Overrides base_plugin.plugin_init
- post_init -- Overrides base_plugin.post_init
- plugin_end -- Overrides base_plugin.plugin_end
-
- Sensor side
- -----------
- register_node -- Register a sensor as available from this XMPP
- instance.
-
- Client side
- -----------
- set_request -- Initiates a control request to modify data in
- sensor(s). Non-blocking, a callback function will
- be called when the sensor has responded.
- set_command -- Initiates a control command to modify data in
- sensor(s). Non-blocking. The sensor(s) will not
- respond regardless of the result of the command,
- so no callback is made.
-
- """
-
- name = 'xep_0325'
- description = 'XEP-0325 Internet of Things - Control'
- dependencies = set(['xep_0030'])
- stanza = stanza
-
-
- default_config = {
- 'threaded': True
-# 'session_db': None
- }
-
- def plugin_init(self):
- """ Start the XEP-0325 plugin """
-
- self.xmpp.register_handler(
- Callback('Control Event:DirectSet',
- StanzaPath('message/set'),
- self._handle_direct_set))
-
- self.xmpp.register_handler(
- Callback('Control Event:SetReq',
- StanzaPath('iq@type=set/set'),
- self._handle_set_req))
-
- self.xmpp.register_handler(
- Callback('Control Event:SetResponse',
- StanzaPath('iq@type=result/setResponse'),
- self._handle_set_response))
-
- self.xmpp.register_handler(
- Callback('Control Event:SetResponseError',
- StanzaPath('iq@type=error/setResponse'),
- self._handle_set_response))
-
- # Server side dicts
- self.nodes = {}
- self.sessions = {}
-
- self.last_seqnr = 0
- self.seqnr_lock = Lock()
-
- ## For testning only
- self.test_authenticated_from = ""
-
- def post_init(self):
- """ Init complete. Register our features in Serivce discovery. """
- BasePlugin.post_init(self)
- self.xmpp['xep_0030'].add_feature(Control.namespace)
- self.xmpp['xep_0030'].set_items(node=Control.namespace, items=tuple())
-
- def _new_session(self):
- """ Return a new session ID. """
- return str(time.time()) + '-' + self.xmpp.new_id()
-
- def plugin_end(self):
- """ Stop the XEP-0325 plugin """
- self.sessions.clear()
- self.xmpp.remove_handler('Control Event:DirectSet')
- self.xmpp.remove_handler('Control Event:SetReq')
- self.xmpp.remove_handler('Control Event:SetResponse')
- self.xmpp.remove_handler('Control Event:SetResponseError')
- self.xmpp['xep_0030'].del_feature(feature=Control.namespace)
- self.xmpp['xep_0030'].set_items(node=Control.namespace, items=tuple())
-
-
- # =================================================================
- # Sensor side (data provider) API
-
- def register_node(self, nodeId, device, commTimeout, sourceId=None, cacheType=None):
- """
- Register a sensor/device as available for control requests/commands
- through this XMPP instance.
-
- The device object may by any custom implementation to support
- specific devices, but it must implement the functions:
- has_control_field
- set_control_fields
- according to the interfaces shown in the example device.py file.
-
- Arguments:
- nodeId -- The identifier for the device
- device -- The device object
- commTimeout -- Time in seconds to wait between each callback from device during
- a data readout. Float.
- sourceId -- [optional] identifying the data source controlling the device
- cacheType -- [optional] narrowing down the search to a specific kind of node
- """
- self.nodes[nodeId] = {"device": device,
- "commTimeout": commTimeout,
- "sourceId": sourceId,
- "cacheType": cacheType}
-
- def _set_authenticated(self, auth=''):
- """ Internal testing function """
- self.test_authenticated_from = auth
-
- def _get_new_seqnr(self):
- """ Returns a unique sequence number (unique across threads) """
- self.seqnr_lock.acquire()
- self.last_seqnr += 1
- self.seqnr_lock.release()
- return str(self.last_seqnr)
-
- def _handle_set_req(self, iq):
- """
- Event handler for reception of an Iq with set req - this is a
- control request.
-
- Verifies that
- - all the requested nodes are available
- (if no nodes are specified in the request, assume all nodes)
- - all the control fields are available from all requested nodes
- (if no nodes are specified in the request, assume all nodes)
-
- If the request passes verification, the control request is passed
- to the devices (in a separate thread).
- If the verification fails, a setResponse with error indication
- is sent.
- """
-
- error_msg = ''
- req_ok = True
- missing_node = None
- missing_field = None
-
- # Authentication
- if len(self.test_authenticated_from) > 0 and not iq['from'] == self.test_authenticated_from:
- # Invalid authentication
- req_ok = False
- error_msg = "Access denied"
-
- # Nodes
- if len(iq['set']['nodes']) > 0:
- for n in iq['set']['nodes']:
- if not n['nodeId'] in self.nodes:
- req_ok = False
- missing_node = n['nodeId']
- error_msg = "Invalid nodeId " + n['nodeId']
- process_nodes = [n['nodeId'] for n in iq['set']['nodes']]
- else:
- process_nodes = self.nodes.keys()
-
- # Fields - for control we need to find all in all devices, otherwise we reject
- process_fields = []
- if len(iq['set']['datas']) > 0:
- for f in iq['set']['datas']:
- for node in self.nodes:
- if not self.nodes[node]["device"].has_control_field(f['name'], f._get_typename()):
- req_ok = False
- missing_field = f['name']
- error_msg = "Invalid field " + f['name']
- break
- process_fields = [(f['name'], f._get_typename(), f['value']) for f in iq['set']['datas']]
-
- if req_ok:
- session = self._new_session()
- self.sessions[session] = {"from": iq['from'], "to": iq['to'], "seqnr": iq['id']}
- self.sessions[session]["commTimers"] = {}
- self.sessions[session]["nodeDone"] = {}
- # Flag that a reply is exected when we are done
- self.sessions[session]["reply"] = True
-
- self.sessions[session]["node_list"] = process_nodes
- if self.threaded:
- #print("starting thread")
- tr_req = Thread(target=self._threaded_node_request, args=(session, process_fields))
- tr_req.start()
- #print("started thread")
- else:
- self._threaded_node_request(session, process_fields)
-
- else:
- iq.reply()
- iq['type'] = 'error'
- iq['setResponse']['responseCode'] = "NotFound"
- if missing_node is not None:
- iq['setResponse'].add_node(missing_node)
- if missing_field is not None:
- iq['setResponse'].add_data(missing_field)
- iq['setResponse']['error']['var'] = "Output"
- iq['setResponse']['error']['text'] = error_msg
- iq.send(block=False)
-
- def _handle_direct_set(self, msg):
- """
- Event handler for reception of a Message with set command - this is a
- direct control command.
-
- Verifies that
- - all the requested nodes are available
- (if no nodes are specified in the request, assume all nodes)
- - all the control fields are available from all requested nodes
- (if no nodes are specified in the request, assume all nodes)
-
- If the request passes verification, the control request is passed
- to the devices (in a separate thread).
- If the verification fails, do nothing.
- """
- req_ok = True
-
- # Nodes
- if len(msg['set']['nodes']) > 0:
- for n in msg['set']['nodes']:
- if not n['nodeId'] in self.nodes:
- req_ok = False
- error_msg = "Invalid nodeId " + n['nodeId']
- process_nodes = [n['nodeId'] for n in msg['set']['nodes']]
- else:
- process_nodes = self.nodes.keys()
-
- # Fields - for control we need to find all in all devices, otherwise we reject
- process_fields = []
- if len(msg['set']['datas']) > 0:
- for f in msg['set']['datas']:
- for node in self.nodes:
- if not self.nodes[node]["device"].has_control_field(f['name'], f._get_typename()):
- req_ok = False
- missing_field = f['name']
- error_msg = "Invalid field " + f['name']
- break
- process_fields = [(f['name'], f._get_typename(), f['value']) for f in msg['set']['datas']]
-
- if req_ok:
- session = self._new_session()
- self.sessions[session] = {"from": msg['from'], "to": msg['to']}
- self.sessions[session]["commTimers"] = {}
- self.sessions[session]["nodeDone"] = {}
- self.sessions[session]["reply"] = False
-
- self.sessions[session]["node_list"] = process_nodes
- if self.threaded:
- #print("starting thread")
- tr_req = Thread(target=self._threaded_node_request, args=(session, process_fields))
- tr_req.start()
- #print("started thread")
- else:
- self._threaded_node_request(session, process_fields)
-
-
- def _threaded_node_request(self, session, process_fields):
- """
- Helper function to handle the device control in a separate thread.
-
- Arguments:
- session -- The request session id
- process_fields -- The fields to set in the devices. List of tuple format:
- (name, datatype, value)
- """
- for node in self.sessions[session]["node_list"]:
- self.sessions[session]["nodeDone"][node] = False
-
- for node in self.sessions[session]["node_list"]:
- timer = Timer(self.nodes[node]['commTimeout'], self._event_comm_timeout, args=(session, node))
- self.sessions[session]["commTimers"][node] = timer
- timer.start()
- self.nodes[node]['device'].set_control_fields(process_fields, session=session, callback=self._device_set_command_callback)
-
- def _event_comm_timeout(self, session, nodeId):
- """
- Triggered if any of the control operations timeout.
- Stop communicating with the failing device.
- If the control command was an Iq request, sends a failure
- message back to the client.
-
- Arguments:
- session -- The request session id
- nodeId -- The id of the device which timed out
- """
-
- if self.sessions[session]["reply"]:
- # Reply is exected when we are done
- iq = self.xmpp.Iq()
- iq['from'] = self.sessions[session]['to']
- iq['to'] = self.sessions[session]['from']
- iq['type'] = "error"
- iq['id'] = self.sessions[session]['seqnr']
- iq['setResponse']['responseCode'] = "OtherError"
- iq['setResponse'].add_node(nodeId)
- iq['setResponse']['error']['var'] = "Output"
- iq['setResponse']['error']['text'] = "Timeout."
- iq.send(block=False)
-
- ## TODO - should we send one timeout per node??
-
- # Drop communication with this device and check if we are done
- self.sessions[session]["nodeDone"][nodeId] = True
- if (self._all_nodes_done(session)):
- # The session is complete, delete it
- del self.sessions[session]
-
- def _all_nodes_done(self, session):
- """
- Checks wheter all devices are done replying to the control command.
-
- Arguments:
- session -- The request session id
- """
- for n in self.sessions[session]["nodeDone"]:
- if not self.sessions[session]["nodeDone"][n]:
- return False
- return True
-
- def _device_set_command_callback(self, session, nodeId, result, error_field=None, error_msg=None):
- """
- Callback function called by the devices when the control command is
- complete or failed.
- If needed, composes a message with the result and sends it back to the
- client.
-
- Arguments:
- session -- The request session id
- nodeId -- The device id which initiated the callback
- result -- The current result status of the control command. Valid values are:
- "error" - Set fields failed.
- "ok" - All fields were set.
- error_field -- [optional] Only applies when result == "error"
- The field name that failed (usually means it is missing)
- error_msg -- [optional] Only applies when result == "error".
- Error details when a request failed.
- """
-
- if not session in self.sessions:
- # This can happend if a session was deleted, like in a timeout. Just drop the data.
- return
-
- if result == "error":
- self.sessions[session]["commTimers"][nodeId].cancel()
-
- if self.sessions[session]["reply"]:
- # Reply is exected when we are done
- iq = self.xmpp.Iq()
- iq['from'] = self.sessions[session]['to']
- iq['to'] = self.sessions[session]['from']
- iq['type'] = "error"
- iq['id'] = self.sessions[session]['seqnr']
- iq['setResponse']['responseCode'] = "OtherError"
- iq['setResponse'].add_node(nodeId)
- if error_field is not None:
- iq['setResponse'].add_data(error_field)
- iq['setResponse']['error']['var'] = error_field
- iq['setResponse']['error']['text'] = error_msg
- iq.send(block=False)
-
- # Drop communication with this device and check if we are done
- self.sessions[session]["nodeDone"][nodeId] = True
- if (self._all_nodes_done(session)):
- # The session is complete, delete it
- del self.sessions[session]
- else:
- self.sessions[session]["commTimers"][nodeId].cancel()
-
- self.sessions[session]["nodeDone"][nodeId] = True
- if (self._all_nodes_done(session)):
- if self.sessions[session]["reply"]:
- # Reply is exected when we are done
- iq = self.xmpp.Iq()
- iq['from'] = self.sessions[session]['to']
- iq['to'] = self.sessions[session]['from']
- iq['type'] = "result"
- iq['id'] = self.sessions[session]['seqnr']
- iq['setResponse']['responseCode'] = "OK"
- iq.send(block=False)
-
- # The session is complete, delete it
- del self.sessions[session]
-
-
- # =================================================================
- # Client side (data controller) API
-
- def set_request(self, from_jid, to_jid, callback, fields, nodeIds=None):
- """
- Called on the client side to initiade a control request.
- Composes a message with the request and sends it to the device(s).
- Does not block, the callback will be called when the device(s)
- has responded.
-
- Arguments:
- from_jid -- The jid of the requester
- to_jid -- The jid of the device(s)
- callback -- The callback function to call when data is availble.
-
- The callback function must support the following arguments:
-
- from_jid -- The jid of the responding device(s)
- result -- The result of the control request. Valid values are:
- "OK" - Control request completed successfully
- "NotFound" - One or more nodes or fields are missing
- "InsufficientPrivileges" - Not authorized.
- "Locked" - Field(s) is locked and cannot
- be changed at the moment.
- "NotImplemented" - Request feature not implemented.
- "FormError" - Error while setting with
- a form (not implemented).
- "OtherError" - Indicates other types of
- errors, such as timeout.
- Details in the error_msg.
-
-
- nodeId -- [optional] Only applicable when result == "error"
- List of node Ids of failing device(s).
-
- fields -- [optional] Only applicable when result == "error"
- List of fields that failed.[optional] Mandatory when result == "rejected" or "failure".
-
- error_msg -- Details about why the request failed.
-
- fields -- Fields to set. List of tuple format: (name, typename, value).
- nodeIds -- [optional] Limits the request to the node Ids in this list.
- """
- iq = self.xmpp.Iq()
- iq['from'] = from_jid
- iq['to'] = to_jid
- seqnr = self._get_new_seqnr()
- iq['id'] = seqnr
- iq['type'] = "set"
- if nodeIds is not None:
- for nodeId in nodeIds:
- iq['set'].add_node(nodeId)
- if fields is not None:
- for name, typename, value in fields:
- iq['set'].add_data(name=name, typename=typename, value=value)
-
- self.sessions[seqnr] = {"from": iq['from'], "to": iq['to'], "callback": callback}
- iq.send(block=False)
-
- def set_command(self, from_jid, to_jid, fields, nodeIds=None):
- """
- Called on the client side to initiade a control command.
- Composes a message with the set commandand sends it to the device(s).
- Does not block. Device(s) will not respond, regardless of result.
-
- Arguments:
- from_jid -- The jid of the requester
- to_jid -- The jid of the device(s)
-
- fields -- Fields to set. List of tuple format: (name, typename, value).
- nodeIds -- [optional] Limits the request to the node Ids in this list.
- """
- msg = self.xmpp.Message()
- msg['from'] = from_jid
- msg['to'] = to_jid
- msg['type'] = "set"
- if nodeIds is not None:
- for nodeId in nodeIds:
- msg['set'].add_node(nodeId)
- if fields is not None:
- for name, typename, value in fields:
- msg['set'].add_data(name, typename, value)
-
- # We won't get any reply, so don't create a session
- msg.send()
-
- def _handle_set_response(self, iq):
- """ Received response from device(s) """
- #print("ooh")
- seqnr = iq['id']
- from_jid = str(iq['from'])
- result = iq['setResponse']['responseCode']
- nodeIds = [n['name'] for n in iq['setResponse']['nodes']]
- fields = [f['name'] for f in iq['setResponse']['datas']]
- error_msg = None
-
- if not iq['setResponse'].find('error') is None and not iq['setResponse']['error']['text'] == "":
- error_msg = iq['setResponse']['error']['text']
-
- callback = self.sessions[seqnr]["callback"]
- callback(from_jid=from_jid, result=result, nodeIds=nodeIds, fields=fields, error_msg=error_msg)
diff --git a/sleekxmpp/plugins/xep_0325/device.py b/sleekxmpp/plugins/xep_0325/device.py
deleted file mode 100644
index f1ed0733..00000000
--- a/sleekxmpp/plugins/xep_0325/device.py
+++ /dev/null
@@ -1,125 +0,0 @@
-"""
- SleekXMPP: The Sleek XMPP Library
- Implementation of xeps for Internet of Things
- http://wiki.xmpp.org/web/Tech_pages/IoT_systems
- Copyright (C) 2013 Sustainable Innovation, Joachim.lindborg@sust.se, bjorn.westrom@consoden.se
- This file is part of SleekXMPP.
-
- See the file LICENSE for copying permission.
-"""
-
-import datetime
-
-class Device(object):
- """
- Example implementation of a device control object.
-
- The device object may by any custom implementation to support
- specific devices, but it must implement the functions:
- has_control_field
- set_control_fields
- """
-
- def __init__(self, nodeId):
- self.nodeId = nodeId
- self.control_fields = {}
-
- def has_control_field(self, field, typename):
- """
- Returns true if the supplied field name exists
- and the type matches for control in this device.
-
- Arguments:
- field -- The field name
- typename -- The expected type
- """
- if field in self.control_fields and self.control_fields[field]["type"] == typename:
- return True
- return False
-
- def set_control_fields(self, fields, session, callback):
- """
- Starts a control setting procedure. Verifies the fields,
- sets the data and (if needed) and calls the callback.
-
- Arguments:
- fields -- List of control fields in tuple format:
- (name, typename, value)
- session -- Session id, only used in the callback as identifier
- callback -- Callback function to call when control set is complete.
-
- The callback function must support the following arguments:
-
- session -- Session id, as supplied in the
- request_fields call
- nodeId -- Identifier for this device
- result -- The current result status of the readout.
- Valid values are:
- "error" - Set fields failed.
- "ok" - All fields were set.
- error_field -- [optional] Only applies when result == "error"
- The field name that failed
- (usually means it is missing)
- error_msg -- [optional] Only applies when result == "error".
- Error details when a request failed.
- """
-
- if len(fields) > 0:
- # Check availiability
- for name, typename, value in fields:
- if not self.has_control_field(name, typename):
- self._send_control_reject(session, name, "NotFound", callback)
- return False
-
- for name, typename, value in fields:
- self._set_field_value(name, value)
-
- callback(session, result="ok", nodeId=self.nodeId)
- return True
-
- def _send_control_reject(self, session, field, message, callback):
- """
- Sends a reject to the caller
-
- Arguments:
- session -- Session id, see definition in
- set_control_fields function
- callback -- Callback function, see definition in
- set_control_fields function
- """
- callback(session, result="error", nodeId=self.nodeId, error_field=field, error_msg=message)
-
- def _add_control_field(self, name, typename, value):
- """
- Adds a control field to the device
-
- Arguments:
- name -- Name of the field
- typename -- Type of the field, one of:
- (boolean, color, string, date, dateTime,
- double, duration, int, long, time)
- value -- Field value
- """
- self.control_fields[name] = {"type": typename, "value": value}
-
- def _set_field_value(self, name, value):
- """
- Set the value of a control field
-
- Arguments:
- name -- Name of the field
- value -- New value for the field
- """
- if name in self.control_fields:
- self.control_fields[name]["value"] = value
-
- def _get_field_value(self, name):
- """
- Get the value of a control field. Only used for unit testing.
-
- Arguments:
- name -- Name of the field
- """
- if name in self.control_fields:
- return self.control_fields[name]["value"]
- return None
diff --git a/sleekxmpp/plugins/xep_0325/stanza/__init__.py b/sleekxmpp/plugins/xep_0325/stanza/__init__.py
deleted file mode 100644
index 746c2033..00000000
--- a/sleekxmpp/plugins/xep_0325/stanza/__init__.py
+++ /dev/null
@@ -1,12 +0,0 @@
-"""
- SleekXMPP: The Sleek XMPP Library
- Implementation of xeps for Internet of Things
- http://wiki.xmpp.org/web/Tech_pages/IoT_systems
- Copyright (C) 2013 Sustainable Innovation, Joachim.lindborg@sust.se, bjorn.westrom@consoden.se
- This file is part of SleekXMPP.
-
- See the file LICENSE for copying permission.
-"""
-
-from sleekxmpp.plugins.xep_0325.stanza.control import *
-
diff --git a/sleekxmpp/plugins/xep_0325/stanza/base.py b/sleekxmpp/plugins/xep_0325/stanza/base.py
deleted file mode 100644
index 1dadcf46..00000000
--- a/sleekxmpp/plugins/xep_0325/stanza/base.py
+++ /dev/null
@@ -1,13 +0,0 @@
-"""
- SleekXMPP: The Sleek XMPP Library
- Implementation of xeps for Internet of Things
- http://wiki.xmpp.org/web/Tech_pages/IoT_systems
- Copyright (C) 2013 Sustainable Innovation, Joachim.lindborg@sust.se, bjorn.westrom@consoden.se
- This file is part of SleekXMPP.
-
- See the file LICENSE for copying permission.
-"""
-
-from sleekxmpp.xmlstream import ET
-
-pass
diff --git a/sleekxmpp/plugins/xep_0325/stanza/control.py b/sleekxmpp/plugins/xep_0325/stanza/control.py
deleted file mode 100644
index 1fd5c35d..00000000
--- a/sleekxmpp/plugins/xep_0325/stanza/control.py
+++ /dev/null
@@ -1,527 +0,0 @@
-"""
- SleekXMPP: The Sleek XMPP Library
- Implementation of xeps for Internet of Things
- http://wiki.xmpp.org/web/Tech_pages/IoT_systems
- Copyright (C) 2013 Sustainable Innovation, Joachim.lindborg@sust.se, bjorn.westrom@consoden.se
- This file is part of SleekXMPP.
-
- See the file LICENSE for copying permission.
-"""
-
-from sleekxmpp import Iq, Message
-from sleekxmpp.xmlstream import register_stanza_plugin, ElementBase, ET, JID
-from re import match
-
-class Control(ElementBase):
- """ Placeholder for the namespace, not used as a stanza """
- namespace = 'urn:xmpp:iot:control'
- name = 'control'
- plugin_attrib = name
- interfaces = set(tuple())
-
-class ControlSet(ElementBase):
- namespace = 'urn:xmpp:iot:control'
- name = 'set'
- plugin_attrib = name
- interfaces = set(['nodes','datas'])
-
- def __init__(self, xml=None, parent=None):
- ElementBase.__init__(self, xml, parent)
- self._nodes = set()
- self._datas = set()
-
- def setup(self, xml=None):
- """
- Populate the stanza object using an optional XML object.
-
- Overrides ElementBase.setup
-
- Caches item information.
-
- Arguments:
- xml -- Use an existing XML object for the stanza's values.
- """
- ElementBase.setup(self, xml)
- self._nodes = set([node['nodeId'] for node in self['nodes']])
- self._datas = set([data['name'] for data in self['datas']])
-
- def add_node(self, nodeId, sourceId=None, cacheType=None):
- """
- Add a new node element. Each item is required to have a
- nodeId, but may also specify a sourceId value and cacheType.
-
- Arguments:
- nodeId -- The ID for the node.
- sourceId -- [optional] identifying the data source controlling the device
- cacheType -- [optional] narrowing down the search to a specific kind of node
- """
- if nodeId not in self._nodes:
- self._nodes.add((nodeId))
- node = RequestNode(parent=self)
- node['nodeId'] = nodeId
- node['sourceId'] = sourceId
- node['cacheType'] = cacheType
- self.iterables.append(node)
- return node
- return None
-
- def del_node(self, nodeId):
- """
- Remove a single node.
-
- Arguments:
- nodeId -- Node ID of the item to remove.
- """
- if nodeId in self._nodes:
- nodes = [i for i in self.iterables if isinstance(i, RequestNode)]
- for node in nodes:
- if node['nodeId'] == nodeId:
- self.xml.remove(node.xml)
- self.iterables.remove(node)
- return True
- return False
-
- def get_nodes(self):
- """Return all nodes."""
- nodes = []
- for node in self['substanzas']:
- if isinstance(node, RequestNode):
- nodes.append(node)
- return nodes
-
- def set_nodes(self, nodes):
- """
- Set or replace all nodes. The given nodes must be in a
- list or set where each item is a tuple of the form:
- (nodeId, sourceId, cacheType)
-
- Arguments:
- nodes -- A series of nodes in tuple format.
- """
- self.del_nodes()
- for node in nodes:
- if isinstance(node, RequestNode):
- self.add_node(node['nodeId'], node['sourceId'], node['cacheType'])
- else:
- nodeId, sourceId, cacheType = node
- self.add_node(nodeId, sourceId, cacheType)
-
- def del_nodes(self):
- """Remove all nodes."""
- self._nodes = set()
- nodes = [i for i in self.iterables if isinstance(i, RequestNode)]
- for node in nodes:
- self.xml.remove(node.xml)
- self.iterables.remove(node)
-
-
- def add_data(self, name, typename, value):
- """
- Add a new data element.
-
- Arguments:
- name -- The name of the data element
- typename -- The type of data element
- (boolean, color, string, date, dateTime,
- double, duration, int, long, time)
- value -- The value of the data element
- """
- if name not in self._datas:
- dataObj = None
- if typename == "boolean":
- dataObj = BooleanParameter(parent=self)
- elif typename == "color":
- dataObj = ColorParameter(parent=self)
- elif typename == "string":
- dataObj = StringParameter(parent=self)
- elif typename == "date":
- dataObj = DateParameter(parent=self)
- elif typename == "dateTime":
- dataObj = DateTimeParameter(parent=self)
- elif typename == "double":
- dataObj = DoubleParameter(parent=self)
- elif typename == "duration":
- dataObj = DurationParameter(parent=self)
- elif typename == "int":
- dataObj = IntParameter(parent=self)
- elif typename == "long":
- dataObj = LongParameter(parent=self)
- elif typename == "time":
- dataObj = TimeParameter(parent=self)
-
- dataObj['name'] = name
- dataObj['value'] = value
-
- self._datas.add(name)
- self.iterables.append(dataObj)
- return dataObj
- return None
-
- def del_data(self, name):
- """
- Remove a single data element.
-
- Arguments:
- data_name -- The data element name to remove.
- """
- if name in self._datas:
- datas = [i for i in self.iterables if isinstance(i, BaseParameter)]
- for data in datas:
- if data['name'] == name:
- self.xml.remove(data.xml)
- self.iterables.remove(data)
- return True
- return False
-
- def get_datas(self):
- """ Return all data elements. """
- datas = []
- for data in self['substanzas']:
- if isinstance(data, BaseParameter):
- datas.append(data)
- return datas
-
- def set_datas(self, datas):
- """
- Set or replace all data elements. The given elements must be in a
- list or set where each item is a data element (numeric, string, boolean, dateTime, timeSpan or enum)
-
- Arguments:
- datas -- A series of data elements.
- """
- self.del_datas()
- for data in datas:
- self.add_data(name=data['name'], typename=data._get_typename(), value=data['value'])
-
- def del_datas(self):
- """Remove all data elements."""
- self._datas = set()
- datas = [i for i in self.iterables if isinstance(i, BaseParameter)]
- for data in datas:
- self.xml.remove(data.xml)
- self.iterables.remove(data)
-
-
-class RequestNode(ElementBase):
- """ Node element in a request """
- namespace = 'urn:xmpp:iot:control'
- name = 'node'
- plugin_attrib = name
- interfaces = set(['nodeId','sourceId','cacheType'])
-
-
-class ControlSetResponse(ElementBase):
- namespace = 'urn:xmpp:iot:control'
- name = 'setResponse'
- plugin_attrib = name
- interfaces = set(['responseCode'])
-
- def __init__(self, xml=None, parent=None):
- ElementBase.__init__(self, xml, parent)
- self._nodes = set()
- self._datas = set()
-
- def setup(self, xml=None):
- """
- Populate the stanza object using an optional XML object.
-
- Overrides ElementBase.setup
-
- Caches item information.
-
- Arguments:
- xml -- Use an existing XML object for the stanza's values.
- """
- ElementBase.setup(self, xml)
- self._nodes = set([node['nodeId'] for node in self['nodes']])
- self._datas = set([data['name'] for data in self['datas']])
-
- def add_node(self, nodeId, sourceId=None, cacheType=None):
- """
- Add a new node element. Each item is required to have a
- nodeId, but may also specify a sourceId value and cacheType.
-
- Arguments:
- nodeId -- The ID for the node.
- sourceId -- [optional] identifying the data source controlling the device
- cacheType -- [optional] narrowing down the search to a specific kind of node
- """
- if nodeId not in self._nodes:
- self._nodes.add(nodeId)
- node = RequestNode(parent=self)
- node['nodeId'] = nodeId
- node['sourceId'] = sourceId
- node['cacheType'] = cacheType
- self.iterables.append(node)
- return node
- return None
-
- def del_node(self, nodeId):
- """
- Remove a single node.
-
- Arguments:
- nodeId -- Node ID of the item to remove.
- """
- if nodeId in self._nodes:
- nodes = [i for i in self.iterables if isinstance(i, RequestNode)]
- for node in nodes:
- if node['nodeId'] == nodeId:
- self.xml.remove(node.xml)
- self.iterables.remove(node)
- return True
- return False
-
- def get_nodes(self):
- """Return all nodes."""
- nodes = []
- for node in self['substanzas']:
- if isinstance(node, RequestNode):
- nodes.append(node)
- return nodes
-
- def set_nodes(self, nodes):
- """
- Set or replace all nodes. The given nodes must be in a
- list or set where each item is a tuple of the form:
- (nodeId, sourceId, cacheType)
-
- Arguments:
- nodes -- A series of nodes in tuple format.
- """
- self.del_nodes()
- for node in nodes:
- if isinstance(node, RequestNode):
- self.add_node(node['nodeId'], node['sourceId'], node['cacheType'])
- else:
- nodeId, sourceId, cacheType = node
- self.add_node(nodeId, sourceId, cacheType)
-
- def del_nodes(self):
- """Remove all nodes."""
- self._nodes = set()
- nodes = [i for i in self.iterables if isinstance(i, RequestNode)]
- for node in nodes:
- self.xml.remove(node.xml)
- self.iterables.remove(node)
-
-
- def add_data(self, name):
- """
- Add a new ResponseParameter element.
-
- Arguments:
- name -- Name of the parameter
- """
- if name not in self._datas:
- self._datas.add(name)
- data = ResponseParameter(parent=self)
- data['name'] = name
- self.iterables.append(data)
- return data
- return None
-
- def del_data(self, name):
- """
- Remove a single ResponseParameter element.
-
- Arguments:
- name -- The data element name to remove.
- """
- if name in self._datas:
- datas = [i for i in self.iterables if isinstance(i, ResponseParameter)]
- for data in datas:
- if data['name'] == name:
- self.xml.remove(data.xml)
- self.iterables.remove(data)
- return True
- return False
-
- def get_datas(self):
- """ Return all ResponseParameter elements. """
- datas = set()
- for data in self['substanzas']:
- if isinstance(data, ResponseParameter):
- datas.add(data)
- return datas
-
- def set_datas(self, datas):
- """
- Set or replace all data elements. The given elements must be in a
- list or set of ResponseParameter elements
-
- Arguments:
- datas -- A series of data element names.
- """
- self.del_datas()
- for data in datas:
- self.add_data(name=data['name'])
-
- def del_datas(self):
- """Remove all ResponseParameter elements."""
- self._datas = set()
- datas = [i for i in self.iterables if isinstance(i, ResponseParameter)]
- for data in datas:
- self.xml.remove(data.xml)
- self.iterables.remove(data)
-
-
-class Error(ElementBase):
- namespace = 'urn:xmpp:iot:control'
- name = 'error'
- plugin_attrib = name
- interfaces = set(['var','text'])
-
- def get_text(self):
- """Return then contents inside the XML tag."""
- return self.xml.text
-
- def set_text(self, value):
- """Set then contents inside the XML tag.
-
- Arguments:
- value -- string
- """
-
- self.xml.text = value
- return self
-
- def del_text(self):
- """Remove the contents inside the XML tag."""
- self.xml.text = ""
- return self
-
-class ResponseParameter(ElementBase):
- """
- Parameter element in ControlSetResponse.
- """
- namespace = 'urn:xmpp:iot:control'
- name = 'parameter'
- plugin_attrib = name
- interfaces = set(['name'])
-
-
-class BaseParameter(ElementBase):
- """
- Parameter element in SetCommand. This is a base class,
- all instances of parameters added to SetCommand must be of types:
- BooleanParameter
- ColorParameter
- StringParameter
- DateParameter
- DateTimeParameter
- DoubleParameter
- DurationParameter
- IntParameter
- LongParameter
- TimeParameter
- """
- namespace = 'urn:xmpp:iot:control'
- name = 'baseParameter'
- plugin_attrib = name
- interfaces = set(['name','value'])
-
- def _get_typename(self):
- return self.name
-
-
-class BooleanParameter(BaseParameter):
- """
- Field data of type boolean.
- Note that the value is expressed as a string.
- """
- name = 'boolean'
- plugin_attrib = name
-
-class ColorParameter(BaseParameter):
- """
- Field data of type color.
- Note that the value is expressed as a string.
- """
- name = 'color'
- plugin_attrib = name
-
-class StringParameter(BaseParameter):
- """
- Field data of type string.
- """
- name = 'string'
- plugin_attrib = name
-
-class DateParameter(BaseParameter):
- """
- Field data of type date.
- Note that the value is expressed as a string.
- """
- name = 'date'
- plugin_attrib = name
-
-class DateTimeParameter(BaseParameter):
- """
- Field data of type dateTime.
- Note that the value is expressed as a string.
- """
- name = 'dateTime'
- plugin_attrib = name
-
-class DoubleParameter(BaseParameter):
- """
- Field data of type double.
- Note that the value is expressed as a string.
- """
- name = 'double'
- plugin_attrib = name
-
-class DurationParameter(BaseParameter):
- """
- Field data of type duration.
- Note that the value is expressed as a string.
- """
- name = 'duration'
- plugin_attrib = name
-
-class IntParameter(BaseParameter):
- """
- Field data of type int.
- Note that the value is expressed as a string.
- """
- name = 'int'
- plugin_attrib = name
-
-class LongParameter(BaseParameter):
- """
- Field data of type long (64-bit int).
- Note that the value is expressed as a string.
- """
- name = 'long'
- plugin_attrib = name
-
-class TimeParameter(BaseParameter):
- """
- Field data of type time.
- Note that the value is expressed as a string.
- """
- name = 'time'
- plugin_attrib = name
-
-register_stanza_plugin(Iq, ControlSet)
-register_stanza_plugin(Message, ControlSet)
-
-register_stanza_plugin(ControlSet, RequestNode, iterable=True)
-
-register_stanza_plugin(ControlSet, BooleanParameter, iterable=True)
-register_stanza_plugin(ControlSet, ColorParameter, iterable=True)
-register_stanza_plugin(ControlSet, StringParameter, iterable=True)
-register_stanza_plugin(ControlSet, DateParameter, iterable=True)
-register_stanza_plugin(ControlSet, DateTimeParameter, iterable=True)
-register_stanza_plugin(ControlSet, DoubleParameter, iterable=True)
-register_stanza_plugin(ControlSet, DurationParameter, iterable=True)
-register_stanza_plugin(ControlSet, IntParameter, iterable=True)
-register_stanza_plugin(ControlSet, LongParameter, iterable=True)
-register_stanza_plugin(ControlSet, TimeParameter, iterable=True)
-
-register_stanza_plugin(Iq, ControlSetResponse)
-register_stanza_plugin(ControlSetResponse, Error)
-register_stanza_plugin(ControlSetResponse, RequestNode, iterable=True)
-register_stanza_plugin(ControlSetResponse, ResponseParameter, iterable=True)
-