]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.13] gh-134664: document `cleanup_socket` parameter in `asyncio.start_unix_server...
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Tue, 27 May 2025 08:34:29 +0000 (10:34 +0200)
committerGitHub <noreply@github.com>
Tue, 27 May 2025 08:34:29 +0000 (14:04 +0530)
gh-134664: document `cleanup_socket` parameter in `asyncio.start_unix_server` (GH-134750)
(cherry picked from commit 92ea1eb38ff97ac046a0031d505c30a51f58a43f)

Co-authored-by: Shamil <ashm.tech@proton.me>
Doc/library/asyncio-stream.rst

index c56166cabb909361d58370cb7d0dbff1a91a5588..90c90862ca1ed3abe58dc0a21cf3011c402c33f7 100644 (file)
@@ -171,13 +171,17 @@ and work with streams:
 .. function:: start_unix_server(client_connected_cb, path=None, \
                  *, limit=None, sock=None, backlog=100, ssl=None, \
                  ssl_handshake_timeout=None, \
-                 ssl_shutdown_timeout=None, start_serving=True)
+                 ssl_shutdown_timeout=None, start_serving=True, cleanup_socket=True)
    :async:
 
    Start a Unix socket server.
 
    Similar to :func:`start_server` but works with Unix sockets.
 
+   If *cleanup_socket* is true then the Unix socket will automatically
+   be removed from the filesystem when the server is closed, unless the
+   socket has been replaced after the server has been created.
+
    See also the documentation of :meth:`loop.create_unix_server`.
 
    .. note::
@@ -198,6 +202,9 @@ and work with streams:
    .. versionchanged:: 3.11
       Added the *ssl_shutdown_timeout* parameter.
 
+   .. versionchanged:: 3.13
+      Added the *cleanup_socket* parameter.
+
 
 StreamReader
 ============