update NoReturn to Never mypy 1.11.0 (#1889)

Author: JuliaBars

docs/pages/interfaces.rst

@@ -31,14 +31,14 @@ for example, can have one, two or three possible types. See the example below:
 
 .. code:: python
 
-  >>> from typing import NoReturn
+  >>> from typing_extensions import Never
 
   >>> from returns.interfaces.mappable import (
   ...    MappableN, Mappable1, Mappable2, Mappable3,
   ... )
 
-  >>> one_type: MappableN[int, NoReturn, NoReturn]
-  >>> two_types: MappableN[int, str, NoReturn]
+  >>> one_type: MappableN[int, Never, Never]
+  >>> two_types: MappableN[int, str, Never]
   >>> three_types: MappableN[int, str, bool]
 
   >>> # We have a shortcut for each amount of arguments to reduce the boilerplate

returns/functions.py

@@ -1,7 +1,7 @@
 from functools import wraps
-from typing import Any, Callable, NoReturn, TypeVar
+from typing import Any, Callable, TypeVar
 
-from typing_extensions import ParamSpec
+from typing_extensions import Never, ParamSpec
 
 _FirstType = TypeVar('_FirstType')
 _SecondType = TypeVar('_SecondType')
@@ -105,7 +105,7 @@ def decorator(argument_to_return: _FirstType) -> None:
     return decorator
 
 
-def raise_exception(exception: Exception) -> NoReturn:
+def raise_exception(exception: Exception) -> Never:
     """
     Helper function to raise exceptions as a function.
 

returns/interfaces/altable.py

@@ -1,13 +1,7 @@
 from abc import abstractmethod
-from typing import (
-    Callable,
-    ClassVar,
-    Generic,
-    NoReturn,
-    Sequence,
-    TypeVar,
-    final,
-)
+from typing import Callable, ClassVar, Generic, Sequence, TypeVar, final
+
+from typing_extensions import Never
 
 from returns.functions import compose, identity
 from returns.primitives.asserts import assert_equal
@@ -85,7 +79,7 @@ def alt(
 
 
 #: Type alias for kinds with two type arguments.
-Altable2 = AltableN[_FirstType, _SecondType, NoReturn]
+Altable2 = AltableN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 Altable3 = AltableN[_FirstType, _SecondType, _ThirdType]

returns/interfaces/applicative.py

@@ -1,5 +1,7 @@
 from abc import abstractmethod
-from typing import Callable, ClassVar, NoReturn, Sequence, Type, TypeVar, final
+from typing import Callable, ClassVar, Sequence, Type, TypeVar, final
+
+from typing_extensions import Never
 
 from returns.functions import compose, identity
 from returns.interfaces import mappable
@@ -162,10 +164,10 @@ def from_value(
 
 
 #: Type alias for kinds with one type argument.
-Applicative1 = ApplicativeN[_FirstType, NoReturn, NoReturn]
+Applicative1 = ApplicativeN[_FirstType, Never, Never]
 
 #: Type alias for kinds with two type arguments.
-Applicative2 = ApplicativeN[_FirstType, _SecondType, NoReturn]
+Applicative2 = ApplicativeN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 Applicative3 = ApplicativeN[_FirstType, _SecondType, _ThirdType]

returns/interfaces/bimappable.py

@@ -1,4 +1,6 @@
-from typing import NoReturn, TypeVar
+from typing import TypeVar
+
+from typing_extensions import Never
 
 from returns.interfaces import altable, mappable
 
@@ -25,7 +27,7 @@ class BiMappableN(
 
 
 #: Type alias for kinds with two type arguments.
-BiMappable2 = BiMappableN[_FirstType, _SecondType, NoReturn]
+BiMappable2 = BiMappableN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 BiMappable3 = BiMappableN[_FirstType, _SecondType, _ThirdType]

returns/interfaces/bindable.py

@@ -1,5 +1,7 @@
 from abc import abstractmethod
-from typing import Callable, Generic, NoReturn, TypeVar
+from typing import Callable, Generic, TypeVar
+
+from typing_extensions import Never
 
 from returns.primitives.hkt import KindN
 
@@ -41,10 +43,10 @@ def bind(
 
 
 #: Type alias for kinds with one type argument.
-Bindable1 = BindableN[_FirstType, NoReturn, NoReturn]
+Bindable1 = BindableN[_FirstType, Never, Never]
 
 #: Type alias for kinds with two type arguments.
-Bindable2 = BindableN[_FirstType, _SecondType, NoReturn]
+Bindable2 = BindableN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 Bindable3 = BindableN[_FirstType, _SecondType, _ThirdType]

returns/interfaces/container.py

@@ -1,4 +1,6 @@
-from typing import Callable, ClassVar, NoReturn, Sequence, TypeVar, final
+from typing import Callable, ClassVar, Sequence, TypeVar, final
+
+from typing_extensions import Never
 
 from returns.interfaces import applicative, bindable
 from returns.primitives.asserts import assert_equal
@@ -121,10 +123,10 @@ class ContainerN(
 
 
 #: Type alias for kinds with one type argument.
-Container1 = ContainerN[_FirstType, NoReturn, NoReturn]
+Container1 = ContainerN[_FirstType, Never, Never]
 
 #: Type alias for kinds with two type arguments.
-Container2 = ContainerN[_FirstType, _SecondType, NoReturn]
+Container2 = ContainerN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 Container3 = ContainerN[_FirstType, _SecondType, _ThirdType]

returns/interfaces/failable.py

@@ -1,5 +1,7 @@
 from abc import abstractmethod
-from typing import Callable, ClassVar, NoReturn, Sequence, Type, TypeVar, final
+from typing import Callable, ClassVar, Sequence, Type, TypeVar, final
+
+from typing_extensions import Never
 
 from returns.interfaces import container as _container
 from returns.interfaces import lashable, swappable
@@ -73,7 +75,7 @@ class FailableN(
 
 
 #: Type alias for kinds with two type arguments.
-Failable2 = FailableN[_FirstType, _SecondType, NoReturn]
+Failable2 = FailableN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 Failable3 = FailableN[_FirstType, _SecondType, _ThirdType]
@@ -154,7 +156,7 @@ def empty(
 
 
 #: Type alias for kinds with two types arguments.
-SingleFailable2 = SingleFailableN[_FirstType, _SecondType, NoReturn]
+SingleFailable2 = SingleFailableN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 SingleFailable3 = SingleFailableN[_FirstType, _SecondType, _ThirdType]
@@ -258,7 +260,7 @@ def from_failure(
 
 
 #: Type alias for kinds with two type arguments.
-DiverseFailable2 = DiverseFailableN[_FirstType, _SecondType, NoReturn]
+DiverseFailable2 = DiverseFailableN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 DiverseFailable3 = DiverseFailableN[_FirstType, _SecondType, _ThirdType]

returns/interfaces/lashable.py

@@ -1,5 +1,7 @@
 from abc import abstractmethod
-from typing import Callable, Generic, NoReturn, TypeVar
+from typing import Callable, Generic, TypeVar
+
+from typing_extensions import Never
 
 from returns.primitives.hkt import KindN
 
@@ -41,7 +43,7 @@ def lash(
 
 
 #: Type alias for kinds with two type arguments.
-Lashable2 = LashableN[_FirstType, _SecondType, NoReturn]
+Lashable2 = LashableN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 Lashable3 = LashableN[_FirstType, _SecondType, _ThirdType]

returns/interfaces/mappable.py

@@ -1,13 +1,7 @@
 from abc import abstractmethod
-from typing import (
-    Callable,
-    ClassVar,
-    Generic,
-    NoReturn,
-    Sequence,
-    TypeVar,
-    final,
-)
+from typing import Callable, ClassVar, Generic, Sequence, TypeVar, final
+
+from typing_extensions import Never
 
 from returns.functions import compose, identity
 from returns.primitives.asserts import assert_equal
@@ -93,10 +87,10 @@ def map(
 
 
 #: Type alias for kinds with one type argument.
-Mappable1 = MappableN[_FirstType, NoReturn, NoReturn]
+Mappable1 = MappableN[_FirstType, Never, Never]
 
 #: Type alias for kinds with two type arguments.
-Mappable2 = MappableN[_FirstType, _SecondType, NoReturn]
+Mappable2 = MappableN[_FirstType, _SecondType, Never]
 
 #: Type alias for kinds with three type arguments.
 Mappable3 = MappableN[_FirstType, _SecondType, _ThirdType]