add (overwrite with) mypy stubs, if available

stdlib/2.7/subprocess.pyi

@@ -0,0 +1,79 @@
+# Stubs for subprocess
+
+# Based on http://docs.python.org/2/library/subprocess.html and Python 3 stub
+
+from typing import Sequence, Any, Mapping, Callable, Tuple, IO, Union, Optional
+
+_FILE = Union[int, IO[Any]]
+
+# TODO force keyword arguments
+# TODO more keyword arguments (from Popen)
+def call(args: Sequence[str], *,
+         stdin: _FILE = None, stdout: _FILE = None, stderr: _FILE = None,
+         shell: bool = False, env: Mapping[str, str] = None,
+         cwd: str = None) -> int: ...
+def check_call(args: Sequence[str], *,
+               stdin: _FILE = None, stdout: _FILE = None, stderr: _FILE = None,
+               shell: bool = False, env: Mapping[str, str] = None, cwd: str = None,
+               close_fds: Sequence[_FILE] = None, preexec_fn: Callable[[], Any] = None) -> int: ...
+def check_output(args: Sequence[str], *,
+                 stdin: _FILE = None, stderr: _FILE = None,
+                 shell: bool = False, universal_newlines: bool = False,
+                 env: Mapping[str, str] = None, cwd: str = None) -> str: ...
+
+PIPE = ... # type: int
+STDOUT = ... # type: int
+
+class CalledProcessError(Exception):
+    returncode = 0
+    cmd = ''
+    output = '' # May be None
+
+    def __init__(self, returncode: int, cmd: str, output: str) -> None: ...
+
+class Popen:
+    stdin = ... # type: Optional[IO[Any]]
+    stdout = ... # type: Optional[IO[Any]]
+    stderr = ... # type: Optional[IO[Any]]
+    pid = 0
+    returncode = 0
+
+    def __init__(self,
+                 args: Sequence[str],
+                 bufsize: int = 0,
+                 executable: str = None,
+                 stdin: _FILE = None,
+                 stdout: _FILE = None,
+                 stderr: _FILE = None,
+                 preexec_fn: Callable[[], Any] = None,
+                 close_fds: bool = False,
+                 shell: bool = False,
+                 cwd: str = None,
+                 env: Mapping[str, str] = None,
+                 universal_newlines: bool = False,
+                 startupinfo: Any = None,
+                 creationflags: int = 0) -> None: ...
+
+    def poll(self) -> int: ...
+    def wait(self) -> int: ...
+    # Return str/bytes
+    def communicate(self, input: str = None) -> Tuple[str, str]: ...
+    def send_signal(self, signal: int) -> None: ...
+    def terminatate(self) -> None: ...
+    def kill(self) -> None: ...
+    def __enter__(self) -> 'Popen': ...
+    def __exit__(self, type, value, traceback) -> bool: ...
+
+def getstatusoutput(cmd: str) -> Tuple[int, str]: ...
+def getoutput(cmd: str) -> str: ...
+
+# Windows-only: STARTUPINFO etc.
+
+STD_INPUT_HANDLE = ... # type: Any
+STD_OUTPUT_HANDLE = ... # type: Any
+STD_ERROR_HANDLE = ... # type: Any
+SW_HIDE = ... # type: Any
+STARTF_USESTDHANDLES = ... # type: Any
+STARTF_USESHOWWINDOW = ... # type: Any
+CREATE_NEW_CONSOLE = ... # type: Any
+CREATE_NEW_PROCESS_GROUP = ... # type: Any