From 36f066a9747afdbc2e9376db90ae8d66399521ff Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Thu, 24 May 2018 21:56:24 -0700 Subject: [PATCH] Document typing.NoReturn (GH-7107) (cherry picked from commit 6e413f4327a68c4c7d62e0b6d0f9144be11dd6cd) Co-authored-by: Ivan Levkivskyi --- Doc/library/typing.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index 4a8f2f8e12e6..bd6f3a95fe62 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -938,6 +938,18 @@ The module defines the following classes, functions and decorators: * Every type is compatible with :data:`Any`. * :data:`Any` is compatible with every type. +.. data:: NoReturn + + Special type indicating that a function never returns. + For example:: + + from typing import NoReturn + + def stop() -> NoReturn: + raise RuntimeError('no way') + + .. versionadded:: 3.6.5 + .. data:: Union Union type; ``Union[X, Y]`` means either X or Y. -- 2.47.3