https://github.com/python/cpython/commit/c6bc883c960a24ccc8f27a475651e9f7cdfee69a commit: c6bc883c960a24ccc8f27a475651e9f7cdfee69a branch: 3.14 author: Miss Islington (bot) <[email protected]> committer: hugovk <[email protected]> date: 2026-10-29T11:42:06+02:00 summary:
[3.14] gh-151950: Document `asyncio.BaseEventLoop` and fix `asyncio-extending.rst` (GH-151976) (#160868) Co-authored-by: sobolevn <[email protected]> Co-authored-by: Stan Ulbrych <[email protected]> Co-authored-by: Hugo van Kemenade <[email protected]> Co-authored-by: Andrew Svetlov <[email protected]> files: M Doc/library/asyncio-eventloop.rst M Doc/library/asyncio-extending.rst M Doc/tools/.nitignore diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst index 3912b4cf59949b..a5065817f34ae6 100644 --- a/Doc/library/asyncio-eventloop.rst +++ b/Doc/library/asyncio-eventloop.rst @@ -1967,6 +1967,17 @@ By default asyncio is configured to use :class:`EventLoop`. methods that an alternative implementation of ``AbstractEventLoop`` should have defined. +.. class:: BaseEventLoop + + A base class that partially implements :class:`AbstractEventLoop` + to simplify writing custom event loops. + + It provides default implementations of many :class:`AbstractEventLoop` + methods, so subclasses have fewer methods to implement themselves. + In return, a subclass is expected to implement a number of internal, + protected methods. + See :ref:`writing_custom_event_loop` for more information. + Examples ======== diff --git a/Doc/library/asyncio-extending.rst b/Doc/library/asyncio-extending.rst index e7b293f484f8de..0be79359b75e32 100644 --- a/Doc/library/asyncio-extending.rst +++ b/Doc/library/asyncio-extending.rst @@ -12,14 +12,17 @@ classes. Asyncio has helpers that could be used to simplify this task. Third-parties should reuse existing asyncio code with caution, a new Python version is free to break backward compatibility - in *internal* part of API. + in the *internal* part of the API. -Writing a Custom Event Loop +.. _writing_custom_event_loop: + +Writing a custom event loop =========================== -:class:`asyncio.AbstractEventLoop` declares very many methods. Implementing all them -from scratch is a tedious job. +:class:`asyncio.AbstractEventLoop` declares very many methods. +See :ref:`asyncio-event-loop-methods` for the full list. +Implementing them all from scratch is a tedious job. A loop can get many common methods implementation for free by inheriting from :class:`asyncio.BaseEventLoop`. diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore index f0cd9c65f41309..c49629da61f140 100644 --- a/Doc/tools/.nitignore +++ b/Doc/tools/.nitignore @@ -4,7 +4,6 @@ Doc/c-api/module.rst Doc/library/ast.rst -Doc/library/asyncio-extending.rst Doc/library/logging.config.rst Doc/library/logging.handlers.rst Doc/library/multiprocessing.rst _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
