<filename>apns_worker/tests/test_threaded_backend.py<gh_stars>1-10
from __future__ import unicode_literals

from binascii import hexlify, unhexlify
from collections import namedtuple
from datetime import datetime, timedelta
from itertools import takewhile, repeat
import json
import logging
import socket
import struct
from threading import Condition
from time import sleep
import unittest

try:
    from unittest import mock
except ImportError:
    import mock

import six

from apns_worker import ApnsManager, Message
from apns_worker.backend.threaded import Connection


_token1 = '<PASSWORD>'
_token2 = '<PASSWORD>'
_token3 = '<PASSWORD>'


class BackendTestCase(unittest.TestCase):
    _when = datetime(2015, 9, 1)
    _timestamp = int((_when - datetime(1970, 1, 1)).total_seconds())

    @classmethod
    def setUpClass(cls):
        super(BackendTestCase, cls).setUpClass()

        logger = logging.getLogger('apns_worker')
        logger.setLevel(logging.WARNING)
        logger.addHandler(logging.StreamHandler())

    def setUp(self):
        super(BackendTestCase, self).setUp()

        self._connection_patch = mock.patch('apns_worker.backend.threaded._new_connection', self.new_connection)
        self._connection_patch.start()

        self._apns = None
        self.connection_inbuf = None
        self.connections = []
        self.apns_error = None
        self.feedbacks = []

    def tearDown(self):
        if self._apns is not None:
            self._apns._backend.stop()
            self._apns = None

        self._connection_patch.stop()
        del self._connection_patch

        super(BackendTestCase, self).tearDown()

    def test_wait_for_notification(self):
        self.assertFalse(self.apns._backend.thread.connection.is_opened)

    def test_send_aps(self):
        kwargs = {
            'alert': 'Alert!',
            'badge': 5,
            'sound': 'Meep Meep!',
            'content_available': True,
            'category': 'stuff',
        }
        self.apns.send_aps([_token1], **kwargs)

        sleep(0.1)

        frame = self.sent_frames[0]
        payload = {'aps': {
            'alert': 'Alert!',
            'badge': 5,
            'sound': 'Meep Meep!',
            'content-available': 1,
            'category': 'stuff',
        }}
        self.assertEqual(frame.decoded, payload)

    def test_send_notification(self):
        msg = Message([_token1], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.assertEqual(self.sent_tokens, [_token1])

    def test_send_multiple(self):
        msg = Message([_token1, _token2], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.assertEqual(self.sent_tokens, [_token1, _token2])

    def test_reject_last(self):
        msg = Message([_token1, _token2], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(struct.pack('!BBI', 8, 1, self.sent_frames[-1].ident))

        sleep(0.1)

        self.assertEqual(self.connections_opened, 1)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token2])
        self.assertEqual(self.apns_error.status, 1)

    def test_reject_middle(self):
        msg = Message([_token1, _token2, _token3], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(struct.pack('!BBI', 8, 1, self.sent_frames[-2].ident))

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token2, _token3, _token3])
        self.assertEqual(self.apns_error.status, 1)

    def test_reject_unknown(self):
        msg = Message([_token1, _token2, _token3], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(struct.pack('!BBI', 8, 1, 100))

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token2, _token3, _token1, _token2, _token3])
        self.assertEqual(self.apns_error, None)

    def test_shutdown(self):
        msg = Message([_token1, _token2, _token3], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(struct.pack('!BBI', 8, 10, self.sent_frames[-2].ident))

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token2, _token3, _token3])
        self.assertEqual(self.apns_error, None)

    def test_read_exc(self):
        msg = Message([_token1], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(socket.error("Test error"))

        sleep(0.1)

        self.apns.send_message(msg)

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token1])
        self.assertEqual(self.apns_error, None)

    def test_write_exc(self):
        self.apns
        self.connection.set_write_exc(socket.error("Test error"))
        msg = Message([_token1], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1])
        self.assertEqual(self.apns_error, None)

    def test_flush(self):
        self.apns.send_aps([_token1], badge=1)
        self.apns.flush_messages()

        self.assertTrue(self.apns._queue.is_empty())

    def test_feedback_empty(self):
        self.connection_inbuf = b''
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 0)

    def test_feedback_partial(self):
        self.connection_inbuf = struct.pack('!IH30s', self._timestamp, 32, unhexlify(_token1))
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 0)

    def test_feedback_single(self):
        self.connection_inbuf = struct.pack('!IH32s', self._timestamp, 32, unhexlify(_token1))
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 1)
        self.assertEqual(self.feedbacks[0].token, _token1)
        self.assertEqual(self.feedbacks[0].when, self._when)

    def test_feedback_remainder(self):
        self.connection_inbuf = struct.pack('!IH32sI', self._timestamp, 32, unhexlify(_token1), 0)
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 1)
        self.assertEqual(self.feedbacks[0].token, _token1)
        self.assertEqual(self.feedbacks[0].when, self._when)

    def test_feedback_multiple(self):
        self.connection_inbuf = struct.pack(
            '!IH32sIH32sI',
            self._timestamp, 32, unhexlify(_token1),
            self._timestamp + 1, 32, unhexlify(_token2),
            0)
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 2)
        self.assertEqual(self.feedbacks[0].token, _token1)
        self.assertEqual(self.feedbacks[0].when, self._when)
        self.assertEqual(self.feedbacks[1].token, _token2)
        self.assertEqual(self.feedbacks[1].when, self._when + timedelta(seconds=1))

    #
    # Hooks
    #

    def new_connection(self, *args, **kwargs):
        connection = TestConnection(self, self.connection_inbuf)
        self.connections.append(connection)

        return connection

    def handle_error(self, error):
        self.apns_error = error

    def handle_feedback(self, feedback):
        self.feedbacks.append(feedback)

    #
    # State
    #

    @property
    def apns(self):
        if self._apns is None:
            self._apns = ApnsManager(
                'key-path', 'cert-path',
                backend_path='apns_worker.backend.threaded.Backend',
                message_grace=0.1, error_handler=self.handle_error
            )

        return self._apns

    @property
    def connection(self):
        return self.connections[-1] if len(self.connections) > 0 else None

    @property
    def connections_opened(self):
        return len([c for c in self.connections if c.is_opened])

    @property
    def connections_closed(self):
        return len([c for c in self.connections if c.is_closed])

    @property
    def sent_tokens(self):
        """ Tokens of send frames, in order. """
        return [frame.token for frame in self.sent_frames]

    @property
    def sent_idents(self):
        """ Idents of sent frames, in order. """
        return [frame.ident for frame in self.sent_frames]

    @property
    def sent_frames(self):
        """ All sent frames, in order. """
        return [frame for connection in self.connections for frame in connection.sent_frames]


class TestConnection(Connection):
    """ A fake apns_worker.backend.threaded.Connection. """
    def __init__(self, test_case, inbuf=None):
        self.test_case = test_case

        self.outbuf = six.BytesIO()
        self.inbuf = inbuf
        self.write_exc = None

        self._close_on_empty = (inbuf is not None)

        self.cond = Condition()
        self._is_opened = False
        self._is_closed = False

        self._sent_frames = None

    def __copy__(self):
        return self.test_case.new_connection()

    @property
    def is_opened(self):
        return self._is_opened

    def connect(self):
        self.is_opened = True

        return (not self._is_closed)

    def recv(self, bufsize=4096):
        """
        This always returns one byte at a time to make sure we're looping
        properly.
        """
        self._is_opened = True

        with self.cond:
            while self.inbuf is None:
                self.cond.wait()

            if isinstance(self.inbuf, Exception):
                val = self.inbuf
                self.inbuf = None
            else:
                val = self.inbuf[:1]
                self.inbuf = self.inbuf[1:] if (len(self.inbuf) > 1) else None
                if (self.inbuf is None) and self._close_on_empty:
                    self.close()

        if isinstance(val, Exception):
            raise val
        else:
            return val

    def sendall(self, buf):
        if self._is_closed:
            return 0

        self._is_opened = True
        self._sent_frames = None

        err = self.write_exc
        if err is not None:
            self.write_exc = None
            raise err
        else:
            return self.outbuf.write(buf)

    def close(self):
        with self.cond:
            self._is_closed = True
            self.inbuf = b''
            self.cond.notify_all()

    #
    # Test methods
    #

    def set_inbuf(self, val):
        """ Send data or an exception to the read thread. """
        with self.cond:
            self.inbuf = val
            self.cond.notify_all()

    def set_write_exc(self, exc):
        """ Set an exception for sendall. """
        self.write_exc = exc

    @property
    def sent_frames(self):
        """ Returns Frame objects representing sent frames. """
        if self._sent_frames is None:
            stream = six.BytesIO(self.outbuf.getvalue())
            self._sent_frames = list(takewhile(lambda f: f is not None, (Frame.parse(stream) for i in repeat(None))))

        return self._sent_frames


class Frame(namedtuple('Frame', ['token', 'payload', 'ident', 'expiration', 'priority'])):
    """ A parsed APNs frame. """
    @classmethod
    def parse(cls, stream):
        frame = None

        try:
            cmd, length = struct.unpack('!BI', stream.read(5))
            if cmd == 2:
                items = cls._parse_items(stream, length)
                frame = cls(**items)
        except struct.error:
            pass

        return frame

    @classmethod
    def _parse_items(cls, stream, length):
        items = {
            'token': None,
            'payload': None,
            'ident': None,
            'expiration': None,
            'priority': None,
        }

        while length > 0:
            item_id, data_len = struct.unpack('!BH', stream.read(3))
            data = stream.read(data_len)

            if item_id == 1:
                items['token'] = hexlify(data).decode('ascii')
            elif item_id == 2:
                items['payload'] = data
            elif item_id == 3:
                items['ident'] = struct.unpack('!I', data)[0]
            elif item_id == 4:
                items['expiration'] = struct.unpack('!I', data)[0]
            elif item_id == 5:
                items['priority'] = struct.unpack('!B', data)[0]
            else:
                raise ValueError("Unknown item ID in frame: {0}".format(item_id))

            length -= (3 + data_len)

        return items

    @property
    def decoded(self):
        return json.loads(self.payload.decode('utf-8'))

<filename>apns_worker/tests/test_threaded_backend.py<gh_stars>1-10
from __future__ import unicode_literals

from binascii import hexlify, unhexlify
from collections import namedtuple
from datetime import datetime, timedelta
from itertools import takewhile, repeat
import json
import logging
import socket
import struct
from threading import Condition
from time import sleep
import unittest

try:
    from unittest import mock
except ImportError:
    import mock

import six

from apns_worker import ApnsManager, Message
from apns_worker.backend.threaded import Connection


_token1 = '<PASSWORD>'
_token2 = '<PASSWORD>'
_token3 = '<PASSWORD>'


class BackendTestCase(unittest.TestCase):
    _when = datetime(2015, 9, 1)
    _timestamp = int((_when - datetime(1970, 1, 1)).total_seconds())

    @classmethod
    def setUpClass(cls):
        super(BackendTestCase, cls).setUpClass()

        logger = logging.getLogger('apns_worker')
        logger.setLevel(logging.WARNING)
        logger.addHandler(logging.StreamHandler())

    def setUp(self):
        super(BackendTestCase, self).setUp()

        self._connection_patch = mock.patch('apns_worker.backend.threaded._new_connection', self.new_connection)
        self._connection_patch.start()

        self._apns = None
        self.connection_inbuf = None
        self.connections = []
        self.apns_error = None
        self.feedbacks = []

    def tearDown(self):
        if self._apns is not None:
            self._apns._backend.stop()
            self._apns = None

        self._connection_patch.stop()
        del self._connection_patch

        super(BackendTestCase, self).tearDown()

    def test_wait_for_notification(self):
        self.assertFalse(self.apns._backend.thread.connection.is_opened)

    def test_send_aps(self):
        kwargs = {
            'alert': 'Alert!',
            'badge': 5,
            'sound': 'Meep Meep!',
            'content_available': True,
            'category': 'stuff',
        }
        self.apns.send_aps([_token1], **kwargs)

        sleep(0.1)

        frame = self.sent_frames[0]
        payload = {'aps': {
            'alert': 'Alert!',
            'badge': 5,
            'sound': 'Meep Meep!',
            'content-available': 1,
            'category': 'stuff',
        }}
        self.assertEqual(frame.decoded, payload)

    def test_send_notification(self):
        msg = Message([_token1], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.assertEqual(self.sent_tokens, [_token1])

    def test_send_multiple(self):
        msg = Message([_token1, _token2], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.assertEqual(self.sent_tokens, [_token1, _token2])

    def test_reject_last(self):
        msg = Message([_token1, _token2], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(struct.pack('!BBI', 8, 1, self.sent_frames[-1].ident))

        sleep(0.1)

        self.assertEqual(self.connections_opened, 1)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token2])
        self.assertEqual(self.apns_error.status, 1)

    def test_reject_middle(self):
        msg = Message([_token1, _token2, _token3], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(struct.pack('!BBI', 8, 1, self.sent_frames[-2].ident))

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token2, _token3, _token3])
        self.assertEqual(self.apns_error.status, 1)

    def test_reject_unknown(self):
        msg = Message([_token1, _token2, _token3], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(struct.pack('!BBI', 8, 1, 100))

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token2, _token3, _token1, _token2, _token3])
        self.assertEqual(self.apns_error, None)

    def test_shutdown(self):
        msg = Message([_token1, _token2, _token3], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(struct.pack('!BBI', 8, 10, self.sent_frames[-2].ident))

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token2, _token3, _token3])
        self.assertEqual(self.apns_error, None)

    def test_read_exc(self):
        msg = Message([_token1], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.connection.set_inbuf(socket.error("Test error"))

        sleep(0.1)

        self.apns.send_message(msg)

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1, _token1])
        self.assertEqual(self.apns_error, None)

    def test_write_exc(self):
        self.apns
        self.connection.set_write_exc(socket.error("Test error"))
        msg = Message([_token1], {'aps': {'badge': 1}})
        self.apns.send_message(msg)

        sleep(0.1)

        self.assertEqual(self.connections_opened, 2)
        self.assertEqual(self.connections_closed, 1)
        self.assertEqual(self.sent_tokens, [_token1])
        self.assertEqual(self.apns_error, None)

    def test_flush(self):
        self.apns.send_aps([_token1], badge=1)
        self.apns.flush_messages()

        self.assertTrue(self.apns._queue.is_empty())

    def test_feedback_empty(self):
        self.connection_inbuf = b''
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 0)

    def test_feedback_partial(self):
        self.connection_inbuf = struct.pack('!IH30s', self._timestamp, 32, unhexlify(_token1))
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 0)

    def test_feedback_single(self):
        self.connection_inbuf = struct.pack('!IH32s', self._timestamp, 32, unhexlify(_token1))
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 1)
        self.assertEqual(self.feedbacks[0].token, _token1)
        self.assertEqual(self.feedbacks[0].when, self._when)

    def test_feedback_remainder(self):
        self.connection_inbuf = struct.pack('!IH32sI', self._timestamp, 32, unhexlify(_token1), 0)
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 1)
        self.assertEqual(self.feedbacks[0].token, _token1)
        self.assertEqual(self.feedbacks[0].when, self._when)

    def test_feedback_multiple(self):
        self.connection_inbuf = struct.pack(
            '!IH32sIH32sI',
            self._timestamp, 32, unhexlify(_token1),
            self._timestamp + 1, 32, unhexlify(_token2),
            0)
        self.apns.get_feedback(self.handle_feedback)

        sleep(0.1)

        self.assertEqual(len(self.feedbacks), 2)
        self.assertEqual(self.feedbacks[0].token, _token1)
        self.assertEqual(self.feedbacks[0].when, self._when)
        self.assertEqual(self.feedbacks[1].token, _token2)
        self.assertEqual(self.feedbacks[1].when, self._when + timedelta(seconds=1))

    #
    # Hooks
    #

    def new_connection(self, *args, **kwargs):
        connection = TestConnection(self, self.connection_inbuf)
        self.connections.append(connection)

        return connection

    def handle_error(self, error):
        self.apns_error = error

    def handle_feedback(self, feedback):
        self.feedbacks.append(feedback)

    #
    # State
    #

    @property
    def apns(self):
        if self._apns is None:
            self._apns = ApnsManager(
                'key-path', 'cert-path',
                backend_path='apns_worker.backend.threaded.Backend',
                message_grace=0.1, error_handler=self.handle_error
            )

        return self._apns

    @property
    def connection(self):
        return self.connections[-1] if len(self.connections) > 0 else None

    @property
    def connections_opened(self):
        return len([c for c in self.connections if c.is_opened])

    @property
    def connections_closed(self):
        return len([c for c in self.connections if c.is_closed])

    @property
    def sent_tokens(self):
        """ Tokens of send frames, in order. """
        return [frame.token for frame in self.sent_frames]

    @property
    def sent_idents(self):
        """ Idents of sent frames, in order. """
        return [frame.ident for frame in self.sent_frames]

    @property
    def sent_frames(self):
        """ All sent frames, in order. """
        return [frame for connection in self.connections for frame in connection.sent_frames]


class TestConnection(Connection):
    """ A fake apns_worker.backend.threaded.Connection. """
    def __init__(self, test_case, inbuf=None):
        self.test_case = test_case

        self.outbuf = six.BytesIO()
        self.inbuf = inbuf
        self.write_exc = None

        self._close_on_empty = (inbuf is not None)

        self.cond = Condition()
        self._is_opened = False
        self._is_closed = False

        self._sent_frames = None

    def __copy__(self):
        return self.test_case.new_connection()

    @property
    def is_opened(self):
        return self._is_opened

    def connect(self):
        self.is_opened = True

        return (not self._is_closed)

    def recv(self, bufsize=4096):
        """
        This always returns one byte at a time to make sure we're looping
        properly.
        """
        self._is_opened = True

        with self.cond:
            while self.inbuf is None:
                self.cond.wait()

            if isinstance(self.inbuf, Exception):
                val = self.inbuf
                self.inbuf = None
            else:
                val = self.inbuf[:1]
                self.inbuf = self.inbuf[1:] if (len(self.inbuf) > 1) else None
                if (self.inbuf is None) and self._close_on_empty:
                    self.close()

        if isinstance(val, Exception):
            raise val
        else:
            return val

    def sendall(self, buf):
        if self._is_closed:
            return 0

        self._is_opened = True
        self._sent_frames = None

        err = self.write_exc
        if err is not None:
            self.write_exc = None
            raise err
        else:
            return self.outbuf.write(buf)

    def close(self):
        with self.cond:
            self._is_closed = True
            self.inbuf = b''
            self.cond.notify_all()

    #
    # Test methods
    #

    def set_inbuf(self, val):
        """ Send data or an exception to the read thread. """
        with self.cond:
            self.inbuf = val
            self.cond.notify_all()

    def set_write_exc(self, exc):
        """ Set an exception for sendall. """
        self.write_exc = exc

    @property
    def sent_frames(self):
        """ Returns Frame objects representing sent frames. """
        if self._sent_frames is None:
            stream = six.BytesIO(self.outbuf.getvalue())
            self._sent_frames = list(takewhile(lambda f: f is not None, (Frame.parse(stream) for i in repeat(None))))

        return self._sent_frames


class Frame(namedtuple('Frame', ['token', 'payload', 'ident', 'expiration', 'priority'])):
    """ A parsed APNs frame. """
    @classmethod
    def parse(cls, stream):
        frame = None

        try:
            cmd, length = struct.unpack('!BI', stream.read(5))
            if cmd == 2:
                items = cls._parse_items(stream, length)
                frame = cls(**items)
        except struct.error:
            pass

        return frame

    @classmethod
    def _parse_items(cls, stream, length):
        items = {
            'token': None,
            'payload': None,
            'ident': None,
            'expiration': None,
            'priority': None,
        }

        while length > 0:
            item_id, data_len = struct.unpack('!BH', stream.read(3))
            data = stream.read(data_len)

            if item_id == 1:
                items['token'] = hexlify(data).decode('ascii')
            elif item_id == 2:
                items['payload'] = data
            elif item_id == 3:
                items['ident'] = struct.unpack('!I', data)[0]
            elif item_id == 4:
                items['expiration'] = struct.unpack('!I', data)[0]
            elif item_id == 5:
                items['priority'] = struct.unpack('!B', data)[0]
            else:
                raise ValueError("Unknown item ID in frame: {0}".format(item_id))

            length -= (3 + data_len)

        return items

    @property
    def decoded(self):
        return json.loads(self.payload.decode('utf-8'))

# # Hooks # # # State # Tokens of send frames, in order. Idents of sent frames, in order. All sent frames, in order. A fake apns_worker.backend.threaded.Connection. This always returns one byte at a time to make sure we're looping         properly. # # Test methods # Send data or an exception to the read thread. Set an exception for sendall. Returns Frame objects representing sent frames. A parsed APNs frame.