Add permissions.OperandHolder to decorators.permission_classes signature (#162)

* Add permissions.OperandHolder to decorators.permission_classes signature

* Test decorators.permission_classes signature

* Test decorators.permission_classes with operators

Author: kontsaki

rest_framework-stubs/decorators.pyi

@@ -3,7 +3,7 @@ from typing import Any, Callable, List, Mapping, Optional, Sequence, Type, Union
 from django.http.response import HttpResponseBase
 from rest_framework.authentication import BaseAuthentication
 from rest_framework.parsers import BaseParser
-from rest_framework.permissions import BasePermission
+from rest_framework.permissions import _PermissionClass
 from rest_framework.renderers import BaseRenderer
 from rest_framework.schemas.inspectors import ViewInspector
 from rest_framework.throttling import BaseThrottle
@@ -75,9 +75,7 @@ def authentication_classes(
 def throttle_classes(
     throttle_classes: Sequence[Union[BaseThrottle, Type[BaseThrottle]]]
 ) -> Callable[[_View], _View]: ...
-def permission_classes(
-    permission_classes: Sequence[Union[BasePermission, Type[BasePermission]]]
-) -> Callable[[_View], _View]: ...
+def permission_classes(permission_classes: Sequence[_PermissionClass]) -> Callable[[_View], _View]: ...
 def schema(view_inspector: Optional[Union[ViewInspector, Type[ViewInspector]]]) -> Callable[[_View], _View]: ...
 def action(
     methods: Optional[_MIXED_CASE_HTTP_VERBS] = ...,

tests/typecheck/test_decorators.yml

@@ -24,3 +24,20 @@
         from rest_framework.decorators import api_view
         @api_view()  # E: Value of type variable "_View" of function cannot be "Callable[[Any], List[Any]]"
         def view_func2(request) -> list: ...
+
+-   case: permission_classes
+    main: |
+        from rest_framework.decorators import permission_classes
+        reveal_type(permission_classes) # N: Revealed type is "def (permission_classes: typing.Sequence[Union[Type[rest_framework.permissions.BasePermission], rest_framework.permissions.OperandHolder, rest_framework.permissions.SingleOperandHolder]]) -> def [_View <: def (*Any, **Any) -> django.http.response.HttpResponseBase] (_View`-1) -> _View`-1"
+
+-   case: permission_classes_with_operators
+    main: |
+        from rest_framework.permissions import BasePermission, IsAuthenticated
+        from rest_framework.decorators import permission_classes
+
+        class Permission(BasePermission):
+            pass
+
+        permission_classes([IsAuthenticated & Permission])
+        permission_classes([IsAuthenticated | Permission])
+        permission_classes([~Permission])