typeshed: remove crufty comments (#4699)

Co-authored-by: hauntsaninja <>

stdlib/2/BaseHTTPServer.pyi

@@ -1,5 +1,3 @@
-# Stubs for BaseHTTPServer (Python 2.7)
-
 import mimetools
 import SocketServer
 from typing import Any, BinaryIO, Callable, Mapping, Optional, Tuple, Union

stdlib/2/CGIHTTPServer.pyi

@@ -1,5 +1,3 @@
-# Stubs for CGIHTTPServer (Python 2.7)
-
 import SimpleHTTPServer
 from typing import List
 

stdlib/2/Queue.pyi

@@ -1,5 +1,3 @@
-# Stubs for Queue (Python 2)
-
 from collections import deque
 from typing import Any, Deque, Generic, Optional, TypeVar
 

stdlib/2/SimpleHTTPServer.pyi

@@ -1,5 +1,3 @@
-# Stubs for SimpleHTTPServer (Python 2)
-
 import BaseHTTPServer
 from StringIO import StringIO
 from typing import IO, Any, AnyStr, Mapping, Optional, Union

stdlib/2/SocketServer.pyi

@@ -1,6 +1,3 @@
-# NB: SocketServer.pyi and socketserver.pyi must remain consistent!
-# Stubs for socketserver
-
 import sys
 import types
 from socket import SocketType

stdlib/2/StringIO.pyi

@@ -1,5 +1,3 @@
-# Stubs for StringIO (Python 2)
-
 from typing import IO, Any, AnyStr, Generic, Iterable, Iterator, List, Optional
 
 class StringIO(IO[AnyStr], Generic[AnyStr]):

stdlib/2/_collections.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the '_collections' module."""
-
 from typing import Any, Callable, Dict, Generic, Iterator, Optional, TypeVar, Union
 
 _K = TypeVar("_K")

stdlib/2/_functools.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the '_functools' module."""
-
 from typing import Any, Callable, Dict, Iterable, Optional, Tuple, TypeVar, overload
 
 _T = TypeVar("_T")

stdlib/2/_hotshot.pyi

@@ -1,8 +1,3 @@
-"""Stub file for the '_hotshot' module."""
-# This is an autogenerated file. It serves as a starting point
-# for a more precise manual annotation of this module.
-# Feel free to edit the source below, but remove this header when you do.
-
 from typing import Any, Dict, Generic, List, Tuple
 
 def coverage(a: str) -> Any: ...

stdlib/2/_sre.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the '_sre' module."""
-
 from typing import Any, Dict, Iterable, List, Mapping, Optional, Sequence, Tuple, Union, overload
 
 CODESIZE: int

stdlib/2/_struct.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the '_struct' module."""
-
 from typing import Any, AnyStr, Tuple
 
 class error(Exception): ...

stdlib/2/_threading_local.pyi

@@ -1,4 +1,3 @@
-# Source: https://hg.python.org/cpython/file/2.7/Lib/_threading_local.py
 from typing import Any
 
 class _localbase(object): ...

stdlib/2/cStringIO.pyi

@@ -1,12 +1,7 @@
-# Stubs for cStringIO (Python 2.7)
-# See https://docs.python.org/2/library/stringio.html
-
 from abc import ABCMeta
 from types import TracebackType
 from typing import IO, Iterable, Iterator, List, Optional, Union, overload
 
-# TODO the typing.IO[] generics should be split into input and output.
-
 # This class isn't actually abstract, but you can't instantiate it
 # directly, so we might as well treat it as abstract in the stub.
 class InputType(IO[str], Iterator[str], metaclass=ABCMeta):

stdlib/2/collections.pyi

@@ -1,5 +1,3 @@
-# These are not exported.
-# These are exported.
 from typing import (
     AbstractSet,
     Any,

stdlib/2/dircache.pyi

@@ -1,5 +1,3 @@
-# Source: https://hg.python.org/cpython/file/2.7/Lib/dircache.py
-
 from typing import List, MutableSequence, Text, Union
 
 def reset() -> None: ...

stdlib/2/distutils/archive_util.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.archive_util
-
 from typing import Optional
 
 def make_archive(

stdlib/2/distutils/bcppcompiler.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.bcppcompiler
-
 from distutils.ccompiler import CCompiler
 
 class BCPPCompiler(CCompiler): ...

stdlib/2/distutils/ccompiler.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.ccompiler
-
 from typing import Any, Callable, List, Optional, Tuple, Union
 
 _Macro = Union[Tuple[str], Tuple[str, Optional[str]]]

stdlib/2/distutils/cmd.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.cmd
-
 from abc import abstractmethod
 from distutils.dist import Distribution
 from typing import Any, Callable, Iterable, List, Optional, Text, Tuple, Union

stdlib/2/distutils/core.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.core
-
 from distutils.cmd import Command as Command
 from distutils.dist import Distribution as Distribution
 from distutils.extension import Extension as Extension

stdlib/2/distutils/cygwinccompiler.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.cygwinccompiler
-
 from distutils.unixccompiler import UnixCCompiler
 
 class CygwinCCompiler(UnixCCompiler): ...

stdlib/2/distutils/debug.pyi

@@ -1,3 +1 @@
-# Stubs for distutils.debug
-
 DEBUG: bool

stdlib/2/distutils/dep_util.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.dep_util
-
 from typing import List, Tuple
 
 def newer(source: str, target: str) -> bool: ...

stdlib/2/distutils/dir_util.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.dir_util
-
 from typing import List
 
 def mkpath(name: str, mode: int = ..., verbose: int = ..., dry_run: int = ...) -> List[str]: ...

stdlib/2/distutils/dist.pyi

@@ -1,4 +1,3 @@
-# Stubs for distutils.dist
 from distutils.cmd import Command
 from typing import Any, Dict, Iterable, Mapping, Optional, Text, Tuple, Type
 

stdlib/2/distutils/emxccompiler.pyi

@@ -1,5 +1,3 @@
-# Stubs for emxccompiler
-
 from distutils.unixccompiler import UnixCCompiler
 
 class EMXCCompiler(UnixCCompiler): ...

stdlib/2/distutils/fancy_getopt.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.fancy_getopt
-
 from typing import Any, List, Mapping, Optional, Tuple, Union, overload
 
 _Option = Tuple[str, Optional[str], str]

stdlib/2/distutils/file_util.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.file_util
-
 from typing import Optional, Sequence, Tuple
 
 def copy_file(

stdlib/2/distutils/filelist.pyi

@@ -1,3 +1 @@
-# Stubs for distutils.filelist
-
 class FileList: ...

stdlib/2/distutils/msvccompiler.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.msvccompiler
-
 from distutils.ccompiler import CCompiler
 
 class MSVCCompiler(CCompiler): ...

stdlib/2/distutils/spawn.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.spawn
-
 from typing import List, Optional
 
 def spawn(cmd: List[str], search_path: bool = ..., verbose: bool = ..., dry_run: bool = ...) -> None: ...

stdlib/2/distutils/sysconfig.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.sysconfig
-
 from distutils.ccompiler import CCompiler
 from typing import Mapping, Optional, Union
 

stdlib/2/distutils/text_file.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.text_file
-
 from typing import IO, List, Optional, Tuple, Union
 
 class TextFile:

stdlib/2/distutils/unixccompiler.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.unixccompiler
-
 from distutils.ccompiler import CCompiler
 
 class UnixCCompiler(CCompiler): ...

stdlib/2/distutils/util.pyi

@@ -1,5 +1,3 @@
-# Stubs for distutils.util
-
 from typing import Any, Callable, List, Mapping, Optional, Tuple
 
 def get_platform() -> str: ...

stdlib/2/email/mime/application.pyi

@@ -1,5 +1,3 @@
-# Stubs for email.mime.application
-
 from email.mime.nonmultipart import MIMENonMultipart
 from typing import Callable, Optional, Tuple, Union
 

stdlib/2/functools.pyi

@@ -1,7 +1,3 @@
-# Stubs for functools (Python 2.7)
-
-# NOTE: These are incomplete!
-
 from abc import ABCMeta, abstractmethod
 from typing import Any, Callable, Dict, Generic, Iterable, Optional, Sequence, Tuple, Type, TypeVar, overload
 

stdlib/2/gc.pyi

@@ -1,5 +1,3 @@
-# Stubs for gc
-
 from typing import Any, List, Tuple
 
 def enable() -> None: ...

stdlib/2/getpass.pyi

@@ -1,5 +1,3 @@
-# Stubs for getpass (Python 2)
-
 from typing import IO, Any
 
 class GetPassWarning(UserWarning): ...

stdlib/2/hashlib.pyi

@@ -1,5 +1,3 @@
-# Stubs for hashlib (Python 2)
-
 from typing import Tuple, Union
 
 _DataType = Union[str, unicode, bytearray, buffer, memoryview]

stdlib/2/httplib.pyi

@@ -1,8 +1,3 @@
-# Stubs for httplib (Python 2)
-#
-# Generated by stubgen and manually massaged a bit.
-# Needs lots more work!
-
 import mimetools
 import ssl
 from typing import Any, Dict, Optional, Protocol

stdlib/2/imp.pyi

@@ -1,5 +1,3 @@
-"""Stubs for the 'imp' module."""
-
 import types
 from typing import IO, Any, Iterable, List, Optional, Tuple
 

stdlib/2/io.pyi

@@ -1,9 +1,3 @@
-# Stubs for io
-
-# Based on https://docs.python.org/2/library/io.html
-
-# Only a subset of functionality is included.
-
 from typing import IO, Any, Union
 
 import _io

stdlib/2/itertools.pyi

@@ -1,7 +1,3 @@
-# Stubs for itertools
-
-# Based on https://docs.python.org/2/library/itertools.html
-
 from typing import Any, Callable, Generic, Iterable, Iterator, Optional, Sequence, Tuple, TypeVar, Union, overload
 
 _T = TypeVar("_T")

stdlib/2/md5.pyi

@@ -1,5 +1,3 @@
-# Stubs for Python 2.7 md5 stdlib module
-
 from hashlib import md5 as md5
 
 new = md5

stdlib/2/mutex.pyi

@@ -1,5 +1,3 @@
-# Source: https://hg.python.org/cpython/file/2.7/Lib/mutex.py
-
 from typing import Any, Callable, Deque, TypeVar
 
 _ArgType = TypeVar("_ArgType")

stdlib/2/os/path.pyi

@@ -1,4 +1,3 @@
-# NB: path.pyi and stdlib/2 and stdlib/3 must remain consistent!
 import os
 import sys
 from _typeshed import AnyPath, BytesPath, StrPath

stdlib/2/os2emxpath.pyi

@@ -1,4 +1,3 @@
-# NB: path.pyi and stdlib/2 and stdlib/3 must remain consistent!
 import os
 import sys
 from _typeshed import AnyPath, BytesPath, StrPath

stdlib/2/platform.pyi

@@ -1,7 +1,3 @@
-# Stubs for platform (Python 2)
-#
-# Based on stub generated by stubgen.
-
 from typing import Any, Optional, Tuple
 
 __copyright__: Any

stdlib/2/random.pyi

@@ -1,11 +1,3 @@
-# Stubs for random
-# Ron Murawski <ron@horizonchess.com>
-# Updated by Jukka Lehtosalo
-
-# based on https://docs.python.org/2/library/random.html
-
-# ----- random classes -----
-
 import _random
 from typing import AbstractSet, Any, Callable, Iterator, List, MutableSequence, Protocol, Sequence, TypeVar, Union, overload
 

stdlib/2/re.pyi

@@ -1,9 +1,3 @@
-# Stubs for re
-# Ron Murawski <ron@horizonchess.com>
-# 'bytes' support added by Jukka Lehtosalo
-
-# based on: http: //docs.python.org/2.7/library/re.html
-
 from typing import (
     Any,
     AnyStr,

stdlib/2/rfc822.pyi

@@ -1,7 +1,3 @@
-# Stubs for rfc822 (Python 2)
-#
-# Based on stub generated by stubgen.
-
 from typing import Any, Optional
 
 class Message:

stdlib/2/sets.pyi

@@ -1,4 +1,3 @@
-# Stubs for sets (Python 2)
 from typing import Any, Callable, Hashable, Iterable, Iterator, MutableMapping, Optional, TypeVar, Union
 
 _T = TypeVar("_T")

stdlib/2/sha.pyi

@@ -1,5 +1,3 @@
-# Stubs for Python 2.7 sha stdlib module
-
 class sha(object):
     def update(self, arg: str) -> None: ...
     def digest(self) -> str: ...

stdlib/2/sre_constants.pyi

@@ -1,5 +1,3 @@
-# Source: https://hg.python.org/cpython/file/2.7/Lib/sre_constants.py
-
 from typing import Dict, List, TypeVar
 
 MAGIC: int

stdlib/2/sre_parse.pyi

@@ -1,5 +1,3 @@
-# Source: https://hg.python.org/cpython/file/2.7/Lib/sre_parse.py
-
 from typing import Any, Dict, Iterable, List, Match, Optional, Pattern as _Pattern, Set, Tuple, Union
 
 SPECIAL_CHARS: str

stdlib/2/string.pyi

@@ -1,7 +1,3 @@
-# Stubs for string
-
-# Based on http://docs.python.org/3.2/library/string.html
-
 from typing import Any, AnyStr, Iterable, List, Mapping, Optional, Sequence, Text, Tuple, Union, overload
 
 ascii_letters: str

stdlib/2/stringold.pyi

@@ -1,4 +1,3 @@
-# Source: https://hg.python.org/cpython/file/2.7/Lib/stringold.py
 from typing import AnyStr, Iterable, List, Optional, Type
 
 whitespace: str

stdlib/2/strop.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the 'strop' module."""
-
 from typing import List, Sequence
 
 lowercase: str

stdlib/2/subprocess.pyi

@@ -1,7 +1,3 @@
-# Stubs for subprocess
-
-# Based on http://docs.python.org/2/library/subprocess.html and Python 3 stub
-
 from typing import IO, Any, Callable, Generic, List, Mapping, Optional, Sequence, Text, Tuple, TypeVar, Union
 
 _FILE = Union[None, int, IO[Any]]

stdlib/2/symbol.pyi

@@ -1,5 +1,3 @@
-# Stubs for symbol (Python 2)
-
 from typing import Dict
 
 single_input: int

stdlib/2/sys.pyi

@@ -1,5 +1,3 @@
-"""Stubs for the 'sys' module."""
-
 from types import ClassType, FrameType, ModuleType, TracebackType
 from typing import IO, Any, BinaryIO, Callable, Dict, List, NoReturn, Optional, Sequence, Text, Tuple, Type, Union, overload
 

stdlib/2/thread.pyi

@@ -1,4 +1,3 @@
-"""Stubs for the "thread" module."""
 from typing import Any, Callable
 
 def _count() -> int: ...

stdlib/2/toaiff.pyi

@@ -1,6 +1,3 @@
-# Stubs for toaiff (Python 2)
-
-# Source: https://hg.python.org/cpython/file/2.7/Lib/toaiff.py
 from pipes import Template
 from typing import Dict, List
 

stdlib/2/tokenize.pyi

@@ -1,5 +1,3 @@
-# Automatically generated by pytype, manually fixed up. May still contain errors.
-
 from typing import Any, Callable, Dict, Generator, Iterable, Iterator, List, Tuple, Union
 
 __author__: str

stdlib/2/types.pyi

@@ -1,10 +1,9 @@
-# Stubs for types
-# Note, all classes "defined" here require special handling.
-
 from typing import Any, Callable, Dict, Iterable, Iterator, List, Optional, Tuple, Type, TypeVar, Union, overload
 
 _T = TypeVar("_T")
 
+# Note, all classes "defined" here require special handling.
+
 class NoneType: ...
 
 TypeType = type

stdlib/2/typing.pyi

@@ -1,5 +1,3 @@
-# Stubs for typing (Python 2.7)
-
 import collections  # Needed by aliases like DefaultDict, see mypy issue 2986
 from abc import ABCMeta, abstractmethod
 from types import CodeType, FrameType, TracebackType

stdlib/2/unittest.pyi

@@ -1,7 +1,3 @@
-# Stubs for unittest
-
-# Based on http://docs.python.org/2.7/library/unittest.html
-
 import datetime
 import types
 from abc import ABCMeta, abstractmethod

stdlib/2/urlparse.pyi

@@ -1,5 +1,3 @@
-# Stubs for urlparse (Python 2)
-
 from typing import AnyStr, Dict, List, NamedTuple, Optional, Sequence, Tuple, Union, overload
 
 _String = Union[str, unicode]

stdlib/2/user.pyi

@@ -1,7 +1,3 @@
-# Stubs for user (Python 2)
-
-# Docs: https://docs.python.org/2/library/user.html
-# Source: https://hg.python.org/cpython/file/2.7/Lib/user.py
 from typing import Any
 
 def __getattr__(name) -> Any: ...

stdlib/2/whichdb.pyi

@@ -1,5 +1,3 @@
-# Source: https://hg.python.org/cpython/file/2.7/Lib/whichdb.py
-
 from typing import Optional, Text
 
 def whichdb(filename: Text) -> Optional[str]: ...

stdlib/2/xmlrpclib.pyi

@@ -1,5 +1,3 @@
-# Stubs for xmlrpclib (Python 2)
-
 from datetime import datetime
 from gzip import GzipFile
 from httplib import HTTPConnection, HTTPResponse, HTTPSConnection