Add type stub for decorator lib (#3038)

Author: RafiB

third_party/2and3/decorator.pyi

@@ -0,0 +1,83 @@
+import sys
+from typing import Any, Callable, Dict, List, NamedTuple, Optional, Pattern, Text, Tuple, TypeVar
+
+_C = TypeVar("_C", bound=Callable[..., Any])
+_Func = TypeVar("_Func", bound=Callable[..., Any])
+
+def get_init(cls): ...
+
+if sys.version_info >= (3,):
+    from inspect import iscoroutinefunction as iscoroutinefunction
+    from inspect import getfullargspec as getfullargspec
+else:
+    FullArgSpec = NamedTuple('FullArgSpec', [('args', List[str]),
+                                             ('varargs', Optional[str]),
+                                             ('varkw', Optional[str]),
+                                             ('defaults', Tuple[Any, ...]),
+                                             ('kwonlyargs', List[str]),
+                                             ('kwonlydefaults', Dict[str, Any]),
+                                             ('annotations', Dict[str, Any]),
+                                             ])
+    def iscoroutinefunction(f: Callable[..., Any]) -> bool: ...
+    def getfullargspec(func: Any) -> FullArgSpec: ...
+
+if sys.version_info >= (3, 2):
+    from contextlib import _GeneratorContextManager
+else:
+    from contextlib import GeneratorContextManager as _GeneratorContextManager
+
+DEF: Pattern[str]
+
+class FunctionMaker(object):
+    args: List[Text]
+    varargs: Optional[Text]
+    varkw: Optional[Text]
+    defaults: Tuple[Any, ...]
+    kwonlyargs: List[Text]
+    kwonlydefaults: Optional[Text]
+    shortsignature: Optional[Text]
+    name: Text
+    doc: Optional[Text]
+    module: Optional[Text]
+    annotations: Dict[Text, Any]
+    signature: Text
+    dict: Dict[Text, Any]
+    def __init__(
+        self,
+        func: Optional[Callable[..., Any]] = ...,
+        name: Optional[Text] = ...,
+        signature: Optional[Text] = ...,
+        defaults: Optional[Tuple[Any, ...]] = ...,
+        doc: Optional[Text] = ...,
+        module: Optional[Text] = ...,
+        funcdict: Optional[Dict[Text, Any]] = ...
+    ) -> None: ...
+    def update(self, func: Any, **kw: Any) -> None: ...
+    def make(
+        self,
+        src_templ: Text,
+        evaldict: Optional[Dict[Text, Any]] = ...,
+        addsource: bool = ...,
+        **attrs: Any
+    ) -> Callable[..., Any]: ...
+    @classmethod
+    def create(
+        cls,
+        obj: Any,
+        body: Text,
+        evaldict: Dict[Text, Any],
+        defaults: Optional[Tuple[Any, ...]] = ...,
+        doc: Optional[Text] = ...,
+        module: Optional[Text] = ...,
+        addsource: bool = ...,
+        **attrs: Any
+    ) -> Callable[..., Any]: ...
+
+def decorate(func: _Func, caller: Callable[..., Any], extras: Any = ...) -> _Func: ...
+def decorator(caller: Callable[..., Any], _func: Optional[Callable[..., Any]] = ...) -> Callable[[_C], _C]: ...
+
+class ContextManager(_GeneratorContextManager[Any]):
+    def __call__(self, func: _C) -> _C: ...
+
+def contextmanager(func: _C) -> _C: ...
+def dispatch_on(*dispatch_args: Any) -> Callable[[Callable[..., Any]], Callable[..., Any]]: ...