Add type stub for decorator lib

Author: Raf Blecher

third_party/2and3/decorator.pyi

@@ -0,0 +1,85 @@
+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): ...
+
+# Duplicated from `stdlib/3/inspect.pyi`
+FullArgSpec = NamedTuple('FullArgSpec', [('args', List[str]),
+                                         ('varargs', Optional[str]),
+                                         ('varkw', Optional[str]),
+                                         ('defaults', tuple),
+                                         ('kwonlyargs', List[str]),
+                                         ('kwonlydefaults', Dict[str, Any]),
+                                         ('annotations', Dict[str, Any]),
+                                         ])
+
+if sys.version_info >= (3,):
+    iscoroutinefunction: Callable[[Callable[..., Any]], bool] = ...  # really inspect.iscoroutinefunction
+    getfullargspec: Callable[[Any], FullArgSpec] = ...  # really inspect.getfullargspec
+else:
+    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[Text]
+
+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: Dict[Text, 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):
+    def __call__(self, func: _C) -> _C: ...
+
+def contextmanager(func: _C) -> _C: ...
+def dispatch_on(*dispatch_args: Any) -> Callable[[Callable[..., Any]], Callable[..., Any]]: ...