]> granicus.if.org Git - python/commit
bpo-32972: Async test case (GH-13386)
authorAndrew Svetlov <andrew.svetlov@gmail.com>
Wed, 29 May 2019 09:33:59 +0000 (12:33 +0300)
committerMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Wed, 29 May 2019 09:33:59 +0000 (02:33 -0700)
commit4dd3e3f9bbd320f0dd556688e04db0a6b55a7b52
tree405a7629dbb3ef8e53cfa873443ec4eacdf3a1b5
parent7d408697a96953a182328ec0b0650e9999da4116
bpo-32972: Async test case (GH-13386)

Add explicit `asyncSetUp` and `asyncTearDown` methods.
The rest is the same as for #13228

`AsyncTestCase` create a loop instance for every test for the sake of test isolation.
Sometimes a loop shared between all tests can speed up tests execution time a lot but it requires control of closed resources after every test finish. Basically, it requires nested supervisors support that was discussed with @1st1 many times. Sorry, asyncio supervisors have no chance to land on Python 3.8.

The PR intentionally does not provide API for changing the used event loop or getting the test loop: use `asyncio.set_event_loop_policy()` and `asyncio.get_event_loop()` instead.

The PR adds four overridable methods to base `unittest.TestCase` class:
```
    def _callSetUp(self):
        self.setUp()

    def _callTestMethod(self, method):
        method()

    def _callTearDown(self):
        self.tearDown()

    def _callCleanup(self, function, /, *args, **kwargs):
        function(*args, **kwargs)
```
It allows using asyncio facilities with minimal influence on the unittest code.

The last but not least: the PR respects contextvars. The context variable installed by `asyncSetUp` is available on test, `tearDown` and a coroutine scheduled by `addCleanup`.

https://bugs.python.org/issue32972
Lib/test/test_support.py
Lib/unittest/__init__.py
Lib/unittest/async_case.py [new file with mode: 0644]
Lib/unittest/case.py
Lib/unittest/test/test_async_case.py [new file with mode: 0644]
Misc/NEWS.d/next/Library/2019-05-20-14-47-55.bpo-32972.LoeUNh.rst [new file with mode: 0644]