add (overwrite with) mypy stubs, if available

stdlib/2.7/string.pyi

@@ -0,0 +1,74 @@
+# Stubs for string
+
+# Based on http://docs.python.org/3.2/library/string.html
+
+from typing import Mapping, Sequence, Any, Optional, Union, List, Tuple, Iterable, AnyStr
+
+ascii_letters = ''
+ascii_lowercase = ''
+ascii_uppercase = ''
+digits = ''
+hexdigits = ''
+letters = ''
+lowercase = ''
+octdigits = ''
+punctuation = ''
+printable = ''
+uppercase = ''
+whitespace = ''
+
+def capwords(s: AnyStr, sep: AnyStr = None) -> AnyStr: ...
+# TODO: originally named 'from'
+def maketrans(_from: str, to: str) -> str: ...
+def atof(s: unicode) -> float: ...
+def atoi(s: unicode, base: int = 10) -> int: ...
+def atol(s: unicode, base: int = 10) -> int: ...
+def capitalize(word: AnyStr) -> AnyStr: ...
+def find(s: unicode, sub: unicode, start: int = None, end: int = None) -> int: ...
+def rfind(s: unicode, sub: unicode, start: int = None, end: int = None) -> int: ...
+def index(s: unicode, sub: unicode, start: int = None, end: int = None) -> int: ...
+def rindex(s: unicode, sub: unicode, start: int = None, end: int = None) -> int: ...
+def count(s: unicode, sub: unicode, start: int = None, end: int = None) -> int: ...
+def lower(s: AnyStr) -> AnyStr: ...
+def split(s: AnyStr, sep: AnyStr = None, maxsplit: int = -1) -> List[AnyStr]: ...
+def rsplit(s: AnyStr, sep: AnyStr = None, maxsplit: int = -1) -> List[AnyStr]: ...
+def splitfields(s: AnyStr, sep: AnyStr = None, maxsplit: int = -1) -> List[AnyStr]: ...
+def join(words: Iterable[AnyStr], sep: AnyStr = None) -> AnyStr: ...
+def joinfields(word: Iterable[AnyStr], sep: AnyStr = None) -> AnyStr: ...
+def lstrip(s: AnyStr, chars: AnyStr = None) -> AnyStr: ...
+def rstrip(s: AnyStr, chars: AnyStr = None) -> AnyStr: ...
+def strip(s: AnyStr, chars: AnyStr = None) -> AnyStr: ...
+def swapcase(s: AnyStr) -> AnyStr: ...
+def translate(s: str, table: str, deletechars: str = None) -> str: ...
+def upper(s: AnyStr) -> AnyStr: ...
+def ljust(s: AnyStr, width: int, fillhar: AnyStr = ' ') -> AnyStr: ...
+def rjust(s: AnyStr, width: int, fillhar: AnyStr = ' ') -> AnyStr: ...
+def center(s: AnyStr, width: int, fillhar: AnyStr = ' ') -> AnyStr: ...
+def zfill(s: AnyStr, width: int) -> AnyStr: ...
+def replace(s: AnyStr, old: AnyStr, new: AnyStr, maxreplace: int = None) -> AnyStr: ...
+
+class Template(object):
+    # TODO: Unicode support?
+    template = ''
+
+    def __init__(self, template: str) -> None: ...
+    def substitute(self, mapping: Mapping[str, str], **kwds: str) -> str: ...
+    def safe_substitute(self, mapping: Mapping[str, str],
+                        **kwds: str) -> str: ...
+
+# TODO(MichalPokorny): This is probably badly and/or loosely typed.
+class Formatter(object):
+    def format(self, format_string: str, *args, **kwargs) -> str: ...
+    def vformat(self, format_string: str, args: Sequence[Any],
+                kwargs: Mapping[str, Any]) -> str: ...
+    def parse(self, format_string: str) -> Iterable[Tuple[str, str, str, str]]: ...
+    def get_field(self, field_name: str, args: Sequence[Any],
+                  kwargs: Mapping[str, Any]) -> Any: ...
+    def get_value(self, key: Union[int, str], args: Sequence[Any],
+                  kwargs: Mapping[str, Any]) -> Any:
+        raise IndexError()
+        raise KeyError()
+    def check_unused_args(self, used_args: Sequence[Union[int, str]], args: Sequence[Any],
+                          kwargs: Mapping[str, Any]) -> None: ...
+    def format_field(self, value: Any, format_spec: str) -> Any: ...
+    def convert_field(self, value: Any, conversion: str) -> Any: ...