130 lines
4.6 KiB
Python
130 lines
4.6 KiB
Python
# Copyright 2017 Mycroft AI Inc.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
#
|
|
import json
|
|
|
|
|
|
class Message(object):
|
|
"""This class is used to minipulate data to be sent over the websocket
|
|
|
|
Message objects will be used to send information back and fourth
|
|
between processes of mycroft service, voice, skill and cli
|
|
Attributes:
|
|
type: type of data sent within the message.
|
|
data: data sent within the message
|
|
context: info about the message not part of data such as source,
|
|
destination or domain.
|
|
"""
|
|
|
|
def __init__(self, type, data=None, context=None):
|
|
"""Used to construct a message object
|
|
|
|
Message objects will be used to send information back and fourth
|
|
bettween processes of mycroft service, voice, skill and cli
|
|
"""
|
|
data = data or {}
|
|
self.type = type
|
|
self.data = data
|
|
self.context = context
|
|
|
|
def serialize(self):
|
|
"""This returns a string of the message info.
|
|
|
|
This makes it easy to send over a websocket. This uses
|
|
json dumps to generate the string with type, data and context
|
|
|
|
Returns:
|
|
str: a json string representation of the message.
|
|
"""
|
|
return json.dumps({
|
|
'type': self.type,
|
|
'data': self.data,
|
|
'context': self.context
|
|
})
|
|
|
|
@staticmethod
|
|
def deserialize(value):
|
|
"""This takes a string and constructs a message object.
|
|
|
|
This makes it easy to take strings from the websocket and create
|
|
a message object. This uses json loads to get the info and generate
|
|
the message object.
|
|
|
|
Args:
|
|
value(str): This is the json string received from the websocket
|
|
|
|
Returns:
|
|
Message: message object constructed from the json string passed
|
|
int the function.
|
|
value(str): This is the string received from the websocket
|
|
"""
|
|
obj = json.loads(value)
|
|
return Message(obj.get('type'), obj.get('data'), obj.get('context'))
|
|
|
|
def reply(self, type, data, context=None):
|
|
"""This is used to construct a reply message for a give message
|
|
|
|
This will take the same parameters as a message object but use
|
|
the current message object as a refrence. It will copy the context
|
|
form the existing message object and add any context passed in to
|
|
the function. Check for a target passed in to the function from
|
|
the data object and add that to the context as a target. If the
|
|
context has a client name then that will become the target in the
|
|
context. The new message will then have data passed in plus the
|
|
new context generated.
|
|
|
|
Args:
|
|
type: type of message
|
|
data: data for message
|
|
context: intented context for new message
|
|
|
|
Returns:
|
|
Message: Message object to be used on the reply to the message
|
|
"""
|
|
context = context or {}
|
|
|
|
new_context = self.context if self.context else {}
|
|
for key in context:
|
|
new_context[key] = context[key]
|
|
if 'target' in data:
|
|
new_context['target'] = data['target']
|
|
elif 'client_name' in context:
|
|
context['target'] = context['client_name']
|
|
return Message(type, data, context=new_context)
|
|
|
|
def publish(self, type, data, context=None):
|
|
"""
|
|
|
|
Copy the original context and add passed in context. Delete
|
|
any target in the new context. Return a new message object with
|
|
passed in data and new context. Type remains unchanged.
|
|
|
|
Args:
|
|
type: type of message
|
|
data: date to send with message
|
|
context: context added to existing context
|
|
|
|
Returns:
|
|
Message: Message object to publish
|
|
"""
|
|
context = context or {}
|
|
new_context = self.context.copy() if self.context else {}
|
|
for key in context:
|
|
new_context[key] = context[key]
|
|
|
|
if 'target' in new_context:
|
|
del new_context['target']
|
|
|
|
return Message(type, data, context=new_context)
|