示例#1
0
    def setUp(self):
        # Create default event loop if no event loop was created by a base class
        if not hasattr(self, 'loop'):
            from asyncframes.asyncio_eventloop import EventLoop
            self.loop = EventLoop()

        # Announce event loop if different
        global EVENTLOOP_CLASS
        if self.loop.__class__ != EVENTLOOP_CLASS:
            print()
            print("Using {}.{}".format(self.loop.__class__.__module__,
                                       self.loop.__class__.__name__))
            EVENTLOOP_CLASS = self.loop.__class__

        # Create logger for debugging program flow using time stamped log messages
        # Create time stamped log messages using self.log.debug(...)
        # Test program flow by passing an expected_log to self.run_frame()
        self.log = logging.getLogger(self._testMethodName +
                                     str(threading.get_ident()))
        self.log.setLevel(logging.DEBUG)
        self.logstream = io.StringIO()
        loghandler = logging.StreamHandler(self.logstream)
        loghandler.setLevel(logging.DEBUG)

        class TimedFormatter(logging.Formatter):
            def __init__(self, *args, **kwargs):
                super().__init__(*args, **kwargs)
                self.starttime = datetime.datetime.now()

            def format(self, record):
                t = (datetime.datetime.now() - self.starttime).total_seconds()
                msg = super().format(record)
                return str(math.floor(t * 10) /
                           10) + ": " + msg if msg else str(
                               math.floor(t * 10) / 10)

        self.logformatter = TimedFormatter("%(message)s")
        loghandler.setFormatter(self.logformatter)
        self.log.addHandler(loghandler)
示例#2
0
    def setUp(self):
        # Create GLib event loop
        try:
            from asyncframes.glib_eventloop import EventLoop
        except ImportError:
            # Announce that we skip this test case, if not announced before
            global SKIP_TEST_CASE
            if self.__class__ != SKIP_TEST_CASE:
                print()
                print(
                    "Unable to import asyncframes.glib_eventloop. Skipping unit tests for this event loop."
                )
                SKIP_TEST_CASE = self.__class__

            raise unittest.SkipTest
        else:
            self.loop = EventLoop()
            super().setUp()
示例#3
0
@PFrame
async def counter(c):
    if DEBUG_EVENTLOOP_AFFINITY:
        print('counter', c + ':', get_current_eventloop_index())
    await sleep()
    if DEBUG_EVENTLOOP_AFFINITY:
        print('counter', c + ':', get_current_eventloop_index())
    for i in range(4):
        time.sleep(1)
        if DEBUG_EVENTLOOP_AFFINITY:
            print('counter', c + ':', get_current_eventloop_index())
        print(c)


@Frame
async def main_frame():
    if DEBUG_EVENTLOOP_AFFINITY:
        print('main_frame:', get_current_eventloop_index())
    a = counter('a')  # Start counter 'a'
    await sleep(0.5)  # Wait 0.5 seconds
    if DEBUG_EVENTLOOP_AFFINITY:
        print('main_frame:', get_current_eventloop_index())
    b = counter('b')  # Start counter 'b'
    await (a & b)  # Wait until both counters finish
    if DEBUG_EVENTLOOP_AFFINITY:
        print('main_frame:', get_current_eventloop_index())


loop = EventLoop()
loop.run(main_frame)
示例#4
0
    print()


@asyncframes.Frame
async def count_using_pframes(printfunc):
    counters = [
        pframe_counter(delay=0.1 * i,
                       printfunc=printfunc,
                       printfunc_args=(i, )) for i in range(3)
    ]
    await asyncframes.all_(*counters)
    print()


if __name__ == "__main__":
    loop = EventLoop()

    alphabetical = lambda i: "abc"[i]
    thread_numbers = lambda i: asyncframes.get_current_eventloop_index()

    print("Run 3 blocking threads in parallel using Frames:")
    loop.run(count_using_frames, printfunc=alphabetical)
    loop.run(count_using_frames, printfunc=thread_numbers)
    print()

    print("Run 3 blocking threads in parallel using PFrames:")
    loop.run(count_using_pframes, printfunc=alphabetical)
    loop.run(count_using_pframes, printfunc=thread_numbers)
    print()

    print("Run 3 blocking threads in parallel using PFrames with 3 threads:")
示例#5
0
class TestAsyncFrames(unittest.TestCase):
    def setUp(self):
        # Create default event loop if no event loop was created by a base class
        if not hasattr(self, 'loop'):
            from asyncframes.asyncio_eventloop import EventLoop
            self.loop = EventLoop()

        # Announce event loop if different
        global EVENTLOOP_CLASS
        if self.loop.__class__ != EVENTLOOP_CLASS:
            print()
            print("Using {}.{}".format(self.loop.__class__.__module__,
                                       self.loop.__class__.__name__))
            EVENTLOOP_CLASS = self.loop.__class__

        # Create logger for debugging program flow using time stamped log messages
        # Create time stamped log messages using self.log.debug(...)
        # Test program flow by passing an expected_log to self.run_frame()
        self.log = logging.getLogger(self._testMethodName +
                                     str(threading.get_ident()))
        self.log.setLevel(logging.DEBUG)
        self.logstream = io.StringIO()
        loghandler = logging.StreamHandler(self.logstream)
        loghandler.setLevel(logging.DEBUG)

        class TimedFormatter(logging.Formatter):
            def __init__(self, *args, **kwargs):
                super().__init__(*args, **kwargs)
                self.starttime = datetime.datetime.now()

            def format(self, record):
                t = (datetime.datetime.now() - self.starttime).total_seconds()
                msg = super().format(record)
                return str(math.floor(t * 10) /
                           10) + ": " + msg if msg else str(
                               math.floor(t * 10) / 10)

        self.logformatter = TimedFormatter("%(message)s")
        loghandler.setFormatter(self.logformatter)
        self.log.addHandler(loghandler)

    def run_frame(self,
                  frame,
                  *frameargs,
                  expected_log=None,
                  assert_raises=None,
                  assert_raises_regex=None):
        @Frame
        async def mainframe():
            self.logstream.truncate(0)  # Reset log
            self.logstream.seek(0)  # Reset log
            self.logformatter.starttime = datetime.datetime.now(
            )  # Reset log start time
            return await frame(*frameargs)

        result = None
        cm = line_tracer.Trace(TRACE_MODE, TRACE_OUTPUT,
                               True) if USE_TRACER else nullcontext()
        for _ in range(NUM_ITERATIONS):
            with cm:
                try:
                    result = self.loop.run(mainframe, num_threads=NUM_THREADS)
                    self.log.debug('done')
                    if expected_log is not None:
                        # Compare log with expected_log
                        expected = '\n'.join(
                            line.strip()
                            for line in expected_log.strip('\n').split('\n')
                        )  # Remove leading and trailing empty lines and white space
                        self.assertEqual(expected, self.logstream.getvalue())
                except Exception as err:
                    if assert_raises:
                        failed = type(err) != assert_raises
                    elif assert_raises_regex:
                        failed = type(
                            err) != assert_raises_regex[0] or not re.match(
                                assert_raises_regex[1], str(err))
                    else:
                        failed = True
                    if failed:
                        raise
                else:
                    if assert_raises or assert_raises_regex:
                        raise AssertionError((
                            assert_raises or assert_raises_regex[0]).__name__ +
                                             " not raised")
        return result

    def test_simple(self):
        test = self

        @Frame
        async def main():
            await wait(test, 0.1, '1')

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.1: done
        """)

    def test_regular_function_mainframe(self):
        test = self

        @Frame
        async def remove_after(frame, seconds):
            await sleep(seconds)
            frame.remove()

        @Frame
        def main(self):
            remove_after(self, 0.1)

        test.run_frame(main,
                       expected_log="""
            0.1: done
        """)

    def test_negative_sleep_duration(self):
        test = self

        @MyFrame
        async def main():
            await sleep(-1)

        test.run_frame(main,
                       expected_log="""
            0.0: done
        """)

    def test_await_order_1(self):
        test = self

        @MyFrame
        async def main():
            wait(test, 0.1, '1')
            await wait(test, 0.2, '2')

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.2: 2
            0.2: done
        """)

    def test_await_order_2(self):
        test = self

        @MyFrame
        async def main():
            await wait(test, 0.1, '1')
            await wait(test, 0.2, '2')

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.3: 2
            0.3: done
        """)

    def test_await_order_3(self):
        test = self

        @MyFrame
        async def main():
            await wait(test, 0.1, '1')
            wait(test, 0.2, '2')

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.1: done
        """)

    def test_await_order_4(self):
        test = self

        @MyFrame
        async def main():
            wait(test, 0.1, '1')
            wait(test, 0.2, '2')

        test.run_frame(main,
                       expected_log="""
            0.0: done
        """)

    def test_await_order_5(self):
        test = self

        @MyFrame
        async def main():
            w1 = wait(test, 0.1, '1')
            w2 = wait(test, 0.2, '2')
            await (w1 & w2)

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.2: 2
            0.2: done
        """)

    def test_await_order_6(self):
        test = self

        @MyFrame
        async def main():
            w1 = wait(test, 0.1, '1')
            w2 = wait(test, 0.2, '2')
            await (w1 | w2)

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.1: done
        """)

    def test_frame_result(self):
        test = self

        @MyFrame
        async def main():
            test.log.debug(await wait(test, 0.1, '1'))

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.1: some result
            0.1: done
        """)

    def test_blocking_sleep(self):
        test = self

        @MyFrame
        async def main():
            test.log.debug(await sleep(0.1))

        test.run_frame(main,
                       expected_log="""
            0.1: None
            0.1: done
        """)

    def test_non_blocking_sleep(self):
        test = self

        @MyFrame
        async def main():
            test.log.debug(await sleep(0))

        test.run_frame(main,
                       expected_log="""
            0.0: None
            0.0: done
        """)

    def test_staticmethod(self):
        test = self

        @MyFrame
        async def main():
            MyFrame.mystaticmethod(test)

        test.run_frame(main,
                       expected_log="""
            0.0: static method called
            0.0: done
        """)

    def test_classvar(self):
        test = self

        @MyFrame
        async def main():
            test.log.debug(MyFrame.classvar)

        test.run_frame(main,
                       expected_log="""
            0.0: class variable
            0.0: done
        """)

    def test_primitive(self):
        test = self

        class MyPrimitive(Primitive):
            def __init__(self):
                super().__init__(MyFrame)

        class MyPrimitive2(Primitive):
            def __init__(self):
                super().__init__(MyPrimitive)

        class MyFrame2(Frame):
            pass

        @MyFrame
        async def f1():
            MyPrimitive()

        test.run_frame(f1)

        @MyFrame2
        async def f2():
            MyPrimitive()

        test.run_frame(f2, assert_raises=InvalidOperationException)

        @MyFrame
        async def f3():
            await f2()

        test.run_frame(f3)

        @MyFrame
        async def f4():
            with test.assertRaises(TypeError):
                MyPrimitive2()

        test.run_frame(f4)

        with test.assertRaises(InvalidOperationException):
            MyPrimitive()

    def test_frameclassargs(self):
        test = self

        class MyFrame2(Frame):
            def __init__(self, param, kwparam):
                super().__init__()
                test.log.debug("param=%s" % param)
                test.log.debug("kwparam=%s" % kwparam)

        @MyFrame2('param_value', kwparam='kwparam_value')
        async def main():
            pass

        test.run_frame(main,
                       expected_log="""
            0.0: param=param_value
            0.0: kwparam=kwparam_value
            0.0: done
        """)

    def test_Frame_current(self):
        test = self

        @MyFrame
        async def frame(self):
            test.subframe_counter = 0
            test.assertEqual(_THREAD_LOCALS._current_frame, self)
            async_subframe()  # Test passive async frame
            test.assertEqual(_THREAD_LOCALS._current_frame, self)
            await async_subframe()  # Test active async frame
            test.assertEqual(_THREAD_LOCALS._current_frame, self)
            subframe()  # Test passive frame
            test.assertEqual(_THREAD_LOCALS._current_frame, self)

            @Frame
            async def remove_after(frame, seconds):
                await sleep(seconds)
                frame.remove()

            sf = subframe()
            remove_after(sf, 0.1)
            await sf  # Test active frame
            test.assertEqual(_THREAD_LOCALS._current_frame, self)

        @MyFrame
        async def async_subframe(self):
            test.assertEqual(_THREAD_LOCALS._current_frame, self)
            await sleep()
            test.subframe_counter += 1

        @MyFrame
        def subframe(self):
            test.assertEqual(_THREAD_LOCALS._current_frame, self)
            test.subframe_counter += 1

        test.run_frame(frame)
        test.assertEqual(test.subframe_counter, 4)

    def test_remove_self(self):
        test = self

        @Frame
        def frame(self):
            test.log.debug("1")
            self.remove()
            test.log.debug(
                "2"
            )  # Frame.remove() doesn't interrupt regular frame functions

        test.run_frame(frame,
                       expected_log="""
            0.0: 1
            0.0: 2
            0.0: done
        """)

        @Frame
        async def async_frame(self):
            test.log.debug("1")
            self.remove()
            test.log.debug("never reached"
                           )  # Frame.remove() interrupts async frame functions

        test.run_frame(async_frame,
                       expected_log="""
            0.0: 1
            0.0: done
        """)

    def test_pframe_remove(self):
        """Test removing self after handling a free event on another thread.

        Expected behaviour:
        After waking all frames that wait for frame_a.free, frame_a.remove
        should terminate frame_a's coroutine by raising GeneratorExit.

        Faced issue:
        After handling frame_a.free inside frame_b, frame_a raises GeneratorExit
        from thread 3. GeneratorExit should instead be raised from the thread
        that frame_a's coroutine is running on (thread 2).
        """

        test = self

        @Frame(thread_idx=2)
        async def frame_a(self):
            time.sleep(0.1)
            r = self.remove()
            time.sleep(0.1)
            await r
            test.log.debug("never reached"
                           )  # Frame.remove() interrupts async frame functions

        @Frame(thread_idx=3)
        async def frame_b(a):
            await a.free

        @Frame(thread_idx=1)
        async def main(self):
            a = frame_a()
            await (a & frame_b(a))

        test.run_frame(main,
                       expected_log="""
            0.2: done
        """)

    def test_reremove(self):
        test = self

        class MyPrimitive(Primitive):
            def __init__(self):
                super().__init__(Frame)

        @Frame
        async def remove_after(frame, seconds):
            await sleep(seconds)
            test.log.debug('Removing frame')
            test.assertEqual(await frame.remove(), True)
            test.log.debug('Re-removing frame')
            test.assertEqual(await frame.remove(), False)

        @Frame
        async def main(self):
            self.p = None

            @Frame
            async def primitive_owner():
                self.p = MyPrimitive()
                await sleep(0.0)
                test.log.debug('Removing primitive')

            primitive_owner()

            remove_after(self, 0.3)
            a = (self.free | sleep(0.1))
            await a
            test.log.debug('Re-removing any_')
            test.assertEqual(await a.remove(), False)

            s = sleep(0.1)
            a = (self.free & s)
            await a
            test.log.debug('Re-removing all_')
            test.assertEqual(await a.remove(), False)

            test.log.debug('Re-removing event source')
            test.assertEqual(await s.remove(), False)

            test.log.debug('Re-removing primitive')
            test.assertEqual(self.p.remove(), False)

            test.log.debug('Re-removing frame during frame.free event')
            test.assertEqual(await self.remove(), True)

        test.run_frame(main,
                       expected_log="""
            0.0: Removing primitive
            0.1: Re-removing any_
            0.3: Removing frame
            0.3: Re-removing all_
            0.3: Re-removing event source
            0.3: Re-removing primitive
            0.3: Re-removing frame during frame.free event
            0.3: Re-removing frame
            0.3: done
        """)

    def test_awaited_by_multiple(self):
        test = self

        @Frame
        async def waitfor(w):
            await w

        @Frame
        async def main1(self):
            w = wait(test, 0.1, '1')
            await (w & w)

        test.run_frame(main1)

        @Frame
        async def main2(self):
            w = wait(test, 0.1, '2')
            await (w | w)

        test.run_frame(main2)

        @Frame
        async def main3(self):
            w = sleep(0.1)
            a1 = waitfor(w)
            a2 = waitfor(w)
            await (a1 & a2)

        test.run_frame(main3)

        @Frame
        async def main4(self):
            w = wait(test, 0.1, '3')
            a1 = waitfor(w)
            a2 = waitfor(w)
            await (a1 & a2)

        test.run_frame(main4)

        @Frame
        async def main5(self):
            w = wait(test, 0.1, '4')
            a1 = waitfor(w)
            a2 = waitfor(w)
            await (a1 | a2)

        test.run_frame(main5)

        @Frame
        async def main6(self):
            s = sleep(0.1)
            await (s | s & s)

        test.run_frame(main6)

    def test_finished_before_await(self):
        test = self

        @Frame
        async def main():
            s = sleep(0.1)
            w = wait(test, 0.1, '1')
            await sleep(0.2)
            await s
            test.log.debug(await w)
            awaitable_repr = Awaitable.__repr__
            Awaitable.__repr__ = Awaitable.__str__
            test.log.debug(await (s | w))
            test.log.debug(await (s & w))
            Awaitable.__repr__ = awaitable_repr

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.2: some result
            0.2: (sleep(0.1), None)
            0.2: [None, 'some result']
            0.2: done
        """)

    def test_custom_event(self):
        test = self

        @Frame
        async def main(self):
            ae = Event('my event')

            send_event(0.1, ae)
            send_event(0.2, ae)
            sender, args = await ae
            test.log.debug("'%s' raised '%s' with args '%s'", sender, ae, args)
            sender, args = await ae
            test.log.debug("'%s' reraised '%s' with args '%s'", sender, ae,
                           args)

            post_event(0.1, ae)
            ae.post((self, 'my event args'), 0.2)
            sender, args = await ae
            test.log.debug("'%s' raised '%s' with args '%s'", sender, ae, args)
            sender, args = await ae
            test.log.debug("'%s' reraised '%s' with args '%s'", sender, ae,
                           args)

            threading.Thread(target=invoke_event, args=(0.1, ae)).start()
            threading.Thread(target=ae.post,
                             args=((self, 'my event args'), 0.2)).start()
            sender, args = await ae
            test.log.debug("'%s' raised '%s' with args '%s'", sender, ae, args)
            sender, args = await ae
            test.log.debug("'%s' reraised '%s' with args '%s'", sender, ae,
                           args)

        @Frame
        async def send_event(self, seconds, awaitable_event):
            await sleep(seconds)
            awaitable_event.send((self, 'my event args'))

        @Frame
        async def post_event(self, seconds, awaitable_event):
            await sleep(seconds)
            awaitable_event.post((self, 'my event args'))

        def invoke_event(seconds, awaitable_event):
            time.sleep(seconds)
            awaitable_event.post(('invoke_event', 'my event args'))

        test.run_frame(main,
                       expected_log="""
            0.1: 'send_event' raised 'my event' with args 'my event args'
            0.2: 'send_event' reraised 'my event' with args 'my event args'
            0.3: 'post_event' raised 'my event' with args 'my event args'
            0.4: 'main' reraised 'my event' with args 'my event args'
            0.5: 'invoke_event' raised 'my event' with args 'my event args'
            0.6: 'main' reraised 'my event' with args 'my event args'
            0.6: done
        """)

    def test_exceptions(self):
        test = self
        test.maxDiff = None

        @Frame
        async def raise_immediately():
            raise MyException()

        @Frame
        async def raise_delayed():
            await sleep(0.1)
            raise MyException()

        @Frame
        async def return_exception():
            return MyException()

        def suppressing_exception_handler(frame, err):
            if type(err) == MyException:
                test.log.debug("Suppressed {} of frame {}".format(
                    repr(err), frame))
            else:
                raise

        def reraising_exception_handler(frame, err):
            test.log.debug("Reraised {} of frame {}".format(repr(err), frame))
            raise

        # Test eventloop raising exception
        test.run_frame(raise_immediately, assert_raises=MyException)
        # Test eventloop returning exception
        test.assertEqual(type(test.run_frame(return_exception)), MyException)

        # Test event handling within eventloop
        @Frame
        async def main(self):
            self.exception_handler = suppressing_exception_handler
            for frame in [raise_immediately, raise_delayed, return_exception]:
                frame()
                hold() | frame()
                sleep() & frame()
                test.assertEqual(type(await frame()), MyException)
                test.assertEqual(tuple(map(type, await (hold() | frame()))),
                                 (frame.frameclass, MyException))
                test.assertEqual(tuple(map(type, await (sleep() & frame()))),
                                 (type(None), MyException))

            self.exception_handler = reraising_exception_handler
            frame = raise_delayed()
            frame.exception_handler = suppressing_exception_handler
            await frame

            #TODO: # Implement starting frames with exception handler
            #TODO:
            #TODO: * Option 1:
            #TODO:   with exception_handler(suppressing_exception_handler):
            #TODO:       raise_immediately()
            #TODO:
            #TODO: * Option 2:
            #TODO:   raise_immediately(exception_handler=suppressing_exception_handler)
            raise_immediately()  #TODO: ... instead of this line
            await sleep(0.2)

        test.run_frame(main,
                       assert_raises=MyException,
                       expected_log="""
            0.0: Suppressed MyException() of frame raise_immediately
            0.0: Suppressed MyException() of frame raise_immediately
            0.0: Suppressed MyException() of frame raise_immediately
            0.0: Suppressed MyException() of frame raise_immediately
            0.0: Suppressed MyException() of frame raise_immediately
            0.0: Suppressed MyException() of frame raise_immediately
            0.0: Suppressed MyException() of frame raise_delayed
            0.0: Suppressed MyException() of frame raise_delayed
            0.0: Suppressed MyException() of frame raise_delayed
            0.0: Suppressed MyException() of frame raise_delayed
            0.0: Suppressed MyException() of frame raise_delayed
            0.0: Suppressed MyException() of frame raise_delayed
            0.0: Suppressed MyException() of frame raise_delayed
            0.0: Reraised MyException() of frame raise_immediately
        """)

    def test_animate(self):
        test = self

        @Frame
        async def a():
            await animate(0.25, lambda f: test.log.debug(''), 0.1)

        @Frame
        async def main():
            await a()

        test.run_frame(main,
                       expected_log="""
            0.1
            0.2
            0.2
            0.2: done
        """)

    def test_unfinished_await(self):
        test = self

        @MyFrame
        async def frame():
            await subframe()
            await (subframe() | hold())
            await (subframe() & sleep())

        @MyFrame
        async def subframe():
            await sleep()
            await sleep()

        test.run_frame(frame)

    def test_rerun(self):
        test = self

        @Frame
        async def main():
            await wait(test, 0.1, 'main')

        @Frame
        def raise_exception():
            raise MyException

        test.run_frame(main,
                       expected_log="""
            0.1: main
            0.1: done
        """)
        test.run_frame(main,
                       expected_log="""
            0.1: main
            0.1: done
        """)
        test.run_frame(raise_exception, assert_raises=MyException)
        test.run_frame(main,
                       expected_log="""
            0.1: main
            0.1: done
        """)

    def test_meta(self):
        test = self

        @Frame
        async def main(self):
            test.assertEqual(str(self), "main")
            test.assertRegex(repr(self), r"<asyncframes.main object at 0x\w*>")

        test.run_frame(main)

    def test_invalid_usage(self):
        test = self

        @Frame
        def raise_already_running():
            test.loop.run(wait, test, 0.0, '', num_threads=NUM_THREADS)

        test.run_frame(
            raise_already_running,
            assert_raises_regex=(InvalidOperationException,
                                 "Another event loop is already running"))
        with test.assertRaisesRegex(
                InvalidOperationException,
                "Can't call frame without a running event loop"):
            wait(test, 0.0, '')

    def test_reawait(self):
        test = self

        @Frame
        async def main():
            s1 = sleep(0.1)
            s2 = sleep(0.2)
            s3 = sleep(0.3)
            test.assertEqual((await (s1 | s2))[0], s1)
            test.log.debug('1')
            test.assertEqual((await (s2 | s3))[0], s2)
            test.log.debug('2')
            test.assertEqual(await (s2 & s3), [None, None])
            test.log.debug('3')
            await s1
            await s2
            await s3
            test.log.debug('4')

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.2: 2
            0.3: 3
            0.3: 4
            0.3: done
        """)

    def test_ready(self):
        test = self

        @Frame
        async def case1():
            test.log.debug('case1_1')

        @Frame
        async def case2():
            test.log.debug('case2_1')
            await hold()
            test.log.debug('case2_2')

        @Frame
        async def case3():
            test.log.debug('case3_1')
            raise MyException()

        @Frame
        async def main(self):
            self.exception_handler = lambda frame, err: test.log.debug(
                "Frame exception caught: %s", repr(err))
            await case1().ready
            await case2().ready
            c3 = case3()
            test.assertEqual(tuple(map(type, await (c3.ready | c3))),
                             (Frame, MyException))
            test.assertFalse(c3.ready)

        test.run_frame(main,
                       expected_log="""
            0.0: case1_1
            0.0: case2_1
            0.0: case3_1
            0.0: Frame exception caught: MyException()
            0.0: done
        """)

    def test_recursive_ready(self):
        test = self

        @Frame
        async def frame1():
            @Frame
            async def frame2():
                @Frame
                async def frame3():
                    @Frame
                    async def frame4():
                        @Frame
                        async def frame5():
                            test.log.debug('frame5 ready')
                            await sleep()

                        test.log.debug('frame4 ready')
                        #TODO: Implement ready propagation through all_
                        # e.g.: await (frame5() & frame5() & sleep())
                        await frame5()

                    test.log.debug('frame3 ready')
                    #TODO: Implement ready propagation through any_
                    # e.g.: await (frame4() | hold())
                    await frame4()

                test.log.debug('frame2 ready')
                await frame3().ready

            test.log.debug('frame1 ready')
            await frame2()

        @Frame
        async def main(self):
            await frame1().ready

        test.run_frame(main,
                       expected_log="""
            0.0: frame1 ready
            0.0: frame2 ready
            0.0: frame3 ready
            0.0: frame4 ready
            0.0: frame5 ready
            0.0: done
        """)

    def test_free(self):
        test = self

        @Frame
        async def frame():
            sf = subframe()
            await sleep(0.1)
            sf.remove()

            sf = subframe()
            await sf.ready

        @Frame
        async def subframe(self):
            test.log.debug('1')
            await self.free
            test.log.debug('2')

        test.run_frame(frame,
                       expected_log="""
            0.0: 1
            0.1: 2
            0.1: 1
            0.1: 2
            0.1: done
        """)

    def test_cancel_free(self):
        test = self

        @Frame
        async def frame():
            sf = subframe()
            await sf.ready
            test.log.debug(
                await
                sf.remove())  # This will be canceled by subframe -> False
            test.log.debug(
                await
                sf.remove())  # This will also be canceled by subframe -> False
            test.log.debug(await
                           sf.remove())  # This will remove subframe -> True
            test.log.debug(await
                           sf.remove())  # This will have no effect -> False

        @Frame
        async def subframe(self):
            f = await self.free
            f.cancel = True
            f = await self.free
            f.cancel = True
            await self.free

        test.run_frame(frame,
                       expected_log="""
            0.0: False
            0.0: False
            0.0: True
            0.0: False
            0.0: done
        """)

    def test_cancel_child_free(self):
        test = self

        @Frame
        async def frame():
            sf = subframe()
            await sf.ready
            test.log.debug(await sf.remove(
            ))  # This will be canceled by subframe_child -> False
            test.log.debug(await sf.remove(
            ))  # This will also be canceled by subframe_child -> False
            test.log.debug(await sf.remove(
            ))  # This will remove subframe and subframe_child -> True
            test.log.debug(await
                           sf.remove())  # This will have no effect -> False

        @Frame
        async def subframe(self):
            @Frame
            async def subframe_child(self):
                f = await self.free
                f.cancel = True
                f = await self.free
                f.cancel = True
                await self.free

            await subframe_child().ready
            await hold()

        test.run_frame(frame,
                       expected_log="""
            0.0: False
            0.0: False
            0.0: True
            0.0: False
            0.0: done
        """)

    def test_delayed_await(self):
        test = self

        @Frame
        async def main(self):
            self.exception_handler = lambda frame, err: test.log.debug(
                "Frame exception caught: %s", repr(err))
            f = raise_exception()
            await sleep(0.1)
            await f
            test.log.debug('after exception')

        @Frame
        async def raise_exception():
            raise MyException

        test.run_frame(main,
                       expected_log="""
            0.0: Frame exception caught: MyException()
            0.1: after exception
            0.1: done
        """)

        test = self

        @Frame
        async def main():
            f = raise_exception()
            await sleep(0.1)
            await f
            test.log.debug('after exception')

        @Frame
        async def raise_exception():
            raise MyException

        test.run_frame(main, assert_raises=MyException)

    def test_startup_behaviour(self):
        test = self

        @Frame
        async def frame():
            sf = immediate_subframe()
            test.assertEqual(sf.var, 'value')
            await sf.ready
            test.assertEqual(sf.var, 'value')

            sf = delayed_subframe()
            with test.assertRaises(AttributeError):
                test.assertEqual(sf.var, 'value')
            await sf.ready
            test.assertEqual(sf.var, 'value')

        @Frame(startup_behaviour=FrameStartupBehaviour.immediate)
        async def immediate_subframe(self):
            self.var = 'value'

        @Frame(startup_behaviour=FrameStartupBehaviour.delayed)
        async def delayed_subframe(self):
            time.sleep(0.1)
            self.var = 'value'
            await sleep()

        test.run_frame(frame)

    def test_pframe(self):
        test = self

        @PFrame
        async def pframe():
            pframe_threadid = threading.get_ident()
            test.log.debug('pframe_1')
            await sleep(0.1)
            test.log.debug('pframe_2')
            await sleep(0.1)
            test.log.debug('pframe_3')

        @asyncframes.Frame  # This has to be a Frame to test successfully. Make sure it's a Frame even when 'Frame' is overwritten with 'PFrame'
        async def main():
            main_threadid = threading.get_ident()
            p = pframe()
            await p.ready
            test.assertEqual(threading.get_ident(), main_threadid)
            test.log.debug('main_1')
            await p
            test.assertEqual(threading.get_ident(), main_threadid)
            test.log.debug('main_2')

        test.run_frame(main,
                       expected_log="""
            0.0: pframe_1
            0.0: main_1
            0.1: pframe_2
            0.2: pframe_3
            0.2: main_2
            0.2: done
        """)

    def test_pframe_send(self):
        test = self

        @PFrame
        async def pframe(e):
            await e

        @PFrame
        async def pframe2(self):
            self.e = Event('my_event')
            await self.e

        @Frame
        async def main():
            e = Event('my_event')
            p = pframe(e)
            await p.ready
            e.send()
            test.assertEqual(p.removed, True)

            p2 = pframe2()
            await p2.ready
            p2.e.send()
            test.assertEqual(p2.removed, True)

        test.run_frame(main)

    def test_await_send(self):
        test = self

        @Frame(thread_idx=2)
        async def a(event):
            await event
            test.log.debug(1)

        @Frame(thread_idx=3)
        async def b(event):
            await a(event)

        @Frame
        async def main():
            event = Event("TODO")
            b(event)
            b(event)
            await sleep(0.1)
            await event.send()
            test.log.debug(2)

        test.run_frame(main,
                       expected_log="""
            0.1: 1
            0.1: 1
            0.1: 2
            0.1: done
        """)

    def test_send_across_threads(self):
        test = self

        @Frame(thread_idx=2)
        async def frame1(e):
            await e
            test.log.debug('1')

        @Frame(thread_idx=3)
        async def frame2(e):
            await e.send()
            test.log.debug('2')

        @Frame
        async def main(self):
            e = Event('my_event')
            f1 = frame1(e)
            await f1.ready
            f2 = frame2(e)
            await (f1 & f2)

        test.run_frame(main,
                       expected_log="""
            0.0: 1
            0.0: 2
            0.0: done
        """)

    def test_ready_across_threads(self):
        test = self

        @Frame(thread_idx=2)
        async def frame1():
            time.sleep(0.1)
            test.log.debug('2')
            await sleep(0.1)
            test.log.debug('4')

        @Frame(thread_idx=3)
        async def frame2(f1):
            test.log.debug('1')
            await f1.ready
            test.log.debug('3')

        @Frame
        async def main(self):
            f1 = frame1()
            f2 = frame2(f1)
            await (f1 & f2)

        test.run_frame(main,
                       expected_log="""
            0.0: 1
            0.1: 2
            0.1: 3
            0.2: 4
            0.2: done
        """)

    def test_free_across_threads(self):
        """Test awaiting the free event from a thread different than the one
        from the removed frame.

        Test status:
        Deterministic

        Expected behaviour:
        When frame f1 is to be removed, all code between `await f1.free` and the
        next await or the end of the frame should be executed before f1 is
        actually removed. This behaviour allows cleanup code to run before the
        frame is removed.

        Faced issue:
        Send is expected to only return once the event has been handled. This
        does not apply when sending across threads. If the awaiting frame runs
        on another thread than the sending frame, send() behaves like post(). It
        would violate the thread-restriction to directly execute the awaiting
        frame. Instead, it posts the request into the awaiting thread's
        eventloop and returns before the posted request is handled.
        """

        test = self

        @Frame(thread_idx=2)
        async def frame1():
            await sleep(0.1)
            test.log.debug('2')

        @Frame(thread_idx=3)
        async def frame2(f1):
            test.log.debug('1')
            await f1.free
            time.sleep(0.1)
            test.log.debug('3 ' + str(f1.removed))

        @Frame
        async def main(self):
            f1 = frame1()
            await frame2(f1)

        test.run_frame(main,
                       expected_log="""
            0.0: 1
            0.1: 2
            0.2: 3 False
            0.2: done
        """)

    def test_remove_across_threads(self):
        """Test removing a frame from another thread."""

        test = self

        @Frame(thread_idx=2)
        async def frame1(self):
            await self.free
            test.log.debug('2 ' + str(self.removed))

        @Frame(thread_idx=3)
        async def frame2(f1):
            test.log.debug(1)
            time.sleep(0.1)
            await f1.remove()
            test.log.debug(3)

        @Frame
        async def main(self):
            f1 = frame1()
            await frame2(f1)

        test.run_frame(main,
                       expected_log="""
            0.0: 1
            0.1: 2 False
            0.1: 3
            0.1: done
        """)

    def test_inline_frame(self):
        test = self

        @Frame
        async def main(self):
            # Inlining a frame class without arguments
            with MyFrame as f1:
                test.assertEqual(Primitive(Frame)._owner, f1)
                with MyFrame as f2:
                    test.assertEqual(Primitive(Frame)._owner, f2)
                    await sleep(0)
                    test.assertEqual(Primitive(Frame)._owner, f2)
                test.assertEqual(Primitive(Frame)._owner, f1)
            test.assertEqual(Primitive(Frame)._owner, self)

            # Inlining a frame class with arguments
            with MyFrame() as f1:
                test.assertEqual(Primitive(Frame)._owner, f1)
                with MyFrame() as f2:
                    test.assertEqual(Primitive(Frame)._owner, f2)
                    await sleep(0)
                    test.assertEqual(Primitive(Frame)._owner, f2)
                test.assertEqual(Primitive(Frame)._owner, f1)
            test.assertEqual(Primitive(Frame)._owner, self)

            # Inlining an existing frame
            @MyFrame
            def subframe():
                test.log.debug('1')

            with subframe as f1:
                test.log.debug('2')
                test.assertEqual(Primitive(Frame)._owner, f1)
                with MyFrame as f2:
                    test.assertEqual(Primitive(Frame)._owner, f2)
                    await sleep(0)
                    test.assertEqual(Primitive(Frame)._owner, f2)
                test.assertEqual(Primitive(Frame)._owner, f1)

            # Using inlining to inject an exception handler
            #TODO: When using PFrame's, there is no guarantee that the handler gets injected before the frame is started
            @MyFrame
            async def subframe2():
                raise MyException

            with subframe2 as s2:
                s2.exception_handler = lambda frame, err: test.log.debug(
                    "Frame exception caught: %s", repr(err))
            await s2

        test.run_frame(main,
                       expected_log="""
            0.0: 1
            0.0: 2
            0.0: Frame exception caught: MyException()
            0.0: done
        """)

    @unittest.skip(
        "Parallel testing tends to fail randomly due to unstable timing")
    def test_thread_independence(self):
        test = self
        errors = queue.Queue()

        def test_thread(tc):
            try:
                test.__class__(tc).debug()
            except unittest.SkipTest:
                pass
            except Exception as err:
                errors.put(err)

        testcases = unittest.defaultTestLoader.getTestCaseNames(test.__class__)
        testcases.remove('test_thread_independence')

        threads = [
            threading.Thread(target=test_thread, args=(testcase, ))
            for testcase in testcases
        ]
        for thread in threads:
            thread.daemon = True
            thread.start()
            time.sleep(
                0.1
            )  # Delay test starts to reduce the effect of startup latency on code timings
        endtime = datetime.datetime.now() + datetime.timedelta(
            seconds=5)  # Limit processing time to 5 seconds
        for thread in threads:
            thread.join(
                max(0, (endtime - datetime.datetime.now()).total_seconds()))

        for i, thread in enumerate(threads):
            if thread.is_alive():
                print(testcases[i] + " did not finish")

        if not errors.empty():
            raise Exception(str(errors.qsize()) +
                            " test cases failed") from errors.get()