add (overwrite with) mypy stubs, if available

stdlib/3/difflib.pyi

@@ -0,0 +1,61 @@
+# Stubs for difflib
+
+# Based on https://docs.python.org/3.2/library/difflib.html
+
+from typing import (
+    TypeVar, Callable, Iterable, List, NamedTuple, Sequence, Tuple, Generic
+)
+
+_T = TypeVar('_T')
+
+class SequenceMatcher(Generic[_T]):
+    def __init__(self, isjunk: Callable[[_T], bool] = None,
+                 a: Sequence[_T] = ..., b: Sequence[_T] = ...,
+                 autojunk: bool = True) -> None: ...
+    def set_seqs(self, a: Sequence[_T], b: Sequence[_T]) -> None: ...
+    def set_seq1(self, a: Sequence[_T]) -> None: ...
+    def set_seq2(self, b: Sequence[_T]) -> None: ...
+    def find_longest_match(self, alo: int, ahi: int, blo: int,
+                           bhi: int) -> Tuple[int, int, int]: ...
+    def get_matching_blocks(self) -> List[Tuple[int, int, int]]: ...
+    def get_opcodes(self) -> List[Tuple[str, int, int, int, int]]: ...
+    def get_grouped_opcodes(self, n: int = 3
+                            ) -> Iterable[Tuple[str, int, int, int, int]]: ...
+    def ratio(self) -> float: ...
+    def quick_ratio(self) -> float: ...
+    def real_quick_ratio(self) -> float: ...
+
+def get_close_matches(word: Sequence[_T], possibilities: List[Sequence[_T]],
+                      n: int = 3, cutoff: float = 0.6) -> List[Sequence[_T]]: ...
+
+class Differ:
+    def __init__(self, linejunk: Callable[[str], bool] = None,
+                 charjunk: Callable[[str], bool] = None) -> None: ...
+    def compare(self, a: Sequence[str], b: Sequence[str]) -> Iterable[str]: ...
+
+def IS_LINE_JUNK(str) -> bool: ...
+def IS_CHARACTER_JUNK(str) -> bool: ...
+def unified_diff(a: Sequence[str], b: Sequence[str], fromfile: str = '',
+                 tofile: str = '', fromfiledate: str = '', tofiledate: str = '',
+                 n: int = 3, lineterm: str = '\n') -> Iterable[str]: ...
+def context_diff(a: Sequence[str], b: Sequence[str], fromfile: str='',
+                 tofile: str = '', fromfiledate: str = '', tofiledate: str = '',
+                 n: int = 3, lineterm: str = '\n') -> Iterable[str]: ...
+def ndiff(a: Sequence[str], b: Sequence[str],
+          linejunk: Callable[[str], bool] = None,
+          charjunk: Callable[[str], bool] = IS_CHARACTER_JUNK
+          ) -> Iterable[str]: ...
+
+class HtmlDiff(object):
+    def __init__(self, tabsize: int = 8, wrapcolumn: int = None,
+                 linejunk: Callable[[str], bool] = None,
+                 charjunk: Callable[[str], bool] = IS_CHARACTER_JUNK
+                 ) -> None: ...
+    def make_file(self, fromlines: Sequence[str], tolines: Sequence[str],
+                  fromdesc: str = '', todesc: str = '', context: bool = False,
+                  numlines: int = 5) -> str: ...
+    def make_table(self, fromlines: Sequence[str], tolines: Sequence[str],
+                   fromdesc: str = '', todesc: str = '', context: bool = False,
+                   numlines: int = 5) -> str: ...
+
+def restore(delta: Iterable[str], which: int) -> Iterable[int]: ...