typeshed

5 Commits

Author	SHA1	Message	Date
wouter bolsterlee	757d962237	Improve ssl module annotations (#5934 ) This improves the type annotations for the ‘ssl’ module: - Various APIs taking file names (e.g. keyfile=, certfile=, cafile=, capath=, ...) were annotated as accepting only strings, while actually they accept str, bytes, and os.PathLike (such as pathlib.Path). CPython's _ssl.c module has always used PyUnicode_FSConverter to handle (normalize) these. Change the annotations accordingly using the internal _typeshed.StrOrBytesPath alias. - Tighten the ‘purpose=’ argument in various functions to use the already defined ‘Purpose’ enum instead of accepting ‘Any’.	2021-08-18 08:23:31 -07:00
wouter bolsterlee	3efb675dba	Use ‘exclude list’ instead of ‘blacklist’ (#4297 ) This replaces all uses of ‘blacklist’ with ‘exclude list’. Benefits: - It is racially neutral terminology; see e.g. [1] - It makes the meaning more clear. In fact, with the popular Python autoformatter called ‘black’, also used by this project, files can be ‘blackened’ which is something completely different from them being on a blacklist. [1] https://chromium.googlesource.com/chromium/src/+/master/styleguide/inclusive_code.md#racially-neutral	2020-07-01 09:10:37 +02:00
wouter bolsterlee	83e955b52f	Use correct return type annotation for BaseException.with_traceback (#4298 ) The return type of the BaseException.with_traceback() method [1] is not specific enough. The return type is guaranteed to be of the same type as ‘self’, which is usually a subclass of BaseException. In fact, .with_traceback() returns ‘self’: try: raise ValueError except Exception as exc: assert exc.with_traceback(None) is exc Fix the annotation to reflect this using the self-type annotation technique described in PEP484 [2], which is supported by (at least) mypy [3]. [1] https://docs.python.org/3/library/exceptions.html#BaseException.with_traceback [2] https://www.python.org/dev/peps/pep-0484/#annotating-instance-and-class-methods [3] https://github.com/python/mypy/issues/1212	2020-06-30 11:40:25 -07:00
wouter bolsterlee	824e94a933	Make 2-arg iter() retrun type match passed callable's return type (#3326 ) This is a continuation of #3291, which was the initial fix for #3201. The 2-arg version of iter() turns a callable into an iterator. The changes made in #3291 introduce an Any return type for both the callable's return type and the iterator's type, while in reality the return type of the function is always the same as the iterator's type.	2019-10-09 08:44:41 +02:00
wouter bolsterlee	afe665690c	Add missing BaseException.__suppress_context__ attribute (#2876 ) See also PEP 415: https://www.python.org/dev/peps/pep-0415/ Fixes #2875.	2019-03-16 22:16:01 +01:00