From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 25 May 2018 04:56:24 +0000 (-0700)
Subject: Document typing.NoReturn (GH-7107)
X-Git-Tag: v3.6.6rc1~99
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=36f066a9747afdbc2e9376db90ae8d66399521ff;p=python

Document typing.NoReturn (GH-7107)

(cherry picked from commit 6e413f4327a68c4c7d62e0b6d0f9144be11dd6cd)

Co-authored-by: Ivan Levkivskyi <levkivskyi@gmail.com>
---

diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 4a8f2f8e12..bd6f3a95fe 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.