Full Code of python/mypy for AI

master bf1b7c8bdda2 cached
1832 files
17.5 MB
4.0M tokens
1 requests
Copy disabled (too large) Download .txt
Showing preview only (16,072K chars total). Download the full file to get everything.
Repository: python/mypy
Branch: master
Commit: bf1b7c8bdda2
Files: 1832
Total size: 17.5 MB

Directory structure:
gitextract_4gxjb3sb/

├── .editorconfig
├── .git-blame-ignore-revs
├── .gitattributes
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug.md
│   │   ├── config.yml
│   │   ├── crash.md
│   │   ├── documentation.md
│   │   └── feature.md
│   ├── PULL_REQUEST_TEMPLATE.md
│   └── workflows/
│       ├── build_wheels.yml
│       ├── docs.yml
│       ├── mypy_primer.yml
│       ├── mypy_primer_comment.yml
│       ├── sync_typeshed.yml
│       ├── test.yml
│       └── test_stubgenc.yml
├── .gitignore
├── .pre-commit-config.yaml
├── .readthedocs.yaml
├── CHANGELOG.md
├── CONTRIBUTING.md
├── CREDITS
├── LICENSE
├── MANIFEST.in
├── README.md
├── action.yml
├── build-requirements.txt
├── conftest.py
├── docs/
│   ├── Makefile
│   ├── README.md
│   ├── make.bat
│   ├── requirements-docs.txt
│   └── source/
│       ├── additional_features.rst
│       ├── builtin_types.rst
│       ├── changelog.md
│       ├── cheat_sheet_py3.rst
│       ├── class_basics.rst
│       ├── command_line.rst
│       ├── common_issues.rst
│       ├── conf.py
│       ├── config_file.rst
│       ├── duck_type_compatibility.rst
│       ├── dynamic_typing.rst
│       ├── error_code_list.rst
│       ├── error_code_list2.rst
│       ├── error_codes.rst
│       ├── existing_code.rst
│       ├── extending_mypy.rst
│       ├── faq.rst
│       ├── final_attrs.rst
│       ├── generics.rst
│       ├── getting_started.rst
│       ├── html_builder.py
│       ├── index.rst
│       ├── inline_config.rst
│       ├── installed_packages.rst
│       ├── kinds_of_types.rst
│       ├── literal_types.rst
│       ├── metaclasses.rst
│       ├── more_types.rst
│       ├── mypy_daemon.rst
│       ├── protocols.rst
│       ├── running_mypy.rst
│       ├── runtime_troubles.rst
│       ├── stubgen.rst
│       ├── stubs.rst
│       ├── stubtest.rst
│       ├── supported_python_features.rst
│       ├── type_inference_and_annotations.rst
│       ├── type_narrowing.rst
│       └── typed_dict.rst
├── misc/
│   ├── analyze_cache.py
│   ├── analyze_typeform_stats.py
│   ├── apply-cache-diff.py
│   ├── build-debug-python.sh
│   ├── build_wheel.py
│   ├── cherry-pick-typeshed.py
│   ├── clean-mypyc.sh
│   ├── convert-cache.py
│   ├── diff-cache.py
│   ├── docker/
│   │   ├── Dockerfile
│   │   ├── README.md
│   │   ├── build.py
│   │   ├── run-wrapper.sh
│   │   └── run.sh
│   ├── dump-ast.py
│   ├── find_type.py
│   ├── gen_blog_post_html.py
│   ├── generate_changelog.py
│   ├── incremental_checker.py
│   ├── log_trace_check.py
│   ├── macs.el
│   ├── perf_checker.py
│   ├── perf_compare.py
│   ├── profile_check.py
│   ├── self_compile_info.py
│   ├── sync-typeshed.py
│   ├── test-stubgenc.sh
│   ├── trigger_wheel_build.sh
│   ├── typeshed_patches/
│   │   ├── 0001-Adjust-stubs-to-fix-mypy-lookup-error-due-to-circula.patch
│   │   ├── 0001-Partially-revert-Clean-up-argparse-hacks.patch
│   │   ├── 0001-Remove-use-of-LiteralString-in-builtins-13743.patch
│   │   ├── 0001-Revert-Remove-redundant-inheritances-from-Iterator.patch
│   │   ├── 0001-Revert-Use-contravariant-type-variable-in-Container.patch
│   │   ├── 0001-Revert-sum-literal-integer-change-13961.patch
│   │   ├── 0001-Revert-typeshed-ctypes-change.patch
│   │   └── 0001-Temporarily-revert-contextlib-deprecation.patch
│   ├── update-stubinfo.py
│   └── upload-pypi.py
├── mypy/
│   ├── __init__.py
│   ├── __main__.py
│   ├── api.py
│   ├── applytype.py
│   ├── argmap.py
│   ├── binder.py
│   ├── bogus_type.py
│   ├── build.py
│   ├── build_worker/
│   │   ├── __init__.py
│   │   ├── __main__.py
│   │   └── worker.py
│   ├── cache.py
│   ├── checker.py
│   ├── checker_shared.py
│   ├── checker_state.py
│   ├── checkexpr.py
│   ├── checkmember.py
│   ├── checkpattern.py
│   ├── checkstrformat.py
│   ├── config_parser.py
│   ├── constant_fold.py
│   ├── constraints.py
│   ├── copytype.py
│   ├── defaults.py
│   ├── dmypy/
│   │   ├── __init__.py
│   │   ├── __main__.py
│   │   └── client.py
│   ├── dmypy_os.py
│   ├── dmypy_server.py
│   ├── dmypy_util.py
│   ├── erasetype.py
│   ├── error_formatter.py
│   ├── errorcodes.py
│   ├── errors.py
│   ├── evalexpr.py
│   ├── expandtype.py
│   ├── exportjson.py
│   ├── exprtotype.py
│   ├── fastparse.py
│   ├── find_sources.py
│   ├── fixup.py
│   ├── freetree.py
│   ├── fscache.py
│   ├── fswatcher.py
│   ├── gclogger.py
│   ├── git.py
│   ├── graph_utils.py
│   ├── indirection.py
│   ├── infer.py
│   ├── inspections.py
│   ├── ipc.py
│   ├── join.py
│   ├── literals.py
│   ├── lookup.py
│   ├── main.py
│   ├── maptype.py
│   ├── meet.py
│   ├── memprofile.py
│   ├── message_registry.py
│   ├── messages.py
│   ├── metastore.py
│   ├── mixedtraverser.py
│   ├── modulefinder.py
│   ├── moduleinspect.py
│   ├── mro.py
│   ├── nativeparse.py
│   ├── nodes.py
│   ├── operators.py
│   ├── options.py
│   ├── parse.py
│   ├── partially_defined.py
│   ├── patterns.py
│   ├── plugin.py
│   ├── plugins/
│   │   ├── __init__.py
│   │   ├── attrs.py
│   │   ├── common.py
│   │   ├── constants.py
│   │   ├── ctypes.py
│   │   ├── dataclasses.py
│   │   ├── default.py
│   │   ├── enums.py
│   │   ├── functools.py
│   │   ├── proper_plugin.py
│   │   └── singledispatch.py
│   ├── py.typed
│   ├── pyinfo.py
│   ├── reachability.py
│   ├── refinfo.py
│   ├── renaming.py
│   ├── report.py
│   ├── scope.py
│   ├── semanal.py
│   ├── semanal_classprop.py
│   ├── semanal_enum.py
│   ├── semanal_infer.py
│   ├── semanal_main.py
│   ├── semanal_namedtuple.py
│   ├── semanal_newtype.py
│   ├── semanal_pass1.py
│   ├── semanal_shared.py
│   ├── semanal_typeargs.py
│   ├── semanal_typeddict.py
│   ├── server/
│   │   ├── __init__.py
│   │   ├── astdiff.py
│   │   ├── astmerge.py
│   │   ├── aststrip.py
│   │   ├── deps.py
│   │   ├── mergecheck.py
│   │   ├── objgraph.py
│   │   ├── subexpr.py
│   │   ├── target.py
│   │   ├── trigger.py
│   │   └── update.py
│   ├── sharedparse.py
│   ├── solve.py
│   ├── split_namespace.py
│   ├── state.py
│   ├── stats.py
│   ├── strconv.py
│   ├── stubdoc.py
│   ├── stubgen.py
│   ├── stubgenc.py
│   ├── stubinfo.py
│   ├── stubtest.py
│   ├── stubutil.py
│   ├── subtypes.py
│   ├── suggestions.py
│   ├── test/
│   │   ├── __init__.py
│   │   ├── config.py
│   │   ├── data.py
│   │   ├── helpers.py
│   │   ├── meta/
│   │   │   ├── __init__.py
│   │   │   ├── _pytest.py
│   │   │   ├── test_diff_helper.py
│   │   │   ├── test_parse_data.py
│   │   │   └── test_update_data.py
│   │   ├── test_config_parser.py
│   │   ├── test_diff_cache.py
│   │   ├── test_find_sources.py
│   │   ├── test_nativeparse.py
│   │   ├── test_ref_info.py
│   │   ├── testapi.py
│   │   ├── testargs.py
│   │   ├── testcheck.py
│   │   ├── testcmdline.py
│   │   ├── testconstraints.py
│   │   ├── testdaemon.py
│   │   ├── testdeps.py
│   │   ├── testdiff.py
│   │   ├── testerrorstream.py
│   │   ├── testexportjson.py
│   │   ├── testfinegrained.py
│   │   ├── testfinegrainedcache.py
│   │   ├── testformatter.py
│   │   ├── testfscache.py
│   │   ├── testgraph.py
│   │   ├── testinfer.py
│   │   ├── testipc.py
│   │   ├── testmerge.py
│   │   ├── testmodulefinder.py
│   │   ├── testmypyc.py
│   │   ├── testoutput.py
│   │   ├── testparse.py
│   │   ├── testpep561.py
│   │   ├── testpythoneval.py
│   │   ├── testreports.py
│   │   ├── testsemanal.py
│   │   ├── testsolve.py
│   │   ├── teststubgen.py
│   │   ├── teststubinfo.py
│   │   ├── teststubtest.py
│   │   ├── testsubtypes.py
│   │   ├── testtransform.py
│   │   ├── testtypegen.py
│   │   ├── testtypes.py
│   │   ├── testutil.py
│   │   ├── typefixture.py
│   │   ├── update_data.py
│   │   └── visitors.py
│   ├── traverser.py
│   ├── treetransform.py
│   ├── tvar_scope.py
│   ├── type_visitor.py
│   ├── typeanal.py
│   ├── typeops.py
│   ├── types.py
│   ├── types_utils.py
│   ├── typeshed/
│   │   ├── LICENSE
│   │   ├── stdlib/
│   │   │   ├── VERSIONS
│   │   │   ├── __future__.pyi
│   │   │   ├── __main__.pyi
│   │   │   ├── _ast.pyi
│   │   │   ├── _asyncio.pyi
│   │   │   ├── _bisect.pyi
│   │   │   ├── _blake2.pyi
│   │   │   ├── _bootlocale.pyi
│   │   │   ├── _bz2.pyi
│   │   │   ├── _codecs.pyi
│   │   │   ├── _collections_abc.pyi
│   │   │   ├── _compat_pickle.pyi
│   │   │   ├── _compression.pyi
│   │   │   ├── _contextvars.pyi
│   │   │   ├── _csv.pyi
│   │   │   ├── _ctypes.pyi
│   │   │   ├── _curses.pyi
│   │   │   ├── _curses_panel.pyi
│   │   │   ├── _dbm.pyi
│   │   │   ├── _decimal.pyi
│   │   │   ├── _frozen_importlib.pyi
│   │   │   ├── _frozen_importlib_external.pyi
│   │   │   ├── _gdbm.pyi
│   │   │   ├── _hashlib.pyi
│   │   │   ├── _heapq.pyi
│   │   │   ├── _imp.pyi
│   │   │   ├── _interpchannels.pyi
│   │   │   ├── _interpqueues.pyi
│   │   │   ├── _interpreters.pyi
│   │   │   ├── _io.pyi
│   │   │   ├── _json.pyi
│   │   │   ├── _locale.pyi
│   │   │   ├── _lsprof.pyi
│   │   │   ├── _lzma.pyi
│   │   │   ├── _markupbase.pyi
│   │   │   ├── _msi.pyi
│   │   │   ├── _multibytecodec.pyi
│   │   │   ├── _operator.pyi
│   │   │   ├── _osx_support.pyi
│   │   │   ├── _pickle.pyi
│   │   │   ├── _posixsubprocess.pyi
│   │   │   ├── _py_abc.pyi
│   │   │   ├── _pydecimal.pyi
│   │   │   ├── _queue.pyi
│   │   │   ├── _random.pyi
│   │   │   ├── _sitebuiltins.pyi
│   │   │   ├── _socket.pyi
│   │   │   ├── _sqlite3.pyi
│   │   │   ├── _ssl.pyi
│   │   │   ├── _stat.pyi
│   │   │   ├── _struct.pyi
│   │   │   ├── _thread.pyi
│   │   │   ├── _threading_local.pyi
│   │   │   ├── _tkinter.pyi
│   │   │   ├── _tracemalloc.pyi
│   │   │   ├── _typeshed/
│   │   │   │   ├── README.md
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _type_checker_internals.pyi
│   │   │   │   ├── dbapi.pyi
│   │   │   │   ├── importlib.pyi
│   │   │   │   ├── wsgi.pyi
│   │   │   │   └── xml.pyi
│   │   │   ├── _warnings.pyi
│   │   │   ├── _weakref.pyi
│   │   │   ├── _weakrefset.pyi
│   │   │   ├── _winapi.pyi
│   │   │   ├── _zstd.pyi
│   │   │   ├── abc.pyi
│   │   │   ├── aifc.pyi
│   │   │   ├── annotationlib.pyi
│   │   │   ├── antigravity.pyi
│   │   │   ├── argparse.pyi
│   │   │   ├── array.pyi
│   │   │   ├── ast.pyi
│   │   │   ├── asynchat.pyi
│   │   │   ├── asyncio/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── base_events.pyi
│   │   │   │   ├── base_futures.pyi
│   │   │   │   ├── base_subprocess.pyi
│   │   │   │   ├── base_tasks.pyi
│   │   │   │   ├── constants.pyi
│   │   │   │   ├── coroutines.pyi
│   │   │   │   ├── events.pyi
│   │   │   │   ├── exceptions.pyi
│   │   │   │   ├── format_helpers.pyi
│   │   │   │   ├── futures.pyi
│   │   │   │   ├── graph.pyi
│   │   │   │   ├── locks.pyi
│   │   │   │   ├── log.pyi
│   │   │   │   ├── mixins.pyi
│   │   │   │   ├── proactor_events.pyi
│   │   │   │   ├── protocols.pyi
│   │   │   │   ├── queues.pyi
│   │   │   │   ├── runners.pyi
│   │   │   │   ├── selector_events.pyi
│   │   │   │   ├── sslproto.pyi
│   │   │   │   ├── staggered.pyi
│   │   │   │   ├── streams.pyi
│   │   │   │   ├── subprocess.pyi
│   │   │   │   ├── taskgroups.pyi
│   │   │   │   ├── tasks.pyi
│   │   │   │   ├── threads.pyi
│   │   │   │   ├── timeouts.pyi
│   │   │   │   ├── tools.pyi
│   │   │   │   ├── transports.pyi
│   │   │   │   ├── trsock.pyi
│   │   │   │   ├── unix_events.pyi
│   │   │   │   ├── windows_events.pyi
│   │   │   │   └── windows_utils.pyi
│   │   │   ├── asyncore.pyi
│   │   │   ├── atexit.pyi
│   │   │   ├── audioop.pyi
│   │   │   ├── base64.pyi
│   │   │   ├── bdb.pyi
│   │   │   ├── binascii.pyi
│   │   │   ├── binhex.pyi
│   │   │   ├── bisect.pyi
│   │   │   ├── builtins.pyi
│   │   │   ├── bz2.pyi
│   │   │   ├── cProfile.pyi
│   │   │   ├── calendar.pyi
│   │   │   ├── cgi.pyi
│   │   │   ├── cgitb.pyi
│   │   │   ├── chunk.pyi
│   │   │   ├── cmath.pyi
│   │   │   ├── cmd.pyi
│   │   │   ├── code.pyi
│   │   │   ├── codecs.pyi
│   │   │   ├── codeop.pyi
│   │   │   ├── collections/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── abc.pyi
│   │   │   ├── colorsys.pyi
│   │   │   ├── compileall.pyi
│   │   │   ├── compression/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _common/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   └── _streams.pyi
│   │   │   │   ├── bz2.pyi
│   │   │   │   ├── gzip.pyi
│   │   │   │   ├── lzma.pyi
│   │   │   │   ├── zlib.pyi
│   │   │   │   └── zstd/
│   │   │   │       ├── __init__.pyi
│   │   │   │       └── _zstdfile.pyi
│   │   │   ├── concurrent/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── futures/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── _base.pyi
│   │   │   │   │   ├── interpreter.pyi
│   │   │   │   │   ├── process.pyi
│   │   │   │   │   └── thread.pyi
│   │   │   │   └── interpreters/
│   │   │   │       ├── __init__.pyi
│   │   │   │       ├── _crossinterp.pyi
│   │   │   │       └── _queues.pyi
│   │   │   ├── configparser.pyi
│   │   │   ├── contextlib.pyi
│   │   │   ├── contextvars.pyi
│   │   │   ├── copy.pyi
│   │   │   ├── copyreg.pyi
│   │   │   ├── crypt.pyi
│   │   │   ├── csv.pyi
│   │   │   ├── ctypes/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _endian.pyi
│   │   │   │   ├── macholib/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── dyld.pyi
│   │   │   │   │   ├── dylib.pyi
│   │   │   │   │   └── framework.pyi
│   │   │   │   ├── util.pyi
│   │   │   │   └── wintypes.pyi
│   │   │   ├── curses/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── ascii.pyi
│   │   │   │   ├── has_key.pyi
│   │   │   │   ├── panel.pyi
│   │   │   │   └── textpad.pyi
│   │   │   ├── dataclasses.pyi
│   │   │   ├── datetime.pyi
│   │   │   ├── dbm/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── dumb.pyi
│   │   │   │   ├── gnu.pyi
│   │   │   │   ├── ndbm.pyi
│   │   │   │   └── sqlite3.pyi
│   │   │   ├── decimal.pyi
│   │   │   ├── difflib.pyi
│   │   │   ├── dis.pyi
│   │   │   ├── distutils/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _msvccompiler.pyi
│   │   │   │   ├── archive_util.pyi
│   │   │   │   ├── bcppcompiler.pyi
│   │   │   │   ├── ccompiler.pyi
│   │   │   │   ├── cmd.pyi
│   │   │   │   ├── command/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── bdist.pyi
│   │   │   │   │   ├── bdist_dumb.pyi
│   │   │   │   │   ├── bdist_msi.pyi
│   │   │   │   │   ├── bdist_packager.pyi
│   │   │   │   │   ├── bdist_rpm.pyi
│   │   │   │   │   ├── bdist_wininst.pyi
│   │   │   │   │   ├── build.pyi
│   │   │   │   │   ├── build_clib.pyi
│   │   │   │   │   ├── build_ext.pyi
│   │   │   │   │   ├── build_py.pyi
│   │   │   │   │   ├── build_scripts.pyi
│   │   │   │   │   ├── check.pyi
│   │   │   │   │   ├── clean.pyi
│   │   │   │   │   ├── config.pyi
│   │   │   │   │   ├── install.pyi
│   │   │   │   │   ├── install_data.pyi
│   │   │   │   │   ├── install_egg_info.pyi
│   │   │   │   │   ├── install_headers.pyi
│   │   │   │   │   ├── install_lib.pyi
│   │   │   │   │   ├── install_scripts.pyi
│   │   │   │   │   ├── register.pyi
│   │   │   │   │   ├── sdist.pyi
│   │   │   │   │   └── upload.pyi
│   │   │   │   ├── config.pyi
│   │   │   │   ├── core.pyi
│   │   │   │   ├── cygwinccompiler.pyi
│   │   │   │   ├── debug.pyi
│   │   │   │   ├── dep_util.pyi
│   │   │   │   ├── dir_util.pyi
│   │   │   │   ├── dist.pyi
│   │   │   │   ├── errors.pyi
│   │   │   │   ├── extension.pyi
│   │   │   │   ├── fancy_getopt.pyi
│   │   │   │   ├── file_util.pyi
│   │   │   │   ├── filelist.pyi
│   │   │   │   ├── log.pyi
│   │   │   │   ├── msvccompiler.pyi
│   │   │   │   ├── spawn.pyi
│   │   │   │   ├── sysconfig.pyi
│   │   │   │   ├── text_file.pyi
│   │   │   │   ├── unixccompiler.pyi
│   │   │   │   ├── util.pyi
│   │   │   │   └── version.pyi
│   │   │   ├── doctest.pyi
│   │   │   ├── email/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _header_value_parser.pyi
│   │   │   │   ├── _policybase.pyi
│   │   │   │   ├── base64mime.pyi
│   │   │   │   ├── charset.pyi
│   │   │   │   ├── contentmanager.pyi
│   │   │   │   ├── encoders.pyi
│   │   │   │   ├── errors.pyi
│   │   │   │   ├── feedparser.pyi
│   │   │   │   ├── generator.pyi
│   │   │   │   ├── header.pyi
│   │   │   │   ├── headerregistry.pyi
│   │   │   │   ├── iterators.pyi
│   │   │   │   ├── message.pyi
│   │   │   │   ├── mime/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── application.pyi
│   │   │   │   │   ├── audio.pyi
│   │   │   │   │   ├── base.pyi
│   │   │   │   │   ├── image.pyi
│   │   │   │   │   ├── message.pyi
│   │   │   │   │   ├── multipart.pyi
│   │   │   │   │   ├── nonmultipart.pyi
│   │   │   │   │   └── text.pyi
│   │   │   │   ├── parser.pyi
│   │   │   │   ├── policy.pyi
│   │   │   │   ├── quoprimime.pyi
│   │   │   │   └── utils.pyi
│   │   │   ├── encodings/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── aliases.pyi
│   │   │   │   ├── ascii.pyi
│   │   │   │   ├── base64_codec.pyi
│   │   │   │   ├── big5.pyi
│   │   │   │   ├── big5hkscs.pyi
│   │   │   │   ├── bz2_codec.pyi
│   │   │   │   ├── charmap.pyi
│   │   │   │   ├── cp037.pyi
│   │   │   │   ├── cp1006.pyi
│   │   │   │   ├── cp1026.pyi
│   │   │   │   ├── cp1125.pyi
│   │   │   │   ├── cp1140.pyi
│   │   │   │   ├── cp1250.pyi
│   │   │   │   ├── cp1251.pyi
│   │   │   │   ├── cp1252.pyi
│   │   │   │   ├── cp1253.pyi
│   │   │   │   ├── cp1254.pyi
│   │   │   │   ├── cp1255.pyi
│   │   │   │   ├── cp1256.pyi
│   │   │   │   ├── cp1257.pyi
│   │   │   │   ├── cp1258.pyi
│   │   │   │   ├── cp273.pyi
│   │   │   │   ├── cp424.pyi
│   │   │   │   ├── cp437.pyi
│   │   │   │   ├── cp500.pyi
│   │   │   │   ├── cp720.pyi
│   │   │   │   ├── cp737.pyi
│   │   │   │   ├── cp775.pyi
│   │   │   │   ├── cp850.pyi
│   │   │   │   ├── cp852.pyi
│   │   │   │   ├── cp855.pyi
│   │   │   │   ├── cp856.pyi
│   │   │   │   ├── cp857.pyi
│   │   │   │   ├── cp858.pyi
│   │   │   │   ├── cp860.pyi
│   │   │   │   ├── cp861.pyi
│   │   │   │   ├── cp862.pyi
│   │   │   │   ├── cp863.pyi
│   │   │   │   ├── cp864.pyi
│   │   │   │   ├── cp865.pyi
│   │   │   │   ├── cp866.pyi
│   │   │   │   ├── cp869.pyi
│   │   │   │   ├── cp874.pyi
│   │   │   │   ├── cp875.pyi
│   │   │   │   ├── cp932.pyi
│   │   │   │   ├── cp949.pyi
│   │   │   │   ├── cp950.pyi
│   │   │   │   ├── euc_jis_2004.pyi
│   │   │   │   ├── euc_jisx0213.pyi
│   │   │   │   ├── euc_jp.pyi
│   │   │   │   ├── euc_kr.pyi
│   │   │   │   ├── gb18030.pyi
│   │   │   │   ├── gb2312.pyi
│   │   │   │   ├── gbk.pyi
│   │   │   │   ├── hex_codec.pyi
│   │   │   │   ├── hp_roman8.pyi
│   │   │   │   ├── hz.pyi
│   │   │   │   ├── idna.pyi
│   │   │   │   ├── iso2022_jp.pyi
│   │   │   │   ├── iso2022_jp_1.pyi
│   │   │   │   ├── iso2022_jp_2.pyi
│   │   │   │   ├── iso2022_jp_2004.pyi
│   │   │   │   ├── iso2022_jp_3.pyi
│   │   │   │   ├── iso2022_jp_ext.pyi
│   │   │   │   ├── iso2022_kr.pyi
│   │   │   │   ├── iso8859_1.pyi
│   │   │   │   ├── iso8859_10.pyi
│   │   │   │   ├── iso8859_11.pyi
│   │   │   │   ├── iso8859_13.pyi
│   │   │   │   ├── iso8859_14.pyi
│   │   │   │   ├── iso8859_15.pyi
│   │   │   │   ├── iso8859_16.pyi
│   │   │   │   ├── iso8859_2.pyi
│   │   │   │   ├── iso8859_3.pyi
│   │   │   │   ├── iso8859_4.pyi
│   │   │   │   ├── iso8859_5.pyi
│   │   │   │   ├── iso8859_6.pyi
│   │   │   │   ├── iso8859_7.pyi
│   │   │   │   ├── iso8859_8.pyi
│   │   │   │   ├── iso8859_9.pyi
│   │   │   │   ├── johab.pyi
│   │   │   │   ├── koi8_r.pyi
│   │   │   │   ├── koi8_t.pyi
│   │   │   │   ├── koi8_u.pyi
│   │   │   │   ├── kz1048.pyi
│   │   │   │   ├── latin_1.pyi
│   │   │   │   ├── mac_arabic.pyi
│   │   │   │   ├── mac_croatian.pyi
│   │   │   │   ├── mac_cyrillic.pyi
│   │   │   │   ├── mac_farsi.pyi
│   │   │   │   ├── mac_greek.pyi
│   │   │   │   ├── mac_iceland.pyi
│   │   │   │   ├── mac_latin2.pyi
│   │   │   │   ├── mac_roman.pyi
│   │   │   │   ├── mac_romanian.pyi
│   │   │   │   ├── mac_turkish.pyi
│   │   │   │   ├── mbcs.pyi
│   │   │   │   ├── oem.pyi
│   │   │   │   ├── palmos.pyi
│   │   │   │   ├── ptcp154.pyi
│   │   │   │   ├── punycode.pyi
│   │   │   │   ├── quopri_codec.pyi
│   │   │   │   ├── raw_unicode_escape.pyi
│   │   │   │   ├── rot_13.pyi
│   │   │   │   ├── shift_jis.pyi
│   │   │   │   ├── shift_jis_2004.pyi
│   │   │   │   ├── shift_jisx0213.pyi
│   │   │   │   ├── tis_620.pyi
│   │   │   │   ├── undefined.pyi
│   │   │   │   ├── unicode_escape.pyi
│   │   │   │   ├── utf_16.pyi
│   │   │   │   ├── utf_16_be.pyi
│   │   │   │   ├── utf_16_le.pyi
│   │   │   │   ├── utf_32.pyi
│   │   │   │   ├── utf_32_be.pyi
│   │   │   │   ├── utf_32_le.pyi
│   │   │   │   ├── utf_7.pyi
│   │   │   │   ├── utf_8.pyi
│   │   │   │   ├── utf_8_sig.pyi
│   │   │   │   ├── uu_codec.pyi
│   │   │   │   └── zlib_codec.pyi
│   │   │   ├── ensurepip/
│   │   │   │   └── __init__.pyi
│   │   │   ├── enum.pyi
│   │   │   ├── errno.pyi
│   │   │   ├── faulthandler.pyi
│   │   │   ├── fcntl.pyi
│   │   │   ├── filecmp.pyi
│   │   │   ├── fileinput.pyi
│   │   │   ├── fnmatch.pyi
│   │   │   ├── formatter.pyi
│   │   │   ├── fractions.pyi
│   │   │   ├── ftplib.pyi
│   │   │   ├── functools.pyi
│   │   │   ├── gc.pyi
│   │   │   ├── genericpath.pyi
│   │   │   ├── getopt.pyi
│   │   │   ├── getpass.pyi
│   │   │   ├── gettext.pyi
│   │   │   ├── glob.pyi
│   │   │   ├── graphlib.pyi
│   │   │   ├── grp.pyi
│   │   │   ├── gzip.pyi
│   │   │   ├── hashlib.pyi
│   │   │   ├── heapq.pyi
│   │   │   ├── hmac.pyi
│   │   │   ├── html/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── entities.pyi
│   │   │   │   └── parser.pyi
│   │   │   ├── http/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── client.pyi
│   │   │   │   ├── cookiejar.pyi
│   │   │   │   ├── cookies.pyi
│   │   │   │   └── server.pyi
│   │   │   ├── imaplib.pyi
│   │   │   ├── imghdr.pyi
│   │   │   ├── imp.pyi
│   │   │   ├── importlib/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _abc.pyi
│   │   │   │   ├── _bootstrap.pyi
│   │   │   │   ├── _bootstrap_external.pyi
│   │   │   │   ├── abc.pyi
│   │   │   │   ├── machinery.pyi
│   │   │   │   ├── metadata/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── _meta.pyi
│   │   │   │   │   └── diagnose.pyi
│   │   │   │   ├── readers.pyi
│   │   │   │   ├── resources/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── _common.pyi
│   │   │   │   │   ├── _functional.pyi
│   │   │   │   │   ├── abc.pyi
│   │   │   │   │   ├── readers.pyi
│   │   │   │   │   └── simple.pyi
│   │   │   │   ├── simple.pyi
│   │   │   │   └── util.pyi
│   │   │   ├── inspect.pyi
│   │   │   ├── io.pyi
│   │   │   ├── ipaddress.pyi
│   │   │   ├── itertools.pyi
│   │   │   ├── json/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── decoder.pyi
│   │   │   │   ├── encoder.pyi
│   │   │   │   ├── scanner.pyi
│   │   │   │   └── tool.pyi
│   │   │   ├── keyword.pyi
│   │   │   ├── lib2to3/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── btm_matcher.pyi
│   │   │   │   ├── fixer_base.pyi
│   │   │   │   ├── fixes/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── fix_apply.pyi
│   │   │   │   │   ├── fix_asserts.pyi
│   │   │   │   │   ├── fix_basestring.pyi
│   │   │   │   │   ├── fix_buffer.pyi
│   │   │   │   │   ├── fix_dict.pyi
│   │   │   │   │   ├── fix_except.pyi
│   │   │   │   │   ├── fix_exec.pyi
│   │   │   │   │   ├── fix_execfile.pyi
│   │   │   │   │   ├── fix_exitfunc.pyi
│   │   │   │   │   ├── fix_filter.pyi
│   │   │   │   │   ├── fix_funcattrs.pyi
│   │   │   │   │   ├── fix_future.pyi
│   │   │   │   │   ├── fix_getcwdu.pyi
│   │   │   │   │   ├── fix_has_key.pyi
│   │   │   │   │   ├── fix_idioms.pyi
│   │   │   │   │   ├── fix_import.pyi
│   │   │   │   │   ├── fix_imports.pyi
│   │   │   │   │   ├── fix_imports2.pyi
│   │   │   │   │   ├── fix_input.pyi
│   │   │   │   │   ├── fix_intern.pyi
│   │   │   │   │   ├── fix_isinstance.pyi
│   │   │   │   │   ├── fix_itertools.pyi
│   │   │   │   │   ├── fix_itertools_imports.pyi
│   │   │   │   │   ├── fix_long.pyi
│   │   │   │   │   ├── fix_map.pyi
│   │   │   │   │   ├── fix_metaclass.pyi
│   │   │   │   │   ├── fix_methodattrs.pyi
│   │   │   │   │   ├── fix_ne.pyi
│   │   │   │   │   ├── fix_next.pyi
│   │   │   │   │   ├── fix_nonzero.pyi
│   │   │   │   │   ├── fix_numliterals.pyi
│   │   │   │   │   ├── fix_operator.pyi
│   │   │   │   │   ├── fix_paren.pyi
│   │   │   │   │   ├── fix_print.pyi
│   │   │   │   │   ├── fix_raise.pyi
│   │   │   │   │   ├── fix_raw_input.pyi
│   │   │   │   │   ├── fix_reduce.pyi
│   │   │   │   │   ├── fix_reload.pyi
│   │   │   │   │   ├── fix_renames.pyi
│   │   │   │   │   ├── fix_repr.pyi
│   │   │   │   │   ├── fix_set_literal.pyi
│   │   │   │   │   ├── fix_standarderror.pyi
│   │   │   │   │   ├── fix_sys_exc.pyi
│   │   │   │   │   ├── fix_throw.pyi
│   │   │   │   │   ├── fix_tuple_params.pyi
│   │   │   │   │   ├── fix_types.pyi
│   │   │   │   │   ├── fix_unicode.pyi
│   │   │   │   │   ├── fix_urllib.pyi
│   │   │   │   │   ├── fix_ws_comma.pyi
│   │   │   │   │   ├── fix_xrange.pyi
│   │   │   │   │   ├── fix_xreadlines.pyi
│   │   │   │   │   └── fix_zip.pyi
│   │   │   │   ├── main.pyi
│   │   │   │   ├── pgen2/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── driver.pyi
│   │   │   │   │   ├── grammar.pyi
│   │   │   │   │   ├── literals.pyi
│   │   │   │   │   ├── parse.pyi
│   │   │   │   │   ├── pgen.pyi
│   │   │   │   │   ├── token.pyi
│   │   │   │   │   └── tokenize.pyi
│   │   │   │   ├── pygram.pyi
│   │   │   │   ├── pytree.pyi
│   │   │   │   └── refactor.pyi
│   │   │   ├── linecache.pyi
│   │   │   ├── locale.pyi
│   │   │   ├── logging/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── config.pyi
│   │   │   │   └── handlers.pyi
│   │   │   ├── lzma.pyi
│   │   │   ├── mailbox.pyi
│   │   │   ├── mailcap.pyi
│   │   │   ├── marshal.pyi
│   │   │   ├── math.pyi
│   │   │   ├── mimetypes.pyi
│   │   │   ├── mmap.pyi
│   │   │   ├── modulefinder.pyi
│   │   │   ├── msilib/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── schema.pyi
│   │   │   │   ├── sequence.pyi
│   │   │   │   └── text.pyi
│   │   │   ├── msvcrt.pyi
│   │   │   ├── multiprocessing/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── connection.pyi
│   │   │   │   ├── context.pyi
│   │   │   │   ├── dummy/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   └── connection.pyi
│   │   │   │   ├── forkserver.pyi
│   │   │   │   ├── heap.pyi
│   │   │   │   ├── managers.pyi
│   │   │   │   ├── pool.pyi
│   │   │   │   ├── popen_fork.pyi
│   │   │   │   ├── popen_forkserver.pyi
│   │   │   │   ├── popen_spawn_posix.pyi
│   │   │   │   ├── popen_spawn_win32.pyi
│   │   │   │   ├── process.pyi
│   │   │   │   ├── queues.pyi
│   │   │   │   ├── reduction.pyi
│   │   │   │   ├── resource_sharer.pyi
│   │   │   │   ├── resource_tracker.pyi
│   │   │   │   ├── shared_memory.pyi
│   │   │   │   ├── sharedctypes.pyi
│   │   │   │   ├── spawn.pyi
│   │   │   │   ├── synchronize.pyi
│   │   │   │   └── util.pyi
│   │   │   ├── netrc.pyi
│   │   │   ├── nis.pyi
│   │   │   ├── nntplib.pyi
│   │   │   ├── nt.pyi
│   │   │   ├── ntpath.pyi
│   │   │   ├── nturl2path.pyi
│   │   │   ├── numbers.pyi
│   │   │   ├── opcode.pyi
│   │   │   ├── operator.pyi
│   │   │   ├── optparse.pyi
│   │   │   ├── os/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── path.pyi
│   │   │   ├── ossaudiodev.pyi
│   │   │   ├── parser.pyi
│   │   │   ├── pathlib/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── types.pyi
│   │   │   ├── pdb.pyi
│   │   │   ├── pickle.pyi
│   │   │   ├── pickletools.pyi
│   │   │   ├── pipes.pyi
│   │   │   ├── pkgutil.pyi
│   │   │   ├── platform.pyi
│   │   │   ├── plistlib.pyi
│   │   │   ├── poplib.pyi
│   │   │   ├── posix.pyi
│   │   │   ├── posixpath.pyi
│   │   │   ├── pprint.pyi
│   │   │   ├── profile.pyi
│   │   │   ├── pstats.pyi
│   │   │   ├── pty.pyi
│   │   │   ├── pwd.pyi
│   │   │   ├── py_compile.pyi
│   │   │   ├── pyclbr.pyi
│   │   │   ├── pydoc.pyi
│   │   │   ├── pydoc_data/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── module_docs.pyi
│   │   │   │   └── topics.pyi
│   │   │   ├── pyexpat/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── errors.pyi
│   │   │   │   └── model.pyi
│   │   │   ├── queue.pyi
│   │   │   ├── quopri.pyi
│   │   │   ├── random.pyi
│   │   │   ├── re.pyi
│   │   │   ├── readline.pyi
│   │   │   ├── reprlib.pyi
│   │   │   ├── resource.pyi
│   │   │   ├── rlcompleter.pyi
│   │   │   ├── runpy.pyi
│   │   │   ├── sched.pyi
│   │   │   ├── secrets.pyi
│   │   │   ├── select.pyi
│   │   │   ├── selectors.pyi
│   │   │   ├── shelve.pyi
│   │   │   ├── shlex.pyi
│   │   │   ├── shutil.pyi
│   │   │   ├── signal.pyi
│   │   │   ├── site.pyi
│   │   │   ├── smtpd.pyi
│   │   │   ├── smtplib.pyi
│   │   │   ├── sndhdr.pyi
│   │   │   ├── socket.pyi
│   │   │   ├── socketserver.pyi
│   │   │   ├── spwd.pyi
│   │   │   ├── sqlite3/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── dbapi2.pyi
│   │   │   │   └── dump.pyi
│   │   │   ├── sre_compile.pyi
│   │   │   ├── sre_constants.pyi
│   │   │   ├── sre_parse.pyi
│   │   │   ├── ssl.pyi
│   │   │   ├── stat.pyi
│   │   │   ├── statistics.pyi
│   │   │   ├── string/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── templatelib.pyi
│   │   │   ├── stringprep.pyi
│   │   │   ├── struct.pyi
│   │   │   ├── subprocess.pyi
│   │   │   ├── sunau.pyi
│   │   │   ├── symbol.pyi
│   │   │   ├── symtable.pyi
│   │   │   ├── sys/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── _monitoring.pyi
│   │   │   ├── sysconfig.pyi
│   │   │   ├── syslog.pyi
│   │   │   ├── tabnanny.pyi
│   │   │   ├── tarfile.pyi
│   │   │   ├── telnetlib.pyi
│   │   │   ├── tempfile.pyi
│   │   │   ├── termios.pyi
│   │   │   ├── textwrap.pyi
│   │   │   ├── this.pyi
│   │   │   ├── threading.pyi
│   │   │   ├── time.pyi
│   │   │   ├── timeit.pyi
│   │   │   ├── tkinter/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── colorchooser.pyi
│   │   │   │   ├── commondialog.pyi
│   │   │   │   ├── constants.pyi
│   │   │   │   ├── dialog.pyi
│   │   │   │   ├── dnd.pyi
│   │   │   │   ├── filedialog.pyi
│   │   │   │   ├── font.pyi
│   │   │   │   ├── messagebox.pyi
│   │   │   │   ├── scrolledtext.pyi
│   │   │   │   ├── simpledialog.pyi
│   │   │   │   ├── tix.pyi
│   │   │   │   └── ttk.pyi
│   │   │   ├── token.pyi
│   │   │   ├── tokenize.pyi
│   │   │   ├── tomllib.pyi
│   │   │   ├── trace.pyi
│   │   │   ├── traceback.pyi
│   │   │   ├── tracemalloc.pyi
│   │   │   ├── tty.pyi
│   │   │   ├── turtle.pyi
│   │   │   ├── types.pyi
│   │   │   ├── typing.pyi
│   │   │   ├── typing_extensions.pyi
│   │   │   ├── unicodedata.pyi
│   │   │   ├── unittest/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _log.pyi
│   │   │   │   ├── async_case.pyi
│   │   │   │   ├── case.pyi
│   │   │   │   ├── loader.pyi
│   │   │   │   ├── main.pyi
│   │   │   │   ├── mock.pyi
│   │   │   │   ├── result.pyi
│   │   │   │   ├── runner.pyi
│   │   │   │   ├── signals.pyi
│   │   │   │   ├── suite.pyi
│   │   │   │   └── util.pyi
│   │   │   ├── urllib/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── error.pyi
│   │   │   │   ├── parse.pyi
│   │   │   │   ├── request.pyi
│   │   │   │   ├── response.pyi
│   │   │   │   └── robotparser.pyi
│   │   │   ├── uu.pyi
│   │   │   ├── uuid.pyi
│   │   │   ├── warnings.pyi
│   │   │   ├── wave.pyi
│   │   │   ├── weakref.pyi
│   │   │   ├── webbrowser.pyi
│   │   │   ├── winreg.pyi
│   │   │   ├── winsound.pyi
│   │   │   ├── wsgiref/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── handlers.pyi
│   │   │   │   ├── headers.pyi
│   │   │   │   ├── simple_server.pyi
│   │   │   │   ├── types.pyi
│   │   │   │   ├── util.pyi
│   │   │   │   └── validate.pyi
│   │   │   ├── xdrlib.pyi
│   │   │   ├── xml/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── dom/
│   │   │   │   │   ├── NodeFilter.pyi
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── domreg.pyi
│   │   │   │   │   ├── expatbuilder.pyi
│   │   │   │   │   ├── minicompat.pyi
│   │   │   │   │   ├── minidom.pyi
│   │   │   │   │   ├── pulldom.pyi
│   │   │   │   │   └── xmlbuilder.pyi
│   │   │   │   ├── etree/
│   │   │   │   │   ├── ElementInclude.pyi
│   │   │   │   │   ├── ElementPath.pyi
│   │   │   │   │   ├── ElementTree.pyi
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   └── cElementTree.pyi
│   │   │   │   ├── parsers/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   └── expat/
│   │   │   │   │       ├── __init__.pyi
│   │   │   │   │       ├── errors.pyi
│   │   │   │   │       └── model.pyi
│   │   │   │   └── sax/
│   │   │   │       ├── __init__.pyi
│   │   │   │       ├── _exceptions.pyi
│   │   │   │       ├── expatreader.pyi
│   │   │   │       ├── handler.pyi
│   │   │   │       ├── saxutils.pyi
│   │   │   │       └── xmlreader.pyi
│   │   │   ├── xmlrpc/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── client.pyi
│   │   │   │   └── server.pyi
│   │   │   ├── xxlimited.pyi
│   │   │   ├── zipapp.pyi
│   │   │   ├── zipfile/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── _path/
│   │   │   │       ├── __init__.pyi
│   │   │   │       └── glob.pyi
│   │   │   ├── zipimport.pyi
│   │   │   ├── zlib.pyi
│   │   │   └── zoneinfo/
│   │   │       ├── __init__.pyi
│   │   │       ├── _common.pyi
│   │   │       └── _tzpath.pyi
│   │   └── stubs/
│   │       ├── librt/
│   │       │   ├── METADATA.toml
│   │       │   └── librt/
│   │       │       ├── __init__.pyi
│   │       │       ├── base64.pyi
│   │       │       ├── internal.pyi
│   │       │       ├── strings.pyi
│   │       │       ├── time.pyi
│   │       │       └── vecs.pyi
│   │       └── mypy-extensions/
│   │           ├── @tests/
│   │           │   └── stubtest_allowlist.txt
│   │           ├── METADATA.toml
│   │           └── mypy_extensions.pyi
│   ├── typestate.py
│   ├── typetraverser.py
│   ├── typevars.py
│   ├── typevartuples.py
│   ├── util.py
│   ├── version.py
│   ├── visitor.py
│   └── xml/
│       ├── mypy-html.css
│       ├── mypy-html.xslt
│       ├── mypy-txt.xslt
│       └── mypy.xsd
├── mypy-requirements.txt
├── mypy_bootstrap.ini
├── mypy_self_check.ini
├── mypyc/
│   ├── .readthedocs.yaml
│   ├── README.md
│   ├── __init__.py
│   ├── __main__.py
│   ├── analysis/
│   │   ├── __init__.py
│   │   ├── attrdefined.py
│   │   ├── blockfreq.py
│   │   ├── capsule_deps.py
│   │   ├── dataflow.py
│   │   ├── ircheck.py
│   │   └── selfleaks.py
│   ├── annotate.py
│   ├── build.py
│   ├── build_setup.py
│   ├── codegen/
│   │   ├── __init__.py
│   │   ├── cstring.py
│   │   ├── emit.py
│   │   ├── emitclass.py
│   │   ├── emitfunc.py
│   │   ├── emitmodule.py
│   │   ├── emitwrapper.py
│   │   └── literals.py
│   ├── common.py
│   ├── crash.py
│   ├── doc/
│   │   ├── Makefile
│   │   ├── bool_operations.rst
│   │   ├── bytearray_operations.rst
│   │   ├── bytes_operations.rst
│   │   ├── compilation_units.rst
│   │   ├── conf.py
│   │   ├── cpython-timings.md
│   │   ├── dev-intro.md
│   │   ├── dict_operations.rst
│   │   ├── differences_from_python.rst
│   │   ├── float_operations.rst
│   │   ├── frozenset_operations.rst
│   │   ├── future.md
│   │   ├── getting_started.rst
│   │   ├── index.rst
│   │   ├── int_operations.rst
│   │   ├── introduction.rst
│   │   ├── list_operations.rst
│   │   ├── make.bat
│   │   ├── native_classes.rst
│   │   ├── native_operations.rst
│   │   ├── performance_tips_and_tricks.rst
│   │   ├── set_operations.rst
│   │   ├── str_operations.rst
│   │   ├── tuple_operations.rst
│   │   └── using_type_annotations.rst
│   ├── errors.py
│   ├── external/
│   │   └── googletest/
│   │       ├── LICENSE
│   │       ├── README.md
│   │       ├── make/
│   │       │   └── Makefile
│   │       └── src/
│   │           ├── gtest-all.cc
│   │           ├── gtest-death-test.cc
│   │           ├── gtest-filepath.cc
│   │           ├── gtest-internal-inl.h
│   │           ├── gtest-port.cc
│   │           ├── gtest-printers.cc
│   │           ├── gtest-test-part.cc
│   │           ├── gtest-typed-test.cc
│   │           ├── gtest.cc
│   │           └── gtest_main.cc
│   ├── ir/
│   │   ├── __init__.py
│   │   ├── class_ir.py
│   │   ├── deps.py
│   │   ├── func_ir.py
│   │   ├── module_ir.py
│   │   ├── ops.py
│   │   ├── pprint.py
│   │   └── rtypes.py
│   ├── irbuild/
│   │   ├── __init__.py
│   │   ├── ast_helpers.py
│   │   ├── builder.py
│   │   ├── callable_class.py
│   │   ├── classdef.py
│   │   ├── constant_fold.py
│   │   ├── context.py
│   │   ├── env_class.py
│   │   ├── expression.py
│   │   ├── for_helpers.py
│   │   ├── format_str_tokenizer.py
│   │   ├── function.py
│   │   ├── generator.py
│   │   ├── ll_builder.py
│   │   ├── main.py
│   │   ├── mapper.py
│   │   ├── match.py
│   │   ├── missingtypevisitor.py
│   │   ├── nonlocalcontrol.py
│   │   ├── prebuildvisitor.py
│   │   ├── prepare.py
│   │   ├── specialize.py
│   │   ├── statement.py
│   │   ├── targets.py
│   │   ├── util.py
│   │   ├── vec.py
│   │   ├── visitor.py
│   │   └── vtable.py
│   ├── lib-rt/
│   │   ├── CPy.h
│   │   ├── base64/
│   │   │   ├── arch/
│   │   │   │   ├── avx/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   └── enc_loop_asm.c
│   │   │   │   ├── avx2/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── dec_loop.c
│   │   │   │   │   ├── dec_reshuffle.c
│   │   │   │   │   ├── enc_loop.c
│   │   │   │   │   ├── enc_loop_asm.c
│   │   │   │   │   ├── enc_reshuffle.c
│   │   │   │   │   └── enc_translate.c
│   │   │   │   ├── avx512/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── enc_loop.c
│   │   │   │   │   └── enc_reshuffle_translate.c
│   │   │   │   ├── generic/
│   │   │   │   │   ├── 32/
│   │   │   │   │   │   ├── dec_loop.c
│   │   │   │   │   │   └── enc_loop.c
│   │   │   │   │   ├── 64/
│   │   │   │   │   │   └── enc_loop.c
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── dec_head.c
│   │   │   │   │   ├── dec_tail.c
│   │   │   │   │   ├── enc_head.c
│   │   │   │   │   └── enc_tail.c
│   │   │   │   ├── neon32/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── dec_loop.c
│   │   │   │   │   ├── enc_loop.c
│   │   │   │   │   ├── enc_reshuffle.c
│   │   │   │   │   └── enc_translate.c
│   │   │   │   ├── neon64/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── dec_loop.c
│   │   │   │   │   ├── enc_loop.c
│   │   │   │   │   ├── enc_loop_asm.c
│   │   │   │   │   └── enc_reshuffle.c
│   │   │   │   ├── sse41/
│   │   │   │   │   └── codec.c
│   │   │   │   ├── sse42/
│   │   │   │   │   └── codec.c
│   │   │   │   └── ssse3/
│   │   │   │       ├── codec.c
│   │   │   │       ├── dec_loop.c
│   │   │   │       ├── dec_reshuffle.c
│   │   │   │       ├── enc_loop.c
│   │   │   │       ├── enc_loop_asm.c
│   │   │   │       ├── enc_reshuffle.c
│   │   │   │       └── enc_translate.c
│   │   │   ├── codec_choose.c
│   │   │   ├── codecs.h
│   │   │   ├── config.h
│   │   │   ├── env.h
│   │   │   ├── lib.c
│   │   │   ├── lib_openmp.c
│   │   │   ├── libbase64.h
│   │   │   ├── librt_base64.c
│   │   │   ├── librt_base64.h
│   │   │   └── tables/
│   │   │       ├── table_dec_32bit.h
│   │   │       ├── table_enc_12bit.h
│   │   │       ├── tables.c
│   │   │       └── tables.h
│   │   ├── build_setup.py
│   │   ├── bytearray_extra_ops.c
│   │   ├── bytearray_extra_ops.h
│   │   ├── bytes_extra_ops.c
│   │   ├── bytes_extra_ops.h
│   │   ├── bytes_ops.c
│   │   ├── byteswriter_extra_ops.c
│   │   ├── byteswriter_extra_ops.h
│   │   ├── dict_ops.c
│   │   ├── exc_ops.c
│   │   ├── float_ops.c
│   │   ├── function_wrapper.c
│   │   ├── generic_ops.c
│   │   ├── getargs.c
│   │   ├── getargsfast.c
│   │   ├── init.c
│   │   ├── int_ops.c
│   │   ├── internal/
│   │   │   ├── librt_internal.c
│   │   │   └── librt_internal.h
│   │   ├── list_ops.c
│   │   ├── misc_ops.c
│   │   ├── module_shim.tmpl
│   │   ├── module_shim_no_gil_multiphase.tmpl
│   │   ├── mypyc_util.h
│   │   ├── pythoncapi_compat.h
│   │   ├── pythonsupport.c
│   │   ├── pythonsupport.h
│   │   ├── set_ops.c
│   │   ├── setup.py
│   │   ├── static_data.c
│   │   ├── static_data.h
│   │   ├── str_extra_ops.c
│   │   ├── str_extra_ops.h
│   │   ├── str_ops.c
│   │   ├── strings/
│   │   │   ├── librt_strings.c
│   │   │   ├── librt_strings.h
│   │   │   └── librt_strings_common.h
│   │   ├── stringwriter_extra_ops.c
│   │   ├── stringwriter_extra_ops.h
│   │   ├── test_capi.cc
│   │   ├── time/
│   │   │   ├── librt_time.c
│   │   │   └── librt_time.h
│   │   ├── tuple_ops.c
│   │   ├── vecs/
│   │   │   ├── librt_vecs.c
│   │   │   ├── librt_vecs.h
│   │   │   ├── vec_bool.c
│   │   │   ├── vec_float.c
│   │   │   ├── vec_i16.c
│   │   │   ├── vec_i32.c
│   │   │   ├── vec_i64.c
│   │   │   ├── vec_nested.c
│   │   │   ├── vec_t.c
│   │   │   ├── vec_template.c
│   │   │   ├── vec_u8.c
│   │   │   └── vecs_internal.h
│   │   ├── vecs_extra_ops.c
│   │   └── vecs_extra_ops.h
│   ├── lower/
│   │   ├── __init__.py
│   │   ├── int_ops.py
│   │   ├── list_ops.py
│   │   ├── misc_ops.py
│   │   └── registry.py
│   ├── namegen.py
│   ├── options.py
│   ├── primitives/
│   │   ├── __init__.py
│   │   ├── bytearray_ops.py
│   │   ├── bytes_ops.py
│   │   ├── dict_ops.py
│   │   ├── exc_ops.py
│   │   ├── float_ops.py
│   │   ├── generic_ops.py
│   │   ├── int_ops.py
│   │   ├── librt_strings_ops.py
│   │   ├── librt_time_ops.py
│   │   ├── librt_vecs_ops.py
│   │   ├── list_ops.py
│   │   ├── misc_ops.py
│   │   ├── registry.py
│   │   ├── set_ops.py
│   │   ├── str_ops.py
│   │   ├── tuple_ops.py
│   │   └── weakref_ops.py
│   ├── py.typed
│   ├── rt_subtype.py
│   ├── sametype.py
│   ├── subtype.py
│   ├── test/
│   │   ├── __init__.py
│   │   ├── config.py
│   │   ├── librt_cache.py
│   │   ├── test_alwaysdefined.py
│   │   ├── test_analysis.py
│   │   ├── test_annotate.py
│   │   ├── test_capsule_deps.py
│   │   ├── test_cheader.py
│   │   ├── test_commandline.py
│   │   ├── test_emit.py
│   │   ├── test_emitclass.py
│   │   ├── test_emitfunc.py
│   │   ├── test_emitwrapper.py
│   │   ├── test_exceptions.py
│   │   ├── test_external.py
│   │   ├── test_irbuild.py
│   │   ├── test_ircheck.py
│   │   ├── test_literals.py
│   │   ├── test_lowering.py
│   │   ├── test_misc.py
│   │   ├── test_namegen.py
│   │   ├── test_optimizations.py
│   │   ├── test_pprint.py
│   │   ├── test_rarray.py
│   │   ├── test_refcount.py
│   │   ├── test_run.py
│   │   ├── test_serialization.py
│   │   ├── test_struct.py
│   │   ├── test_tuplename.py
│   │   ├── test_typeops.py
│   │   └── testutil.py
│   ├── test-data/
│   │   ├── alwaysdefined.test
│   │   ├── analysis.test
│   │   ├── annotate-basic.test
│   │   ├── capsule-deps.test
│   │   ├── commandline.test
│   │   ├── driver/
│   │   │   └── driver.py
│   │   ├── exceptions-freq.test
│   │   ├── exceptions.test
│   │   ├── fixtures/
│   │   │   ├── ir.py
│   │   │   ├── testutil.py
│   │   │   └── typing-full.pyi
│   │   ├── irbuild-any.test
│   │   ├── irbuild-base64.test
│   │   ├── irbuild-basic.test
│   │   ├── irbuild-bool.test
│   │   ├── irbuild-bytes.test
│   │   ├── irbuild-classes.test
│   │   ├── irbuild-constant-fold.test
│   │   ├── irbuild-dict.test
│   │   ├── irbuild-dunders.test
│   │   ├── irbuild-float.test
│   │   ├── irbuild-frozenset.test
│   │   ├── irbuild-generics.test
│   │   ├── irbuild-glue-methods.test
│   │   ├── irbuild-i16.test
│   │   ├── irbuild-i32.test
│   │   ├── irbuild-i64.test
│   │   ├── irbuild-int.test
│   │   ├── irbuild-isinstance.test
│   │   ├── irbuild-librt-strings.test
│   │   ├── irbuild-lists.test
│   │   ├── irbuild-match.test
│   │   ├── irbuild-math.test
│   │   ├── irbuild-nested.test
│   │   ├── irbuild-optional.test
│   │   ├── irbuild-python314.test
│   │   ├── irbuild-set.test
│   │   ├── irbuild-singledispatch.test
│   │   ├── irbuild-statements.test
│   │   ├── irbuild-str.test
│   │   ├── irbuild-strip-asserts.test
│   │   ├── irbuild-time.test
│   │   ├── irbuild-try.test
│   │   ├── irbuild-tuple.test
│   │   ├── irbuild-u8.test
│   │   ├── irbuild-unreachable.test
│   │   ├── irbuild-vec-i64.test
│   │   ├── irbuild-vec-misc.test
│   │   ├── irbuild-vec-nested.test
│   │   ├── irbuild-vec-t.test
│   │   ├── irbuild-vectorcall.test
│   │   ├── irbuild-weakref.test
│   │   ├── lowering-int.test
│   │   ├── lowering-list.test
│   │   ├── opt-copy-propagation.test
│   │   ├── opt-flag-elimination.test
│   │   ├── refcount.test
│   │   ├── run-async.test
│   │   ├── run-attrs.test
│   │   ├── run-base64.test
│   │   ├── run-bench.test
│   │   ├── run-bools.test
│   │   ├── run-bytes.test
│   │   ├── run-classes.test
│   │   ├── run-dicts.test
│   │   ├── run-dunders-special.test
│   │   ├── run-dunders.test
│   │   ├── run-exceptions.test
│   │   ├── run-floats.test
│   │   ├── run-functions.test
│   │   ├── run-generators.test
│   │   ├── run-generics.test
│   │   ├── run-i16.test
│   │   ├── run-i32.test
│   │   ├── run-i64.test
│   │   ├── run-imports.test
│   │   ├── run-integers.test
│   │   ├── run-librt-strings.test
│   │   ├── run-librt-time.test
│   │   ├── run-lists.test
│   │   ├── run-loops.test
│   │   ├── run-match.test
│   │   ├── run-math.test
│   │   ├── run-misc.test
│   │   ├── run-multimodule.test
│   │   ├── run-mypy-sim.test
│   │   ├── run-primitives.test
│   │   ├── run-python312.test
│   │   ├── run-python37.test
│   │   ├── run-python38.test
│   │   ├── run-sets.test
│   │   ├── run-signatures.test
│   │   ├── run-singledispatch.test
│   │   ├── run-strings.test
│   │   ├── run-traits.test
│   │   ├── run-tuples.test
│   │   ├── run-u8.test
│   │   ├── run-vecs-i64-interp.test
│   │   ├── run-vecs-i64.test
│   │   ├── run-vecs-misc-interp.test
│   │   ├── run-vecs-misc.test
│   │   ├── run-vecs-nested-interp.test
│   │   ├── run-vecs-nested.test
│   │   ├── run-vecs-t-interp.test
│   │   ├── run-vecs-t.test
│   │   └── run-weakref.test
│   └── transform/
│       ├── __init__.py
│       ├── copy_propagation.py
│       ├── exceptions.py
│       ├── flag_elimination.py
│       ├── ir_transform.py
│       ├── log_trace.py
│       ├── lower.py
│       ├── refcount.py
│       ├── spill.py
│       └── uninit.py
├── pyproject.toml
├── runtests.py
├── setup.py
├── test-data/
│   ├── packages/
│   │   ├── modulefinder/
│   │   │   ├── nsx-pkg1/
│   │   │   │   └── nsx/
│   │   │   │       └── a/
│   │   │   │           └── __init__.py
│   │   │   ├── nsx-pkg2/
│   │   │   │   └── nsx/
│   │   │   │       └── b/
│   │   │   │           └── __init__.py
│   │   │   ├── nsx-pkg3/
│   │   │   │   └── nsx/
│   │   │   │       └── c/
│   │   │   │           ├── c
│   │   │   │           └── c.py
│   │   │   ├── nsy-pkg1/
│   │   │   │   └── nsy/
│   │   │   │       └── a/
│   │   │   │           ├── __init__.py
│   │   │   │           └── __init__.pyi
│   │   │   ├── nsy-pkg2/
│   │   │   │   └── nsy/
│   │   │   │       ├── b/
│   │   │   │       │   └── __init__.py
│   │   │   │       ├── b.pyi
│   │   │   │       ├── c.py
│   │   │   │       └── c.pyi
│   │   │   ├── pkg1/
│   │   │   │   ├── a
│   │   │   │   └── a.py
│   │   │   ├── pkg2/
│   │   │   │   └── b/
│   │   │   │       └── __init__.py
│   │   │   └── readme.txt
│   │   ├── modulefinder-site-packages/
│   │   │   ├── baz/
│   │   │   │   ├── baz_pkg/
│   │   │   │   │   ├── __init__.py
│   │   │   │   │   └── py.typed
│   │   │   │   └── ns_baz_pkg/
│   │   │   │       ├── a.py
│   │   │   │       └── py.typed
│   │   │   ├── foo/
│   │   │   │   ├── __init__.py
│   │   │   │   └── bar.py
│   │   │   ├── foo-stubs/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── bar.pyi
│   │   │   │   └── qux.pyi
│   │   │   ├── ns_pkg_typed/
│   │   │   │   ├── a.py
│   │   │   │   ├── b/
│   │   │   │   │   └── c.py
│   │   │   │   └── py.typed
│   │   │   ├── ns_pkg_untyped/
│   │   │   │   ├── a.py
│   │   │   │   └── b/
│   │   │   │       └── c.py
│   │   │   ├── ns_pkg_w_stubs/
│   │   │   │   ├── typed/
│   │   │   │   │   └── __init__.py
│   │   │   │   ├── typed_inline/
│   │   │   │   │   ├── __init__.py
│   │   │   │   │   └── py.typed
│   │   │   │   └── untyped/
│   │   │   │       └── __init__.py
│   │   │   ├── ns_pkg_w_stubs-stubs/
│   │   │   │   └── typed/
│   │   │   │       └── __init__.pyi
│   │   │   ├── pkg_typed/
│   │   │   │   ├── __init__.py
│   │   │   │   ├── a.py
│   │   │   │   ├── b/
│   │   │   │   │   ├── __init__.py
│   │   │   │   │   └── c.py
│   │   │   │   └── py.typed
│   │   │   ├── pkg_typed_w_stubs/
│   │   │   │   ├── __init__.py
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── py.typed
│   │   │   │   ├── spam.py
│   │   │   │   └── spam.pyi
│   │   │   ├── pkg_typed_w_stubs-stubs/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── spam.pyi
│   │   │   ├── pkg_untyped/
│   │   │   │   ├── __init__.py
│   │   │   │   ├── a.py
│   │   │   │   └── b/
│   │   │   │       ├── __init__.py
│   │   │   │       └── c.py
│   │   │   └── standalone.py
│   │   ├── modulefinder-src/
│   │   │   ├── neighbor_pkg/
│   │   │   │   ├── __init__.py
│   │   │   │   └── py.typed
│   │   │   └── ns_neighbor_pkg/
│   │   │       ├── a.py
│   │   │       └── py.typed
│   │   ├── typedpkg/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg/
│   │   │       ├── __init__.py
│   │   │       ├── dne.py
│   │   │       ├── pkg/
│   │   │       │   ├── __init__.py
│   │   │       │   ├── aaa.py
│   │   │       │   └── py.typed
│   │   │       ├── py.typed
│   │   │       └── sample.py
│   │   ├── typedpkg-stubs/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg-stubs/
│   │   │       ├── __init__.pyi
│   │   │       ├── py.typed
│   │   │       └── sample.pyi
│   │   ├── typedpkg_ns_a/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg_ns/
│   │   │       ├── __init__.py
│   │   │       └── a/
│   │   │           ├── __init__.py
│   │   │           ├── bbb.py
│   │   │           └── py.typed
│   │   ├── typedpkg_ns_b/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg_ns/
│   │   │       ├── __init__.py
│   │   │       └── b/
│   │   │           ├── __init__.py
│   │   │           └── bbb.py
│   │   ├── typedpkg_ns_b-stubs/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg_ns-stubs/
│   │   │       └── b/
│   │   │           ├── __init__.pyi
│   │   │           └── bbb.pyi
│   │   └── typedpkg_ns_nested/
│   │       ├── pyproject.toml
│   │       └── typedpkg_ns/
│   │           ├── a/
│   │           │   ├── __init__.py
│   │           │   └── py.typed
│   │           └── b/
│   │               └── __init__.py
│   ├── pybind11_fixtures/
│   │   ├── expected_stubs_no_docs/
│   │   │   └── pybind11_fixtures/
│   │   │       ├── __init__.pyi
│   │   │       └── demo.pyi
│   │   ├── expected_stubs_with_docs/
│   │   │   └── pybind11_fixtures/
│   │   │       ├── __init__.pyi
│   │   │       └── demo.pyi
│   │   ├── pyproject.toml
│   │   ├── setup.py
│   │   └── src/
│   │       └── main.cpp
│   └── unit/
│       ├── README.md
│       ├── check-abstract.test
│       ├── check-annotated.test
│       ├── check-assert-type-fail.test
│       ├── check-async-await.test
│       ├── check-basic.test
│       ├── check-bound.test
│       ├── check-callable.test
│       ├── check-class-namedtuple.test
│       ├── check-classes.test
│       ├── check-classvar.test
│       ├── check-columns.test
│       ├── check-ctypes.test
│       ├── check-custom-plugin.test
│       ├── check-dataclass-transform.test
│       ├── check-dataclasses.test
│       ├── check-deprecated.test
│       ├── check-dynamic-typing.test
│       ├── check-enum.test
│       ├── check-errorcodes.test
│       ├── check-expressions.test
│       ├── check-fastparse.test
│       ├── check-final.test
│       ├── check-flags.test
│       ├── check-formatting.test
│       ├── check-functions.test
│       ├── check-functools.test
│       ├── check-generic-alias.test
│       ├── check-generic-subtyping.test
│       ├── check-generics.test
│       ├── check-ignore.test
│       ├── check-incomplete-fixture.test
│       ├── check-incremental.test
│       ├── check-inference-context.test
│       ├── check-inference.test
│       ├── check-inline-config.test
│       ├── check-isinstance.test
│       ├── check-itertools.test
│       ├── check-kwargs.test
│       ├── check-lists.test
│       ├── check-literal.test
│       ├── check-lowercase.test
│       ├── check-modules-case.test
│       ├── check-modules-fast.test
│       ├── check-modules.test
│       ├── check-multiple-inheritance.test
│       ├── check-namedtuple.test
│       ├── check-narrowing.test
│       ├── check-native-int.test
│       ├── check-newsemanal.test
│       ├── check-newsyntax.test
│       ├── check-newtype.test
│       ├── check-optional.test
│       ├── check-overloading.test
│       ├── check-parameter-specification.test
│       ├── check-plugin-attrs.test
│       ├── check-plugin-error-codes.test
│       ├── check-possibly-undefined.test
│       ├── check-protocols.test
│       ├── check-python310.test
│       ├── check-python311.test
│       ├── check-python312.test
│       ├── check-python313.test
│       ├── check-python314.test
│       ├── check-python38.test
│       ├── check-python39.test
│       ├── check-recursive-types.test
│       ├── check-redefine.test
│       ├── check-redefine2.test
│       ├── check-reports.test
│       ├── check-selftype.test
│       ├── check-semanal-error.test
│       ├── check-serialize.test
│       ├── check-singledispatch.test
│       ├── check-slots.test
│       ├── check-statements.test
│       ├── check-super.test
│       ├── check-tuples.test
│       ├── check-type-aliases.test
│       ├── check-type-checks.test
│       ├── check-type-object-type-inference.test
│       ├── check-type-promotion.test
│       ├── check-typeddict.test
│       ├── check-typeform.test
│       ├── check-typeguard.test
│       ├── check-typeis.test
│       ├── check-typevar-defaults.test
│       ├── check-typevar-tuple.test
│       ├── check-typevar-unbound.test
│       ├── check-typevar-values.test
│       ├── check-underscores.test
│       ├── check-union-error-syntax.test
│       ├── check-union-or-syntax.test
│       ├── check-unions.test
│       ├── check-unreachable-code.test
│       ├── check-unsupported.test
│       ├── check-varargs.test
│       ├── check-vec.test
│       ├── check-warnings.test
│       ├── cmdline.pyproject.test
│       ├── cmdline.test
│       ├── daemon.test
│       ├── deps-classes.test
│       ├── deps-expressions.test
│       ├── deps-generics.test
│       ├── deps-statements.test
│       ├── deps-types.test
│       ├── deps.test
│       ├── diff.test
│       ├── envvars.test
│       ├── errorstream.test
│       ├── exportjson.test
│       ├── fine-grained-attr.test
│       ├── fine-grained-blockers.test
│       ├── fine-grained-cache-incremental.test
│       ├── fine-grained-cycles.test
│       ├── fine-grained-dataclass-transform.test
│       ├── fine-grained-dataclass.test
│       ├── fine-grained-follow-imports.test
│       ├── fine-grained-inspect.test
│       ├── fine-grained-modules.test
│       ├── fine-grained-python312.test
│       ├── fine-grained-python314.test
│       ├── fine-grained-suggest.test
│       ├── fine-grained.test
│       ├── fixtures/
│       │   ├── __init_subclass__.pyi
│       │   ├── __new__.pyi
│       │   ├── alias.pyi
│       │   ├── any.pyi
│       │   ├── args.pyi
│       │   ├── async_await.pyi
│       │   ├── bool.pyi
│       │   ├── callable.pyi
│       │   ├── classmethod.pyi
│       │   ├── complex.pyi
│       │   ├── complex_tuple.pyi
│       │   ├── dataclasses.pyi
│       │   ├── dict-full.pyi
│       │   ├── dict.pyi
│       │   ├── divmod.pyi
│       │   ├── enum.pyi
│       │   ├── exception.pyi
│       │   ├── f_string.pyi
│       │   ├── fine_grained.pyi
│       │   ├── float.pyi
│       │   ├── floatdict.pyi
│       │   ├── for.pyi
│       │   ├── for_else_exception.pyi
│       │   ├── function.pyi
│       │   ├── isinstance.pyi
│       │   ├── isinstance_python3_10.pyi
│       │   ├── isinstancelist.pyi
│       │   ├── len.pyi
│       │   ├── list.pyi
│       │   ├── literal__new__.pyi
│       │   ├── module.pyi
│       │   ├── module_all.pyi
│       │   ├── narrowing.pyi
│       │   ├── notimplemented.pyi
│       │   ├── object_hashable.pyi
│       │   ├── object_with_init_subclass.pyi
│       │   ├── ops.pyi
│       │   ├── paramspec.pyi
│       │   ├── plugin_attrs.pyi
│       │   ├── primitives.pyi
│       │   ├── property.pyi
│       │   ├── set.pyi
│       │   ├── slice.pyi
│       │   ├── staticmethod.pyi
│       │   ├── transform.pyi
│       │   ├── tuple-simple.pyi
│       │   ├── tuple-typeshed.pyi
│       │   ├── tuple.pyi
│       │   ├── type.pyi
│       │   ├── typing-async.pyi
│       │   ├── typing-full.pyi
│       │   ├── typing-medium.pyi
│       │   ├── typing-namedtuple.pyi
│       │   ├── typing-override.pyi
│       │   ├── typing-typeddict-iror.pyi
│       │   ├── typing-typeddict.pyi
│       │   └── union.pyi
│       ├── hacks.txt
│       ├── lib-stub/
│       │   ├── _decimal.pyi
│       │   ├── _typeshed.pyi
│       │   ├── _weakref.pyi
│       │   ├── abc.pyi
│       │   ├── attr/
│       │   │   ├── __init__.pyi
│       │   │   └── converters.pyi
│       │   ├── attrs/
│       │   │   ├── __init__.pyi
│       │   │   └── converters.pyi
│       │   ├── blocker.pyi
│       │   ├── blocker2.pyi
│       │   ├── broken.pyi
│       │   ├── builtins.pyi
│       │   ├── collections.pyi
│       │   ├── contextlib.pyi
│       │   ├── dataclasses.pyi
│       │   ├── datetime.pyi
│       │   ├── decimal.pyi
│       │   ├── enum.pyi
│       │   ├── functools.pyi
│       │   ├── future/
│       │   │   ├── __init__.pyi
│       │   │   └── utils.pyi
│       │   ├── math.pyi
│       │   ├── mypy_extensions.pyi
│       │   ├── native_internal.pyi
│       │   ├── numbers.pyi
│       │   ├── six.pyi
│       │   ├── string/
│       │   │   ├── __init__.pyi
│       │   │   └── templatelib.pyi
│       │   ├── sys.pyi
│       │   ├── traceback.pyi
│       │   ├── types.pyi
│       │   ├── typing.pyi
│       │   ├── typing_extensions.pyi
│       │   ├── unannotated_lib.pyi
│       │   └── weakref.pyi
│       ├── merge.test
│       ├── native-parser-imports.test
│       ├── native-parser.test
│       ├── outputjson.test
│       ├── parse-errors.test
│       ├── parse-python310.test
│       ├── parse-python312.test
│       ├── parse-python313.test
│       ├── parse-python314.test
│       ├── parse.test
│       ├── pep561.test
│       ├── plugins/
│       │   ├── add_classmethod.py
│       │   ├── add_method.py
│       │   ├── add_overloaded_method.py
│       │   ├── arg_kinds.py
│       │   ├── arg_names.py
│       │   ├── attrhook.py
│       │   ├── attrhook2.py
│       │   ├── badreturn.py
│       │   ├── badreturn2.py
│       │   ├── callable_instance.py
│       │   ├── class_attr_hook.py
│       │   ├── class_callable.py
│       │   ├── common_api_incremental.py
│       │   ├── config_data.py
│       │   ├── custom_errorcode.py
│       │   ├── customentry.py
│       │   ├── customize_mro.py
│       │   ├── decimal_to_int.py
│       │   ├── depshook.py
│       │   ├── descriptor.py
│       │   ├── dyn_class.py
│       │   ├── dyn_class_from_method.py
│       │   ├── fnplugin.py
│       │   ├── fully_qualified_test_hook.py
│       │   ├── function_sig_hook.py
│       │   ├── magic_method.py
│       │   ├── method_in_decorator.py
│       │   ├── method_sig_hook.py
│       │   ├── named_callable.py
│       │   ├── noentry.py
│       │   ├── plugin2.py
│       │   ├── type_anal_hook.py
│       │   └── union_method.py
│       ├── pythoneval-asyncio.test
│       ├── pythoneval.test
│       ├── ref-info.test
│       ├── reports.test
│       ├── semanal-abstractclasses.test
│       ├── semanal-basic.test
│       ├── semanal-classes.test
│       ├── semanal-classvar.test
│       ├── semanal-errors-python310.test
│       ├── semanal-errors.test
│       ├── semanal-expressions.test
│       ├── semanal-lambda.test
│       ├── semanal-literal.test
│       ├── semanal-modules.test
│       ├── semanal-namedtuple.test
│       ├── semanal-python310.test
│       ├── semanal-statements.test
│       ├── semanal-symtable.test
│       ├── semanal-typealiases.test
│       ├── semanal-typeddict.test
│       ├── semanal-typeinfo.test
│       ├── semanal-types.test
│       ├── stubgen.test
│       └── typexport-basic.test
├── test-requirements.in
├── test-requirements.txt
└── tox.ini

================================================
FILE CONTENTS
================================================

================================================
FILE: .editorconfig
================================================
root = true

[*.{py,pyi,c,cpp,h,rst,md,yml,yaml,json,test}]
trim_trailing_whitespace = true
insert_final_newline = true
indent_style = space

[*.{py,pyi,c,h,json,test}]
indent_size = 4

[*.{yml,yaml}]
indent_size = 2


================================================
FILE: .git-blame-ignore-revs
================================================
# Adopt black and isort
97c5ee99bc98dc475512e549b252b23a6e7e0997
# Use builtin generics and PEP 604 for type annotations wherever possible (#13427)
23ee1e7aff357e656e3102435ad0fe3b5074571e
# Use variable annotations (#10723)
f98f78216ba9d6ab68c8e69c19e9f3c7926c5efe
# run pyupgrade (#12711)
fc335cb16315964b923eb1927e3aad1516891c28
# update black to 23.3.0 (#15059)
4276308be01ea498d946a79554b4a10b1cf13ccb
# Update black to 24.1.1 (#16847)
8107e53158d83d30bb04d290ac10d8d3ccd344f8


================================================
FILE: .gitattributes
================================================
# We vendor typeshed from https://github.com/python/typeshed
mypy/typeshed/** linguist-vendored


================================================
FILE: .github/ISSUE_TEMPLATE/bug.md
================================================
---
name: Bug Report
about: Submit a bug report
labels: "bug"
---

<!--
If you're not sure whether what you're experiencing is a mypy bug, please see the "Question and Help" form instead.
Please consider:

- checking our common issues page: https://mypy.readthedocs.io/en/stable/common_issues.html
- searching our issue tracker: https://github.com/python/mypy/issues to see if it's already been reported
- asking on gitter chat: https://gitter.im/python/typing
-->

**Bug Report**

<!--
If you're reporting a problem with a specific library function, the typeshed tracker is better suited for this report: https://github.com/python/typeshed/issues

If the project you encountered the issue in is open source, please provide a link to the project.
-->

(A clear and concise description of what the bug is.)

**To Reproduce**

```python
# Ideally, a small sample program that demonstrates the problem.
# Or even better, a reproducible playground link https://mypy-play.net/ (use the "Gist" button)
```

**Expected Behavior**

<!--
How did you expect mypy to behave? It’s fine if you’re not sure your understanding is correct.
Write down what you thought would happen. If you expected no errors, delete this section.
-->

**Actual Behavior**

<!-- What went wrong? Paste mypy's output. -->

**Your Environment**

<!-- Include as many relevant details about the environment you experienced the bug in -->

- Mypy version used:
- Mypy command-line flags:
- Mypy configuration options from `mypy.ini` (and other config files):
- Python version used:

<!-- You can freely edit this text, please remove all the lines you believe are unnecessary. -->


================================================
FILE: .github/ISSUE_TEMPLATE/config.yml
================================================
contact_links:
  - about: "Please check the linked documentation page before filing new issues."
    name: "Common issues and solutions"
    url: "https://mypy.readthedocs.io/en/stable/common_issues.html"
  - about: "Please ask and answer any questions on the python/typing Gitter."
    name: "Questions or Chat"
    url: "https://gitter.im/python/typing"


================================================
FILE: .github/ISSUE_TEMPLATE/crash.md
================================================
---
name: Crash Report
about: Crash (traceback or "INTERNAL ERROR")
labels: "crash"
---

<!--
  Use this form only if mypy reports an "INTERNAL ERROR" and/or gives a traceback.
  Please include the traceback and all other messages below (use `mypy --show-traceback`).
-->

**Crash Report**

(Tell us what happened.)

**Traceback**

```python-traceback
(Insert traceback and other messages from mypy here -- use `--show-traceback`.)
```

**To Reproduce**

(Write what you did to reproduce the crash.  Full source code is
appreciated.  We also very much appreciate it if you try to narrow the
source down to a small stand-alone example.)

```python
# Ideally, a small sample program that demonstrates the problem.
# Or even better, a reproducible playground link https://mypy-play.net/ (use the "Gist" button)
```

**Your Environment**

<!-- Include as many relevant details about the environment you experienced the bug in -->

- Mypy version used:
- Mypy command-line flags:
- Mypy configuration options from `mypy.ini` (and other config files):
- Python version used:
- Operating system and version:

<!--
You can freely edit this text, please remove all the lines
you believe are unnecessary.
-->


================================================
FILE: .github/ISSUE_TEMPLATE/documentation.md
================================================
---
name: Documentation
about: Report a problem with the documentation
labels: "documentation"
---

**Documentation**

(A clear and concise description of the issue.)


================================================
FILE: .github/ISSUE_TEMPLATE/feature.md
================================================
---
name: Feature
about: Submit a proposal for a new mypy feature
labels: "feature"
---

**Feature**

<!-- Enter a clear and concise description of your feature proposal here. -->

**Pitch**

<!-- Please explain why this feature should be implemented and how it would be used. Add examples, if applicable. -->


================================================
FILE: .github/PULL_REQUEST_TEMPLATE.md
================================================
<!-- If this pull request fixes an issue, add "Fixes #NNN" with the issue number. -->

(Explain how this PR changes mypy.)

<!--
Checklist:
- Read the [Contributing Guidelines](https://github.com/python/mypy/blob/master/CONTRIBUTING.md)
- Add tests for all changed behaviour.
- If you can't add a test, please explain why and how you verified your changes work.
- Make sure CI passes.
- Please do not force push to the PR once it has been reviewed.
-->


================================================
FILE: .github/workflows/build_wheels.yml
================================================
name: Trigger wheel build

on:
  push:
    branches: [main, master, 'release*']
    tags: ['*']

permissions:
  contents: read

jobs:
  build-wheels:
    if: github.repository == 'python/mypy'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          persist-credentials: false
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - name: Trigger script
        env:
          WHEELS_PUSH_TOKEN: ${{ secrets.WHEELS_PUSH_TOKEN }}
        run: ./misc/trigger_wheel_build.sh


================================================
FILE: .github/workflows/docs.yml
================================================
name: Check documentation build

on:
  workflow_dispatch:
  push:
    branches: [main, master, 'release*']
    tags: ['*']
  pull_request:
    paths:
    - 'docs/**'
    # We now have a docs check that fails if any error codes don't have documentation,
    # so it's important to do the docs build on all PRs touching mypy/errorcodes.py
    # in case somebody's adding a new error code without any docs
    - 'mypy/errorcodes.py'
    # Part of the documentation is automatically generated from the options
    # definitions in mypy/main.py
    - 'mypy/main.py'
    - 'mypyc/doc/**'
    - '**/*.rst'
    - '**/*.md'
    - CREDITS
    - LICENSE

permissions:
  contents: read

concurrency:
  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
  cancel-in-progress: true

jobs:
  docs:
    runs-on: ubuntu-latest
    timeout-minutes: 10
    env:
      TOXENV: docs
      TOX_SKIP_MISSING_INTERPRETERS: False
      VERIFY_MYPY_ERROR_CODES: 1
    steps:
      - uses: actions/checkout@v4
        with:
          persist-credentials: false
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - name: Install tox
        run: pip install tox==4.26.0
      - name: Setup tox environment
        run: tox run -e ${{ env.TOXENV }} --notest
      - name: Test
        run: tox run -e ${{ env.TOXENV }} --skip-pkg-install


================================================
FILE: .github/workflows/mypy_primer.yml
================================================
name: Run mypy_primer

on:
  # Only run on PR, since we diff against master
  pull_request:
    paths-ignore:
    - 'docs/**'
    - '**/*.rst'
    - '**/*.md'
    - 'misc/**'
    - 'mypyc/**'
    - 'mypy/stubtest.py'
    - 'mypy/stubgen.py'
    - 'mypy/stubgenc.py'
    - 'mypy/test/**'
    - 'test-data/**'

permissions:
  contents: read

concurrency:
  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
  cancel-in-progress: true

jobs:
  mypy_primer:
    name: Run mypy_primer
    runs-on: ubuntu-latest
    strategy:
      matrix:
        shard-index: [0, 1, 2, 3, 4, 5]
      fail-fast: false
    timeout-minutes: 60
    steps:
      - uses: actions/checkout@v4
        with:
          path: mypy_to_test
          fetch-depth: 0
          persist-credentials: false
      - uses: actions/setup-python@v5
        with:
          python-version: "3.14"
      - name: Install dependencies
        run: |
          python -m pip install -U pip
          pip install git+https://github.com/hauntsaninja/mypy_primer.git
      - name: Run mypy_primer
        shell: bash
        run: |
          cd mypy_to_test
          echo "new commit"
          git rev-list --format=%s --max-count=1 $GITHUB_SHA

          MERGE_BASE=$(git merge-base $GITHUB_SHA origin/$GITHUB_BASE_REF)
          git checkout -b base_commit $MERGE_BASE
          echo "base commit"
          git rev-list --format=%s --max-count=1 base_commit

          echo ''
          cd ..
          # fail action if exit code isn't zero or one
          (
            mypy_primer \
            --repo mypy_to_test \
            --new $GITHUB_SHA --old base_commit \
            --num-shards 6 --shard-index ${{ matrix.shard-index }} \
            --debug \
            --additional-flags="--debug-serialize" \
            --output concise \
            --mypy-install-librt \
            | tee diff_${{ matrix.shard-index }}.txt
          ) || [ $? -eq 1 ]
      - if: ${{ matrix.shard-index == 0 }}
        name: Save PR number
        run: |
          echo ${{ github.event.pull_request.number }} | tee pr_number.txt
      - name: Upload mypy_primer diff + PR number
        uses: actions/upload-artifact@v4
        if: ${{ matrix.shard-index == 0 }}
        with:
          name: mypy_primer_diffs-${{ matrix.shard-index }}
          path: |
            diff_${{ matrix.shard-index }}.txt
            pr_number.txt
      - name: Upload mypy_primer diff
        uses: actions/upload-artifact@v4
        if: ${{ matrix.shard-index != 0 }}
        with:
          name: mypy_primer_diffs-${{ matrix.shard-index }}
          path: diff_${{ matrix.shard-index }}.txt

  join_artifacts:
    name: Join artifacts
    runs-on: ubuntu-latest
    needs: [mypy_primer]
    steps:
      - name: Merge artifacts
        uses: actions/upload-artifact/merge@v4
        with:
          name: mypy_primer_diffs
          pattern: mypy_primer_diffs-*
          delete-merged: true


================================================
FILE: .github/workflows/mypy_primer_comment.yml
================================================
name: Comment with mypy_primer diff

on:  # zizmor: ignore[dangerous-triggers]
  workflow_run:
    workflows:
      - Run mypy_primer
    types:
      - completed

permissions: {}

jobs:
  comment:
    name: Comment PR from mypy_primer
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    if: ${{ github.event.workflow_run.conclusion == 'success' }}
    steps:
      - name: Download diffs
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const artifacts = await github.rest.actions.listWorkflowRunArtifacts({
               owner: context.repo.owner,
               repo: context.repo.repo,
               run_id: ${{ github.event.workflow_run.id }},
            });
            const [matchArtifact] = artifacts.data.artifacts.filter((artifact) =>
              artifact.name == "mypy_primer_diffs");

            const download = await github.rest.actions.downloadArtifact({
               owner: context.repo.owner,
               repo: context.repo.repo,
               artifact_id: matchArtifact.id,
               archive_format: "zip",
            });
            fs.writeFileSync("diff.zip", Buffer.from(download.data));

      - run: unzip diff.zip
      - run: |
          cat diff_*.txt | tee fulldiff.txt

      - name: Post comment
        id: post-comment
        uses: actions/github-script@v7
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          script: |
            const MAX_CHARACTERS = 50000
            const MAX_CHARACTERS_PER_PROJECT = MAX_CHARACTERS / 3

            const fs = require('fs')
            let data = fs.readFileSync('fulldiff.txt', { encoding: 'utf8' })

            function truncateIfNeeded(original, maxLength) {
              if (original.length <= maxLength) {
                return original
              }
              let truncated = original.substring(0, maxLength)
              // further, remove last line that might be truncated
              truncated = truncated.substring(0, truncated.lastIndexOf('\n'))
              let lines_truncated = original.split('\n').length - truncated.split('\n').length
              return `${truncated}\n\n... (truncated ${lines_truncated} lines) ...`
            }

            const projects = data.split('\n\n')
            // don't let one project dominate
            data = projects.map(project => truncateIfNeeded(project, MAX_CHARACTERS_PER_PROJECT)).join('\n\n')
            // posting comment fails if too long, so truncate
            data = truncateIfNeeded(data, MAX_CHARACTERS)

            console.log("Diff from mypy_primer:")
            console.log(data)

            let body
            if (data.trim()) {
              body = 'Diff from [mypy_primer](https://github.com/hauntsaninja/mypy_primer), showing the effect of this PR on open source code:\n```diff\n' + data + '```'
            } else {
              body = "According to [mypy_primer](https://github.com/hauntsaninja/mypy_primer), this change doesn't affect type check results on a corpus of open source code. ✅"
            }
            const prNumber = parseInt(fs.readFileSync("pr_number.txt", { encoding: "utf8" }))
            await github.rest.issues.createComment({
              issue_number: prNumber,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body
            })
            return prNumber

      - name: Hide old comments
        # v0.4.0
        uses: kanga333/comment-hider@c12bb20b48aeb8fc098e35967de8d4f8018fffdf
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          leave_visible: 1
          issue_number: ${{ steps.post-comment.outputs.result }}


================================================
FILE: .github/workflows/sync_typeshed.yml
================================================
name: Sync typeshed

on:
  workflow_dispatch:
  schedule:
    - cron: "0 0 1,15 * *"

permissions: {}

jobs:
  sync_typeshed:
    name: Sync typeshed
    if: github.repository == 'python/mypy'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    timeout-minutes: 10
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
          persist-credentials: true  # needed to `git push` the PR branch
        # TODO: use whatever solution ends up working for
        # https://github.com/python/typeshed/issues/8434
      - uses: actions/setup-python@v5
        with:
          python-version: "3.10"
      - name: git config
        run: |
          git config --global user.name mypybot
          git config --global user.email '<>'
      - name: Sync typeshed
        run: |
          python -m pip install requests==2.28.1
          GITHUB_TOKEN=${{ secrets.GITHUB_TOKEN }} python misc/sync-typeshed.py --make-pr


================================================
FILE: .github/workflows/test.yml
================================================
name: Tests

on:
  workflow_dispatch:
  push:
    branches: [main, master, 'release*']
    tags: ['*']
  pull_request:
    paths-ignore:
    - 'docs/**'
    - 'mypyc/doc/**'
    - '**/*.rst'
    - '**/*.md'
    - .gitignore
    - CREDITS
    - LICENSE

permissions:
  contents: read

concurrency:
  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
  cancel-in-progress: true

jobs:
  main:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        include:
        # Make sure to run mypyc compiled unit tests for both
        # the oldest and newest supported Python versions
        - name: Test suite with py310-ubuntu, mypyc-compiled
          python: '3.10'
          os: ubuntu-24.04-arm
          toxenv: py
          tox_extra_args: "-n 4"
          test_mypyc: true
        - name: Test suite with py311-ubuntu
          python: '3.11'
          os: ubuntu-24.04-arm
          toxenv: py
          tox_extra_args: "-n 4"
        - name: Test suite with py312-ubuntu
          python: '3.12'
          os: ubuntu-24.04-arm
          toxenv: py
          tox_extra_args: "-n 4"
        - name: Test suite with py313-ubuntu, mypyc-compiled
          python: '3.13'
          os: ubuntu-24.04-arm
          toxenv: py
          tox_extra_args: "-n 4"
          test_mypyc: true
        - name: Test suite with py314-ubuntu, mypyc-compiled
          python: '3.14'
          os: ubuntu-24.04-arm
          toxenv: py
          tox_extra_args: "-n 4"
          test_mypyc: true
        - name: Test suite with py314t-ubuntu, mypyc-compiled
          python: '3.14t'
          os: ubuntu-24.04-arm
          toxenv: py
          tox_extra_args: "-n 4"
          test_mypyc: true
        - name: Test suite with py314-windows-64
          python: '3.14'
          os: windows-latest
          toxenv: py
          tox_extra_args: "-n 4"

        # - name: Test suite with py315-dev-ubuntu
        #   python: '3.15-dev'
        #   os: ubuntu-24.04-arm
        #   toxenv: py
        #   tox_extra_args: "-n 4"
        #   # allow_failure: true
        #   test_mypyc: true

        - name: mypyc runtime tests with py313-macos
          python: '3.13'
          os: macos-latest
          toxenv: py
          tox_extra_args: "-n 3 mypyc/test/test_run.py mypyc/test/test_external.py"

        - name: mypyc runtime tests with py310-ubuntu
          python: '3.10'
          os: ubuntu-latest
          toxenv: py
          tox_extra_args: "-n 3 mypyc/test/test_run.py mypyc/test/test_external.py"

        # This is broken. See
        # - https://github.com/python/mypy/issues/17819
        # - https://github.com/python/mypy/pull/17822
        # - name: mypyc runtime tests with py310-debug-build-ubuntu
        #   python: '3.10'
        #   os: ubuntu-latest
        #   toxenv: py
        #   tox_extra_args: "-n 4 mypyc/test/test_run.py mypyc/test/test_external.py"
        #   debug_build: true

        - name: Parallel tests with py314-ubuntu, interpreted
          python: '3.14'
          os: ubuntu-24.04-arm
          toxenv: py
          tox_extra_args: "-n 4 --mypy-num-workers=4 mypy/test/testcheck.py"
        - name: Parallel tests with py314-ubuntu, mypyc-compiled
          python: '3.14'
          os: ubuntu-24.04-arm
          toxenv: py
          tox_extra_args: "-n 4 --mypy-num-workers=4 mypy/test/testcheck.py"
          test_mypyc: true
        - name: Parallel tests with py314-windows-64, interpreted
          python: '3.14'
          os: windows-latest
          toxenv: py
          tox_extra_args: "-n 2 --mypy-num-workers=2 mypy/test/testcheck.py -k 'incremental or modules or classes'"

        - name: Type check our own code (py310-ubuntu)
          python: '3.10'
          os: ubuntu-latest
          toxenv: type
        - name: Type check our own code (py310-windows-64)
          python: '3.10'
          os: windows-latest
          toxenv: type

          # We also run these checks with pre-commit in CI,
          # but it's useful to run them with tox too,
          # to ensure the tox env works as expected
        - name: Formatting and code style with Black + ruff
          python: '3.10'
          os: ubuntu-latest
          toxenv: lint

    name: ${{ matrix.name }}
    timeout-minutes: 60
    env:
      TOX_SKIP_MISSING_INTERPRETERS: False
      # Rich (pip) -- Disable color for windows + pytest
      FORCE_COLOR: ${{ !(startsWith(matrix.os, 'windows-') && startsWith(matrix.toxenv, 'py')) && 1 || 0 }}
      # Tox
      PY_COLORS: 1
      # Python -- Disable argparse help colors (3.14+)
      PYTHON_COLORS: 0
      # Mypy (see https://github.com/python/mypy/issues/7771)
      TERM: xterm-color
      MYPY_FORCE_COLOR: 1
      MYPY_FORCE_TERMINAL_WIDTH: 200
      # Pytest
      PYTEST_ADDOPTS: --color=yes

    steps:
    - uses: actions/checkout@v4
      with:
        persist-credentials: false

    - name: Latest dev build
      if: ${{ endsWith(matrix.python, '-dev') }}
      run: |
          git clone --depth 1 https://github.com/python/cpython.git /tmp/cpython --branch $( echo ${{ matrix.python }} | sed 's/-dev//' )
          cd /tmp/cpython
          echo git rev-parse HEAD; git rev-parse HEAD
          git show --no-patch
          sudo apt-get update -q
          sudo apt-get install -q -y --no-install-recommends \
            build-essential gdb lcov libbz2-dev libffi-dev libgdbm-dev liblzma-dev libncurses5-dev \
            libreadline6-dev libsqlite3-dev libssl-dev lzma lzma-dev tk-dev uuid-dev zlib1g-dev
          ./configure --prefix=/opt/pythondev
          make -j$(nproc)
          sudo make install
          sudo ln -s /opt/pythondev/bin/python3 /opt/pythondev/bin/python
          sudo ln -s /opt/pythondev/bin/pip3 /opt/pythondev/bin/pip
          echo "/opt/pythondev/bin" >> $GITHUB_PATH
    - name: Debug build
      if: ${{ matrix.debug_build }}
      run: |
          git clone --depth 1 https://github.com/python/cpython.git /tmp/cpython --branch ${{ matrix.python }}
          cd /tmp/cpython
          echo git rev-parse HEAD; git rev-parse HEAD
          git show --no-patch
          sudo apt-get update -q
          sudo apt-get install -q -y --no-install-recommends \
            build-essential gdb lcov libbz2-dev libffi-dev libgdbm-dev liblzma-dev libncurses5-dev \
            libreadline6-dev libsqlite3-dev libssl-dev lzma lzma-dev tk-dev uuid-dev zlib1g-dev
          ./configure CFLAGS="-DPy_DEBUG -DPy_TRACE_REFS -DPYMALLOC_DEBUG" --with-pydebug -with-trace-refs --prefix=/opt/pythondev
          make -j$(nproc)
          sudo make install
          sudo ln -s /opt/pythondev/bin/python3 /opt/pythondev/bin/python
          sudo ln -s /opt/pythondev/bin/pip3 /opt/pythondev/bin/pip
          echo "/opt/pythondev/bin" >> $GITHUB_PATH
    - uses: actions/setup-python@v5
      if: ${{ !(matrix.debug_build || endsWith(matrix.python, '-dev')) }}
      with:
        python-version: ${{ matrix.python }}

    - name: Install tox
      run: |
        echo PATH; echo $PATH
        echo which python; which python
        echo which pip; which pip
        echo python version; python -c 'import sys; print(sys.version)'
        echo debug build; python -c 'import sysconfig; print(bool(sysconfig.get_config_var("Py_DEBUG")))'
        echo os.cpu_count; python -c 'import os; print(os.cpu_count())'
        echo os.sched_getaffinity; python -c 'import os; print(len(getattr(os, "sched_getaffinity", lambda *args: [])(0)))'
        pip install tox==4.26.0

    - name: Compiled with mypyc
      if: ${{ matrix.test_mypyc }}
      run: |
        pip install -r test-requirements.txt
        CC=clang MYPYC_OPT_LEVEL=0 MYPY_USE_MYPYC=1 pip install -e .

    - name: Setup tox environment
      run: |
        tox run -e ${{ matrix.toxenv }} --notest
    - name: Test
      run: tox run -e ${{ matrix.toxenv }} --skip-pkg-install -- ${{ matrix.tox_extra_args }}
      continue-on-error: ${{ matrix.allow_failure == 'true' }}

    - name: Mark as success (check failures manually)
      if: ${{ matrix.allow_failure == 'true' }}
      run: exit 0

  python_32bits:
    runs-on: ubuntu-latest
    name: Test mypyc suite with 32-bit Python
    timeout-minutes: 60
    env:
      TOX_SKIP_MISSING_INTERPRETERS: False
      # Rich (pip)
      FORCE_COLOR: 1
      # Tox
      PY_COLORS: 1
      # Mypy (see https://github.com/python/mypy/issues/7771)
      TERM: xterm-color
      MYPY_FORCE_COLOR: 1
      MYPY_FORCE_TERMINAL_WIDTH: 200
      # Pytest
      PYTEST_ADDOPTS: --color=yes
      CXX: i686-linux-gnu-g++
      CC: i686-linux-gnu-gcc
    steps:
      - uses: actions/checkout@v4
        with:
          persist-credentials: false
      - name: Install 32-bit build dependencies
        run: |
          sudo dpkg --add-architecture i386 && \
          sudo apt-get update && sudo apt-get install -y \
            zlib1g-dev:i386 \
            libgcc-s1:i386 \
            g++-i686-linux-gnu \
            gcc-i686-linux-gnu \
            libffi-dev:i386 \
            libssl-dev:i386 \
            libbz2-dev:i386 \
            libncurses-dev:i386 \
            libreadline-dev:i386 \
            libsqlite3-dev:i386 \
            liblzma-dev:i386 \
            uuid-dev:i386
      - name: Compile, install, and activate 32-bit Python
        uses: gabrielfalcao/pyenv-action@v13
        with:
          default: 3.11.1
          command: python -c "import platform; print(f'{platform.architecture()=} {platform.machine()=}');"
      - name: Install tox
        run: pip install tox==4.26.0
      - name: Setup tox environment
        run: tox run -e py --notest
      - name: Test
        run: tox run -e py --skip-pkg-install -- -n 4 mypyc/test/


================================================
FILE: .github/workflows/test_stubgenc.yml
================================================
name: Test stubgenc on pybind11_fixtures

on:
  workflow_dispatch:
  push:
    branches: [main, master, 'release*']
    tags: ['*']
  pull_request:
    paths:
    - 'misc/test-stubgenc.sh'
    - 'mypy/stubgenc.py'
    - 'mypy/stubdoc.py'
    - 'mypy/stubutil.py'
    - 'test-data/pybind11_fixtures/**'

permissions:
  contents: read

concurrency:
  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
  cancel-in-progress: true

jobs:
  stubgenc:
    # Check stub file generation for a small pybind11 project
    # (full text match is required to pass)
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:

    - uses: actions/checkout@v4
      with:
        persist-credentials: false

    - name: Setup 🐍 3.10
      uses: actions/setup-python@v5
      with:
        python-version: '3.10'

    - name: Test stubgenc
      run: misc/test-stubgenc.sh


================================================
FILE: .gitignore
================================================
build/
__pycache__
*.py[cod]
*~
/build
/env*/
docs/build/
docs/source/_build
mypyc/doc/_build
*.iml
/out/
.venv*
venv/
.mypy_cache/
.incremental_checker_cache.json
.cache
test-data/packages/.pip_lock
dmypy.json
.dmypy.json
/.mypyc_test_output

# Packages
*.egg
*.egg-info
*.eggs

# IDEs
.idea
.vscode

# vim temporary files
.*.sw?
*.sw?

# Operating Systems
.DS_Store

# Coverage Files
htmlcov
.coverage*

# pytest cache
.pytest_cache/

# virtualenv
.Python
bin/
lib/
include/
.python-version
pyvenv.cfg

.tox
pip-wheel-metadata


test_capi
*.o
*.a
test_capi
/mypyc/lib-rt/build/
/mypyc/lib-rt/*.so


================================================
FILE: .pre-commit-config.yaml
================================================
exclude: '^(mypyc/external/)|(mypy/typeshed/)|misc/typeshed_patches'  # Exclude all vendored code from lints
repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v5.0.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer
  - repo: https://github.com/psf/black-pre-commit-mirror
    rev: 26.1.0
    hooks:
      - id: black
        exclude: '^(test-data/)'
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.14.3
    hooks:
      - id: ruff-check
        args: [--exit-non-zero-on-fix]
  - repo: https://github.com/python-jsonschema/check-jsonschema
    rev: 0.32.1
    hooks:
      - id: check-github-workflows
      - id: check-github-actions
      - id: check-readthedocs
  - repo: https://github.com/codespell-project/codespell
    rev: v2.4.1
    hooks:
      - id: codespell
        args:
          - --ignore-words-list=HAX,ccompiler,ot,statics,whet,zar
        exclude: ^(mypy/test/|mypy/typeshed/|mypyc/test-data/|test-data/).+$
  - repo: https://github.com/rhysd/actionlint
    rev: v1.7.7
    hooks:
      - id: actionlint
        args: [
          -ignore=property "debug_build" is not defined,
          -ignore=property "allow_failure" is not defined,
          -ignore=SC2(046|086),
        ]
        additional_dependencies:
          # actionlint has a shellcheck integration which extracts shell scripts in `run:` steps from GitHub Actions
          # and checks these with shellcheck. This is arguably its most useful feature,
          # but the integration only works if shellcheck is installed
          - "github.com/wasilibs/go-shellcheck/cmd/shellcheck@v0.11.1"
  - repo: https://github.com/woodruffw/zizmor-pre-commit
    rev: v1.5.2
    hooks:
      - id: zizmor
  - repo: local
    hooks:
      - id: bad-pr-link
        name: Bad PR link
        description: Detect PR links text that don't match their URL
        language: pygrep
        entry: '\[(\d+)\]\(https://github.com/python/mypy/pull/(?!\1/?\))\d+/?\)'
        files: CHANGELOG.md
  # Should be the last one:
  - repo: meta
    hooks:
      - id: check-hooks-apply
      - id: check-useless-excludes

ci:
  autoupdate_schedule: quarterly


================================================
FILE: .readthedocs.yaml
================================================
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

version: 2

build:
  os: ubuntu-22.04
  tools:
    python: "3.11"

sphinx:
   configuration: docs/source/conf.py

formats: [pdf, htmlzip, epub]

python:
   install:
   - requirements: docs/requirements-docs.txt


================================================
FILE: CHANGELOG.md
================================================
# Mypy Release Notes

## Next Release

### Better narrowing

Mypy's implementation of narrowing has been substantially reworked. Mypy will now narrow more
aggressively, more consistently, and more correctly. In particular, you are likely to notice new
narrowing behavior in equality expressions (`==`), containment expressions (`in`),
match statements, and additional expressions providing type guards.

Note that mypy (and other Python type checkers) do not model the potential for various non-local
operations to invalidate narrowing assumptions. This means mypy may conclude that some of your code
is [unreachable](https://mypy.readthedocs.io/en/stable/common_issues.html#unreachable-code) and
avoid further checking of it. The `--warn-unreachable` flag is useful for highlighting these cases.
To reset narrowing, you can insert dummy reassignments, for instance `var = var` will reset
all narrowing of `var.attr`.

Future work includes better narrowing on initial assignments, more narrowing to `Literal` types,
and better checking of unreachable code.

Contributed by Shantanu Jain.

- Rework narrowing logic for equality and identity (Shantanu, PR [20492](https://github.com/python/mypy/pull/20492))
- Refactor equality and identity narrowing for clarity (Shantanu, PR [20595](https://github.com/python/mypy/pull/20595))
- Treat NotImplemented as a singleton type (Shantanu, PR [20601](https://github.com/python/mypy/pull/20601))
- Improve narrowing logic for Enum int and str subclasses (Shantanu, PR [20609](https://github.com/python/mypy/pull/20609))
- Narrow types based on collection containment (Shantanu, PR [20602](https://github.com/python/mypy/pull/20602))
- Refactor and improve narrowing for type(x) == t checks (Shantanu, PR [20634](https://github.com/python/mypy/pull/20634))
- Narrow for type expr comparisons to type exprs (Shantanu, PR [20639](https://github.com/python/mypy/pull/20639))
- Narrowing for comparisons against `x.__class__` (Shantanu, PR [20642](https://github.com/python/mypy/pull/20642))
- Better narrowing with custom equality (Shantanu, PR [20643](https://github.com/python/mypy/pull/20643))
- Use a single pass for core narrowing logic, add comments (Shantanu, PR [20659](https://github.com/python/mypy/pull/20659))
- Narrowing for final type objects (Shantanu, PR [20661](https://github.com/python/mypy/pull/20661))
- Avoid narrowing type[T] (Shantanu, PR [20662](https://github.com/python/mypy/pull/20662))
- Avoid widening to Any for checks like `type(x) is type(y: Any)` (Shantanu, PR [20663](https://github.com/python/mypy/pull/20663))
- Preserve some lost narrowing, cleanup (Shantanu, PR [20674](https://github.com/python/mypy/pull/20674))
- Fix narrowing related code for types with overloaded `__new__` (Shantanu, PR [20676](https://github.com/python/mypy/pull/20676))
- Fix isinstance with unions of tuples (Shantanu, PR [20677](https://github.com/python/mypy/pull/20677))
- Fix regression to chained containment (Shantanu, PR [20688](https://github.com/python/mypy/pull/20688))
- Improve else handling with custom equality (Shantanu, PR [20692](https://github.com/python/mypy/pull/20692))
- Better model runtime in isinstance and type checks (Shantanu, PR [20675](https://github.com/python/mypy/pull/20675))
- Use --warn-unreachable and --strict-equality in more tests (Shantanu, PR [20707](https://github.com/python/mypy/pull/20707))
- Model exact narrowing with type(x) checks (Shantanu, PR [20703](https://github.com/python/mypy/pull/20703))
- Short term fix for bytes narrowing (Shantanu, PR [20704](https://github.com/python/mypy/pull/20704))
- Preserve narrowing in unreachable code (Shantanu, PR [20710](https://github.com/python/mypy/pull/20710))
- Fix bug when narrowing union containing custom eq against custom eq (Shantanu, PR [20754](https://github.com/python/mypy/pull/20754))
- Fix narrowing for unions (Shantanu, PR [20728](https://github.com/python/mypy/pull/20728))
- Unsoundly narrow away from None with custom eq (Shantanu, PR [20756](https://github.com/python/mypy/pull/20756))
- Improve narrowing with numeric types (Shantanu, PR [20727](https://github.com/python/mypy/pull/20727))
- Fix narrowing with final type objects (Shantanu, PR [20743](https://github.com/python/mypy/pull/20743))
- Further improve match statement narrowing against unions (Shantanu, PR [20744](https://github.com/python/mypy/pull/20744))
- Avoid narrowing to NewType (Shantanu, PR [20766](https://github.com/python/mypy/pull/20766))
- Better match narrowing for irrefutable sequence patterns (Shantanu, PR [20782](https://github.com/python/mypy/pull/20782))
- Remove prohibit_none_typevar_overlap (Shantanu, PR [20864](https://github.com/python/mypy/pull/20864))
- Fix match statement narrowing reachability for tuples (Shantanu, PR [20896](https://github.com/python/mypy/pull/20896))
- Better handling of generics when narrowing (Shantanu, PR [20863](https://github.com/python/mypy/pull/20863))
- Better match narrowing for type objects (Shantanu, PR [20872](https://github.com/python/mypy/pull/20872))
- Narrow Callable generic return types (Shantanu, PR [20868](https://github.com/python/mypy/pull/20868))
- Better match narrowing for unions of type objects (Shantanu, PR [20905](https://github.com/python/mypy/pull/20905))
- Improve reachability in narrowing logic (Shantanu, PR [20660](https://github.com/python/mypy/pull/20660))
- Better match narrowing for irrefutable mapping patterns (Shantanu, PR [20906](https://github.com/python/mypy/pull/20906))
- Fix match statement semantic reachability (Shantanu, PR [20968](https://github.com/python/mypy/pull/20968))
- Add some additional narrowing test cases (Shantanu, PR [20598](https://github.com/python/mypy/pull/20598))
- Move tests to check-narrowing , improve them slightly (Shantanu, PR [20637](https://github.com/python/mypy/pull/20637))
- Add more tests for narrowing logic (Shantanu, PR [20672](https://github.com/python/mypy/pull/20672))
- More testing related improvements and updates (Shantanu, PR [20709](https://github.com/python/mypy/pull/20709))
- Add --warn-unreachable to more tests (Shantanu, PR [20977](https://github.com/python/mypy/pull/20977))

### Drop Support for Python 3.9

Mypy no longer supports running with Python 3.9, which has reached end-of-life.
When running mypy with Python 3.10+, it is still possible to type check code
that needs to support Python 3.9 with the `--python-version 3.9` argument.
Support for this will be dropped in the first half of 2026!

Contributed by Marc Mueller (PR [20156](https://github.com/python/mypy/pull/20156)).

### Mypyc Accelerated Mypy Wheels for ARM Windows and Free Threading

For best performance, mypy can be compiled to C extension modules using mypyc. This makes
mypy 3-5x faster than when interpreted with pure Python. We now build and upload mypyc
accelerated mypy wheels for `win_arm64` and `cp314t-...` to PyPI, making it easy for Windows
users on ARM and those using the free theading builds for Python 3.14 to realise this speedup
-- just `pip install` the latest mypy.

Contributed by Marc Mueller
(PR [mypy_mypyc-wheels#106](https://github.com/mypyc/mypy_mypyc-wheels/pull/106),
PR [mypy_mypyc-wheels#110](https://github.com/mypyc/mypy_mypyc-wheels/pull/110)).

### Removed flags `--force-uppercase-builtins` and `--force-union-syntax`

The `--force-uppercase-builtins` flag was deprecated and has been a no-op since mypy 1.17.0.
Since mypy has dropped support for Python 3.9, the `--force-union-syntax` flag is no longer
necessary.

Contributed by Marc Mueller (PR [20410](https://github.com/python/mypy/pull/20410))
and (PR [20405](https://github.com/python/mypy/pull/20405)).

## Mypy 1.19

We’ve just uploaded mypy 1.19.0 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)).
Mypy is a static type checker for Python. This release includes new features, performance
improvements and bug fixes. You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Python 3.9 Support Ending Soon

This is the last mypy feature release that supports Python 3.9, which reached
end of life in October 2025.

### Performance Improvements
- Switch to a more dynamic SCC processing logic (Ivan Levkivskyi, PR [20053](https://github.com/python/mypy/pull/20053))
- Speed up type aliases (Ivan Levkivskyi, PR [19810](https://github.com/python/mypy/pull/19810))

### Fixed‑Format Cache Improvements

Mypy uses a cache by default to speed up incremental runs by reusing partial results
from earlier runs. Mypy 1.18 added a new binary fixed-format cache representation as
an experimental feature. The feature is no longer experimental, and we are planning
to enable it by default in a future mypy release (possibly 1.20), since it's faster
and uses less space than the original, JSON-based cache format. Use
`--fixed-format-cache` to enable the fixed-format cache.

Mypy now has an extra dependency on the `librt` PyPI package, as it's needed for
cache serialization and deserialization.

Mypy ships with a tool to convert fixed-format cache files to the old JSON format.
Example of how to use this:
```
$ python -m mypy.exportjson .mypy_cache/.../my_module.data.ff
```

This way existing use cases that parse JSON cache files can be supported when using
the new format, though an extra conversion step is needed.

This release includes these improvements:

- Force-discard cache if cache format changed (Ivan Levkivskyi, PR [20152](https://github.com/python/mypy/pull/20152))
- Add tool to convert binary cache files to JSON (Jukka Lehtosalo, PR [20071](https://github.com/python/mypy/pull/20071))
- Use more efficient serialization format for long integers in cache files (Jukka Lehtosalo, PR [20151](https://github.com/python/mypy/pull/20151))
- More robust packing of floats in fixed-format cache (Ivan Levkivskyi, PR [20150](https://github.com/python/mypy/pull/20150))
- Use self-descriptive cache with type tags (Ivan Levkivskyi, PR [20137](https://github.com/python/mypy/pull/20137))
- Use fixed format for cache metas (Ivan Levkivskyi, PR [20088](https://github.com/python/mypy/pull/20088))
- Make metas more compact; fix indirect suppression (Ivan Levkivskyi, PR [20075](https://github.com/python/mypy/pull/20075))
- Use dedicated tags for most common cached instances (Ivan Levkivskyi, PR [19762](https://github.com/python/mypy/pull/19762))

### PEP 747: Annotating Type Forms

Mypy now recognizes `TypeForm[T]` as a type and implements
[PEP 747](https://peps.python.org/pep-0747/). The feature is still experimental,
and it's disabled by default. Use `--enable-incomplete-feature=TypeForm` to
enable type forms. A type form object captures the type information provided by a
runtime type expression. Example:

```python
from typing_extensions import TypeForm

def trycast[T](typx: TypeForm[T], value: object) -> T | None: ...

def example(o: object) -> None:
    # 'int | str' below is an expression that represents a type.
    # Unlike type[T], TypeForm[T] can be used with all kinds of types,
    # including union types.
    x = trycast(int | str, o)
    if x is not None:
        # Type of 'x' is 'int | str' here
        ...
```

This feature was contributed by David Foster (PR [19596](https://github.com/python/mypy/pull/19596)).

### Fixes to Crashes
- Do not push partial types to the binder (Stanislav Terliakov, PR [20202](https://github.com/python/mypy/pull/20202))
- Fix crash on recursive tuple with Hashable (Ivan Levkivskyi, PR [20232](https://github.com/python/mypy/pull/20232))
- Fix crash related to decorated functions (Stanislav Terliakov, PR [20203](https://github.com/python/mypy/pull/20203))
- Do not abort constructing TypeAlias if only type parameters hold us back (Stanislav Terliakov, PR [20162](https://github.com/python/mypy/pull/20162))
- Use the fallback for `ModuleSpec` early if it can never be resolved (Stanislav Terliakov, PR [20167](https://github.com/python/mypy/pull/20167))
- Do not store deferred NamedTuple fields as redefinitions (Stanislav Terliakov, PR [20147](https://github.com/python/mypy/pull/20147))
- Discard partial types remaining after inference failure (Stanislav Terliakov, PR [20126](https://github.com/python/mypy/pull/20126))
- Fix an infinite recursion bug (Stanislav Terliakov, PR [20127](https://github.com/python/mypy/pull/20127))
- Fix IsADirectoryError for namespace packages when using --linecoverage-report (wyattscarpenter, PR [20109](https://github.com/python/mypy/pull/20109))
- Fix an internal error when creating cobertura output for namespace package (wyattscarpenter, PR [20112](https://github.com/python/mypy/pull/20112))
- Allow type parameters reusing the name missing from current module (Stanislav Terliakov, PR [20081](https://github.com/python/mypy/pull/20081))
- Prevent TypeGuardedType leak from narrowing declared type as part of type variable bound (Stanislav Terliakov, PR [20046](https://github.com/python/mypy/pull/20046))
- Fix crash on invalid unpack in base class (Ivan Levkivskyi, PR [19962](https://github.com/python/mypy/pull/19962))
- Traverse ParamSpec prefix where we should (Ivan Levkivskyi, PR [19800](https://github.com/python/mypy/pull/19800))
- Fix daemon crash related to imports (Ivan Levkivskyi, PR [20271](https://github.com/python/mypy/pull/20271))

### Mypyc: Support for `__getattr__`, `__setattr__`, and `__delattr__`

Mypyc now has partial support for `__getattr__`, `__setattr__` and
`__delattr__` methods in native classes.

Note that native attributes are not stored using `__dict__`. Setting attributes
directly while bypassing `__setattr__` is possible by using
`super().__setattr__(...)` or `object.__setattr__(...)`, but not via `__dict__`.

Example:
```python
class Demo:
    _data: dict[str, str]

    def __init__(self) -> None:
        # Initialize data dict without calling our __setattr__
        super().__setattr__("_data", {})

    def __setattr__(self, name: str, value: str) -> None:
        print(f"Setting {name} = {value!r}")

        if name == "_data":
            raise AttributeError("'_data' cannot be set")

        self._data[name] = value

    def __getattr__(self, name: str) -> str:
        print(f"Getting {name}")

        try:
            return self._data[name]
        except KeyError:
            raise AttributeError(name)

d = Demo()
d.x = "hello"
d.y = "world"

print(d.x)
print(d.y)
```

Related PRs:
- Generate `__setattr__` wrapper (Piotr Sawicki, PR [19937](https://github.com/python/mypy/pull/19937))
- Generate `__getattr__` wrapper (Piotr Sawicki, PR [19909](https://github.com/python/mypy/pull/19909))
- Support deleting attributes in `__setattr__` wrapper (Piotr Sawicki, PR [19997](https://github.com/python/mypy/pull/19997))

### Miscellaneous Mypyc Improvements
- Fix `__new__` in native classes with inheritance (Piotr Sawicki, PR [20302](https://github.com/python/mypy/pull/20302))
- Fix crash on `super` in generator (Ivan Levkivskyi, PR [20291](https://github.com/python/mypy/pull/20291))
- Fix calling base class async method using `super()` (Jukka Lehtosalo, PR [20254](https://github.com/python/mypy/pull/20254))
- Fix async or generator methods in traits (Jukka Lehtosalo, PR [20246](https://github.com/python/mypy/pull/20246))
- Optimize equality check with string literals (BobTheBuidler, PR [19883](https://github.com/python/mypy/pull/19883))
- Fix inheritance of async defs (Jukka Lehtosalo, PR [20044](https://github.com/python/mypy/pull/20044))
- Reject invalid `mypyc_attr` args (BobTheBuidler, PR [19963](https://github.com/python/mypy/pull/19963))
- Optimize `isinstance` with tuple of primitive types (BobTheBuidler, PR [19949](https://github.com/python/mypy/pull/19949))
- Optimize away first index check in for loops if length > 1 (BobTheBuidler, PR [19933](https://github.com/python/mypy/pull/19933))
- Fix broken exception/cancellation handling in async def (Jukka Lehtosalo, PR [19951](https://github.com/python/mypy/pull/19951))
- Transform `object.__new__` inside `__new__` (Piotr Sawicki, PR [19866](https://github.com/python/mypy/pull/19866))
- Fix crash with NewType and other non-class types in incremental builds (Jukka Lehtosalo, PR [19837](https://github.com/python/mypy/pull/19837))
- Optimize container creation from expressions with length known at compile time (BobTheBuidler, PR [19503](https://github.com/python/mypy/pull/19503))
- Allow per-class free list to be used with inheritance (Jukka Lehtosalo, PR [19790](https://github.com/python/mypy/pull/19790))
- Fix object finalization (Marc Mueller, PR [19749](https://github.com/python/mypy/pull/19749))
- Allow defining a single-item free "list" for a native class (Jukka Lehtosalo, PR [19785](https://github.com/python/mypy/pull/19785))
- Speed up unary "not" (Jukka Lehtosalo, PR [19774](https://github.com/python/mypy/pull/19774))

### Stubtest Improvements
- Check `_value_` for ellipsis-valued stub enum members (Stanislav Terliakov, PR [19760](https://github.com/python/mypy/pull/19760))
- Include function name in overload assertion messages (Joren Hammudoglu, PR [20063](https://github.com/python/mypy/pull/20063))
- Fix special case in analyzing function signature (iap, PR [19822](https://github.com/python/mypy/pull/19822))
- Improve `allowlist` docs with better example (sobolevn, PR [20007](https://github.com/python/mypy/pull/20007))

### Documentation Updates
- Update duck type compatibility: mention strict-bytes and mypy 2.0 (wyattscarpenter, PR [20121](https://github.com/python/mypy/pull/20121))
- Document `--enable-incomplete-feature TypeForm` (wyattscarpenter, PR [20173](https://github.com/python/mypy/pull/20173))
- Change the inline TypedDict example (wyattscarpenter, PR [20172](https://github.com/python/mypy/pull/20172))
- Replace `List` with built‑in `list` (PEP 585) (Thiago J. Barbalho, PR [20000](https://github.com/python/mypy/pull/20000))
- Improve junit documentation (wyattscarpenter, PR [19867](https://github.com/python/mypy/pull/19867))

### Other Notable Fixes and Improvements
- Fix annotated with function as type keyword list parameter (KarelKenens, PR [20094](https://github.com/python/mypy/pull/20094))
- Fix errors for raise NotImplemented (Shantanu, PR [20168](https://github.com/python/mypy/pull/20168))
- Don't let help formatter line-wrap URLs (Frank Dana, PR [19825](https://github.com/python/mypy/pull/19825))
- Do not cache fast container types inside lambdas (Stanislav Terliakov, PR [20166](https://github.com/python/mypy/pull/20166))
- Respect force-union-syntax flag in error hint (Marc Mueller, PR [20165](https://github.com/python/mypy/pull/20165))
- Fix type checking of dict type aliases (Shantanu, PR [20170](https://github.com/python/mypy/pull/20170))
- Use pretty callable formatting more often for callable expressions (Theodore Ando, PR [20128](https://github.com/python/mypy/pull/20128))
- Use dummy concrete type instead of `Any` when checking protocol variance (bzoracler, PR [20110](https://github.com/python/mypy/pull/20110))
- PEP 696: Fix swapping TypeVars with defaults (Randolf Scholz, PR [19449](https://github.com/python/mypy/pull/19449))
- Fix narrowing of class pattern with union type (Randolf Scholz, PR [19517](https://github.com/python/mypy/pull/19517))
- Do not emit unreachable warnings for lines that return `NotImplemented` (Christoph Tyralla, PR [20083](https://github.com/python/mypy/pull/20083))
- Fix matching against `typing.Callable` and `Protocol` types (Randolf Scholz, PR [19471](https://github.com/python/mypy/pull/19471))
- Make `--pretty` work better on multi-line issues (A5rocks, PR [20056](https://github.com/python/mypy/pull/20056))
- More precise return types for `TypedDict.get` (Randolf Scholz, PR [19897](https://github.com/python/mypy/pull/19897))
- Prevent false unreachable warnings for `@final` instances that occur when strict optional checking is disabled (Christoph Tyralla, PR [20045](https://github.com/python/mypy/pull/20045))
- Check class references to catch non-existent classes in match cases (A5rocks, PR [20042](https://github.com/python/mypy/pull/20042))
- Do not sort unused error codes in unused error codes warning (wyattscarpenter, PR [20036](https://github.com/python/mypy/pull/20036))
- Fix `[name-defined]` false positive in `class A[X, Y=X]:` case (sobolevn, PR [20021](https://github.com/python/mypy/pull/20021))
- Filter SyntaxWarnings during AST parsing (Marc Mueller, PR [20023](https://github.com/python/mypy/pull/20023))
- Make untyped decorator its own error code (wyattscarpenter, PR [19911](https://github.com/python/mypy/pull/19911))
- Support error codes from plugins in options (Sigve Sebastian Farstad, PR [19719](https://github.com/python/mypy/pull/19719))
- Allow returning Literals in `__new__` (James Hilton-Balfe, PR [15687](https://github.com/python/mypy/pull/15687))
- Inverse interface freshness logic (Ivan Levkivskyi, PR [19809](https://github.com/python/mypy/pull/19809))
- Do not report exhaustive-match after deferral (Stanislav Terliakov, PR [19804](https://github.com/python/mypy/pull/19804))
- Make `untyped_calls_exclude` invalidate cache (Ivan Levkivskyi, PR [19801](https://github.com/python/mypy/pull/19801))
- Add await to empty context hack (Stanislav Terliakov, PR [19777](https://github.com/python/mypy/pull/19777))
- Consider non-empty enums assignable to Self (Stanislav Terliakov, PR [19779](https://github.com/python/mypy/pull/19779))

### Typeshed updates

Please see [git log](https://github.com/python/typeshed/commits/main?after=ebce8d766b41fbf4d83cf47c1297563a9508ff60+0&branch=main&path=stdlib) for full list of standard library typeshed stub changes.

### Mypy 1.19.1

- Fix noncommutative joins with bounded TypeVars (Shantanu, PR [20345](https://github.com/python/mypy/pull/20345))
- Respect output format for cached runs by serializing raw errors in cache metas (Ivan Levkivskyi, PR [20372](https://github.com/python/mypy/pull/20372))
- Allow `types.NoneType` in match cases (A5rocks, PR [20383](https://github.com/python/mypy/pull/20383))
- Fix mypyc generator regression with empty tuple (BobTheBuidler, PR [20371](https://github.com/python/mypy/pull/20371))
- Fix crash involving Unpack-ed TypeVarTuple (Shantanu, PR [20323](https://github.com/python/mypy/pull/20323))
- Fix crash on star import of redefinition (Ivan Levkivskyi, PR [20333](https://github.com/python/mypy/pull/20333))
- Fix crash on typevar with forward ref used in other module (Ivan Levkivskyi, PR [20334](https://github.com/python/mypy/pull/20334))
- Fail with an explicit error on PyPy (Ivan Levkivskyi, PR [20389](https://github.com/python/mypy/pull/20389))

### Acknowledgements

Thanks to all mypy contributors who contributed to this release:
- A5rocks
- BobTheBuidler
- bzoracler
- Chainfire
- Christoph Tyralla
- David Foster
- Frank Dana
- Guo Ci
- iap
- Ivan Levkivskyi
- James Hilton-Balfe
- jhance
- Joren Hammudoglu
- Jukka Lehtosalo
- KarelKenens
- Kevin Kannammalil
- Marc Mueller
- Michael Carlstrom
- Michael J. Sullivan
- Piotr Sawicki
- Randolf Scholz
- Shantanu
- Sigve Sebastian Farstad
- sobolevn
- Stanislav Terliakov
- Stephen Morton
- Theodore Ando
- Thiago J. Barbalho
- wyattscarpenter

I’d also like to thank my employer, Dropbox, for supporting mypy development.

## Mypy 1.18

We’ve just uploaded mypy 1.18.1 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)).
Mypy is a static type checker for Python. This release includes new features, performance
improvements and bug fixes. You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Mypy Performance Improvements

Mypy 1.18.1 includes numerous performance improvements, resulting in about 40% speedup
compared to 1.17 when type checking mypy itself. In extreme cases, the improvement
can be 10x or higher. The list below is an overview of the various mypy optimizations.
Many mypyc improvements (discussed in a separate section below) also improve performance.

Type caching optimizations have a small risk of causing regressions. When
reporting issues with unexpected inferred types, please also check if
`--disable-expression-cache` will work around the issue, as it turns off some of
these optimizations.

- Improve self check performance by 1.8% (Jukka Lehtosalo, PR [19768](https://github.com/python/mypy/pull/19768), [19769](https://github.com/python/mypy/pull/19769), [19770](https://github.com/python/mypy/pull/19770))
- Optimize fixed-format deserialization (Ivan Levkivskyi, PR [19765](https://github.com/python/mypy/pull/19765))
- Use macros to optimize fixed-format deserialization (Ivan Levkivskyi, PR [19757](https://github.com/python/mypy/pull/19757))
- Two additional micro‑optimizations (Ivan Levkivskyi, PR [19627](https://github.com/python/mypy/pull/19627))
- Another set of micro‑optimizations (Ivan Levkivskyi, PR [19633](https://github.com/python/mypy/pull/19633))
- Cache common types (Ivan Levkivskyi, PR [19621](https://github.com/python/mypy/pull/19621))
- Skip more method bodies in third‑party libraries for speed (Ivan Levkivskyi, PR [19586](https://github.com/python/mypy/pull/19586))
- Simplify the representation of callable types (Ivan Levkivskyi, PR [19580](https://github.com/python/mypy/pull/19580))
- Add cache for types of some expressions (Ivan Levkivskyi, PR [19505](https://github.com/python/mypy/pull/19505))
- Use cache for dictionary expressions (Ivan Levkivskyi, PR [19536](https://github.com/python/mypy/pull/19536))
- Use cache for binary operations (Ivan Levkivskyi, PR [19523](https://github.com/python/mypy/pull/19523))
- Cache types of type objects (Ivan Levkivskyi, PR [19514](https://github.com/python/mypy/pull/19514))
- Avoid duplicate work when checking boolean operations (Ivan Levkivskyi, PR [19515](https://github.com/python/mypy/pull/19515))
- Optimize generic inference passes (Ivan Levkivskyi, PR [19501](https://github.com/python/mypy/pull/19501))
- Speed up the default plugin (Jukka Lehtosalo, PRs [19385](https://github.com/python/mypy/pull/19385) and [19462](https://github.com/python/mypy/pull/19462))
- Remove nested imports from the default plugin (Ivan Levkivskyi, PR [19388](https://github.com/python/mypy/pull/19388))
- Micro‑optimize type expansion (Jukka Lehtosalo, PR [19461](https://github.com/python/mypy/pull/19461))
- Micro‑optimize type indirection (Jukka Lehtosalo, PR [19460](https://github.com/python/mypy/pull/19460))
- Micro‑optimize the plugin framework (Jukka Lehtosalo, PR [19464](https://github.com/python/mypy/pull/19464))
- Avoid temporary set creation in subtype checking (Jukka Lehtosalo, PR [19463](https://github.com/python/mypy/pull/19463))
- Subtype checking micro‑optimization (Jukka Lehtosalo, PR [19384](https://github.com/python/mypy/pull/19384))
- Return early where possible in subtype check (Stanislav Terliakov, PR [19400](https://github.com/python/mypy/pull/19400))
- Deduplicate some types before joining (Stanislav Terliakov, PR [19409](https://github.com/python/mypy/pull/19409))
- Speed up type checking by caching argument inference context (Jukka Lehtosalo, PR [19323](https://github.com/python/mypy/pull/19323))
- Optimize binding method self argument type and deprecation checks (Ivan Levkivskyi, PR [19556](https://github.com/python/mypy/pull/19556))
- Keep trivial instance types/aliases during expansion (Ivan Levkivskyi, PR [19543](https://github.com/python/mypy/pull/19543))

### Fixed‑Format Cache (Experimental)

Mypy now supports a new cache format used for faster incremental builds. It makes
incremental builds up to twice as fast. The feature is experimental and
currently only supported when using a compiled version of mypy. Use `--fixed-format-cache`
to enable the new format, or `fixed_format_cache = True` in a configuration file.

We plan to enable this by default in a future mypy release, and we'll eventually
deprecate and remove support for the original JSON-based format.

Unlike the JSON-based cache format, the new binary format is currently
not easy to parse and inspect by mypy users. We are planning to provide a tool to
convert fixed-format cache files to JSON, but details of the output JSON may be
different from the current JSON format. If you rely on being able to inspect
mypy cache files, we recommend creating a GitHub issue and explaining your use
case, so that we can more likely provide support for it. (Using
`MypyFile.read(binary_data)` to inspect cache data may be sufficient to support
some use cases.)

This feature was contributed by Ivan Levkivskyi (PR [19668](https://github.com/python/mypy/pull/19668), [19735](https://github.com/python/mypy/pull/19735), [19750](https://github.com/python/mypy/pull/19750), [19681](https://github.com/python/mypy/pull/19681), [19752](https://github.com/python/mypy/pull/19752), [19815](https://github.com/python/mypy/pull/19815)).

### Flexible Variable Definitions: Update

Mypy 1.16.0 introduced `--allow-redefinition-new`, which allows redefining variables
with different types, and inferring union types for variables from multiple assignments.
The feature is now documented in the `--help` output, but the feature is still experimental.

We are planning to enable this by default in mypy 2.0, and we will also deprecate the
older `--allow-redefinition` flag. Since the new behavior differs significantly from
the older flag, we encourage users of `--allow-redefinition` to experiment with
`--allow-redefinition-new` and create a GitHub issue if the new functionality doesn't
support some important use cases.

This feature was contributed by Jukka Lehtosalo.

### Inferred Type for Bare ClassVar

A ClassVar without an explicit type annotation now causes the type of the variable
to be inferred from the initializer:


```python
from typing import ClassVar

class Item:
    # Type of 'next_id' is now 'int' (it was 'Any')
    next_id: ClassVar = 1

    ...
```

This feature was contributed by Ivan Levkivskyi (PR [19573](https://github.com/python/mypy/pull/19573)).

### Disjoint Base Classes (@disjoint_base, PEP 800)

Mypy now understands disjoint bases (PEP 800): it recognizes the `@disjoint_base`
decorator, and rejects class definitions that combine mutually incompatible base classes,
and takes advantage of the fact that such classes cannot exist in reachability and
narrowing logic.

This class definition will now generate an error:

```python
# Error: Class "Bad" has incompatible disjoint bases
class Bad(str, Exception):
    ...
```

This feature was contributed by Jelle Zijlstra (PR [19678](https://github.com/python/mypy/pull/19678)).

### Miscellaneous New Mypy Features

- Add `--strict-equality-for-none` to flag non-overlapping comparisons involving None (Christoph Tyralla, PR [19718](https://github.com/python/mypy/pull/19718))
- Don’t show import‑related errors after a module‑level assert such as `assert sys.platform == "linux"` that is always false (Stanislav Terliakov, PR [19347](https://github.com/python/mypy/pull/19347))

### Improvements to Match Statements

- Add temporary named expressions for match subjects (Stanislav Terliakov, PR [18446](https://github.com/python/mypy/pull/18446))
- Fix unwrapping of assignment expressions in match subject (Marc Mueller, PR [19742](https://github.com/python/mypy/pull/19742))
- Omit errors for class patterns against object (Marc Mueller, PR [19709](https://github.com/python/mypy/pull/19709))
- Remove unnecessary error for certain match class patterns (Marc Mueller, PR [19708](https://github.com/python/mypy/pull/19708))
- Use union type for captured vars in or pattern (Marc Mueller, PR [19710](https://github.com/python/mypy/pull/19710))
- Prevent final reassignment inside match case (Omer Hadari, PR [19496](https://github.com/python/mypy/pull/19496))

### Fixes to Crashes

- Fix crash with variadic tuple arguments to a generic type (Randolf Scholz, PR [19705](https://github.com/python/mypy/pull/19705))
- Fix crash when enable_error_code in pyproject.toml has wrong type (wyattscarpenter, PR [19494](https://github.com/python/mypy/pull/19494))
- Prevent crash for dataclass with PEP 695 TypeVarTuple on Python 3.13+ (Stanislav Terliakov, PR [19565](https://github.com/python/mypy/pull/19565))
- Fix crash on settable property alias (Ivan Levkivskyi, PR [19615](https://github.com/python/mypy/pull/19615))

### Experimental Free-threading Support for Mypyc

All mypyc tests now pass on free-threading Python 3.14 release candidate builds. The performance
of various micro-benchmarks scale well across multiple threads.

Free-threading support is still experimental. Note that native attribute access
(get and set), list item access and certain other operations are still
unsafe when there are race conditions. This will likely change in the future.
You can follow the
[area-free-threading label](https://github.com/mypyc/mypyc/issues?q=is%3Aissue%20state%3Aopen%20label%3Aarea-free-threading)
in the mypyc issues tracker to follow progress.

Related PRs:
- Enable free‑threading when compiling multiple modules (Jukka Lehtosalo, PR [19541](https://github.com/python/mypy/pull/19541))
- Fix `list.pop` on free‑threaded builds (Jukka Lehtosalo, PR [19522](https://github.com/python/mypy/pull/19522))
- Make type objects immortal under free‑threading (Jukka Lehtosalo, PR [19538](https://github.com/python/mypy/pull/19538))

### Mypyc: Support `__new__`

Mypyc now has rudimentary support for user-defined `__new__` methods.

This feature was contributed by Piotr Sawicki (PR [19739](https://github.com/python/mypy/pull/19739)).

### Mypyc: Faster Generators and Async Functions

Generators and calls of async functions are now faster, sometimes by 2x or more.

Related PRs:
- Speed up for loops over native generators (Jukka Lehtosalo, PR [19415](https://github.com/python/mypy/pull/19415))
- Speed up native‑to‑native calls using await (Jukka Lehtosalo, PR [19398](https://github.com/python/mypy/pull/19398))
- Call generator helper directly in await expressions (Jukka Lehtosalo, PR [19376](https://github.com/python/mypy/pull/19376))
- Speed up generator allocation with per‑type freelists (Jukka Lehtosalo, PR [19316](https://github.com/python/mypy/pull/19316))

### Miscellaneous Mypyc Improvements

- Special‑case certain Enum method calls for speed (Ivan Levkivskyi, PR [19634](https://github.com/python/mypy/pull/19634))
- Fix issues related to subclassing and undefined attribute tracking (Chainfire, PR [19787](https://github.com/python/mypy/pull/19787))
- Fix invalid C function signature (Jukka Lehtosalo, PR [19773](https://github.com/python/mypy/pull/19773))
- Speed up implicit `__ne__` (Jukka Lehtosalo, PR [19759](https://github.com/python/mypy/pull/19759))
- Speed up equality with optional str/bytes types (Jukka Lehtosalo, PR [19758](https://github.com/python/mypy/pull/19758))
- Speed up access to empty tuples (BobTheBuidler, PR [19654](https://github.com/python/mypy/pull/19654))
- Speed up calls with `*args` (BobTheBuidler, PRs [19623](https://github.com/python/mypy/pull/19623) and [19631](https://github.com/python/mypy/pull/19631))
- Speed up calls with `**kwargs` (BobTheBuidler, PR [19630](https://github.com/python/mypy/pull/19630))
- Optimize `type(x)`, `x.__class__`, and `<type>.__name__` (Jukka Lehtosalo, PR [19691](https://github.com/python/mypy/pull/19691), [19683](https://github.com/python/mypy/pull/19683))
- Specialize `bytes.decode` for common encodings (Jukka Lehtosalo, PR [19688](https://github.com/python/mypy/pull/19688))
- Speed up `in` operations using final fixed‑length tuples (Jukka Lehtosalo, PR [19682](https://github.com/python/mypy/pull/19682))
- Optimize f‑string building from final values (BobTheBuidler, PR [19611](https://github.com/python/mypy/pull/19611))
- Add dictionary set item for exact dict instances (BobTheBuidler, PR [19657](https://github.com/python/mypy/pull/19657))
- Cache length when iterating over immutable types (BobTheBuidler, PR [19656](https://github.com/python/mypy/pull/19656))
- Fix name conflict related to attributes of generator classes (Piotr Sawicki, PR [19535](https://github.com/python/mypy/pull/19535))
- Fix segfault from heap type objects with a static docstring (Brian Schubert, PR [19636](https://github.com/python/mypy/pull/19636))
- Unwrap NewType to its base type for additional optimizations (BobTheBuidler, PR [19497](https://github.com/python/mypy/pull/19497))
- Generate an export table only for separate compilation (Jukka Lehtosalo, PR [19521](https://github.com/python/mypy/pull/19521))
- Speed up `isinstance` with built‑in types (Piotr Sawicki, PR [19435](https://github.com/python/mypy/pull/19435))
- Use native integers for some sequence indexing (Jukka Lehtosalo, PR [19426](https://github.com/python/mypy/pull/19426))
- Speed up `isinstance(obj, list)` (Piotr Sawicki, PR [19416](https://github.com/python/mypy/pull/19416))
- Report error on reserved method names (Piotr Sawicki, PR [19407](https://github.com/python/mypy/pull/19407))
- Speed up string equality (Jukka Lehtosalo, PR [19402](https://github.com/python/mypy/pull/19402))
- Raise `NameError` on undefined names (Piotr Sawicki, PR [19395](https://github.com/python/mypy/pull/19395))
- Use per‑type freelists for nested functions (Jukka Lehtosalo, PR [19390](https://github.com/python/mypy/pull/19390))
- Simplify comparison of tuple elements (Piotr Sawicki, PR [19396](https://github.com/python/mypy/pull/19396))
- Generate introspection signatures for compiled functions (Brian Schubert, PR [19307](https://github.com/python/mypy/pull/19307))
- Fix undefined attribute checking special case (Jukka Lehtosalo, PR [19378](https://github.com/python/mypy/pull/19378))
- Fix comparison of tuples with different lengths (Piotr Sawicki, PR [19372](https://github.com/python/mypy/pull/19372))
- Speed up `list.clear` (Jahongir Qurbonov, PR [19344](https://github.com/python/mypy/pull/19344))
- Speed up `weakref.proxy` (BobTheBuidler, PR [19217](https://github.com/python/mypy/pull/19217))
- Speed up `weakref.ref` (BobTheBuidler, PR [19099](https://github.com/python/mypy/pull/19099))
- Speed up `str.count` (BobTheBuidler, PR [19264](https://github.com/python/mypy/pull/19264))

### Stubtest Improvements
- Add temporary `--ignore-disjoint-bases` flag to ease PEP 800 migration (Joren Hammudoglu, PR [19740](https://github.com/python/mypy/pull/19740))
- Flag redundant uses of `@disjoint_base` (Jelle Zijlstra, PR [19715](https://github.com/python/mypy/pull/19715))
- Improve signatures for `__init__` of C extension classes (Stephen Morton, PR [18259](https://github.com/python/mypy/pull/18259))
- Handle overloads with mixed positional‑only parameters (Stephen Morton, PR [18287](https://github.com/python/mypy/pull/18287))
- Use “parameter” (not “argument”) in error messages (PrinceNaroliya, PR [19707](https://github.com/python/mypy/pull/19707))
- Don’t require `@disjoint_base` when `__slots__` imply finality (Jelle Zijlstra, PR [19701](https://github.com/python/mypy/pull/19701))
- Allow runtime‑existing aliases of `@type_check_only` types (Brian Schubert, PR [19568](https://github.com/python/mypy/pull/19568))
- More detailed checking of type objects in stubtest (Stephen Morton, PR [18251](https://github.com/python/mypy/pull/18251))
- Support running stubtest in non-UTF8 terminals (Stanislav Terliakov, PR [19085](https://github.com/python/mypy/pull/19085))

### Documentation Updates

- Add idlemypyextension to IDE integrations (CoolCat467, PR [18615](https://github.com/python/mypy/pull/18615))
- Document that `object` is often preferable to `Any` in APIs (wyattscarpenter, PR [19103](https://github.com/python/mypy/pull/19103))
- Include a detailed listing of flags enabled by `--strict` (wyattscarpenter, PR [19062](https://github.com/python/mypy/pull/19062))
- Update “common issues” (reveal_type/reveal_locals; note on orjson) (wyattscarpenter, PR [19059](https://github.com/python/mypy/pull/19059), [19058](https://github.com/python/mypy/pull/19058))

### Other Notable Fixes and Improvements

- Remove deprecated `--new-type-inference` flag (the new algorithm has long been default) (Ivan Levkivskyi, PR [19570](https://github.com/python/mypy/pull/19570))
- Use empty context as a fallback for return expressions when outer context misleads inference (Ivan Levkivskyi, PR [19767](https://github.com/python/mypy/pull/19767))
- Fix forward references in type parameters of over‑parameterized PEP 695 aliases (Brian Schubert, PR [19725](https://github.com/python/mypy/pull/19725))
- Don’t expand PEP 695 aliases when checking node fullnames (Brian Schubert, PR [19699](https://github.com/python/mypy/pull/19699))
- Don’t use outer context for 'or' expression inference when LHS is Any (Stanislav Terliakov, PR [19748](https://github.com/python/mypy/pull/19748))
- Recognize buffer protocol special methods (Brian Schubert, PR [19581](https://github.com/python/mypy/pull/19581))
- Support attribute access on enum members correctly (Stanislav Terliakov, PR [19422](https://github.com/python/mypy/pull/19422))
- Check `__slots__` assignments on self types (Stanislav Terliakov, PR [19332](https://github.com/python/mypy/pull/19332))
- Move self‑argument checks after decorator application (Stanislav Terliakov, PR [19490](https://github.com/python/mypy/pull/19490))
- Infer empty list for `__slots__` and module `__all__` (Stanislav Terliakov, PR [19348](https://github.com/python/mypy/pull/19348))
- Use normalized tuples for fallback calculation (Stanislav Terliakov, PR [19111](https://github.com/python/mypy/pull/19111))
- Preserve literals when joining similar types (Stanislav Terliakov, PR [19279](https://github.com/python/mypy/pull/19279))
- Allow adjacent conditionally‑defined overloads (Stanislav Terliakov, PR [19042](https://github.com/python/mypy/pull/19042))
- Check property decorators more strictly (Stanislav Terliakov, PR [19313](https://github.com/python/mypy/pull/19313))
- Support properties with generic setters (Ivan Levkivskyi, PR [19298](https://github.com/python/mypy/pull/19298))
- Generalize class/static method and property alias support (Ivan Levkivskyi, PR [19297](https://github.com/python/mypy/pull/19297))
- Re‑widen custom properties after narrowing (Ivan Levkivskyi, PR [19296](https://github.com/python/mypy/pull/19296))
- Avoid erasing type objects when checking runtime cover (Shantanu, PR [19320](https://github.com/python/mypy/pull/19320))
- Include tuple fallback in constraints built from tuple types (Stanislav Terliakov, PR [19100](https://github.com/python/mypy/pull/19100))
- Somewhat better isinstance support on old‑style unions (Shantanu, PR [19714](https://github.com/python/mypy/pull/19714))
- Improve promotions inside unions (Christoph Tyralla, PR [19245](https://github.com/python/mypy/pull/19245))
- Treat uninhabited types as having all attributes (Ivan Levkivskyi, PR [19300](https://github.com/python/mypy/pull/19300))
- Improve metaclass conflict checks (Robsdedude, PR [17682](https://github.com/python/mypy/pull/17682))
- Fixes to metaclass resolution algorithm (Robsdedude, PR [17713](https://github.com/python/mypy/pull/17713))
- PEP 702 @deprecated: handle “combined” overloads (Christoph Tyralla, PR [19626](https://github.com/python/mypy/pull/19626))
- PEP 702 @deprecated: include overloads in snapshot descriptions (Christoph Tyralla, PR [19613](https://github.com/python/mypy/pull/19613))
- Ignore overload implementation when checking `__OP__` / `__rOP__` compatibility (Stanislav Terliakov, PR [18502](https://github.com/python/mypy/pull/18502))
- Support `_value_` as a fallback for ellipsis Enum members (Stanislav Terliakov, PR [19352](https://github.com/python/mypy/pull/19352))
- Sort arguments in TypedDict overlap messages (Marc Mueller, PR [19666](https://github.com/python/mypy/pull/19666))
- Fix handling of implicit return in lambda (Stanislav Terliakov, PR [19642](https://github.com/python/mypy/pull/19642))
- Improve behavior of uninhabited types (Stanislav Terliakov, PR [19648](https://github.com/python/mypy/pull/19648))
- Fix overload diagnostics when `*args` and `**kwargs` both match (Shantanu, PR [19614](https://github.com/python/mypy/pull/19614))
- Further fix overload diagnostics for `*args`/`**kwargs` (Shantanu, PR [19619](https://github.com/python/mypy/pull/19619))
- Show type variable name in "Cannot infer type argument" (Brian Schubert, PR [19290](https://github.com/python/mypy/pull/19290))
- Fail gracefully on unsupported template strings (PEP 750) (Brian Schubert, PR [19700](https://github.com/python/mypy/pull/19700))
- Revert colored argparse help for Python 3.14 (Marc Mueller, PR [19721](https://github.com/python/mypy/pull/19721))
- Update stubinfo for latest typeshed (Shantanu, PR [19771](https://github.com/python/mypy/pull/19771))
- Fix dict assignment when an incompatible same‑shape TypedDict exists (Stanislav Terliakov, PR [19592](https://github.com/python/mypy/pull/19592))
- Fix constructor type for subclasses of Any (Ivan Levkivskyi, PR [19295](https://github.com/python/mypy/pull/19295))
- Fix TypeGuard/TypeIs being forgotten in some cases (Brian Schubert, PR [19325](https://github.com/python/mypy/pull/19325))
- Fix TypeIs negative narrowing for unions of generics (Brian Schubert, PR [18193](https://github.com/python/mypy/pull/18193))
- dmypy suggest: Fix incorrect signature suggestion when a type matches a module name (Brian Schubert, PR [18937](https://github.com/python/mypy/pull/18937))
- dmypy suggest: Fix interaction with `__new__` (Stanislav Terliakov, PR [18966](https://github.com/python/mypy/pull/18966))
- dmypy suggest: Support Callable / callable Protocols in decorator unwrapping (Anthony Sottile, PR [19072](https://github.com/python/mypy/pull/19072))
- Fix missing error when redeclaring a type variable in a nested generic class (Brian Schubert, PR [18883](https://github.com/python/mypy/pull/18883))
- Fix for overloaded type object erasure (Shantanu, PR [19338](https://github.com/python/mypy/pull/19338))
- Fix TypeGuard with call on temporary object (Saul Shanabrook, PR [19577](https://github.com/python/mypy/pull/19577))

### Typeshed Updates

Please see [git log](https://github.com/python/typeshed/commits/main?after=2480d7e7c74493a024eaf254c5d2c6f452c80ee2+0&branch=main&path=stdlib) for full list of standard library typeshed stub changes.

### Mypy 1.18.2

- Fix crash on recursive alias (Ivan Levkivskyi, PR [19845](https://github.com/python/mypy/pull/19845))
- Add additional guidance for stubtest errors when runtime is `object.__init__` (Stephen Morton, PR [19733](https://github.com/python/mypy/pull/19733))
- Fix handling of None values in f-string expressions in mypyc (BobTheBuidler, PR [19846](https://github.com/python/mypy/pull/19846))

### Acknowledgements

Thanks to all mypy contributors who contributed to this release:

- Ali Hamdan
- Anthony Sottile
- BobTheBuidler
- Brian Schubert
- Chainfire
- Charlie Denton
- Christoph Tyralla
- CoolCat467
- Daniel Hnyk
- Emily
- Emma Smith
- Ethan Sarp
- Ivan Levkivskyi
- Jahongir Qurbonov
- Jelle Zijlstra
- Joren Hammudoglu
- Jukka Lehtosalo
- Marc Mueller
- Omer Hadari
- Piotr Sawicki
- PrinceNaroliya
- Randolf Scholz
- Robsdedude
- Saul Shanabrook
- Shantanu
- Stanislav Terliakov
- Stephen Morton
- wyattscarpenter

I’d also like to thank my employer, Dropbox, for supporting mypy development.

## Mypy 1.17

We’ve just uploaded mypy 1.17 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)).
Mypy is a static type checker for Python. This release includes new features and bug fixes.
You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Optionally Check That Match Is Exhaustive

Mypy can now optionally generate an error if a match statement does not
match exhaustively, without having to use `assert_never(...)`. Enable
this by using `--enable-error-code exhaustive-match`.

Example:

```python
# mypy: enable-error-code=exhaustive-match

import enum

class Color(enum.Enum):
    RED = 1
    BLUE = 2

def show_color(val: Color) -> None:
    # error: Unhandled case for values of type "Literal[Color.BLUE]"
    match val:
        case Color.RED:
            print("red")
```

This feature was contributed by Donal Burns (PR [19144](https://github.com/python/mypy/pull/19144)).

### Further Improvements to Attribute Resolution

This release includes additional improvements to how attribute types
and kinds are resolved. These fix many bugs and overall improve consistency.

* Handle corner case: protocol/class variable/descriptor (Ivan Levkivskyi, PR [19277](https://github.com/python/mypy/pull/19277))
* Fix a few inconsistencies in protocol/type object interactions (Ivan Levkivskyi, PR [19267](https://github.com/python/mypy/pull/19267))
* Refactor/unify access to static attributes (Ivan Levkivskyi, PR [19254](https://github.com/python/mypy/pull/19254))
* Remove inconsistencies in operator handling (Ivan Levkivskyi, PR [19250](https://github.com/python/mypy/pull/19250))
* Make protocol subtyping more consistent (Ivan Levkivskyi, PR [18943](https://github.com/python/mypy/pull/18943))

### Fixes to Nondeterministic Type Checking

Previous mypy versions could infer different types for certain expressions
across different runs (typically depending on which order certain types
were processed, and this order was nondeterministic). This release includes
fixes to several such issues.

* Fix nondeterministic type checking by making join with explicit Protocol and type promotion commute (Shantanu, PR [18402](https://github.com/python/mypy/pull/18402))
* Fix nondeterministic type checking caused by nonassociative of None joins (Shantanu, PR [19158](https://github.com/python/mypy/pull/19158))
* Fix nondeterministic type checking caused by nonassociativity of joins (Shantanu, PR [19147](https://github.com/python/mypy/pull/19147))
* Fix nondeterministic type checking by making join between `type` and TypeVar commute (Shantanu, PR [19149](https://github.com/python/mypy/pull/19149))

### Remove Support for Targeting Python 3.8

Mypy now requires `--python-version 3.9` or greater. Support for targeting Python 3.8 is
fully removed now. Since 3.8 is an unsupported version, mypy will default to the oldest
supported version (currently 3.9) if you still try to target 3.8.

This change is necessary because typeshed stopped supporting Python 3.8 after it
reached its End of Life in October 2024.

Contributed by Marc Mueller
(PR [19157](https://github.com/python/mypy/pull/19157), PR [19162](https://github.com/python/mypy/pull/19162)).

### Initial Support for Python 3.14

Mypy is now tested on 3.14 and mypyc works with 3.14.0b3 and later.
Binary wheels compiled with mypyc for mypy itself will be available for 3.14
some time after 3.14.0rc1 has been released.

Note that not all features are supported just yet.

Contributed by Marc Mueller (PR [19164](https://github.com/python/mypy/pull/19164))

### Deprecated Flag: `--force-uppercase-builtins`

Mypy only supports Python 3.9+. The `--force-uppercase-builtins` flag is now
deprecated as unnecessary, and a no-op. It will be removed in a future version.

Contributed by Marc Mueller (PR [19176](https://github.com/python/mypy/pull/19176))

### Mypyc: Improvements to Generators and Async Functions

This release includes both performance improvements and bug fixes related
to generators and async functions (these share many implementation details).

* Fix exception swallowing in async try/finally blocks with await (Chainfire, PR [19353](https://github.com/python/mypy/pull/19353))
* Fix AttributeError in async try/finally with mixed return paths (Chainfire, PR [19361](https://github.com/python/mypy/pull/19361))
* Make generated generator helper method internal (Jukka Lehtosalo, PR [19268](https://github.com/python/mypy/pull/19268))
* Free coroutine after await encounters StopIteration (Jukka Lehtosalo, PR [19231](https://github.com/python/mypy/pull/19231))
* Use non-tagged integer for generator label (Jukka Lehtosalo, PR [19218](https://github.com/python/mypy/pull/19218))
* Merge generator and environment classes in simple cases (Jukka Lehtosalo, PR [19207](https://github.com/python/mypy/pull/19207))

### Mypyc: Partial, Unsafe Support for Free Threading

Mypyc has minimal, quite memory-unsafe support for the free threaded
builds of 3.14. It is also only lightly tested. Bug reports and experience
reports are welcome!

Here are some of the major limitations:
* Free threading only works when compiling a single module at a time.
* If there is concurrent access to an object while another thread is mutating the same
  object, it's possible to encounter segfaults and memory corruption.
* There are no efficient native primitives for thread synthronization, though the
  regular `threading` module can be used.
* Some workloads don't scale well to multiple threads for no clear reason.

Related PRs:

* Enable partial, unsafe support for free-threading (Jukka Lehtosalo, PR [19167](https://github.com/python/mypy/pull/19167))
* Fix incref/decref on free-threaded builds (Jukka Lehtosalo, PR [19127](https://github.com/python/mypy/pull/19127))

### Other Mypyc Fixes and Improvements

* Derive .c file name from full module name if using multi_file (Jukka Lehtosalo, PR [19278](https://github.com/python/mypy/pull/19278))
* Support overriding the group name used in output files (Jukka Lehtosalo, PR [19272](https://github.com/python/mypy/pull/19272))
* Add note about using non-native class to subclass built-in types (Jukka Lehtosalo, PR [19236](https://github.com/python/mypy/pull/19236))
* Make some generated classes implicitly final (Jukka Lehtosalo, PR [19235](https://github.com/python/mypy/pull/19235))
* Don't simplify module prefixes if using separate compilation (Jukka Lehtosalo, PR [19206](https://github.com/python/mypy/pull/19206))

### Stubgen Improvements

* Add import for `types` in `__exit__` method signature (Alexey Makridenko, PR [19120](https://github.com/python/mypy/pull/19120))
* Add support for including class and property docstrings (Chad Dombrova, PR [17964](https://github.com/python/mypy/pull/17964))
* Don't generate `Incomplete | None = None` argument annotation (Sebastian Rittau, PR [19097](https://github.com/python/mypy/pull/19097))
* Support several more constructs in stubgen's alias printer (Stanislav Terliakov, PR [18888](https://github.com/python/mypy/pull/18888))

### Miscellaneous Fixes and Improvements

* Combine the revealed types of multiple iteration steps in a more robust manner (Christoph Tyralla, PR [19324](https://github.com/python/mypy/pull/19324))
* Improve the handling of "iteration dependent" errors and notes in finally clauses (Christoph Tyralla, PR [19270](https://github.com/python/mypy/pull/19270))
* Lessen dmypy suggest path limitations for Windows machines (CoolCat467, PR [19337](https://github.com/python/mypy/pull/19337))
* Fix type ignore comments erroneously marked as unused by dmypy (Charlie Denton, PR [15043](https://github.com/python/mypy/pull/15043))
* Fix misspelled `exhaustive-match` error code (johnthagen, PR [19276](https://github.com/python/mypy/pull/19276))
* Fix missing error context for unpacking assignment involving star expression (Brian Schubert, PR [19258](https://github.com/python/mypy/pull/19258))
* Fix and simplify error de-duplication (Ivan Levkivskyi, PR [19247](https://github.com/python/mypy/pull/19247))
* Disallow `ClassVar` in type aliases (Brian Schubert, PR [19263](https://github.com/python/mypy/pull/19263))
* Add script that prints list of compiled files when compiling mypy (Jukka Lehtosalo, PR [19260](https://github.com/python/mypy/pull/19260))
* Fix help message url for "None and Optional handling" section (Guy Wilson, PR [19252](https://github.com/python/mypy/pull/19252))
* Display fully qualified name of imported base classes in errors about incompatible overrides (Mikhail Golubev, PR [19115](https://github.com/python/mypy/pull/19115))
* Avoid false `unreachable`, `redundant-expr`, and `redundant-casts` warnings in loops more robustly and efficiently, and avoid multiple `revealed type` notes for the same line (Christoph Tyralla, PR [19118](https://github.com/python/mypy/pull/19118))
* Fix type extraction from `isinstance` checks (Stanislav Terliakov, PR [19223](https://github.com/python/mypy/pull/19223))
* Erase stray type variables in `functools.partial` (Stanislav Terliakov, PR [18954](https://github.com/python/mypy/pull/18954))
* Make inferring condition value recognize the whole truth table (Stanislav Terliakov, PR [18944](https://github.com/python/mypy/pull/18944))
* Support type aliases, `NamedTuple` and `TypedDict` in constrained TypeVar defaults (Stanislav Terliakov, PR [18884](https://github.com/python/mypy/pull/18884))
* Move dataclass `kw_only` fields to the end of the signature (Stanislav Terliakov, PR [19018](https://github.com/python/mypy/pull/19018))
* Provide a better fallback value for the `python_version` option (Marc Mueller, PR [19162](https://github.com/python/mypy/pull/19162))
* Avoid spurious non-overlapping equality error with metaclass with `__eq__` (Michael J. Sullivan, PR [19220](https://github.com/python/mypy/pull/19220))
* Narrow type variable bounds (Ivan Levkivskyi, PR [19183](https://github.com/python/mypy/pull/19183))
* Add classifier for Python 3.14 (Marc Mueller, PR [19199](https://github.com/python/mypy/pull/19199))
* Capitalize syntax error messages (Charulata, PR [19114](https://github.com/python/mypy/pull/19114))
* Infer constraints eagerly if actual is Any (Ivan Levkivskyi, PR [19190](https://github.com/python/mypy/pull/19190))
* Include walrus assignments in conditional inference (Stanislav Terliakov, PR [19038](https://github.com/python/mypy/pull/19038))
* Use PEP 604 syntax when converting types to strings (Marc Mueller, PR [19179](https://github.com/python/mypy/pull/19179))
* Use more lower-case builtin types in error messages (Marc Mueller, PR [19177](https://github.com/python/mypy/pull/19177))
* Fix example to use correct method of Stack (Łukasz Kwieciński, PR [19123](https://github.com/python/mypy/pull/19123))
* Forbid `.pop` of `Readonly` `NotRequired` TypedDict items (Stanislav Terliakov, PR [19133](https://github.com/python/mypy/pull/19133))
* Emit a friendlier warning on invalid exclude regex, instead of a stacktrace (wyattscarpenter, PR [19102](https://github.com/python/mypy/pull/19102))
* Enable ANSI color codes for dmypy client in Windows (wyattscarpenter, PR [19088](https://github.com/python/mypy/pull/19088))
* Extend special case for context-based type variable inference to unions in return position (Stanislav Terliakov, PR [18976](https://github.com/python/mypy/pull/18976))

### Mypy 1.17.1
* Retain `None` as constraints bottom if no bottoms were provided (Stanislav Terliakov, PR [19485](https://github.com/python/mypy/pull/19485))
* Fix "ignored exception in `hasattr`" in dmypy (Stanislav Terliakov, PR [19428](https://github.com/python/mypy/pull/19428))
* Prevent a crash when InitVar is redefined with a method in a subclass (Stanislav Terliakov, PR [19453](https://github.com/python/mypy/pull/19453))

### Acknowledgements

Thanks to all mypy contributors who contributed to this release:

* Alexey Makridenko
* Brian Schubert
* Chad Dombrova
* Chainfire
* Charlie Denton
* Charulata
* Christoph Tyralla
* CoolCat467
* Donal Burns
* Guy Wilson
* Ivan Levkivskyi
* johnthagen
* Jukka Lehtosalo
* Łukasz Kwieciński
* Marc Mueller
* Michael J. Sullivan
* Mikhail Golubev
* Sebastian Rittau
* Shantanu
* Stanislav Terliakov
* wyattscarpenter

I’d also like to thank my employer, Dropbox, for supporting mypy development.

## Mypy 1.16

We’ve just uploaded mypy 1.16 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)).
Mypy is a static type checker for Python. This release includes new features and bug fixes.
You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Different Property Getter and Setter Types

Mypy now supports using different types for a property getter and setter:

```python
class A:
    _value: int

    @property
    def foo(self) -> int:
        return self._value

    @foo.setter
    def foo(self, x: str | int) -> None:
        try:
            self._value = int(x)
        except ValueError:
            raise Exception(f"'{x}' is not a valid value for 'foo'")
```
This was contributed by Ivan Levkivskyi (PR [18510](https://github.com/python/mypy/pull/18510)).

### Flexible Variable Redefinitions (Experimental)

Mypy now allows unannotated variables to be freely redefined with
different types when using the experimental `--allow-redefinition-new`
flag. You will also need to enable `--local-partial-types`. Mypy will
now infer a union type when different types are assigned to a
variable:

```py
# mypy: allow-redefinition-new, local-partial-types

def f(n: int, b: bool) -> int | str:
    if b:
        x = n
    else:
        x = str(n)
    # Type of 'x' is int | str here.
    return x
```

Without the new flag, mypy only supports inferring optional types (`X
| None`) from multiple assignments, but now mypy can infer arbitrary
union types.

An unannotated variable can now also have different types in different
code locations:

```py
# mypy: allow-redefinition-new, local-partial-types
...

if cond():
    for x in range(n):
        # Type of 'x' is 'int' here
        ...
else:
    for x in ['a', 'b']:
        # Type of 'x' is 'str' here
        ...
```

We are planning to turn this flag on by default in mypy 2.0, along
with `--local-partial-types`. The feature is still experimental and
has known issues, and the semantics may still change in the
future. You may need to update or add type annotations when switching
to the new behavior, but if you encounter anything unexpected, please
create a GitHub issue.

This was contributed by Jukka Lehtosalo
(PR [18727](https://github.com/python/mypy/pull/18727), PR [19153](https://github.com/python/mypy/pull/19153)).

### Stricter Type Checking with Imprecise Types

Mypy can now detect additional errors in code that uses `Any` types or has missing function annotations.

When calling `dict.get(x, None)` on an object of type `dict[str, Any]`, this
now results in an optional type (in the past it was `Any`):

```python
def f(d: dict[str, Any]) -> int:
    # Error: Return value has type "Any | None" but expected "int"
    return d.get("x", None)
```

Type narrowing using assignments can result in more precise types in
the presence of `Any` types:

```python
def foo(): ...

def bar(n: int) -> None:
    x = foo()
    # Type of 'x' is 'Any' here
    if n > 5:
        x = str(n)
        # Type of 'x' is 'str' here
```

When using `--check-untyped-defs`, unannotated overrides are now
checked more strictly against superclass definitions.

Related PRs:

 * Use union types instead of join in binder (Ivan Levkivskyi, PR [18538](https://github.com/python/mypy/pull/18538))
 * Check superclass compatibility of untyped methods if `--check-untyped-defs` is set (Stanislav Terliakov, PR [18970](https://github.com/python/mypy/pull/18970))

### Improvements to Attribute Resolution

This release includes several fixes to inconsistent resolution of attribute, method and descriptor types.

 * Consolidate descriptor handling (Ivan Levkivskyi, PR [18831](https://github.com/python/mypy/pull/18831))
 * Make multiple inheritance checking use common semantics (Ivan Levkivskyi, PR [18876](https://github.com/python/mypy/pull/18876))
 * Make method override checking use common semantics  (Ivan Levkivskyi, PR [18870](https://github.com/python/mypy/pull/18870))
 * Fix descriptor overload selection (Ivan Levkivskyi, PR [18868](https://github.com/python/mypy/pull/18868))
 * Handle union types when binding `self` (Ivan Levkivskyi, PR [18867](https://github.com/python/mypy/pull/18867))
 * Make variable override checking use common semantics (Ivan Levkivskyi, PR [18847](https://github.com/python/mypy/pull/18847))
 * Make descriptor handling behave consistently (Ivan Levkivskyi, PR [18831](https://github.com/python/mypy/pull/18831))

### Make Implementation for Abstract Overloads Optional

The implementation can now be omitted for abstract overloaded methods,
even outside stubs:

```py
from abc import abstractmethod
from typing import overload

class C:
    @abstractmethod
    @overload
    def foo(self, x: int) -> int: ...

    @abstractmethod
    @overload
    def foo(self, x: str) -> str: ...

    # No implementation required for "foo"
```

This was contributed by Ivan Levkivskyi (PR [18882](https://github.com/python/mypy/pull/18882)).

### Option to Exclude Everything in .gitignore

You can now use `--exclude-gitignore` to exclude everything in a
`.gitignore` file from the mypy build. This behaves similar to
excluding the paths using `--exclude`. We might enable this by default
in a future mypy release.

This was contributed by Ivan Levkivskyi (PR [18696](https://github.com/python/mypy/pull/18696)).

### Selectively Disable Deprecated Warnings

It's now possible to selectively disable warnings generated from
[`warnings.deprecated`](https://docs.python.org/3/library/warnings.html#warnings.deprecated)
using the [`--deprecated-calls-exclude`](https://mypy.readthedocs.io/en/stable/command_line.html#cmdoption-mypy-deprecated-calls-exclude)
option:

```python
# mypy --enable-error-code deprecated
#      --deprecated-calls-exclude=foo.A
import foo

foo.A().func()  # OK, the deprecated warning is ignored
```

```python
# file foo.py

from typing_extensions import deprecated

class A:
    @deprecated("Use A.func2 instead")
    def func(self): pass

    ...
```

Contributed by Marc Mueller (PR [18641](https://github.com/python/mypy/pull/18641))

### Annotating Native/Non-Native Classes in Mypyc

You can now declare a class as a non-native class when compiling with
mypyc. Unlike native classes, which are extension classes and have an
immutable structure, non-native classes are normal Python classes at
runtime and are fully dynamic.  Example:

```python
from mypy_extensions import mypyc_attr

@mypyc_attr(native_class=False)
class NonNativeClass:
    ...

o = NonNativeClass()

# Ok, even if attribute "foo" not declared in class body
setattr(o, "foo", 1)
```

Classes are native by default in compiled modules, but classes that
use certain features (such as most metaclasses) are implicitly
non-native.

You can also explicitly declare a class as native. In this case mypyc
will generate an error if it can't compile the class as a native
class, instead of falling back to a non-native class:

```python
from mypy_extensions import mypyc_attr
from foo import MyMeta

# Error: Unsupported metaclass for a native class
@mypyc_attr(native_class=True)
class C(metaclass=MyMeta):
    ...
```

Since native classes are significantly more efficient that non-native
classes, you may want to ensure that certain classes always compiled
as native classes.

This feature was contributed by Valentin Stanciu (PR [18802](https://github.com/python/mypy/pull/18802)).

### Mypyc Fixes and Improvements

 * Improve documentation of native and non-native classes (Jukka Lehtosalo, PR [19154](https://github.com/python/mypy/pull/19154))
 * Fix compilation when using Python 3.13 debug build (Valentin Stanciu, PR [19045](https://github.com/python/mypy/pull/19045))
 * Show the reason why a class can't be a native class (Valentin Stanciu, PR [19016](https://github.com/python/mypy/pull/19016))
 * Support await/yield while temporary values are live (Michael J. Sullivan, PR [16305](https://github.com/python/mypy/pull/16305))
 * Fix spilling values with overlapping error values (Jukka Lehtosalo, PR [18961](https://github.com/python/mypy/pull/18961))
 * Fix reference count of spilled register in async def (Jukka Lehtosalo, PR [18957](https://github.com/python/mypy/pull/18957))
 * Add basic optimization for `sorted` (Marc Mueller, PR [18902](https://github.com/python/mypy/pull/18902))
 * Fix access of class object in a type annotation (Advait Dixit, PR [18874](https://github.com/python/mypy/pull/18874))
 * Optimize `list.__imul__` and `tuple.__mul__ `(Marc Mueller, PR [18887](https://github.com/python/mypy/pull/18887))
 * Optimize `list.__add__`, `list.__iadd__` and `tuple.__add__` (Marc Mueller, PR [18845](https://github.com/python/mypy/pull/18845))
 * Add and implement primitive `list.copy()` (exertustfm, PR [18771](https://github.com/python/mypy/pull/18771))
 * Optimize `builtins.repr` (Marc Mueller, PR [18844](https://github.com/python/mypy/pull/18844))
 * Support iterating over keys/values/items of dict-bound TypeVar and ParamSpec.kwargs (Stanislav Terliakov, PR [18789](https://github.com/python/mypy/pull/18789))
 * Add efficient primitives for `str.strip()` etc. (Advait Dixit, PR [18742](https://github.com/python/mypy/pull/18742))
 * Document that `strip()` etc. are optimized (Jukka Lehtosalo, PR [18793](https://github.com/python/mypy/pull/18793))
 * Fix mypyc crash with enum type aliases (Valentin Stanciu, PR [18725](https://github.com/python/mypy/pull/18725))
 * Optimize `str.find` and `str.rfind` (Marc Mueller, PR [18709](https://github.com/python/mypy/pull/18709))
 * Optimize `str.__contains__` (Marc Mueller, PR [18705](https://github.com/python/mypy/pull/18705))
 * Fix order of steal/unborrow in tuple unpacking (Ivan Levkivskyi, PR [18732](https://github.com/python/mypy/pull/18732))
 * Optimize `str.partition` and `str.rpartition` (Marc Mueller, PR [18702](https://github.com/python/mypy/pull/18702))
 * Optimize `str.startswith` and `str.endswith` with tuple argument (Marc Mueller, PR [18678](https://github.com/python/mypy/pull/18678))
 * Improve `str.startswith` and `str.endswith` with tuple argument (Marc Mueller, PR [18703](https://github.com/python/mypy/pull/18703))
 * `pythoncapi_compat`: don't define Py_NULL if it is already defined (Michael R. Crusoe, PR [18699](https://github.com/python/mypy/pull/18699))
 * Optimize `str.splitlines` (Marc Mueller, PR [18677](https://github.com/python/mypy/pull/18677))
 * Mark `dict.setdefault` as optimized (Marc Mueller, PR [18685](https://github.com/python/mypy/pull/18685))
 * Support `__del__` methods (Advait Dixit, PR [18519](https://github.com/python/mypy/pull/18519))
 * Optimize `str.rsplit` (Marc Mueller, PR [18673](https://github.com/python/mypy/pull/18673))
 * Optimize `str.removeprefix` and `str.removesuffix` (Marc Mueller, PR [18672](https://github.com/python/mypy/pull/18672))
 * Recognize literal types in `__match_args__` (Stanislav Terliakov, PR [18636](https://github.com/python/mypy/pull/18636))
 * Fix non extension classes with attribute annotations using forward references (Valentin Stanciu, PR [18577](https://github.com/python/mypy/pull/18577))
 * Use lower-case generic types such as `list[t]` in documentation (Jukka Lehtosalo, PR [18576](https://github.com/python/mypy/pull/18576))
 * Improve support for `frozenset` (Marc Mueller, PR [18571](https://github.com/python/mypy/pull/18571))
 * Fix wheel build for cp313-win (Marc Mueller, PR [18560](https://github.com/python/mypy/pull/18560))
 * Reduce impact of immortality (introduced in Python 3.12) on reference counting performance (Jukka Lehtosalo, PR [18459](https://github.com/python/mypy/pull/18459))
 * Update math error messages for 3.14 (Marc Mueller, PR [18534](https://github.com/python/mypy/pull/18534))
 * Update math error messages for 3.14 (2) (Marc Mueller, PR [18949](https://github.com/python/mypy/pull/18949))
 * Replace deprecated `_PyLong_new` with `PyLongWriter` API (Marc Mueller, PR [18532](https://github.com/python/mypy/pull/18532))

### Fixes to Crashes

 * Traverse module ancestors when traversing reachable graph nodes during dmypy update (Stanislav Terliakov, PR [18906](https://github.com/python/mypy/pull/18906))
 * Fix crash on multiple unpacks in a bare type application (Stanislav Terliakov, PR [18857](https://github.com/python/mypy/pull/18857))
 * Prevent crash when enum/TypedDict call is stored as a class attribute (Stanislav Terliakov, PR [18861](https://github.com/python/mypy/pull/18861))
 * Fix crash on multiple unpacks in a bare type application (Stanislav Terliakov, PR [18857](https://github.com/python/mypy/pull/18857))
 * Fix crash on type inference against non-normal callables (Ivan Levkivskyi, PR [18858](https://github.com/python/mypy/pull/18858))
 * Fix crash on decorated getter in settable property (Ivan Levkivskyi, PR [18787](https://github.com/python/mypy/pull/18787))
 * Fix crash on callable with `*args` and suffix against Any (Ivan Levkivskyi, PR [18781](https://github.com/python/mypy/pull/18781))
 * Fix crash on deferred supertype and setter override (Ivan Levkivskyi, PR [18649](https://github.com/python/mypy/pull/18649))
 * Fix crashes on incorrectly detected recursive aliases (Ivan Levkivskyi, PR [18625](https://github.com/python/mypy/pull/18625))
 * Report that `NamedTuple` and `dataclass` are incompatile instead of crashing (Christoph Tyralla, PR [18633](https://github.com/python/mypy/pull/18633))
 * Fix mypy daemon crash (Valentin Stanciu, PR [19087](https://github.com/python/mypy/pull/19087))

### Performance Improvements

These are specific to mypy. Mypyc-related performance improvements are discussed elsewhere.

 * Speed up binding `self` in trivial cases (Ivan Levkivskyi, PR [19024](https://github.com/python/mypy/pull/19024))
 * Small constraint solver optimization (Aaron Gokaslan, PR [18688](https://github.com/python/mypy/pull/18688))

### Documentation Updates

 * Improve documentation of `--strict` (lenayoung8, PR [18903](https://github.com/python/mypy/pull/18903))
 * Remove a note about `from __future__ import annotations` (Ageev Maxim, PR [18915](https://github.com/python/mypy/pull/18915))
 * Improve documentation on type narrowing (Tim Hoffmann, PR [18767](https://github.com/python/mypy/pull/18767))
 * Fix metaclass usage example (Georg, PR [18686](https://github.com/python/mypy/pull/18686))
 * Update documentation on `extra_checks` flag (Ivan Levkivskyi, PR [18537](https://github.com/python/mypy/pull/18537))

### Stubgen Improvements

 * Fix `TypeAlias` handling (Alexey Makridenko, PR [18960](https://github.com/python/mypy/pull/18960))
 * Handle `arg=None` in C extension modules (Anthony Sottile, PR [18768](https://github.com/python/mypy/pull/18768))
 * Fix valid type detection to allow pipe unions (Chad Dombrova, PR [18726](https://github.com/python/mypy/pull/18726))
 * Include simple decorators in stub files (Marc Mueller, PR [18489](https://github.com/python/mypy/pull/18489))
 * Support positional and keyword-only arguments in stubdoc (Paul Ganssle, PR [18762](https://github.com/python/mypy/pull/18762))
 * Fall back to `Incomplete` if we are unable to determine the module name (Stanislav Terliakov, PR [19084](https://github.com/python/mypy/pull/19084))

### Stubtest Improvements

 * Make stubtest ignore `__slotnames__` (Nick Pope, PR [19077](https://github.com/python/mypy/pull/19077))
 * Fix stubtest tests on 3.14 (Jelle Zijlstra, PR [19074](https://github.com/python/mypy/pull/19074))
 * Support for `strict_bytes` in stubtest (Joren Hammudoglu, PR [19002](https://github.com/python/mypy/pull/19002))
 * Understand override (Shantanu, PR [18815](https://github.com/python/mypy/pull/18815))
 * Better checking of runtime arguments with dunder names (Shantanu, PR [18756](https://github.com/python/mypy/pull/18756))
 * Ignore setattr and delattr inherited from object (Stephen Morton, PR [18325](https://github.com/python/mypy/pull/18325))

### Miscellaneous Fixes and Improvements

 * Add `--strict-bytes` to `--strict` (wyattscarpenter, PR [19049](https://github.com/python/mypy/pull/19049))
 * Admit that Final variables are never redefined (Stanislav Terliakov, PR [19083](https://github.com/python/mypy/pull/19083))
 * Add special support for `@django.cached_property` needed in `django-stubs` (sobolevn, PR [18959](https://github.com/python/mypy/pull/18959))
 * Do not narrow types to `Never` with binder (Ivan Levkivskyi, PR [18972](https://github.com/python/mypy/pull/18972))
 * Local forward references should precede global forward references (Ivan Levkivskyi, PR [19000](https://github.com/python/mypy/pull/19000))
 * Do not cache module lookup results in incremental mode that may become invalid (Stanislav Terliakov, PR [19044](https://github.com/python/mypy/pull/19044))
 * Only consider meta variables in ambiguous "any of" constraints (Stanislav Terliakov, PR [18986](https://github.com/python/mypy/pull/18986))
 * Allow accessing `__init__` on final classes and when `__init__` is final (Stanislav Terliakov, PR [19035](https://github.com/python/mypy/pull/19035))
 * Treat varargs as positional-only (A5rocks, PR [19022](https://github.com/python/mypy/pull/19022))
 * Enable colored output for argparse help in Python 3.14 (Marc Mueller, PR [19021](https://github.com/python/mypy/pull/19021))
 * Fix argparse for Python 3.14 (Marc Mueller, PR [19020](https://github.com/python/mypy/pull/19020))
 * `dmypy suggest` can now suggest through contextmanager-based decorators (Anthony Sottile, PR [18948](https://github.com/python/mypy/pull/18948))
 * Fix `__r<magic_methods>__` being used under the same `__<magic_method>__` hook (Arnav Jain, PR [18995](https://github.com/python/mypy/pull/18995))
 * Prioritize `.pyi` from `-stubs` packages over bundled `.pyi` (Joren Hammudoglu, PR [19001](https://github.com/python/mypy/pull/19001))
 * Fix missing subtype check case for `type[T]` (Stanislav Terliakov, PR [18975](https://github.com/python/mypy/pull/18975))
 * Fixes to the detection of redundant casts (Anthony Sottile, PR [18588](https://github.com/python/mypy/pull/18588))
 * Make some parse errors non-blocking (Shantanu, PR [18941](https://github.com/python/mypy/pull/18941))
 * Fix PEP 695 type alias with a mix of type arguments (PEP 696) (Marc Mueller, PR [18919](https://github.com/python/mypy/pull/18919))
 * Allow deeper recursion in mypy daemon, better error reporting (Carter Dodd, PR [17707](https://github.com/python/mypy/pull/17707))
 * Fix swapped errors for frozen/non-frozen dataclass inheritance (Nazrawi Demeke, PR [18918](https://github.com/python/mypy/pull/18918))
 * Fix incremental issue with namespace packages (Shantanu, PR [18907](https://github.com/python/mypy/pull/18907))
 * Exclude irrelevant members when narrowing union overlapping with enum (Stanislav Terliakov, PR [18897](https://github.com/python/mypy/pull/18897))
 * Flatten union before contracting literals when checking subtyping (Stanislav Terliakov, PR [18898](https://github.com/python/mypy/pull/18898))
 * Do not add `kw_only` dataclass fields to `__match_args__` (sobolevn, PR [18892](https://github.com/python/mypy/pull/18892))
 * Fix error message when returning long tuple with type mismatch (Thomas Mattone, PR [18881](https://github.com/python/mypy/pull/18881))
 * Treat `TypedDict` (old-style) aliases as regular `TypedDict`s (Stanislav Terliakov, PR [18852](https://github.com/python/mypy/pull/18852))
 * Warn about unused `type: ignore` comments when error code is disabled (Brian Schubert, PR [18849](https://github.com/python/mypy/pull/18849))
 * Reject duplicate `ParamSpec.{args,kwargs}` at call site (Stanislav Terliakov, PR [18854](https://github.com/python/mypy/pull/18854))
 * Make detection of enum members more consistent (sobolevn, PR [18675](https://github.com/python/mypy/pull/18675))
 * Admit that `**kwargs` mapping subtypes may have no direct type parameters (Stanislav Terliakov, PR [18850](https://github.com/python/mypy/pull/18850))
 * Don't suggest `types-setuptools` for `pkg_resources` (Shantanu, PR [18840](https://github.com/python/mypy/pull/18840))
 * Suggest `scipy-stubs` for `scipy` as non-typeshed stub package (Joren Hammudoglu, PR [18832](https://github.com/python/mypy/pull/18832))
 * Narrow tagged unions in match statements (Gene Parmesan Thomas, PR [18791](https://github.com/python/mypy/pull/18791))
 * Consistently store settable property type (Ivan Levkivskyi, PR [18774](https://github.com/python/mypy/pull/18774))
 * Do not blindly undefer on leaving function (Ivan Levkivskyi, PR [18674](https://github.com/python/mypy/pull/18674))
 * Process superclass methods before subclass methods in semanal (Ivan Levkivskyi, PR [18723](https://github.com/python/mypy/pull/18723))
 * Only defer top-level functions (Ivan Levkivskyi, PR [18718](https://github.com/python/mypy/pull/18718))
 * Add one more type-checking pass (Ivan Levkivskyi, PR [18717](https://github.com/python/mypy/pull/18717))
 * Properly account for `member` and `nonmember` in enums (sobolevn, PR [18559](https://github.com/python/mypy/pull/18559))
 * Fix instance vs tuple subtyping edge case (Ivan Levkivskyi, PR [18664](https://github.com/python/mypy/pull/18664))
 * Improve handling of Any/object in variadic generics (Ivan Levkivskyi, PR [18643](https://github.com/python/mypy/pull/18643))
 * Fix handling of named tuples in class match pattern (Ivan Levkivskyi, PR [18663](https://github.com/python/mypy/pull/18663))
 * Fix regression for user config files (Shantanu, PR [18656](https://github.com/python/mypy/pull/18656))
 * Fix dmypy socket issue on GNU/Hurd (Mattias Ellert, PR [18630](https://github.com/python/mypy/pull/18630))
 * Don't assume that for loop body index variable is always set (Jukka Lehtosalo, PR [18631](https://github.com/python/mypy/pull/18631))
 * Fix overlap check for variadic generics (Ivan Levkivskyi, PR [18638](https://github.com/python/mypy/pull/18638))
 * Improve support for `functools.partial` of overloaded callable protocol (Shantanu, PR [18639](https://github.com/python/mypy/pull/18639))
 * Allow lambdas in `except*` clauses (Stanislav Terliakov, PR [18620](https://github.com/python/mypy/pull/18620))
 * Fix trailing commas in many multiline string options in `pyproject.toml` (sobolevn, PR [18624](https://github.com/python/mypy/pull/18624))
 * Allow trailing commas for `files` setting in `mypy.ini` and `setup.ini` (sobolevn, PR [18621](https://github.com/python/mypy/pull/18621))
 * Fix "not callable" issue for `@dataclass(frozen=True)` with `Final` attr (sobolevn, PR [18572](https://github.com/python/mypy/pull/18572))
 * Add missing TypedDict special case when checking member access (Stanislav Terliakov, PR [18604](https://github.com/python/mypy/pull/18604))
 * Use lower case `list` and `dict` in invariance notes (Jukka Lehtosalo, PR [18594](https://github.com/python/mypy/pull/18594))
 * Fix inference when class and instance match protocol (Ivan Levkivskyi, PR [18587](https://github.com/python/mypy/pull/18587))
 * Remove support for `builtins.Any` (Marc Mueller, PR [18578](https://github.com/python/mypy/pull/18578))
 * Update the overlapping check for tuples to account for NamedTuples (A5rocks, PR [18564](https://github.com/python/mypy/pull/18564))
 * Fix `@deprecated` (PEP 702) with normal overloaded methods (Christoph Tyralla, PR [18477](https://github.com/python/mypy/pull/18477))
 * Start propagating end columns/lines for `type-arg` errors (A5rocks, PR [18533](https://github.com/python/mypy/pull/18533))
 * Improve handling of `type(x) is Foo` checks (Stanislav Terliakov, PR [18486](https://github.com/python/mypy/pull/18486))
 * Suggest `typing.Literal` for exit-return error messages (Marc Mueller, PR [18541](https://github.com/python/mypy/pull/18541))
 * Allow redefinitions in except/else/finally (Stanislav Terliakov, PR [18515](https://github.com/python/mypy/pull/18515))
 * Disallow setting Python version using inline config (Shantanu, PR [18497](https://github.com/python/mypy/pull/18497))
 * Improve type inference in tuple multiplication plugin (Shantanu, PR [18521](https://github.com/python/mypy/pull/18521))
 * Add missing line number to `yield from` with wrong type (Stanislav Terliakov, PR [18518](https://github.com/python/mypy/pull/18518))
 * Hint at argument names when formatting callables with compatible return types in error messages (Stanislav Terliakov, PR [18495](https://github.com/python/mypy/pull/18495))
 * Add better naming and improve compatibility for ad hoc intersections of instances (Christoph Tyralla, PR [18506](https://github.com/python/mypy/pull/18506))

### Acknowledgements

Thanks to all mypy contributors who contributed to this release:

- A5rocks
- Aaron Gokaslan
- Advait Dixit
- Ageev Maxim
- Alexey Makridenko
- Ali Hamdan
- Anthony Sottile
- Arnav Jain
- Brian Schubert
- bzoracler
- Carter Dodd
- Chad Dombrova
- Christoph Tyralla
- Dimitri Papadopoulos Orfanos
- Emma Smith
- exertustfm
- Gene Parmesan Thomas
- Georg
- Ivan Levkivskyi
- Jared Hance
- Jelle Zijlstra
- Joren Hammudoglu
- lenayoung8
- Marc Mueller
- Mattias Ellert
- Michael J. Sullivan
- Michael R. Crusoe
- Nazrawi Demeke
- Nick Pope
- Paul Ganssle
- Shantanu
- sobolevn
- Stanislav Terliakov
- Stephen Morton
- Thomas Mattone
- Tim Hoffmann
- Tim Ruffing
- Valentin Stanciu
- Wesley Collin Wright
- wyattscarpenter

I’d also like to thank my employer, Dropbox, for supporting mypy development.

## Mypy 1.15

We’ve just uploaded mypy 1.15 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)).
Mypy is a static type checker for Python. This release includes new features, performance
improvements and bug fixes. You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Performance Improvements

Mypy is up to 40% faster in some use cases. This improvement comes largely from tuning the performance
of the garbage collector. Additionally, the release includes several micro-optimizations that may
be impactful for large projects.

Contributed by Jukka Lehtosalo
- PR [18306](https://github.com/python/mypy/pull/18306)
- PR [18302](https://github.com/python/mypy/pull/18302)
- PR [18298](https://github.com/python/mypy/pull/18298)
- PR [18299](https://github.com/python/mypy/pull/18299)

### Mypyc Accelerated Mypy Wheels for ARM Linux

For best performance, mypy can be compiled to C extension modules using mypyc. This makes
mypy 3-5x faster than when interpreted with pure Python. We now build and upload mypyc
accelerated mypy wheels for `manylinux_aarch64` to PyPI, making it easy for Linux users on
ARM platforms to realise this speedup -- just `pip install` the latest mypy.

Contributed by Christian Bundy and Marc Mueller
(PR [mypy_mypyc-wheels#76](https://github.com/mypyc/mypy_mypyc-wheels/pull/76),
PR [mypy_mypyc-wheels#89](https://github.com/mypyc/mypy_mypyc-wheels/pull/89)).

### `--strict-bytes`

By default, mypy treats `bytearray` and `memoryview` values as assignable to the `bytes`
type, for historical reasons. Use the `--strict-bytes` flag to disable this
behavior. [PEP 688](https://peps.python.org/pep-0688) specified the removal of this
special case. The flag will be enabled by default in **mypy 2.0**.

Contributed by Ali Hamdan (PR [18263](https://github.com/python/mypy/pull/18263)) and
Shantanu Jain (PR [13952](https://github.com/python/mypy/pull/13952)).

### Improvements to Reachability Analysis and Partial Type Handling in Loops

This change results in mypy better modelling control flow within loops and hence detecting
several previously ignored issues. In some cases, this change may require additional
explicit variable annotations.

Contributed by Christoph Tyralla (PR [18180](https://github.com/python/mypy/pull/18180),
PR [18433](https://github.com/python/mypy/pull/18433)).

(Speaking of partial types, remember that we plan to enable `--local-partial-types`
by default in **mypy 2.0**.)

### Better Discovery of Configuration Files

Mypy will now walk up the filesystem (up until a repository or file system root) to discover
configuration files. See the
[mypy configuration file documentation](https://mypy.readthedocs.io/en/stable/config_file.html)
for more details.

Contributed by Mikhail Shiryaev and Shantanu Jain
(PR [16965](https://github.com/python/mypy/pull/16965), PR [18482](https://github.com/python/mypy/pull/18482))

### Better Line Numbers for Decorators and Slice Expressions

Mypy now uses more correct line numbers for decorators and slice expressions. In some cases,
you may have to change the location of a `# type: ignore` comment.

Contributed by Shantanu Jain (PR [18392](https://github.com/python/mypy/pull/18392),
PR [18397](https://github.com/python/mypy/pull/18397)).

### Drop Support for Python 3.8

Mypy no longer supports running with Python 3.8, which has reached end-of-life.
When running mypy with Python 3.9+, it is still possible to type check code
that needs to support Python 3.8 with the `--python-version 3.8` argument.
Support for this will be dropped in the first half of 2025!

Contributed by Marc Mueller (PR [17492](https://github.com/python/mypy/pull/17492)).

### Mypyc Improvements

 * Fix `__init__` for classes with `@attr.s(slots=True)` (Advait Dixit, PR [18447](https://github.com/python/mypy/pull/18447))
 * Report error for nested class instead of crashing (Valentin Stanciu, PR [18460](https://github.com/python/mypy/pull/18460))
 * Fix `InitVar` for dataclasses (Advait Dixit, PR [18319](https://github.com/python/mypy/pull/18319))
 * Remove unnecessary mypyc files from wheels (Marc Mueller, PR [18416](https://github.com/python/mypy/pull/18416))
 * Fix issues with relative imports (Advait Dixit, PR [18286](https://github.com/python/mypy/pull/18286))
 * Add faster primitive for some list get item operations (Jukka Lehtosalo, PR [18136](https://github.com/python/mypy/pull/18136))
 * Fix iteration over `NamedTuple` objects (Advait Dixit, PR [18254](https://github.com/python/mypy/pull/18254))
 * Mark mypyc package with `py.typed` (bzoracler, PR [18253](https://github.com/python/mypy/pull/18253))
 * Fix list index while checking for `Enum` class (Advait Dixit, PR [18426](https://github.com/python/mypy/pull/18426))

### Stubgen Improvements

 * Improve dataclass init signatures (Marc Mueller, PR [18430](https://github.com/python/mypy/pull/18430))
 * Preserve `dataclass_transform` decorator (Marc Mueller, PR [18418](https://github.com/python/mypy/pull/18418))
 * Fix `UnpackType` for 3.11+ (Marc Mueller, PR [18421](https://github.com/python/mypy/pull/18421))
 * Improve `self` annotations (Marc Mueller, PR [18420](https://github.com/python/mypy/pull/18420))
 * Print `InspectError` traceback in stubgen `walk_packages` when verbose is specified (Gareth, PR [18224](https://github.com/python/mypy/pull/18224))

### Stubtest Improvements

 * Fix crash with numpy array default values (Ali Hamdan, PR [18353](https://github.com/python/mypy/pull/18353))
 * Distinguish metaclass attributes from class attributes (Stephen Morton, PR [18314](https://github.com/python/mypy/pull/18314))

### Fixes to Crashes

 * Prevent crash with `Unpack` of a fixed tuple in PEP695 type alias (Stanislav Terliakov, PR [18451](https://github.com/python/mypy/pull/18451))
 * Fix crash with `--cache-fine-grained --cache-dir=/dev/null` (Shantanu, PR [18457](https://github.com/python/mypy/pull/18457))
 * Prevent crashing when `match` arms use name of existing callable (Stanislav Terliakov, PR [18449](https://github.com/python/mypy/pull/18449))
 * Gracefully handle encoding errors when writing to stdout (Brian Schubert, PR [18292](https://github.com/python/mypy/pull/18292))
 * Prevent crash on generic NamedTuple with unresolved typevar bound (Stanislav Terliakov, PR [18585](https://github.com/python/mypy/pull/18585))

### Documentation Updates

 * Add inline tabs to documentation (Marc Mueller, PR [18262](https://github.com/python/mypy/pull/18262))
 * Document any `TYPE_CHECKING` name works (Shantanu, PR [18443](https://github.com/python/mypy/pull/18443))
 * Update documentation to not mention 3.8 where possible (sobolevn, PR [18455](https://github.com/python/mypy/pull/18455))
 * Mention `ignore_errors` in exclude documentation (Shantanu, PR [18412](https://github.com/python/mypy/pull/18412))
 * Add `Self` misuse to common issues (Shantanu, PR [18261](https://github.com/python/mypy/pull/18261))

### Other Notable Fixes and Improvements

 * Fix literal context for ternary expressions (Ivan Levkivskyi, PR [18545](https://github.com/python/mypy/pull/18545))
 * Ignore `dataclass.__replace__` LSP violations (Marc Mueller, PR [18464](https://github.com/python/mypy/pull/18464))
 * Bind `self` to the class being defined when checking multiple inheritance (Stanislav Terliakov, PR [18465](https://github.com/python/mypy/pull/18465))
 * Fix attribute type resolution with multiple inheritance (Stanislav Terliakov, PR [18415](https://github.com/python/mypy/pull/18415))
 * Improve security of our GitHub Actions (sobolevn, PR [18413](https://github.com/python/mypy/pull/18413))
 * Unwrap `type[Union[...]]` when solving type variable constraints (Stanislav Terliakov, PR [18266](https://github.com/python/mypy/pull/18266))
 * Allow `Any` to match sequence patterns in match/case (Stanislav Terliakov, PR [18448](https://github.com/python/mypy/pull/18448))
 * Fix parent generics mapping when overriding generic attribute with property (Stanislav Terliakov, PR [18441](https://github.com/python/mypy/pull/18441))
 * Add dedicated error code for explicit `Any` (Shantanu, PR [18398](https://github.com/python/mypy/pull/18398))
 * Reject invalid `ParamSpec` locations (Stanislav Terliakov, PR [18278](https://github.com/python/mypy/pull/18278))
 * Stop suggesting stubs that have been removed from typeshed (Shantanu, PR [18373](https://github.com/python/mypy/pull/18373))
 * Allow inverting `--local-partial-types` (Shantanu, PR [18377](https://github.com/python/mypy/pull/18377))
 * Allow to use `Final` and `ClassVar` after Python 3.13 (정승원, PR [18358](https://github.com/python/mypy/pull/18358))
 * Update suggestions to include latest stubs in typeshed (Shantanu, PR [18366](https://github.com/python/mypy/pull/18366))
 * Fix `--install-types` masking failure details (wyattscarpenter, PR [17485](https://github.com/python/mypy/pull/17485))
 * Reject promotions when checking against protocols (Christoph Tyralla, PR [18360](https://github.com/python/mypy/pull/18360))
 * Don't erase type object arguments in diagnostics (Shantanu, PR [18352](https://github.com/python/mypy/pull/18352))
 * Clarify status in `dmypy status` output (Kcornw, PR [18331](https://github.com/python/mypy/pull/18331))
 * Disallow no-argument generic aliases when using PEP 613 explicit aliases (Brian Schubert, PR [18173](https://github.com/python/mypy/pull/18173))
 * Suppress errors for unreachable branches in conditional expressions (Brian Schubert, PR [18295](https://github.com/python/mypy/pull/18295))
 * Do not allow `ClassVar` and `Final` in `TypedDict` and `NamedTuple` (sobolevn, PR [18281](https://github.com/python/mypy/pull/18281))
 * Report error if not enough or too many types provided to `TypeAliasType` (bzoracler, PR [18308](https://github.com/python/mypy/pull/18308))
 * Use more precise context for `TypedDict` plugin errors (Brian Schubert, PR [18293](https://github.com/python/mypy/pull/18293))
 * Use more precise context for invalid type argument errors (Brian Schubert, PR [18290](https://github.com/python/mypy/pull/18290))
 * Do not allow `type[]` to contain `Literal` types (sobolevn, PR [18276](https://github.com/python/mypy/pull/18276))
 * Allow bytearray/bytes comparisons with `--strict-bytes` (Jukka Lehtosalo, PR [18255](https://github.com/python/mypy/pull/18255))

### Acknowledgements

Thanks to all mypy contributors who contributed to this release:

- Advait Dixit
- Ali Hamdan
- Brian Schubert
- bzoracler
- Cameron Matsui
- Christoph Tyralla
- Gareth
- Ivan Levkivskyi
- Jukka Lehtosalo
- Kcornw
- Marc Mueller
- Mikhail f. Shiryaev
- Shantanu
- sobolevn
- Stanislav Terliakov
- Stephen Morton
- Valentin Stanciu
- Viktor Szépe
- wyattscarpenter
- 정승원

I’d also like to thank my employer, Dropbox, for supporting mypy development.

## Mypy 1.14

We’ve just uploaded mypy 1.14 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)).
Mypy is a static type checker for Python. This release includes new features and bug fixes.
You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Change to Enum Membership Semantics

As per the updated [typing specification for enums](https://typing.readthedocs.io/en/latest/spec/enums.html#defining-members),
enum members must be left unannotated.

```python
class Pet(Enum):
    CAT = 1  # Member attribute
    DOG = 2  # Member attribute

    # New error: Enum members must be left unannotated
    WOLF: int = 3

    species: str  # Considered a non-member attribute
```

In particular, the specification change can result in issues in type stubs (`.pyi` files), since
historically it was common to leave the value absent:

```python
# In a type stub (.pyi file)

class Pet(Enum):
    # Change in semantics: previously considered members,
    # now non-member attributes
    CAT: int
    DOG: int

    # Mypy will now issue a warning if it detects this
    # situation in type stubs:
    # > Detected enum "Pet" in a type stub with zero
    # > members. There is a chance this is due to a recent
    # > change in the semantics of enum membership. If so,
    # > use `member = value` to mark an enum member,
    # > instead of `member: type`

class Pet(Enum):
    # As per the specification, you should now do one of
    # the following:
    DOG = 1  # Member attribute with value 1 and known type
    WOLF = cast(int, ...)  # Member attribute with unknown
                           # value but known type
    LION = ...  # Member attribute with unknown value and
                # # unknown type
```

Contributed by Terence Honles (PR [17207](https://github.com/python/mypy/pull/17207)) and
Shantanu Jain (PR [18068](https://github.com/python/mypy/pull/18068)).

### Support for @deprecated Decorator (PEP 702)

Mypy can now issue errors or notes when code imports a deprecated feature
explicitly with a `from mod import depr` statement, or uses a deprecated feature
imported otherwise or defined locally. Features are considered deprecated when
decorated with `warnings.deprecated`, as specified in [PEP 702](https://peps.python.org/pep-0702).

You can enable the error code via `--enable-error-code=deprecated` on the mypy
command line or `enable_error_code = deprecated` in the mypy config file.
Use the command line flag `--report-deprecated-as-note` or config file option
`report_deprecated_as_note=True` to turn all such errors into notes.

Deprecation errors will be enabled by default in a future mypy version.

This feature was contributed by Christoph Tyralla.

List of changes:

 * Add basic support for PEP 702 (`@deprecated`) (Christoph Tyralla, PR [17476](https://github.com/python/mypy/pull/17476))
 * Support descriptors with `@deprecated` (Christoph Tyralla, PR [18090](https://github.com/python/mypy/pull/18090))
 * Make "deprecated" note an error, disabled by default (Valentin Stanciu, PR [18192](https://github.com/python/mypy/pull/18192))
 * Consider all possible type positions with `@deprecated` (Christoph Tyralla, PR [17926](https://github.com/python/mypy/pull/17926))
 * Improve the handling of explicit type annotations in assignment statements with `@deprecated` (Christoph Tyralla, PR [17899](https://github.com/python/mypy/pull/17899))

### Optionally Analyzing Untyped Modules

Mypy normally doesn't analyze imports from third-party modules (installed using pip, for example)
if there are no stubs or a py.typed marker file. To force mypy to analyze these imports, you
can now use the `--follow-untyped-imports` flag or set the `follow_untyped_imports`
config file option to True. This can be set either in the global section of your mypy config
file, or individually on a per-module basis.

This feature was contributed by Jannick Kremer.

List of changes:

 * Implement flag to allow type checking of untyped modules (Jannick Kremer, PR [17712](https://github.com/python/mypy/pull/17712))
 * Warn about `--follow-untyped-imports` (Shantanu, PR [18249](https://github.com/python/mypy/pull/18249))

### Support New Style Type Variable Defaults (PEP 696)

Mypy now supports type variable defaults using the new syntax described in PEP 696, which
was introduced in Python 3.13. Example:

```python
@dataclass
class Box[T = int]:  # Set default for "T"
    value: T | None = None

reveal_type(Box())                      # type is Box[int], since it's the default
reveal_type(Box(value="Hello World!"))  # type is Box[str]
```

This feature was contributed by Marc Mueller (PR [17985](https://github.com/python/mypy/pull/17985)).

### Improved For Loop Index Variable Type Narrowing

Mypy now preserves the literal type of for loop index variables, to support `TypedDict`
lookups. Example:

```python
from typing import TypedDict

class X(TypedDict):
    hourly: int
    daily: int

def func(x: X) -> int:
    s = 0
    for var in ("hourly", "daily"):
        # "Union[Literal['hourly']?, Literal['daily']?]"
        reveal_type(var)

        # x[var] no longer triggers a literal-required error
        s += x[var]
    return s
```

This was contributed by Marc Mueller (PR [18014](https://github.com/python/mypy/pull/18014)).

### Mypyc Improvements

 * Document optimized bytes operations and additional str operations (Jukka Lehtosalo, PR [18242](https://github.com/python/mypy/pull/18242))
 * Add primitives and specialization for `ord()` (Jukka Lehtosalo, PR [18240](https://github.com/python/mypy/pull/18240))
 * Optimize `str.encode` with specializations for common used encodings (Valentin Stanciu, PR [18232](https://github.com/python/mypy/pull/18232))
 * Fix fall back to generic operation for staticmethod and classmethod (Advait Dixit, PR [18228](https://github.com/python/mypy/pull/18228))
 * Support unicode surrogates in string literals (Jukka Lehtosalo, PR [18209](https://github.com/python/mypy/pull/18209))
 * Fix index variable in for loop with `builtins.enumerate` (Advait Dixit, PR [18202](https://github.com/python/mypy/pull/18202))
 * Fix check for enum classes (Advait Dixit, PR [18178](https://github.com/python/mypy/pull/18178))
 * Fix loading type from imported modules (Advait Dixit, PR [18158](https://github.com/python/mypy/pull/18158))
 * Fix initializers of final attributes in class body (Jared Hance, PR [18031](https://github.com/python/mypy/pull/18031))
 * Fix name generation for modules with similar full names (aatle, PR [18001](https://github.com/python/mypy/pull/18001))
 * Fix relative imports in `__init__.py` (Shantanu, PR [17979](https://github.com/python/mypy/pull/17979))
 * Optimize dunder methods (jairov4, PR [17934](https://github.com/python/mypy/pull/17934))
 * Replace deprecated `_PyDict_GetItemStringWithError` (Marc Mueller, PR [17930](https://github.com/python/mypy/pull/17930))
 * Fix wheel build for cp313-win (Marc Mueller, PR [17941](https://github.com/python/mypy/pull/17941))
 * Use public PyGen_GetCode instead of vendored implementation (Marc Mueller, PR [17931](https://github.com/python/mypy/pull/17931))
 * Optimize calls to final classes (jairov4, PR [17886](https://github.com/python/mypy/pull/17886))
 * Support ellipsis (`...`) expressions in class bodies (Newbyte, PR [17923](https://github.com/python/mypy/pull/17923))
 * Sync `pythoncapi_compat.h` (Marc Mueller, PR [17929](https://github.com/python/mypy/pull/17929))
 * Add `runtests.py mypyc-fast` for running fast mypyc tests (Jukka Lehtosalo, PR [17906](https://github.com/python/mypy/pull/17906))

### Stubgen Improvements

 * Do not include mypy generated symbols (Ali Hamdan, PR [18137](https://github.com/python/mypy/pull/18137))
 * Fix `FunctionContext.fullname` for nested classes (Chad Dombrova, PR [17963](https://github.com/python/mypy/pull/17963))
 * Add flagfile support (Ruslan Sayfutdinov, PR [18061](https://github.com/python/mypy/pull/18061))
 * Add support for PEP 695 and PEP 696 syntax (Ali Hamdan, PR [18054](https://github.com/python/mypy/pull/18054))

### Stubtest Improvements

 * Allow the use of `--show-traceback` and `--pdb` with stubtest (Stephen Morton, PR [18037](https://github.com/python/mypy/pull/18037))
 * Verify `__all__` exists in stub (Sebastian Rittau, PR [18005](https://github.com/python/mypy/pull/18005))
 * Stop telling people to use double underscores (Jelle Zijlstra, PR [17897](https://github.com/python/mypy/pull/17897))

### Documentation Updates

 * Update config file documentation (sobolevn, PR [18103](https://github.com/python/mypy/pull/18103))
 * Improve contributor documentation for Windows (ag-tafe, PR [18097](https://github.com/python/mypy/pull/18097))
 * Correct note about `--disallow-any-generics` flag in documentation (Abel Sen, PR [18055](https://github.com/python/mypy/pull/18055))
 * Further caution against `--follow-imports=skip` (Shantanu, PR [18048](https://github.com/python/mypy/pull/18048))
 * Fix the edit page button link in documentation (Kanishk Pachauri, PR [17933](https://github.com/python/mypy/pull/17933))

### Other Notables Fixes and Improvements

 * Allow enum members to have type objects as values (Jukka Lehtosalo, PR [19160](https://github.com/python/mypy/pull/19160))
 * Show `Protocol` `__call__` for arguments with incompatible types (MechanicalConstruct, PR [18214](https://github.com/python/mypy/pull/18214))
 * Make join and meet symmetric with `strict_optional` (MechanicalConstruct, PR [18227](https://github.com/python/mypy/pull/18227))
 * Preserve block unreachablility when checking function definitions with constrained TypeVars (Brian Schubert, PR [18217](https://github.com/python/mypy/pull/18217))
 * Do not include non-init fields in the synthesized `__replace__` method for dataclasses (Victorien, PR [18221](https://github.com/python/mypy/pull/18221))
 * Disallow `TypeVar` constraints parameterized by type variables (Brian Schubert, PR [18186](https://github.com/python/mypy/pull/18186))
 * Always complain about invalid varargs and varkwargs (Shantanu, PR [18207](https://github.com/python/mypy/pull/18207))
 * Set default strict_optional state to True (Shantanu, PR [18198](https://github.com/python/mypy/pull/18198))
 * Preserve type variable default None in type alias (Sukhorosov Aleksey, PR [18197](https://github.com/python/mypy/pull/18197))
 * Add checks for invalid usage of continue/break/return in `except*` block (coldwolverine, PR [18132](https://github.com/python/mypy/pull/18132))
 * Do not consider bare TypeVar not overlapping with None for reachability analysis (Stanislav Terliakov, PR [18138](https://github.com/python/mypy/pull/18138))
 * Special case `types.DynamicClassAttribute` as property-like (Stephen Morton, PR [18150](https://github.com/python/mypy/pull/18150))
 * Disallow bare `ParamSpec` in type aliases (Brian Schubert, PR [18174](https://github.com/python/mypy/pull/18174))
 * Move long_description metadata to pyproject.toml (Marc Mueller, PR [18172](https://github.com/python/mypy/pull/18172))
 * Support `==`-based narrowing of Optional (Christoph Tyralla, PR [18163](https://github.com/python/mypy/pull/18163))
 * Allow TypedDict assignment of Required item to NotRequired ReadOnly item (Brian Schubert, PR [18164](https://github.com/python/mypy/pull/18164))
 * Allow nesting of Annotated with TypedDict special forms inside TypedDicts (Brian Schubert, PR [18165](https://github.com/python/mypy/pull/18165))
 * Infer generic type arguments for slice expressions (Brian Schubert, PR [18160](https://github.com/python/mypy/pull/18160))
 * Fix checking of match sequence pattern against bounded type variables (Brian Schubert, PR [18091](https://github.com/python/mypy/pull/18091))
 * Fix incorrect truthyness for Enum types and literals (David Salvisberg, PR [17337](https://github.com/python/mypy/pull/17337))
 * Move static project metadata to pyproject.toml (Marc Mueller, PR [18146](https://github.com/python/mypy/pull/18146))
 * Fallback to stdlib json if integer exceeds 64-bit range (q0w, PR [18148](https://github.com/python/mypy/pull/18148))
 * Fix 'or' pattern structural matching exhaustiveness (yihong, PR [18119](https://github.com/python/mypy/pull/18119))
 * Fix type inference of positional parameter in class pattern involving builtin subtype (Brian Schubert, PR [18141](https://github.com/python/mypy/pull/18141))
 * Fix `[override]` error with no line number when argument node has no line number (Brian Schubert, PR [18122](https://github.com/python/mypy/pull/18122))
 * Fix some dmypy crashes (Ivan Levkivskyi, PR [18098](https://github.com/python/mypy/pull/18098))
 * Fix subtyping between instance type and overloaded (Shantanu, PR [18102](https://github.com/python/mypy/pull/18102))
 * Clean up new_semantic_analyzer config (Shantanu, PR [18071](https://github.com/python/mypy/pull/18071))
 * Issue warning for enum with no members in stub (Shantanu, PR [18068](https://github.com/python/mypy/pull/18068))
 * Fix enum attributes are not members (Terence Honles, PR [17207](https://github.com/python/mypy/pull/17207))
 * Fix crash when checking slice expression with step 0 in tuple index (Brian Schubert, PR [18063](https://github.com/python/mypy/pull/18063))
 * Allow union-with-callable attributes to be overridden by methods (Brian Schubert, PR [18018](https://github.com/python/mypy/pull/18018))
 * Emit `[mutable-override]` for covariant override of attribute with method (Brian Schubert, PR [18058](https://github.com/python/mypy/pull/18058))
 * Support ParamSpec mapping with `functools.partial` (Stanislav Terliakov, PR [17355](https://github.com/python/mypy/pull/17355))
 * Fix approved stub ignore, remove normpath (Shantanu, PR [18045](https://github.com/python/mypy/pull/18045))
 * Make `disallow-any-unimported` flag invertible (Séamus Ó Ceanainn, PR [18030](https://github.com/python/mypy/pull/18030))
 * Filter to possible package paths before trying to resolve a module (falsedrow, PR [18038](https://github.com/python/mypy/pull/18038))
 * Fix overlap check for ParamSpec types (Jukka Lehtosalo, PR [18040](https://github.com/python/mypy/pull/18040))
 * Do not prioritize ParamSpec signatures during overload resolution (Stanislav Terliakov, PR [18033](https://github.com/python/mypy/pull/18033))
 * Fix ternary union for literals (Ivan Levkivskyi, PR [18023](https://github.com/python/mypy/pull/18023))
 * Fix compatibility checks for conditional function definitions using decorators (Brian Schubert, PR [18020](https://github.com/python/mypy/pull/18020))
 * TypeGuard should be bool not Any when matching TypeVar (Evgeniy Slobodkin, PR [17145](https://github.com/python/mypy/pull/17145))
 * Fix convert-cache tool (Shantanu, PR [17974](https://github.com/python/mypy/pull/17974))
 * Fix generator comprehension with mypyc (Shantanu, PR [17969](https://github.com/python/mypy/pull/17969))
 * Fix crash issue when using shadowfile with pretty (Max Chang, PR [17894](https://github.com/python/mypy/pull/17894))
 * Fix multiple nested classes with new generics syntax (Max Chang, PR [17820](https://github.com/python/mypy/pull/17820))
 * Better error for `mypy -p package` without py.typed (Joe Gordon, PR [17908](https://github.com/python/mypy/pull/17908))
 * Emit error for `raise NotImplemented` (Brian Schubert, PR [17890](https://github.com/python/mypy/pull/17890))
 * Add `is_lvalue` attribute to AttributeContext (Brian Schubert, PR [17881](https://github.com/python/mypy/pull/17881))

### Acknowledgements

Thanks to all mypy contributors who contributed to this release:

- aatle
- Abel Sen
- Advait Dixit
- ag-tafe
- Alex Waygood
- Ali Hamdan
- Brian Schubert
- Carlton Gibson
- Chad Dombrova
- Chelsea Durazo
- chiri
- Christoph Tyralla
- coldwolverine
- David Salvisberg
- Ekin Dursun
- Evgeniy Slobodkin
- falsedrow
- Gaurav Giri
- Ihor
- Ivan Levkivskyi
- jairov4
- Jannick Kremer
- Jared Hance
- Jelle Zijlstra
- jianghuyiyuan
- Joe Gordon
- John Doknjas
- Jukka Lehtosalo
- Kanishk Pachauri
- Marc Mueller
- Max Chang
- MechanicalConstruct
- Newbyte
- q0w
- Ruslan Sayfutdinov
- Sebastian Rittau
- Shantanu
- sobolevn
- Stanislav Terliakov
- Stephen Morton
- Sukhorosov Aleksey
- Séamus Ó Ceanainn
- Terence Honles
- Valentin Stanciu
- vasiliy
- Victorien
- yihong

I’d also like to thank my employer, Dropbox, for supporting mypy development.


## Mypy 1.13

We’ve just uploaded mypy 1.13 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)).
Mypy is a static type checker for Python. You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

Note that unlike typical releases, Mypy 1.13 does not have any changes to type checking semantics
from 1.12.1.

### Improved Performance

Mypy 1.13 contains several performance improvements. Users can expect mypy to be 5-20% faster.
In environments with long search paths (such as environments using many editable installs), mypy
can be significantly faster, e.g. 2.2x faster in the use case targeted by these improvements.

Mypy 1.13 allows use of the `orjson` library for handling the cache instead of the stdlib `json`,
for improved performance. You can ensure the presence of `orjson` using the `faster-cache` extra:

    python3 -m pip install -U mypy[faster-cache]

Mypy may depend on `orjson` by default in the future.

These improvements were contributed by Shantanu.

List of changes:
* Significantly speed up file handling error paths (Shantanu, PR [17920](https://github.com/python/mypy/pull/17920))
* Use fast path in modulefinder more often (Shantanu, PR [17950](https://github.com/python/mypy/pull/17950))
* Let mypyc optimise os.path.join (Shantanu, PR [17949](https://github.com/python/mypy/pull/17949))
* Make is_sub_path faster (Shantanu, PR [17962](https://github.com/python/mypy/pull/17962))
* Speed up stubs suggestions (Shantanu, PR [17965](https://github.com/python/mypy/pull/17965))
* Use sha1 for hashing (Shantanu, PR [17953](https://github.com/python/mypy/pull/17953))
* Use orjson instead of json, when available (Shantanu, PR [17955](https://github.com/python/mypy/pull/17955))
* Add faster-cache extra, test in CI (Shantanu, PR [17978](https://github.com/python/mypy/pull/17978))

### Acknowledgements
Thanks to all mypy contributors who contributed to this release:

- Shantanu Jain
- Jukka Lehtosalo

## Mypy 1.12

We’ve just uploaded mypy 1.12 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)). Mypy is a static type
checker for Python. This release includes new features, performance improvements and bug fixes.
You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Support Python 3.12 Syntax for Generics (PEP 695)

Support for the new type parameter syntax introduced in Python 3.12 is now enabled by default,
documented, and no longer experimental. It was available through a feature flag in
mypy 1.11 as an experimental feature.

This example demonstrates the new syntax:

```python
# Generic function
def f[T](x: T) -> T: ...

reveal_type(f(1))  # Revealed type is 'int'

# Generic class
class C[T]:
    def __init__(self, x: T) -> None:
       self.x = x

c = C('a')
reveal_type(c.x)  # Revealed type is 'str'

# Type alias
type A[T] = C[list[T]]
```

For more information, refer to the [documentation](https://mypy.readthedocs.io/en/latest/generics.html).

These improvements are included:

 * Document Python 3.12 type parameter syntax (Jukka Lehtosalo, PR [17816](https://github.com/python/mypy/pull/17816))
 * Further documentation updates (Jukka Lehtosalo, PR [17826](https://github.com/python/mypy/pull/17826))
 * Allow Self return types with contravariance (Jukka Lehtosalo, PR [17786](https://github.com/python/mypy/pull/17786))
 * Enable new type parameter syntax by default (Jukka Lehtosalo, PR [17798](https://github.com/python/mypy/pull/17798))
 * Generate error if new-style type alias used as base class (Jukka Lehtosalo, PR [17789](https://github.com/python/mypy/pull/17789))
 * Inherit variance if base class has explicit variance (Jukka Lehtosalo, PR [17787](https://github.com/python/mypy/pull/17787))
 * Fix crash on invalid type var reference (Jukka Lehtosalo, PR [17788](https://github.com/python/mypy/pull/17788))
 * Fix covariance of frozen dataclasses (Jukka Lehtosalo, PR [17783](https://github.com/python/mypy/pull/17783))
 * Allow covariance with attribute that has "`_`" name prefix (Jukka Lehtosalo, PR [17782](https://github.com/python/mypy/pull/17782))
 * Support `Annotated[...]` in new-style type aliases (Jukka Lehtosalo, PR [17777](https://github.com/python/mypy/pull/17777))
 * Fix nested generic classes (Jukka Lehtosalo, PR [17776](https://github.com/python/mypy/pull/17776))
 * Add detection and error reporting for the use of incorrect expressions within the scope of a type parameter and a type alias (Kirill Podoprigora, PR [17560](https://github.com/python/mypy/pull/17560))

### Basic Support for Python 3.13

This release adds partial support for Python 3.13 features and compiled binaries for
Python 3.13. Mypyc now also supports Python 3.13.

In particular, these features are supported:
 * Various new stdlib features and changes (through typeshed stub improvements)
 * `typing.ReadOnly` (see below for more)
 * `typing.TypeIs` (added in mypy 1.10, [PEP 742](https://peps.python.org/pep-0742/))
 * Type parameter defaults when using the legacy syntax ([PEP 696](https://peps.python.org/pep-0696/))

These features are not supported yet:
 * `warnings.deprecated` ([PEP 702](https://peps.python.org/pep-0702/))
 * Type parameter defaults when using Python 3.12 type parameter syntax

### Mypyc Support for Python 3.13

Mypyc now supports Python 3.13. This was contributed by Marc Mueller, with additional
fixes by Jukka Lehtosalo. Free threaded Python 3.13 builds are not supported yet.

List of changes:

 * Add additional includes for Python 3.13 (Marc Mueller, PR [17506](https://github.com/python/mypy/pull/17506))
 * Add another include for Python 3.13 (Marc Mueller, PR [17509](https://github.com/python/mypy/pull/17509))
 * Fix ManagedDict functions for Python 3.13 (Marc Mueller, PR [17507](https://github.com/python/mypy/pull/17507))
 * Update mypyc test output for Python 3.13 (Marc Mueller, PR [17508](https://github.com/python/mypy/pull/17508))
 * Fix `PyUnicode` functions for Python 3.13 (Marc Mueller, PR [17504](https://github.com/python/mypy/pull/17504))
 * Fix `_PyObject_LookupAttrId` for Python 3.13 (Marc Mueller, PR [17505](https://github.com/python/mypy/pull/17505))
 * Fix `_PyList_Extend` for Python 3.13 (Marc Mueller, PR [17503](https://github.com/python/mypy/pull/17503))
 * Fix `gen_is_coroutine` for Python 3.13 (Marc Mueller, PR [17501](https://github.com/python/mypy/pull/17501))
 * Fix `_PyObject_FastCall` for Python 3.13 (Marc Mueller, PR [17502](https://github.com/python/mypy/pull/17502))
 * Avoid uses of `_PyObject_CallMethodOneArg` on 3.13 (Jukka Lehtosalo, PR [17526](https://github.com/python/mypy/pull/17526))
 * Don't rely on `_PyType_CalculateMetaclass` on 3.13 (Jukka Lehtosalo, PR [17525](https://github.com/python/mypy/pull/17525))
 * Don't use `_PyUnicode_FastCopyCharacters` on 3.13 (Jukka Lehtosalo, PR [17524](https://github.com/python/mypy/pull/17524))
 * Don't use `_PyUnicode_EQ` on 3.13, as it's no longer exported (Jukka Lehtosalo, PR [17523](https://github.com/python/mypy/pull/17523))

### Inferring Unions for Conditional Expressions

Mypy now always tries to infer a union type for a conditional expression if left and right
operand types are different. This results in more precise inferred types and lets mypy detect
more issues. Example:

```python
s = "foo" if cond() else 1
# Type of "s" is now "str | int" (it used to be "object")
```

Notably, if one of the operands has type `Any`, the type of a conditional expression is
now `<type> | Any`. Previously the inferred type was just `Any`. The new type essentially
indicates that the value can be of type `<type>`, and potentially of some (unknown) type.
Most operations performed on the result must also be valid for `<type>`.
Example where this is relevant:

```python
from typing import Any

def func(a: Any, b: bool) -> None:
    x = a if b else None
    # Type of x is "Any | None"
    print(x.y)  # Error: None has no attribute "y"
```

This feature was contributed by Ivan Levkivskyi (PR [17427](https://github.com/python/mypy/pull/17427)).

### ReadOnly Support for TypedDict (PEP 705)

You can now use `typing.ReadOnly` to specity TypedDict items as
read-only ([PEP 705](https://peps.python.org/pep-0705/)):

```python
from typing import TypedDict

# Or "from typing ..." on Python 3.13
from typing_extensions import ReadOnly

class TD(TypedDict):
    a: int
    b: ReadOnly[int]

d: TD = {"a": 1, "b": 2}
d["a"] = 3  # OK
d["b"] = 5  # Error: "b" is ReadOnly
```

This feature was contributed by Nikita Sobolev (PR [17644](https://github.com/python/mypy/pull/17644)).

### Python 3.8 End of Life Approaching

We are planning to drop support for Python 3.8 in the next mypy feature release or the
one after that. Python 3.8 reaches end of life in October 2024.

### Planned Changes to Defaults

We are planning to enable `--local-partial-types` by default in mypy 2.0. This will
often require at least minor code changes. This option is implicitly enabled by mypy
daemon, so this makes the behavior of daemon and non-daemon modes consistent.

We recommend that mypy users start using local partial types soon (or to explicitly disable
them) to prepare for the change.

This can also be configured in a mypy configuration file:

```
local_partial_types = True
```

For more information, refer to the
[documentation](https://mypy.readthedocs.io/en/stable/command_line.html#cmdoption-mypy-local-partial-types).

### Documentation Updates

Mypy documentation now uses modern syntax variants and imports in many examples. Some
examples no longer work on Python 3.8, which is the earliest Python version that mypy supports.

Notably, `Iterable` and other protocols/ABCs are imported from `collections.abc` instead of
`typing`:
```python
from collections.abc import Iterable, Callable
```

Examples also avoid the upper-case aliases to built-in types: `list[str]` is used instead
of `List[str]`. The `X | Y` union type syntax introduced in Python 3.10 is also now prevalent.

List of documentation updates:

 * Document `--output=json` CLI option (Edgar Ramírez Mondragón, PR [17611](https://github.com/python/mypy/pull/17611))
 * Update various references to deprecated type aliases in docs (Jukka Lehtosalo, PR [17829](https://github.com/python/mypy/pull/17829))
 * Make "X | Y" union syntax more prominent in documentation (Jukka Lehtosalo, PR [17835](https://github.com/python/mypy/pull/17835))
 * Discuss upper bounds before self types in documentation (Jukka Lehtosalo, PR [17827](https://github.com/python/mypy/pull/17827))
 * Make changelog visible in mypy documentation (quinn-sasha, PR [17742](https://github.com/python/mypy/pull/17742))
 * List all incomplete features in `--enable-incomplete-feature` docs (sobolevn, PR [17633](https://github.com/python/mypy/pull/17633))
 * Remove the explicit setting of a pygments theme (Pradyun Gedam, PR [17571](https://github.com/python/mypy/pull/17571))
 * Document ReadOnly with TypedDict (Jukka Lehtosalo, PR [17905](https://github.com/python/mypy/pull/17905))
 * Document TypeIs (Chelsea Durazo, PR [17821](https://github.com/python/mypy/pull/17821))

### Experimental Inline TypedDict Syntax

Mypy now supports a non-standard, experimental syntax for defining anonymous TypedDicts.
Example:

```python
def func(n: str, y: int) -> {"name": str, "year": int}:
    return {"name": n, "year": y}
```

The feature is disabled by default. Use `--enable-incomplete-feature=InlineTypedDict` to
enable it. *We might remove this feature in a future release.*

This feature was contributed by Ivan Levkivskyi (PR [17457](https://github.com/python/mypy/pull/17457)).

### Stubgen Improvements

 * Fix crash on literal class-level keywords (sobolevn, PR [17663](https://github.com/python/mypy/pull/17663))
 * Stubgen add `--version` (sobolevn, PR [17662](https://github.com/python/mypy/pull/17662))
 * Fix `stubgen --no-analysis/--parse-only` docs (sobolevn, PR [17632](https://github.com/python/mypy/pull/17632))
 * Include keyword only args when generating signatures in stubgenc (Eric Mark Martin, PR [17448](https://github.com/python/mypy/pull/17448))
 * Add support for detecting `Literal` types when extracting types from docstrings (Michael Carlstrom, PR [17441](https://github.com/python/mypy/pull/17441))
 * Use `Generator` type var defaults (Sebastian Rittau, PR [17670](https://github.com/python/mypy/pull/17670))

### Stubtest Improvements
 * Add support for `cached_property` (Ali Hamdan, PR [17626](https://github.com/python/mypy/pull/17626))
 * Add `enable_incomplete_feature` validation to `stubtest` (sobolevn, PR [17635](https://github.com/python/mypy/pull/17635))
 * Fix error code handling in `stubtest` with `--mypy-config-file` (sobolevn, PR [17629](https://github.com/python/mypy/pull/17629))

### Other Notables Fixes and Improvements

 * Report error if using unsupported type parameter defaults (Jukka Lehtosalo, PR [17876](https://github.com/python/mypy/pull/17876))
 * Fix re-processing cross-reference in mypy daemon when node kind changes (Ivan Levkivskyi, PR [17883](https://github.com/python/mypy/pull/17883))
 * Don't use equality to narrow when value is IntEnum/StrEnum (Jukka Lehtosalo, PR [17866](https://github.com/python/mypy/pull/17866))
 * Don't consider None vs IntEnum comparison ambiguous (Jukka Lehtosalo, PR [17877](https://github.com/python/mypy/pull/17877))
 * Fix narrowing of IntEnum and StrEnum types (Jukka Lehtosalo, PR [17874](https://github.com/python/mypy/pull/17874))
 * Filter overload items based on self type during type inference (Jukka Lehtosalo, PR [17873](https://github.com/python/mypy/pull/17873))
 * Enable negative narrowing of union TypeVar upper bounds (Brian Schubert, PR [17850](https://github.com/python/mypy/pull/17850))
 * Fix issue with member expression formatting (Brian Schubert, PR [17848](https://github.com/python/mypy/pull/17848))
 * Avoid type size explosion when expanding types (Jukka Lehtosalo, PR [17842](https://github.com/python/mypy/pull/17842))
 * Fix negative narrowing of tuples in match statement (Brian Schubert, PR [17817](https://github.com/python/mypy/pull/17817))
 * Narrow falsey str/bytes/int to literal type (Brian Schubert, PR [17818](https://github.com/python/mypy/pull/17818))
 * Test against latest Python 3.13, make testing 3.14 easy (Shantanu, PR [17812](https://github.com/python/mypy/pull/17812))
 * Reject ParamSpec-typed callables calls with insufficient arguments (Stanislav Terliakov, PR [17323](https://github.com/python/mypy/pull/17323))
 * Fix crash when passing too many type arguments to generic base class accepting single ParamSpec (Brian Schubert, PR [17770](https://github.com/python/mypy/pull/17770))
 * Fix TypeVar upper bounds sometimes not being displayed in pretty callables (Brian Schubert, PR [17802](https://github.com/python/mypy/pull/17802))
 * Added error code for overlapping function signatures (Katrina Connors, PR [17597](https://github.com/python/mypy/pull/17597))
 * Check for `truthy-bool` in `not ...` unary expressions (sobolevn, PR [17773](https://github.com/python/mypy/pull/17773))
 * Add missing lines-covered and lines-valid attributes (Soubhik Kumar Mitra, PR [17738](https://github.com/python/mypy/pull/17738))
 * Fix another crash scenario with recursive tuple types (Ivan Levkivskyi, PR [17708](https://github.com/python/mypy/pull/17708))
 * Resolve TypeVar upper bounds in `functools.partial` (Shantanu, PR [17660](https://github.com/python/mypy/pull/17660))
 * Always reset binder when checking deferred nodes (Ivan Levkivskyi, PR [17643](https://github.com/python/mypy/pull/17643))
 * Fix crash on a callable attribute with single unpack (Ivan Levkivskyi, PR [17641](https://github.com/python/mypy/pull/17641))
 * Fix mismatched signature between checker plugin API and implementation (bzoracler, PR [17343](https://github.com/python/mypy/pull/17343))
 * Indexing a type also produces a GenericAlias (Shantanu, PR [17546](https://github.com/python/mypy/pull/17546))
 * Fix crash on self-type in callable protocol (Ivan Levkivskyi, PR [17499](https://github.com/python/mypy/pull/17499))
 * Fix crash on NamedTuple with method and error in function (Ivan Levkivskyi, PR [17498](https://github.com/python/mypy/pull/17498))
 * Add `__replace__` for dataclasses in 3.13 (Max Muoto, PR [17469](https://github.com/python/mypy/pull/17469))
 * Fix help message for `--no-namespace-packages` (Raphael Krupinski, PR [17472](https://github.com/python/mypy/pull/17472))
 * Fix typechecking for async generators (Danny Yang, PR [17452](https://github.com/python/mypy/pull/17452))
 * Fix strict optional handling in attrs plugin (Ivan Levkivskyi, PR [17451](https://github.com/python/mypy/pull/17451))
 * Allow mixing ParamSpec and TypeVarTuple in Generic (Ivan Levkivskyi, PR [17450](https://github.com/python/mypy/pull/17450))
 * Improvements to `functools.partial` of types (Shantanu, PR [17898](https://github.com/python/mypy/pull/17898))
 * Make ReadOnly TypedDict items covariant (Jukka Lehtosalo, PR [17904](https://github.com/python/mypy/pull/17904))
 * Fix union callees with `functools.partial` (Jukka Lehtosalo, PR [17903](https://github.com/python/mypy/pull/17903))
 * Improve handling of generic functions with `functools.partial` (Ivan Levkivskyi, PR [17925](https://github.com/python/mypy/pull/17925))

### Typeshed Updates

Please see [git log](https://github.com/python/typeshed/commits/main?after=91a58b07cdd807b1d965e04ba85af2adab8bf924+0&branch=main&path=stdlib) for full list of standard library typeshed stub changes.

### Mypy 1.12.1
 * Fix crash when showing partially analyzed type in error message (Ivan Levkivskyi, PR [17961](https://github.com/python/mypy/pull/17961))
 * Fix iteration over union (when self type is involved) (Shantanu, PR [17976](https://github.com/python/mypy/pull/17976))
 * Fix type object with type var default in union context (Jukka Lehtosalo, PR [17991](https://github.com/python/mypy/pull/17991))
 * Revert change to `os.path` stubs affecting use of `os.PathLike[Any]` (Shantanu, PR [17995](https://github.com/python/mypy/pull/17995))

### Acknowledgements
Thanks to all mypy contributors who contributed to this release:

- Ali Hamdan
- Anders Kaseorg
- Bénédikt Tran
- Brian Schubert
- bzoracler
- Chelsea Durazo
- Danny Yang
- Edgar Ramírez Mondragón
- Eric Mark Martin
- InSync
- Ivan Levkivskyi
- Jordandev678
- Katrina Connors
- Kirill Podoprigora
- Marc Mueller
- Max Muoto
- Max Murin
- Michael Carlstrom
- Michael I Chen
- Pradyun Gedam
- quinn-sasha
- Raphael Krupinski
- Sebastian Rittau
- Shantanu
- sobolevn
- Soubhik Kumar Mitra
- Stanislav Terliakov
- wyattscarpenter

I’d also like to thank my employer, Dropbox, for supporting mypy development.


## Mypy 1.11

We’ve just uploaded mypy 1.11 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)). Mypy is a static type checker for Python. This release includes new features, performance improvements and bug fixes. You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Support Python 3.12 Syntax for Generics (PEP 695)

Mypy now supports the new type parameter syntax introduced in Python 3.12 ([PEP 695](https://peps.python.org/pep-0695/)).
This feature is still experimental and must be enabled with the `--enable-incomplete-feature=NewGenericSyntax` flag, or with `enable_incomplete_feature = NewGenericSyntax` in the mypy configuration file.
We plan to enable this by default in the next mypy feature release.

This example demonstrates the new syntax:

```python
# Generic function
def f[T](x: T) -> T: ...

reveal_type(f(1))  # Revealed type is 'int'

# Generic class
class C[T]:
    def __init__(self, x: T) -> None:
       self.x = x

c = C('a')
reveal_type(c.x)  # Revealed type is 'str'

# Type alias
type A[T] = C[list[T]]
```

This feature was contributed by Jukka Lehtosalo.


### Support for `functools.partial`

Mypy now type checks uses of `functools.partial`. Previously mypy would accept arbitrary arguments.

This example will now produce an error:

```python
from functools import partial

def f(a: int, b: str) -> None: ...

g = partial(f, 1)

# Argument has incompatible type "int"; expected "str"
g(11)
```

This feature was contributed by Shantanu (PR [16939](https://github.com/python/mypy/pull/16939)).


### Stricter Checks for Untyped Overrides

Past mypy versions didn't check if untyped methods were compatible with overridden methods. This would result in false negatives. Now mypy performs these checks when using `--check-untyped-defs`.

For example, this now generates an error if using `--check-untyped-defs`:

```python
class Base:
    def f(self, x: int = 0) -> None: ...

class Derived(Base):
    # Signature incompatible with "Base"
    def f(self): ...
```

This feature was contributed by Steven Troxler (PR [17276](https://github.com/python/mypy/pull/17276)).


### Type Inference Improvements

The new polymorphic inference algorithm introduced in mypy 1.5 is now used in more situations. This improves type inference involving generic higher-order functions, in particular.

This feature was contributed by Ivan Levkivskyi (PR [17348](https://github.com/python/mypy/pull/17348)).

Mypy now uses unions of tuple item types in certain contexts to enable more precise inferred types. Example:

```python
for x in (1, 'x'):
    # Previously inferred as 'object'
    reveal_type(x)  # Revealed type is 'int | str'
```

This was also contributed by Ivan Levkivskyi (PR [17408](https://github.com/python/mypy/pull/17408)).


### Improvements to Detection of Overlapping Overloads

The details of how mypy checks if two `@overload` signatures are unsafely overlapping were overhauled. This both fixes some false positives, and allows mypy to detect additional unsafe signatures.

This feature was contributed by Ivan Levkivskyi (PR [17392](https://github.com/python/mypy/pull/17392)).


### Better Support for Type Hints in Expressions

Mypy now allows more expressions that evaluate to valid type annotations in all expression contexts. The inferred types of these expressions are also sometimes more precise. Previously they were often `object`.

This example uses a union type that includes a callable type as an expression, and it no longer generates an error:

```python
from typing import Callable

print(Callable[[], int] | None)  # No error
```

This feature was contributed by Jukka Lehtosalo (PR [17404](https://github.com/python/mypy/pull/17404)).


### Mypyc Improvements

Mypyc now supports the new syntax for generics introduced in Python 3.12 (see above). Another notable improvement is significantly faster basic operations on `int` values.

 * Support Python 3.12 syntax for generic functions and classes (Jukka Lehtosalo, PR [17357](https://github.com/python/mypy/pull/17357))
 * Support Python 3.12 type alias syntax (Jukka Lehtosalo, PR [17384](https://github.com/python/mypy/pull/17384))
 * Fix ParamSpec (Shantanu, PR [17309](https://github.com/python/mypy/pull/17309))
 * Inline fast paths of integer unboxing operations (Jukka Lehtosalo, PR [17266](https://github.com/python/mypy/pull/17266))
 * Inline tagged integer arithmetic and bitwise operations (Jukka Lehtosalo, PR [17265](https://github.com/python/mypy/pull/17265))
 * Allow specifying primitives as pure (Jukka Lehtosalo, PR [17263](https://github.com/python/mypy/pull/17263))


### Changes to Stubtest
 * Ignore `_ios_support` (Alex Waygood, PR [17270](https://github.com/python/mypy/pull/17270))
 * Improve support for Python 3.13 (Shantanu, PR [17261](https://github.com/python/mypy/pull/17261))


### Changes to Stubgen
 * Gracefully handle invalid `Optional` and recognize aliases to PEP 604 unions (Ali Hamdan, PR [17386](https://github.com/python/mypy/pull/17386))
 * Fix for Python 3.13 (Jelle Zijlstra, PR [17290](https://github.com/python/mypy/pull/17290))
 * Preserve enum value initialisers (Shantanu, PR [17125](https://github.com/python/mypy/pull/17125))


### Miscellaneous New Features
 * Add error format support and JSON output option via `--output json` (Tushar Sadhwani, PR [11396](https://github.com/python/mypy/pull/11396))
 * Support `enum.member` in Python 3.11+ (Nikita Sobolev, PR [17382](https://github.com/python/mypy/pull/17382))
 * Support `enum.nonmember` in Python 3.11+ (Nikita Sobolev, PR [17376](https://github.com/python/mypy/pull/17376))
 * Support `namedtuple.__replace__` in Python 3.13 (Shantanu, PR [17259](https://github.com/python/mypy/pull/17259))
 * Support `rename=True` in collections.namedtuple (Jelle Zijlstra, PR [17247](https://github.com/python/mypy/pull/17247))
 * Add support for `__spec__` (Shantanu, PR [14739](https://github.com/python/mypy/pull/14739))


### Changes to Error Reporting
 * Mention `--enable-incomplete-feature=NewGenericSyntax` in messages (Shantanu, PR [17462](https://github.com/python/mypy/pull/17462))
 * Do not report plugin-generated methods with `explicit-override` (sobolevn, PR [17433](https://github.com/python/mypy/pull/17433))
 * Use and display namespaces for function type variables (Ivan Levkivskyi, PR [17311](https://github.com/python/mypy/pull/17311))
 * Fix false positive for Final local scope variable in Protocol (GiorgosPapoutsakis, PR [17308](https://github.com/python/mypy/pull/17308))
 * Use Never in more messages, use ambiguous in join (Shantanu, PR [17304](https://github.com/python/mypy/pull/17304))
 * Log full path to config file in verbose output (dexterkennedy, PR [17180](https://github.com/python/mypy/pull/17180))
 * Added `[prop-decorator]` code for unsupported property decorators (#14461) (Christopher Barber, PR [16571](https://github.com/python/mypy/pull/16571))
 * Suppress second error message with `:=` and `[truthy-bool]` (Nikita Sobolev, PR [15941](https://github.com/python/mypy/pull/15941))
 * Generate error for assignment of functional Enum to variable of different name (Shantanu, PR [16805](https://github.com/python/mypy/pull/16805))
 * Fix error reporting on cached run after uninstallation of third party library (Shantanu, PR [17420](https://github.com/python/mypy/pull/17420))


### Fixes for Crashes
 * Fix daemon crash on invalid type in TypedDict (Ivan Levkivskyi, PR [17495](https://github.com/python/mypy/pull/17495))
 * Fix crash and bugs related to `partial()` (Ivan Levkivskyi, PR [17423](https://github.com/python/mypy/pull/17423))
 * Fix crash when overriding with unpacked TypedDict (Ivan Levkivskyi, PR [17359](https://github.com/python/mypy/pull/17359))
 * Fix crash on TypedDict unpacking for ParamSpec (Ivan Levkivskyi, PR [17358](https://github.com/python/mypy/pull/17358))
 * Fix crash involving recursive union of tuples (Ivan Levkivskyi, PR [17353](https://github.com/python/mypy/pull/17353))
 * Fix crash on invalid callable property override (Ivan Levkivskyi, PR [17352](https://github.com/python/mypy/pull/17352))
 * Fix crash on unpacking self in NamedTuple (Ivan Levkivskyi, PR [17351](https://github.com/python/mypy/pull/17351))
 * Fix crash on recursive alias with an optional type (Ivan Levkivskyi, PR [17350](https://github.com/python/mypy/pull/17350))
 * Fix crash on type comment inside generic definitions (Bénédikt Tran, PR [16849](https://github.com/python/mypy/pull/16849))


### Changes to Documentation
 * Use inline config in documentation for optional error codes (Shantanu, PR [17374](https://github.com/python/mypy/pull/17374))
 * Use lower-case generics in documentation (Seo Sanghyeon, PR [17176](https://github.com/python/mypy/pull/17176))
 * Add documentation for show-error-code-links (GiorgosPapoutsakis, PR [17144](https://github.com/python/mypy/pull/17144))
 * Update CONTRIBUTING.md to include commands for Windows (GiorgosPapoutsakis, PR [17142](https://github.com/python/mypy/pull/17142))


### Other Notable Improvements and Fixes
 * Fix ParamSpec inference against TypeVarTuple (Ivan Levkivskyi, PR [17431](https://github.com/python/mypy/pull/17431))
 * Fix explicit type for `partial` (Ivan Levkivskyi, PR [17424](https://github.com/python/mypy/pull/17424))
 * Always allow lambda calls (Ivan Levkivskyi, PR [17430](https://github.com/python/mypy/pull/17430))
 * Fix isinstance checks with PEP 604 unions containing None (Shantanu, PR [17415](https://github.com/python/mypy/pull/17415))
 * Fix self-referential upper bound in new-style type variables (Ivan Levkivskyi, PR [17407](https://github.com/python/mypy/pull/17407))
 * Consider overlap between instances and callables (Ivan Levkivskyi, PR [17389](https://github.com/python/mypy/pull/17389))
 * Allow new-style self-types in classmethods (Ivan Levkivskyi, PR [17381](https://github.com/python/mypy/pull/17381))
 * Fix isinstance with type aliases to PEP 604 unions (Shantanu, PR [17371](https://github.com/python/mypy/pull/17371))
 * Properly handle unpacks in overlap checks (Ivan Levkivskyi, PR [17356](https://github.com/python/mypy/pull/17356))
 * Fix type application for classes with generic constructors (Ivan Levkivskyi, PR [17354](https://github.com/python/mypy/pull/17354))
 * Update `typing_extensions` to >=4.6.0 to fix Python 3.12 error (Ben Brown, PR [17312](https://github.com/python/mypy/pull/17312))
 * Avoid "does not return" error in lambda (Shantanu, PR [17294](https://github.com/python/mypy/pull/17294))
 * Fix bug with descriptors in non-strict-optional mode (Max Murin, PR [17293](https://github.com/python/mypy/pull/17293))
 * Don’t leak unreachability from lambda body to surrounding scope (Anders Kaseorg, PR [17287](https://github.com/python/mypy/pull/17287))
 * Fix issues with non-ASCII characters on Windows (Alexander Leopold Shon, PR [17275](https://github.com/python/mypy/pull/17275))
 * Fix for type narrowing of negative integer literals (gilesgc, PR [17256](https://github.com/python/mypy/pull/17256))
 * Fix confusion between .py and .pyi files in mypy daemon (Valentin Stanciu, PR [17245](https://github.com/python/mypy/pull/17245))
 * Fix type of `tuple[X, Y]` expression (urnest, PR [17235](https://github.com/python/mypy/pull/17235))
 * Don't forget that a `TypedDict` was wrapped in `Unpack` after a `name-defined` error occurred (Christoph Tyralla, PR [17226](https://github.com/python/mypy/pull/17226))
 * Mark annotated argument as having an explicit, not inferred type (bzoracler, PR [17217](https://github.com/python/mypy/pull/17217))
 * Don't consider Enum private attributes as enum members (Ali Hamdan, PR [17182](https://github.com/python/mypy/pull/17182))
 * Fix Literal strings containing pipe characters (Jelle Zijlstra, PR [17148](https://github.com/python/mypy/pull/17148))


### Typeshed Updates

Please see [git log](https://github.com/python/typeshed/commits/main?after=6dda799d8ad1d89e0f8aad7ac41d2d34bd838ace+0&branch=main&path=stdlib) for full list of standard library typeshed stub changes.

### Mypy 1.11.1
 * Fix `RawExpressionType.accept` crash with `--cache-fine-grained` (Anders Kaseorg, PR [17588](https://github.com/python/mypy/pull/17588))
 * Fix PEP 604 isinstance caching (Shantanu, PR [17563](https://github.com/python/mypy/pull/17563))
 * Fix `typing.TypeAliasType` being undefined on python < 3.12 (Nikita Sobolev, PR [17558](https://github.com/python/mypy/pull/17558))
 * Fix `types.GenericAlias` lookup crash (Shantanu, PR [17543](https://github.com/python/mypy/pull/17543))

### Mypy 1.11.2
 * Alternative fix for a union-like literal string (Ivan Levkivskyi, PR [17639](https://github.com/python/mypy/pull/17639))
 * Unwrap `TypedDict` item types before storing (Ivan Levkivskyi, PR [17640](https://github.com/python/mypy/pull/17640))

### Acknowledgements
Thanks to all mypy contributors who contributed to this release:

- Alex Waygood
- Alexander Leopold Shon
- Ali Hamdan
- Anders Kaseorg
- Ben Brown
- Bénédikt Tran
- bzoracler
- Christoph Tyralla
- Christopher Barber
- dexterkennedy
- gilesgc
- GiorgosPapoutsakis
- Ivan Levkivskyi
- Jelle Zijlstra
- Jukka Lehtosalo
- Marc Mueller
- Matthieu Devlin
- Michael R. Crusoe
- Nikita Sobolev
- Seo Sanghyeon
- Shantanu
- sobolevn
- Steven Troxler
- Tadeu Manoel
- Tamir Duberstein
- Tushar Sadhwani
- urnest
- Valentin Stanciu

I’d also like to thank my employer, Dropbox, for supporting mypy development.


## Mypy 1.10

We’ve just uploaded mypy 1.10 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)). Mypy is a static type checker for Python. This release includes new features, performance improvements and bug fixes. You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Support TypeIs (PEP 742)

Mypy now supports `TypeIs` ([PEP 742](https://peps.python.org/pep-0742/)), which allows
functions to narrow the type of a value, similar to `isinstance()`. Unlike `TypeGuard`,
`TypeIs` can narrow in both the `if` and `else` branches of an if statement:

```python
from typing_extensions import TypeIs

def is_str(s: object) -> TypeIs[str]:
    return isinstance(s, str)

def f(o: str | int) -> None:
    if is_str(o):
        # Type of o is 'str'
        ...
    else:
        # Type of o is 'int'
        ...
```

`TypeIs` will be added to the `typing` module in Python 3.13, but it
can be used on earlier Python versions by importing it from
`typing_extensions`.

This feature was contributed by Jelle Zijlstra (PR [16898](https://github.com/python/mypy/pull/16898)).

### Support TypeVar Defaults (PEP 696)

[PEP 696](https://peps.python.org/pep-0696/) adds support for type parameter defaults.
Example:

```python
from typing import Generic
from typing_extensions import TypeVar

T = TypeVar("T", default=int)

class C(Generic[T]):
   ...

x: C = ...
y: C[str] = ...
reveal_type(x)  # C[int], because of the default
reveal_type(y)  # C[str]
```

TypeVar defaults will be added to the `typing` module in Python 3.13, but they
can be used with earlier Python releases by importing `TypeVar` from
`typing_extensions`.

This feature was contributed by Marc Mueller (PR [16878](https://github.com/python/mypy/pull/16878)
and PR [16925](https://github.com/python/mypy/pull/16925)).

### Support TypeAliasType (PEP 695)
As part of the initial steps towards implementing [PEP 695](https://peps.python.org/pep-0695/), mypy now supports `TypeAliasType`.
`TypeAliasType` provides a backport of the new `type` statement in Python 3.12.

```python
type ListOrSet[T] = list[T] | set[T]
```

is equivalent to:

```python
T = TypeVar("T")
ListOrSet = TypeAliasType("ListOrSet", list[T] | set[T], type_params=(T,))
```

Example of use in mypy:

```python
from typing_extensions import TypeAliasType, TypeVar

NewUnionType = TypeAliasType("NewUnionType", int | str)
x: NewUnionType = 42
y: NewUnionType = 'a'
z: NewUnionType = object()  # error: Incompatible types in assignment (expression has type "object", variable has type "int | str")  [assignment]

T = TypeVar("T")
ListOrSet = TypeAliasType("ListOrSet", list[T] | set[T], type_params=(T,))
a: ListOrSet[int] = [1, 2]
b: ListOrSet[str] = {'a', 'b'}
c: ListOrSet[str] = 'test'  # error: Incompatible types in assignment (expression has type "str", variable has type "list[str] | set[str]")  [assignment]
```

`TypeAliasType` was added to the `typing` module in Python 3.12, but it can be used with earlier Python releases by importing from `typing_extensions`.

This feature was contributed by Ali Hamdan (PR [16926](https://github.com/python/mypy/pull/16926), PR [17038](https://github.com/python/mypy/pull/17038) and PR [17053](https://github.com/python/mypy/pull/17053))

### Detect Additional Unsafe Uses of super()

Mypy will reject unsafe uses of `super()` more consistently, when the target has a
trivial (empty) body. Example:

```python
class Proto(Protocol):
    def method(self) -> int: ...

class Sub(Proto):
    def method(self) -> int:
        return super().meth()  # Error (unsafe)
```

This feature was contributed by Shantanu (PR [16756](https://github.com/python/mypy/pull/16756)).

### Stubgen Improvements
- Preserve empty tuple annotation (Ali Hamdan, PR [16907](https://github.com/python/mypy/pull/16907))
- Add support for PEP 570 positional-only parameters (Ali Hamdan, PR [16904](https://github.com/python/mypy/pull/16904))
- Replace obsolete typing aliases with builtin containers (Ali Hamdan, PR [16780](https://github.com/python/mypy/pull/16780))
- Fix generated dataclass `__init__` signature (Ali Hamdan, PR [16906](https://github.com/python/mypy/pull/16906))

### Mypyc Improvements

- Provide an easier way to define IR-to-IR transforms (Jukka Lehtosalo, PR [16998](https://github.com/python/mypy/pull/16998))
- Implement lowering pass and add primitives for int (in)equality (Jukka Lehtosalo, PR [17027](https://github.com/python/mypy/pull/17027))
- Implement lowering for remaining tagged integer comparisons (Jukka Lehtosalo, PR [17040](https://github.com/python/mypy/pull/17040))
- Optimize away some bool/bit registers (Jukka Lehtosalo, PR [17022](https://github.com/python/mypy/pull/17022))
- Remangle redefined names produced by async with (Richard Si, PR [16408](https://github.com/python/mypy/pull/16408))
- Optimize TYPE_CHECKING to False at Runtime (Srinivas Lade, PR [16263](https://github.com/python/mypy/pull/16263))
- Fix compilation of unreachable comprehensions (Richard Si, PR [15721](https://github.com/python/mypy/pull/15721))
- Don't crash on non-inlinable final local reads (Richard Si, PR [15719](https://github.com/python/mypy/pull/15719))

### Documentation Improvements
- Import `TypedDict` from `typing` instead of `typing_extensions` (Riccardo Di Maio, PR [16958](https://github.com/python/mypy/pull/16958))
- Add missing `mutable-override` to section title (James Braza, PR [16886](https://github.com/python/mypy/pull/16886))

### Error Reporting Improvements

- Use lower-case generics more consistently in error messages (Jukka Lehtosalo, PR [17035](https://github.com/python/mypy/pull/17035))

### Other Notable Changes and Fixes
- Fix incorrect inferred type when accessing descriptor on union type (Matthieu Devlin, PR [16604](https://github.com/python/mypy/pull/16604))
- Fix crash when expanding invalid `Unpack` in a `Callable` alias (Ali Hamdan, PR [17028](https://github.com/python/mypy/pull/17028))
- Fix false positive when string formatting with string enum (roberfi, PR [16555](https://github.com/python/mypy/pull/16555))
- Narrow individual items when matching a tuple to a sequence pattern (Loïc Simon, PR [16905](https://github.com/python/mypy/pull/16905))
- Fix false positive from type variable within TypeGuard or TypeIs (Evgeniy Slobodkin, PR [17071](https://github.com/python/mypy/pull/17071))
- Improve `yield from` inference for unions of generators (Shantanu, PR [16717](https://github.com/python/mypy/pull/16717))
- Fix emulating hash method logic in `attrs` classes (Hashem, PR [17016](https://github.com/python/mypy/pull/17016))
- Add reverted typeshed commit that uses `ParamSpec` for `functools.wraps` (Tamir Duberstein, PR [16942](https://github.com/python/mypy/pull/16942))
- Fix type narrowing for `types.EllipsisType` (Shantanu, PR [17003](https://github.com/python/mypy/pull/17003))
- Fix single item enum match type exhaustion (Oskari Lehto, PR [16966](https://github.com/python/mypy/pull/16966))
- Improve type inference with empty collections (Marc Mueller, PR [16994](https://github.com/python/mypy/pull/16994))
- Fix override checking for decorated property (Shantanu, PR [16856](https://github.com/python/mypy/pull/16856))
- Fix narrowing on match with function subject (Edward Paget, PR [16503](https://github.com/python/mypy/pull/16503))
- Allow `+N` within `Literal[...]` (Spencer Brown, PR [16910](https://github.com/python/mypy/pull/16910))
- Experimental: Support TypedDict within `type[...]` (Marc Mueller, PR [16963](https://github.com/python/mypy/pull/16963))
- Experimtental: Fix issue with TypedDict with optional keys in `type[...]` (Marc Mueller, PR [17068](https://github.com/python/mypy/pull/17068))

### Typeshed Updates

Please see [git log](https://github.com/python/typeshed/commits/main?after=6dda799d8ad1d89e0f8aad7ac41d2d34bd838ace+0&branch=main&path=stdlib) for full list of standard library typeshed stub changes.

### Mypy 1.10.1

- Fix error reporting on cached run after uninstallation of third party library (Shantanu, PR [17420](https://github.com/python/mypy/pull/17420))

### Acknowledgements
Thanks to all mypy contributors who contributed to this release:

- Alex Waygood
- Ali Hamdan
- Edward Paget
- Evgeniy Slobodkin
- Hashem
- hesam
- Hugo van Kemenade
- Ihor
- James Braza
- Jelle Zijlstra
- jhance
- Jukka Lehtosalo
- Loïc Simon
- Marc Mueller
- Matthieu Devlin
- Michael R. Crusoe
- Nikita Sobolev
- Oskari Lehto
- Riccardo Di Maio
- Richard Si
- roberfi
- Roman Solomatin
- Sam Xifaras
- Shantanu
- Spencer Brown
- Srinivas Lade
- Tamir Duberstein
- youkaichao

I’d also like to thank my employer, Dropbox, for supporting mypy development.


## Mypy 1.9

We’ve just uploaded mypy 1.9 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)). Mypy is a static type checker for Python. This release includes new features, performance improvements and bug fixes. You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Breaking Changes

Because the version of typeshed we use in mypy 1.9 doesn't support 3.7, neither does mypy 1.9. (Jared Hance, PR [16883](https://github.com/python/mypy/pull/16883))

We are planning to enable
[local partial types](https://mypy.readthedocs.io/en/stable/command_line.html#cmdoption-mypy-local-partial-types) (enabled via the
`--local-partial-types` flag) later this year by default. This change
was announced years ago, but now it's finally happening. This is a
major backward-incompatible change, so we'll probably include it as
part of the upcoming mypy 2.0 release. This makes daemon and
non-daemon mypy runs have the same behavior by default.

Local partial types can also be enabled in the mypy config file:
```
local_partial_types = True
```

We are looking at providing a tool to make it easier to migrate
projects to use `--local-partial-types`, but it's not yet clear whether
this is practical. The migration usually involves adding some
explicit type annotations to module-level and class-level variables.

### Basic Support for Type Parameter Defaults (PEP 696)

This release contains new experimental support for type parameter
defaults ([PEP 696](https://peps.python.org/pep-0696)). Please try it
out! This feature was contributed by Marc Mueller.

Since this feature will be officially introduced in the next Python
feature release (3.13), you will need to import `TypeVar`, `ParamSpec`
or `TypeVarTuple` from `typing_extensions` to use defaults for now.

This example adapted from the PEP defines a default for `BotT`:
```python
from typing import Generic
from typing_extensions import TypeVar

class Bot: ...

BotT = TypeVar("BotT", bound=Bot, default=Bot)

class Context(Generic[BotT]):
    bot: BotT

class MyBot(Bot): ...

# type is Bot (the default)
reveal_type(Context().bot)
# type is MyBot
reveal_type(Context[MyBot]().bot)
```

### Type-checking Improvements
 * Fix missing type store for overloads (Marc Mueller, PR [16803](https://github.com/python/mypy/pull/16803))
 * Fix `'WriteToConn' object has no attribute 'flush'` (Charlie Denton, PR [16801](https://github.com/python/mypy/pull/16801))
 * Improve TypeAlias error messages (Marc Mueller, PR [16831](https://github.com/python/mypy/pull/16831))
 * Support narrowing unions that include `type[None]` (Christoph Tyralla, PR [16315](https://github.com/python/mypy/pull/16315))
 * Support TypedDict functional syntax as class base type (anniel-stripe, PR [16703](https://github.com/python/mypy/pull/16703))
 * Accept multiline quoted annotations (Shantanu, PR [16765](https://github.com/python/mypy/pull/16765))
 * Allow unary + in `Literal` (Jelle Zijlstra, PR [16729](https://github.com/python/mypy/pull/16729))
 * Substitute type variables in return type of static methods (Kouroche Bouchiat, PR [16670](https://github.com/python/mypy/pull/16670))
 * Consider TypeVarTuple to be invariant (Marc Mueller, PR [16759](https://github.com/python/mypy/pull/16759))
 * Add `alias` support to `field()` in `attrs` plugin (Nikita Sobolev, PR [16610](https://github.com/python/mypy/pull/16610))
 * Improve attrs hashability detection (Tin Tvrtković, PR [16556](https://github.com/python/mypy/pull/16556))

### Performance Improvements

 * Speed up finding function type variables (Jukka Lehtosalo, PR [16562](https://github.com/python/mypy/pull/16562))

### Documentation Updates

 * Document supported values for `--enable-incomplete-feature` in "mypy --help" (Froger David, PR [16661](https://github.com/python/mypy/pull/16661))
 * Update new type system discussion links (thomaswhaley, PR [16841](https://github.com/python/mypy/pull/16841))
 * Add missing class instantiation to cheat sheet (Aleksi Tarvainen, PR [16817](https://github.com/python/mypy/pull/16817))
 * Document how evil `--no-strict-optional` is (Shantanu, PR [16731](https://github.com/python/mypy/pull/16731))
 * Improve mypy daemon documentation note about local partial types (Makonnen Makonnen, PR [16782](https://github.com/python/mypy/pull/16782))
 * Fix numbering error (Stefanie Molin, PR [16838](https://github.com/python/mypy/pull/16838))
 * Various documentation improvements (Shantanu, PR [16836](https://github.com/python/mypy/pull/16836))

### Stubtest Improvements
 * Ignore private function/method parameters when they are missing from the stub (private parameter names start with a single underscore and have a default) (PR [16507](https://github.com/python/mypy/pull/16507))
 * Ignore a new protocol dunder (Alex Waygood, PR [16895](https://github.com/python/mypy/pull/16895))
 * Private parameters can be omitted (Sebastian Rittau, PR [16507](https://github.com/python/mypy/pull/16507))
 * Add support for setting enum members to "..." (Jelle Zijlstra, PR [16807](https://github.com/python/mypy/pull/16807))
 * Adjust symbol table logic (Shantanu, PR [16823](https://github.com/python/mypy/pull/16823))
 * Fix posisitional-only handling in overload resolution (Shantanu, PR [16750](https://github.com/python/mypy/pull/16750))

### Stubgen Improvements
 * Fix crash on star unpack of TypeVarTuple (Ali Hamdan, PR [16869](https://github.com/python/mypy/pull/16869))
 * Use PEP 604 unions everywhere (Ali Hamdan, PR [16519](https://github.com/python/mypy/pull/16519))
 * Do not ignore property deleter (Ali Hamdan, PR [16781](https://github.com/python/mypy/pull/16781))
 * Support type stub generation for `staticmethod` (WeilerMarcel, PR [14934](https://github.com/python/mypy/pull/14934))

### Acknowledgements

​Thanks to all mypy contributors who contributed to this release:

- Aleksi Tarvainen
- Alex Waygood
- Ali Hamdan
- anniel-stripe
- Charlie Denton
- Christoph Tyralla
- Dheeraj
- Fabian Keller
- Fabian Lewis
- Froger David
- Ihor
- Jared Hance
- Jelle Zijlstra
- Jukka Lehtosalo
- Kouroche Bouchiat
- Lukas Geiger
- Maarten Huijsmans
- Makonnen Makonnen
- Marc Mueller
- Nikita Sobolev
- Sebastian Rittau
- Shantanu
- Stefanie Molin
- Stephen Morton
- thomaswhaley
- Tin Tvrtković
- WeilerMarcel
- Wesley Collin Wright
- zipperer

I’d also like to thank my employer, Dropbox, for supporting mypy development.

## Mypy 1.8

We’ve just uploaded mypy 1.8 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)). Mypy is a static type checker for Python. This release includes new features, performance improvements and bug fixes. You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Type-checking Improvements
 * Do not intersect types in isinstance checks if at least one is final (Christoph Tyralla, PR [16330](https://github.com/python/mypy/pull/16330))
 * Detect that `@final` class without `__bool__` cannot have falsey instances (Ilya Priven, PR [16566](https://github.com/python/mypy/pull/16566))
 * Do not allow `TypedDict` classes with extra keywords (Nikita Sobolev, PR [16438](https://github.com/python/mypy/pull/16438))
 * Do not allow class-level keywords for `NamedTuple` (Nikita Sobolev, PR [16526](https://github.com/python/mypy/pull/16526))
 * Make imprecise constraints handling more robust (Ivan Levkivskyi, PR [16502](https://github.com/python/mypy/pull/16502))
 * Fix strict-optional in extending generic TypedDict (Ivan Levkivskyi, PR [16398](https://github.com/python/mypy/pull/16398))
 * Allow type ignores of PEP 695 constructs (Shantanu, PR [16608](https://github.com/python/mypy/pull/16608))
 * Enable `type_check_only` support for `TypedDict` and `NamedTuple` (Nikita Sobolev, PR [16469](https://github.com/python/mypy/pull/16469))

### Performance Improvements
 * Add fast path to analyzing special form assignments (Jukka Lehtosalo, PR [16561](https://github.com/python/mypy/pull/16561))

### Improvements to Error Reporting
 * Don't show documentation links for plugin error codes (Ivan Levkivskyi, PR [16383](https://github.com/python/mypy/pull/16383))
 * Improve error messages for `super` checks and add more tests (Nikita Sobolev, PR [16393](https://github.com/python/mypy/pull/16393))
 * Add error code for mutable covariant override (Ivan Levkivskyi, PR [16399](https://github.com/python/mypy/pull/16399))

### Stubgen Improvements
 * Preserve simple defaults in function signatures (Ali Hamdan, PR [15355](https://github.com/python/mypy/pull/15355))
 * Include `__all__` in output (Jelle Zijlstra, PR [16356](https://github.com/python/mypy/pull/16356))
 * Fix stubgen regressions with pybind11 and mypy 1.7 (Chad Dombrova, PR [16504](https://github.com/python/mypy/pull/16504))

### Stubtest Improvements
 * Improve handling of unrepresentable defaults (Jelle Zijlstra, PR [16433](https://github.com/python/mypy/pull/16433))
 * Print more helpful errors if a function is missing from stub (Alex Waygood, PR [16517](https://github.com/python/mypy/pull/16517))
 * Support `@type_check_only` decorator (Nikita Sobolev, PR [16422](https://github.com/python/mypy/pull/16422))
 * Warn about missing `__del__` (Shantanu, PR [16456](https://github.com/python/mypy/pull/16456))
 * Fix crashes with some uses of `final` and `deprecated` (Shantanu, PR [16457](https://github.com/python/mypy/pull/16457))

### Fixes to Crashes
 * Fix crash with type alias to `Callable[[Unpack[Tuple[Any, ...]]], Any]` (Alex Waygood, PR [16541](https://github.com/python/mypy/pull/16541))
 * Fix crash on TypeGuard in `__call__` (Ivan Levkivskyi, PR [16516](https://github.com/python/mypy/pull/16516))
 * Fix crash on invalid enum in method (Ivan Levkivskyi, PR [16511](https://github.com/python/mypy/pull/16511))
 * Fix crash on unimported Any in TypedDict (Ivan Levkivskyi, PR [16510](https://github.com/python/mypy/pull/16510))

### Documentation Updates
 * Update soft-error-limit default value to -1 (Sveinung Gundersen, PR [16542](https://github.com/python/mypy/pull/16542))
 * Support Sphinx 7.x (Michael R. Crusoe, PR [16460](https://github.com/python/mypy/pull/16460))

### Other Notable Changes and Fixes
 * Allow mypy to output a junit file with per-file results (Matthew Wright, PR [16388](https://github.com/python/mypy/pull/16388))

### Typeshed Updates

Please see [git log](https://github.com/python/typeshed/commits/main?after=4a854366e03dee700109f8e758a08b2457ea2f51+0&branch=main&path=stdlib) for full list of standard library typeshed stub changes.

### Acknowledgements

​Thanks to all mypy contributors who contributed to this release:

- Alex Waygood
- Ali Hamdan
- Chad Dombrova
- Christoph Tyralla
- Ilya Priven
- Ivan Levkivskyi
- Jelle Zijlstra
- Jukka Lehtosalo
- Marcel Telka
- Matthew Wright
- Michael R. Crusoe
- Nikita Sobolev
- Ole Peder Brandtzæg
- robjhornby
- Shantanu
- Sveinung Gundersen
- Valentin Stanciu

I’d also like to thank my employer, Dropbox, for supporting mypy development.

Posted by Wesley Collin Wright

## Mypy 1.7

We’ve just uploaded mypy 1.7 to the Python Package Index ([PyPI](https://pypi.org/project/mypy/)). Mypy is a static type checker for Python. This release includes new features, performance improvements and bug fixes. You can install it as follows:

    python3 -m pip install -U mypy

You can read the full documentation for this release on [Read the Docs](http://mypy.readthedocs.io).

### Using TypedDict for `**kwargs` Typing

Mypy now has support for using `Unpack[...]` with a TypedDict type to annotate `**kwargs` arguments enabled by default. Example:

```python
# Or 'from typing_extensions import ...'
from typing import TypedDict, Unpack

class Person(TypedDict):
    name: str
    age: int

def foo(**kwargs: Unpack[Person]) -> None:
    ...

foo(name="x", age=1)  # Ok
foo(name=1)  # Error
```

The definition of `foo` above is equivalent to the one below, with keyword-only arguments `name` and `age`:

```python
def foo(*, name: str, age: int) -> None:
    ...
```

Refer to [PEP 692](https://peps.python.org/pep-0692/) for more information. Note that unlike in the current version of the PEP, mypy always treats signatures with `Unpack[SomeTypedDict]` as equivalent to their expanded forms with explicit keyword arguments, and there aren't special type checking rules fo
Download .txt
gitextract_4gxjb3sb/

├── .editorconfig
├── .git-blame-ignore-revs
├── .gitattributes
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug.md
│   │   ├── config.yml
│   │   ├── crash.md
│   │   ├── documentation.md
│   │   └── feature.md
│   ├── PULL_REQUEST_TEMPLATE.md
│   └── workflows/
│       ├── build_wheels.yml
│       ├── docs.yml
│       ├── mypy_primer.yml
│       ├── mypy_primer_comment.yml
│       ├── sync_typeshed.yml
│       ├── test.yml
│       └── test_stubgenc.yml
├── .gitignore
├── .pre-commit-config.yaml
├── .readthedocs.yaml
├── CHANGELOG.md
├── CONTRIBUTING.md
├── CREDITS
├── LICENSE
├── MANIFEST.in
├── README.md
├── action.yml
├── build-requirements.txt
├── conftest.py
├── docs/
│   ├── Makefile
│   ├── README.md
│   ├── make.bat
│   ├── requirements-docs.txt
│   └── source/
│       ├── additional_features.rst
│       ├── builtin_types.rst
│       ├── changelog.md
│       ├── cheat_sheet_py3.rst
│       ├── class_basics.rst
│       ├── command_line.rst
│       ├── common_issues.rst
│       ├── conf.py
│       ├── config_file.rst
│       ├── duck_type_compatibility.rst
│       ├── dynamic_typing.rst
│       ├── error_code_list.rst
│       ├── error_code_list2.rst
│       ├── error_codes.rst
│       ├── existing_code.rst
│       ├── extending_mypy.rst
│       ├── faq.rst
│       ├── final_attrs.rst
│       ├── generics.rst
│       ├── getting_started.rst
│       ├── html_builder.py
│       ├── index.rst
│       ├── inline_config.rst
│       ├── installed_packages.rst
│       ├── kinds_of_types.rst
│       ├── literal_types.rst
│       ├── metaclasses.rst
│       ├── more_types.rst
│       ├── mypy_daemon.rst
│       ├── protocols.rst
│       ├── running_mypy.rst
│       ├── runtime_troubles.rst
│       ├── stubgen.rst
│       ├── stubs.rst
│       ├── stubtest.rst
│       ├── supported_python_features.rst
│       ├── type_inference_and_annotations.rst
│       ├── type_narrowing.rst
│       └── typed_dict.rst
├── misc/
│   ├── analyze_cache.py
│   ├── analyze_typeform_stats.py
│   ├── apply-cache-diff.py
│   ├── build-debug-python.sh
│   ├── build_wheel.py
│   ├── cherry-pick-typeshed.py
│   ├── clean-mypyc.sh
│   ├── convert-cache.py
│   ├── diff-cache.py
│   ├── docker/
│   │   ├── Dockerfile
│   │   ├── README.md
│   │   ├── build.py
│   │   ├── run-wrapper.sh
│   │   └── run.sh
│   ├── dump-ast.py
│   ├── find_type.py
│   ├── gen_blog_post_html.py
│   ├── generate_changelog.py
│   ├── incremental_checker.py
│   ├── log_trace_check.py
│   ├── macs.el
│   ├── perf_checker.py
│   ├── perf_compare.py
│   ├── profile_check.py
│   ├── self_compile_info.py
│   ├── sync-typeshed.py
│   ├── test-stubgenc.sh
│   ├── trigger_wheel_build.sh
│   ├── typeshed_patches/
│   │   ├── 0001-Adjust-stubs-to-fix-mypy-lookup-error-due-to-circula.patch
│   │   ├── 0001-Partially-revert-Clean-up-argparse-hacks.patch
│   │   ├── 0001-Remove-use-of-LiteralString-in-builtins-13743.patch
│   │   ├── 0001-Revert-Remove-redundant-inheritances-from-Iterator.patch
│   │   ├── 0001-Revert-Use-contravariant-type-variable-in-Container.patch
│   │   ├── 0001-Revert-sum-literal-integer-change-13961.patch
│   │   ├── 0001-Revert-typeshed-ctypes-change.patch
│   │   └── 0001-Temporarily-revert-contextlib-deprecation.patch
│   ├── update-stubinfo.py
│   └── upload-pypi.py
├── mypy/
│   ├── __init__.py
│   ├── __main__.py
│   ├── api.py
│   ├── applytype.py
│   ├── argmap.py
│   ├── binder.py
│   ├── bogus_type.py
│   ├── build.py
│   ├── build_worker/
│   │   ├── __init__.py
│   │   ├── __main__.py
│   │   └── worker.py
│   ├── cache.py
│   ├── checker.py
│   ├── checker_shared.py
│   ├── checker_state.py
│   ├── checkexpr.py
│   ├── checkmember.py
│   ├── checkpattern.py
│   ├── checkstrformat.py
│   ├── config_parser.py
│   ├── constant_fold.py
│   ├── constraints.py
│   ├── copytype.py
│   ├── defaults.py
│   ├── dmypy/
│   │   ├── __init__.py
│   │   ├── __main__.py
│   │   └── client.py
│   ├── dmypy_os.py
│   ├── dmypy_server.py
│   ├── dmypy_util.py
│   ├── erasetype.py
│   ├── error_formatter.py
│   ├── errorcodes.py
│   ├── errors.py
│   ├── evalexpr.py
│   ├── expandtype.py
│   ├── exportjson.py
│   ├── exprtotype.py
│   ├── fastparse.py
│   ├── find_sources.py
│   ├── fixup.py
│   ├── freetree.py
│   ├── fscache.py
│   ├── fswatcher.py
│   ├── gclogger.py
│   ├── git.py
│   ├── graph_utils.py
│   ├── indirection.py
│   ├── infer.py
│   ├── inspections.py
│   ├── ipc.py
│   ├── join.py
│   ├── literals.py
│   ├── lookup.py
│   ├── main.py
│   ├── maptype.py
│   ├── meet.py
│   ├── memprofile.py
│   ├── message_registry.py
│   ├── messages.py
│   ├── metastore.py
│   ├── mixedtraverser.py
│   ├── modulefinder.py
│   ├── moduleinspect.py
│   ├── mro.py
│   ├── nativeparse.py
│   ├── nodes.py
│   ├── operators.py
│   ├── options.py
│   ├── parse.py
│   ├── partially_defined.py
│   ├── patterns.py
│   ├── plugin.py
│   ├── plugins/
│   │   ├── __init__.py
│   │   ├── attrs.py
│   │   ├── common.py
│   │   ├── constants.py
│   │   ├── ctypes.py
│   │   ├── dataclasses.py
│   │   ├── default.py
│   │   ├── enums.py
│   │   ├── functools.py
│   │   ├── proper_plugin.py
│   │   └── singledispatch.py
│   ├── py.typed
│   ├── pyinfo.py
│   ├── reachability.py
│   ├── refinfo.py
│   ├── renaming.py
│   ├── report.py
│   ├── scope.py
│   ├── semanal.py
│   ├── semanal_classprop.py
│   ├── semanal_enum.py
│   ├── semanal_infer.py
│   ├── semanal_main.py
│   ├── semanal_namedtuple.py
│   ├── semanal_newtype.py
│   ├── semanal_pass1.py
│   ├── semanal_shared.py
│   ├── semanal_typeargs.py
│   ├── semanal_typeddict.py
│   ├── server/
│   │   ├── __init__.py
│   │   ├── astdiff.py
│   │   ├── astmerge.py
│   │   ├── aststrip.py
│   │   ├── deps.py
│   │   ├── mergecheck.py
│   │   ├── objgraph.py
│   │   ├── subexpr.py
│   │   ├── target.py
│   │   ├── trigger.py
│   │   └── update.py
│   ├── sharedparse.py
│   ├── solve.py
│   ├── split_namespace.py
│   ├── state.py
│   ├── stats.py
│   ├── strconv.py
│   ├── stubdoc.py
│   ├── stubgen.py
│   ├── stubgenc.py
│   ├── stubinfo.py
│   ├── stubtest.py
│   ├── stubutil.py
│   ├── subtypes.py
│   ├── suggestions.py
│   ├── test/
│   │   ├── __init__.py
│   │   ├── config.py
│   │   ├── data.py
│   │   ├── helpers.py
│   │   ├── meta/
│   │   │   ├── __init__.py
│   │   │   ├── _pytest.py
│   │   │   ├── test_diff_helper.py
│   │   │   ├── test_parse_data.py
│   │   │   └── test_update_data.py
│   │   ├── test_config_parser.py
│   │   ├── test_diff_cache.py
│   │   ├── test_find_sources.py
│   │   ├── test_nativeparse.py
│   │   ├── test_ref_info.py
│   │   ├── testapi.py
│   │   ├── testargs.py
│   │   ├── testcheck.py
│   │   ├── testcmdline.py
│   │   ├── testconstraints.py
│   │   ├── testdaemon.py
│   │   ├── testdeps.py
│   │   ├── testdiff.py
│   │   ├── testerrorstream.py
│   │   ├── testexportjson.py
│   │   ├── testfinegrained.py
│   │   ├── testfinegrainedcache.py
│   │   ├── testformatter.py
│   │   ├── testfscache.py
│   │   ├── testgraph.py
│   │   ├── testinfer.py
│   │   ├── testipc.py
│   │   ├── testmerge.py
│   │   ├── testmodulefinder.py
│   │   ├── testmypyc.py
│   │   ├── testoutput.py
│   │   ├── testparse.py
│   │   ├── testpep561.py
│   │   ├── testpythoneval.py
│   │   ├── testreports.py
│   │   ├── testsemanal.py
│   │   ├── testsolve.py
│   │   ├── teststubgen.py
│   │   ├── teststubinfo.py
│   │   ├── teststubtest.py
│   │   ├── testsubtypes.py
│   │   ├── testtransform.py
│   │   ├── testtypegen.py
│   │   ├── testtypes.py
│   │   ├── testutil.py
│   │   ├── typefixture.py
│   │   ├── update_data.py
│   │   └── visitors.py
│   ├── traverser.py
│   ├── treetransform.py
│   ├── tvar_scope.py
│   ├── type_visitor.py
│   ├── typeanal.py
│   ├── typeops.py
│   ├── types.py
│   ├── types_utils.py
│   ├── typeshed/
│   │   ├── LICENSE
│   │   ├── stdlib/
│   │   │   ├── VERSIONS
│   │   │   ├── __future__.pyi
│   │   │   ├── __main__.pyi
│   │   │   ├── _ast.pyi
│   │   │   ├── _asyncio.pyi
│   │   │   ├── _bisect.pyi
│   │   │   ├── _blake2.pyi
│   │   │   ├── _bootlocale.pyi
│   │   │   ├── _bz2.pyi
│   │   │   ├── _codecs.pyi
│   │   │   ├── _collections_abc.pyi
│   │   │   ├── _compat_pickle.pyi
│   │   │   ├── _compression.pyi
│   │   │   ├── _contextvars.pyi
│   │   │   ├── _csv.pyi
│   │   │   ├── _ctypes.pyi
│   │   │   ├── _curses.pyi
│   │   │   ├── _curses_panel.pyi
│   │   │   ├── _dbm.pyi
│   │   │   ├── _decimal.pyi
│   │   │   ├── _frozen_importlib.pyi
│   │   │   ├── _frozen_importlib_external.pyi
│   │   │   ├── _gdbm.pyi
│   │   │   ├── _hashlib.pyi
│   │   │   ├── _heapq.pyi
│   │   │   ├── _imp.pyi
│   │   │   ├── _interpchannels.pyi
│   │   │   ├── _interpqueues.pyi
│   │   │   ├── _interpreters.pyi
│   │   │   ├── _io.pyi
│   │   │   ├── _json.pyi
│   │   │   ├── _locale.pyi
│   │   │   ├── _lsprof.pyi
│   │   │   ├── _lzma.pyi
│   │   │   ├── _markupbase.pyi
│   │   │   ├── _msi.pyi
│   │   │   ├── _multibytecodec.pyi
│   │   │   ├── _operator.pyi
│   │   │   ├── _osx_support.pyi
│   │   │   ├── _pickle.pyi
│   │   │   ├── _posixsubprocess.pyi
│   │   │   ├── _py_abc.pyi
│   │   │   ├── _pydecimal.pyi
│   │   │   ├── _queue.pyi
│   │   │   ├── _random.pyi
│   │   │   ├── _sitebuiltins.pyi
│   │   │   ├── _socket.pyi
│   │   │   ├── _sqlite3.pyi
│   │   │   ├── _ssl.pyi
│   │   │   ├── _stat.pyi
│   │   │   ├── _struct.pyi
│   │   │   ├── _thread.pyi
│   │   │   ├── _threading_local.pyi
│   │   │   ├── _tkinter.pyi
│   │   │   ├── _tracemalloc.pyi
│   │   │   ├── _typeshed/
│   │   │   │   ├── README.md
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _type_checker_internals.pyi
│   │   │   │   ├── dbapi.pyi
│   │   │   │   ├── importlib.pyi
│   │   │   │   ├── wsgi.pyi
│   │   │   │   └── xml.pyi
│   │   │   ├── _warnings.pyi
│   │   │   ├── _weakref.pyi
│   │   │   ├── _weakrefset.pyi
│   │   │   ├── _winapi.pyi
│   │   │   ├── _zstd.pyi
│   │   │   ├── abc.pyi
│   │   │   ├── aifc.pyi
│   │   │   ├── annotationlib.pyi
│   │   │   ├── antigravity.pyi
│   │   │   ├── argparse.pyi
│   │   │   ├── array.pyi
│   │   │   ├── ast.pyi
│   │   │   ├── asynchat.pyi
│   │   │   ├── asyncio/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── base_events.pyi
│   │   │   │   ├── base_futures.pyi
│   │   │   │   ├── base_subprocess.pyi
│   │   │   │   ├── base_tasks.pyi
│   │   │   │   ├── constants.pyi
│   │   │   │   ├── coroutines.pyi
│   │   │   │   ├── events.pyi
│   │   │   │   ├── exceptions.pyi
│   │   │   │   ├── format_helpers.pyi
│   │   │   │   ├── futures.pyi
│   │   │   │   ├── graph.pyi
│   │   │   │   ├── locks.pyi
│   │   │   │   ├── log.pyi
│   │   │   │   ├── mixins.pyi
│   │   │   │   ├── proactor_events.pyi
│   │   │   │   ├── protocols.pyi
│   │   │   │   ├── queues.pyi
│   │   │   │   ├── runners.pyi
│   │   │   │   ├── selector_events.pyi
│   │   │   │   ├── sslproto.pyi
│   │   │   │   ├── staggered.pyi
│   │   │   │   ├── streams.pyi
│   │   │   │   ├── subprocess.pyi
│   │   │   │   ├── taskgroups.pyi
│   │   │   │   ├── tasks.pyi
│   │   │   │   ├── threads.pyi
│   │   │   │   ├── timeouts.pyi
│   │   │   │   ├── tools.pyi
│   │   │   │   ├── transports.pyi
│   │   │   │   ├── trsock.pyi
│   │   │   │   ├── unix_events.pyi
│   │   │   │   ├── windows_events.pyi
│   │   │   │   └── windows_utils.pyi
│   │   │   ├── asyncore.pyi
│   │   │   ├── atexit.pyi
│   │   │   ├── audioop.pyi
│   │   │   ├── base64.pyi
│   │   │   ├── bdb.pyi
│   │   │   ├── binascii.pyi
│   │   │   ├── binhex.pyi
│   │   │   ├── bisect.pyi
│   │   │   ├── builtins.pyi
│   │   │   ├── bz2.pyi
│   │   │   ├── cProfile.pyi
│   │   │   ├── calendar.pyi
│   │   │   ├── cgi.pyi
│   │   │   ├── cgitb.pyi
│   │   │   ├── chunk.pyi
│   │   │   ├── cmath.pyi
│   │   │   ├── cmd.pyi
│   │   │   ├── code.pyi
│   │   │   ├── codecs.pyi
│   │   │   ├── codeop.pyi
│   │   │   ├── collections/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── abc.pyi
│   │   │   ├── colorsys.pyi
│   │   │   ├── compileall.pyi
│   │   │   ├── compression/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _common/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   └── _streams.pyi
│   │   │   │   ├── bz2.pyi
│   │   │   │   ├── gzip.pyi
│   │   │   │   ├── lzma.pyi
│   │   │   │   ├── zlib.pyi
│   │   │   │   └── zstd/
│   │   │   │       ├── __init__.pyi
│   │   │   │       └── _zstdfile.pyi
│   │   │   ├── concurrent/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── futures/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── _base.pyi
│   │   │   │   │   ├── interpreter.pyi
│   │   │   │   │   ├── process.pyi
│   │   │   │   │   └── thread.pyi
│   │   │   │   └── interpreters/
│   │   │   │       ├── __init__.pyi
│   │   │   │       ├── _crossinterp.pyi
│   │   │   │       └── _queues.pyi
│   │   │   ├── configparser.pyi
│   │   │   ├── contextlib.pyi
│   │   │   ├── contextvars.pyi
│   │   │   ├── copy.pyi
│   │   │   ├── copyreg.pyi
│   │   │   ├── crypt.pyi
│   │   │   ├── csv.pyi
│   │   │   ├── ctypes/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _endian.pyi
│   │   │   │   ├── macholib/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── dyld.pyi
│   │   │   │   │   ├── dylib.pyi
│   │   │   │   │   └── framework.pyi
│   │   │   │   ├── util.pyi
│   │   │   │   └── wintypes.pyi
│   │   │   ├── curses/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── ascii.pyi
│   │   │   │   ├── has_key.pyi
│   │   │   │   ├── panel.pyi
│   │   │   │   └── textpad.pyi
│   │   │   ├── dataclasses.pyi
│   │   │   ├── datetime.pyi
│   │   │   ├── dbm/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── dumb.pyi
│   │   │   │   ├── gnu.pyi
│   │   │   │   ├── ndbm.pyi
│   │   │   │   └── sqlite3.pyi
│   │   │   ├── decimal.pyi
│   │   │   ├── difflib.pyi
│   │   │   ├── dis.pyi
│   │   │   ├── distutils/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _msvccompiler.pyi
│   │   │   │   ├── archive_util.pyi
│   │   │   │   ├── bcppcompiler.pyi
│   │   │   │   ├── ccompiler.pyi
│   │   │   │   ├── cmd.pyi
│   │   │   │   ├── command/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── bdist.pyi
│   │   │   │   │   ├── bdist_dumb.pyi
│   │   │   │   │   ├── bdist_msi.pyi
│   │   │   │   │   ├── bdist_packager.pyi
│   │   │   │   │   ├── bdist_rpm.pyi
│   │   │   │   │   ├── bdist_wininst.pyi
│   │   │   │   │   ├── build.pyi
│   │   │   │   │   ├── build_clib.pyi
│   │   │   │   │   ├── build_ext.pyi
│   │   │   │   │   ├── build_py.pyi
│   │   │   │   │   ├── build_scripts.pyi
│   │   │   │   │   ├── check.pyi
│   │   │   │   │   ├── clean.pyi
│   │   │   │   │   ├── config.pyi
│   │   │   │   │   ├── install.pyi
│   │   │   │   │   ├── install_data.pyi
│   │   │   │   │   ├── install_egg_info.pyi
│   │   │   │   │   ├── install_headers.pyi
│   │   │   │   │   ├── install_lib.pyi
│   │   │   │   │   ├── install_scripts.pyi
│   │   │   │   │   ├── register.pyi
│   │   │   │   │   ├── sdist.pyi
│   │   │   │   │   └── upload.pyi
│   │   │   │   ├── config.pyi
│   │   │   │   ├── core.pyi
│   │   │   │   ├── cygwinccompiler.pyi
│   │   │   │   ├── debug.pyi
│   │   │   │   ├── dep_util.pyi
│   │   │   │   ├── dir_util.pyi
│   │   │   │   ├── dist.pyi
│   │   │   │   ├── errors.pyi
│   │   │   │   ├── extension.pyi
│   │   │   │   ├── fancy_getopt.pyi
│   │   │   │   ├── file_util.pyi
│   │   │   │   ├── filelist.pyi
│   │   │   │   ├── log.pyi
│   │   │   │   ├── msvccompiler.pyi
│   │   │   │   ├── spawn.pyi
│   │   │   │   ├── sysconfig.pyi
│   │   │   │   ├── text_file.pyi
│   │   │   │   ├── unixccompiler.pyi
│   │   │   │   ├── util.pyi
│   │   │   │   └── version.pyi
│   │   │   ├── doctest.pyi
│   │   │   ├── email/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _header_value_parser.pyi
│   │   │   │   ├── _policybase.pyi
│   │   │   │   ├── base64mime.pyi
│   │   │   │   ├── charset.pyi
│   │   │   │   ├── contentmanager.pyi
│   │   │   │   ├── encoders.pyi
│   │   │   │   ├── errors.pyi
│   │   │   │   ├── feedparser.pyi
│   │   │   │   ├── generator.pyi
│   │   │   │   ├── header.pyi
│   │   │   │   ├── headerregistry.pyi
│   │   │   │   ├── iterators.pyi
│   │   │   │   ├── message.pyi
│   │   │   │   ├── mime/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── application.pyi
│   │   │   │   │   ├── audio.pyi
│   │   │   │   │   ├── base.pyi
│   │   │   │   │   ├── image.pyi
│   │   │   │   │   ├── message.pyi
│   │   │   │   │   ├── multipart.pyi
│   │   │   │   │   ├── nonmultipart.pyi
│   │   │   │   │   └── text.pyi
│   │   │   │   ├── parser.pyi
│   │   │   │   ├── policy.pyi
│   │   │   │   ├── quoprimime.pyi
│   │   │   │   └── utils.pyi
│   │   │   ├── encodings/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── aliases.pyi
│   │   │   │   ├── ascii.pyi
│   │   │   │   ├── base64_codec.pyi
│   │   │   │   ├── big5.pyi
│   │   │   │   ├── big5hkscs.pyi
│   │   │   │   ├── bz2_codec.pyi
│   │   │   │   ├── charmap.pyi
│   │   │   │   ├── cp037.pyi
│   │   │   │   ├── cp1006.pyi
│   │   │   │   ├── cp1026.pyi
│   │   │   │   ├── cp1125.pyi
│   │   │   │   ├── cp1140.pyi
│   │   │   │   ├── cp1250.pyi
│   │   │   │   ├── cp1251.pyi
│   │   │   │   ├── cp1252.pyi
│   │   │   │   ├── cp1253.pyi
│   │   │   │   ├── cp1254.pyi
│   │   │   │   ├── cp1255.pyi
│   │   │   │   ├── cp1256.pyi
│   │   │   │   ├── cp1257.pyi
│   │   │   │   ├── cp1258.pyi
│   │   │   │   ├── cp273.pyi
│   │   │   │   ├── cp424.pyi
│   │   │   │   ├── cp437.pyi
│   │   │   │   ├── cp500.pyi
│   │   │   │   ├── cp720.pyi
│   │   │   │   ├── cp737.pyi
│   │   │   │   ├── cp775.pyi
│   │   │   │   ├── cp850.pyi
│   │   │   │   ├── cp852.pyi
│   │   │   │   ├── cp855.pyi
│   │   │   │   ├── cp856.pyi
│   │   │   │   ├── cp857.pyi
│   │   │   │   ├── cp858.pyi
│   │   │   │   ├── cp860.pyi
│   │   │   │   ├── cp861.pyi
│   │   │   │   ├── cp862.pyi
│   │   │   │   ├── cp863.pyi
│   │   │   │   ├── cp864.pyi
│   │   │   │   ├── cp865.pyi
│   │   │   │   ├── cp866.pyi
│   │   │   │   ├── cp869.pyi
│   │   │   │   ├── cp874.pyi
│   │   │   │   ├── cp875.pyi
│   │   │   │   ├── cp932.pyi
│   │   │   │   ├── cp949.pyi
│   │   │   │   ├── cp950.pyi
│   │   │   │   ├── euc_jis_2004.pyi
│   │   │   │   ├── euc_jisx0213.pyi
│   │   │   │   ├── euc_jp.pyi
│   │   │   │   ├── euc_kr.pyi
│   │   │   │   ├── gb18030.pyi
│   │   │   │   ├── gb2312.pyi
│   │   │   │   ├── gbk.pyi
│   │   │   │   ├── hex_codec.pyi
│   │   │   │   ├── hp_roman8.pyi
│   │   │   │   ├── hz.pyi
│   │   │   │   ├── idna.pyi
│   │   │   │   ├── iso2022_jp.pyi
│   │   │   │   ├── iso2022_jp_1.pyi
│   │   │   │   ├── iso2022_jp_2.pyi
│   │   │   │   ├── iso2022_jp_2004.pyi
│   │   │   │   ├── iso2022_jp_3.pyi
│   │   │   │   ├── iso2022_jp_ext.pyi
│   │   │   │   ├── iso2022_kr.pyi
│   │   │   │   ├── iso8859_1.pyi
│   │   │   │   ├── iso8859_10.pyi
│   │   │   │   ├── iso8859_11.pyi
│   │   │   │   ├── iso8859_13.pyi
│   │   │   │   ├── iso8859_14.pyi
│   │   │   │   ├── iso8859_15.pyi
│   │   │   │   ├── iso8859_16.pyi
│   │   │   │   ├── iso8859_2.pyi
│   │   │   │   ├── iso8859_3.pyi
│   │   │   │   ├── iso8859_4.pyi
│   │   │   │   ├── iso8859_5.pyi
│   │   │   │   ├── iso8859_6.pyi
│   │   │   │   ├── iso8859_7.pyi
│   │   │   │   ├── iso8859_8.pyi
│   │   │   │   ├── iso8859_9.pyi
│   │   │   │   ├── johab.pyi
│   │   │   │   ├── koi8_r.pyi
│   │   │   │   ├── koi8_t.pyi
│   │   │   │   ├── koi8_u.pyi
│   │   │   │   ├── kz1048.pyi
│   │   │   │   ├── latin_1.pyi
│   │   │   │   ├── mac_arabic.pyi
│   │   │   │   ├── mac_croatian.pyi
│   │   │   │   ├── mac_cyrillic.pyi
│   │   │   │   ├── mac_farsi.pyi
│   │   │   │   ├── mac_greek.pyi
│   │   │   │   ├── mac_iceland.pyi
│   │   │   │   ├── mac_latin2.pyi
│   │   │   │   ├── mac_roman.pyi
│   │   │   │   ├── mac_romanian.pyi
│   │   │   │   ├── mac_turkish.pyi
│   │   │   │   ├── mbcs.pyi
│   │   │   │   ├── oem.pyi
│   │   │   │   ├── palmos.pyi
│   │   │   │   ├── ptcp154.pyi
│   │   │   │   ├── punycode.pyi
│   │   │   │   ├── quopri_codec.pyi
│   │   │   │   ├── raw_unicode_escape.pyi
│   │   │   │   ├── rot_13.pyi
│   │   │   │   ├── shift_jis.pyi
│   │   │   │   ├── shift_jis_2004.pyi
│   │   │   │   ├── shift_jisx0213.pyi
│   │   │   │   ├── tis_620.pyi
│   │   │   │   ├── undefined.pyi
│   │   │   │   ├── unicode_escape.pyi
│   │   │   │   ├── utf_16.pyi
│   │   │   │   ├── utf_16_be.pyi
│   │   │   │   ├── utf_16_le.pyi
│   │   │   │   ├── utf_32.pyi
│   │   │   │   ├── utf_32_be.pyi
│   │   │   │   ├── utf_32_le.pyi
│   │   │   │   ├── utf_7.pyi
│   │   │   │   ├── utf_8.pyi
│   │   │   │   ├── utf_8_sig.pyi
│   │   │   │   ├── uu_codec.pyi
│   │   │   │   └── zlib_codec.pyi
│   │   │   ├── ensurepip/
│   │   │   │   └── __init__.pyi
│   │   │   ├── enum.pyi
│   │   │   ├── errno.pyi
│   │   │   ├── faulthandler.pyi
│   │   │   ├── fcntl.pyi
│   │   │   ├── filecmp.pyi
│   │   │   ├── fileinput.pyi
│   │   │   ├── fnmatch.pyi
│   │   │   ├── formatter.pyi
│   │   │   ├── fractions.pyi
│   │   │   ├── ftplib.pyi
│   │   │   ├── functools.pyi
│   │   │   ├── gc.pyi
│   │   │   ├── genericpath.pyi
│   │   │   ├── getopt.pyi
│   │   │   ├── getpass.pyi
│   │   │   ├── gettext.pyi
│   │   │   ├── glob.pyi
│   │   │   ├── graphlib.pyi
│   │   │   ├── grp.pyi
│   │   │   ├── gzip.pyi
│   │   │   ├── hashlib.pyi
│   │   │   ├── heapq.pyi
│   │   │   ├── hmac.pyi
│   │   │   ├── html/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── entities.pyi
│   │   │   │   └── parser.pyi
│   │   │   ├── http/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── client.pyi
│   │   │   │   ├── cookiejar.pyi
│   │   │   │   ├── cookies.pyi
│   │   │   │   └── server.pyi
│   │   │   ├── imaplib.pyi
│   │   │   ├── imghdr.pyi
│   │   │   ├── imp.pyi
│   │   │   ├── importlib/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _abc.pyi
│   │   │   │   ├── _bootstrap.pyi
│   │   │   │   ├── _bootstrap_external.pyi
│   │   │   │   ├── abc.pyi
│   │   │   │   ├── machinery.pyi
│   │   │   │   ├── metadata/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── _meta.pyi
│   │   │   │   │   └── diagnose.pyi
│   │   │   │   ├── readers.pyi
│   │   │   │   ├── resources/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── _common.pyi
│   │   │   │   │   ├── _functional.pyi
│   │   │   │   │   ├── abc.pyi
│   │   │   │   │   ├── readers.pyi
│   │   │   │   │   └── simple.pyi
│   │   │   │   ├── simple.pyi
│   │   │   │   └── util.pyi
│   │   │   ├── inspect.pyi
│   │   │   ├── io.pyi
│   │   │   ├── ipaddress.pyi
│   │   │   ├── itertools.pyi
│   │   │   ├── json/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── decoder.pyi
│   │   │   │   ├── encoder.pyi
│   │   │   │   ├── scanner.pyi
│   │   │   │   └── tool.pyi
│   │   │   ├── keyword.pyi
│   │   │   ├── lib2to3/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── btm_matcher.pyi
│   │   │   │   ├── fixer_base.pyi
│   │   │   │   ├── fixes/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── fix_apply.pyi
│   │   │   │   │   ├── fix_asserts.pyi
│   │   │   │   │   ├── fix_basestring.pyi
│   │   │   │   │   ├── fix_buffer.pyi
│   │   │   │   │   ├── fix_dict.pyi
│   │   │   │   │   ├── fix_except.pyi
│   │   │   │   │   ├── fix_exec.pyi
│   │   │   │   │   ├── fix_execfile.pyi
│   │   │   │   │   ├── fix_exitfunc.pyi
│   │   │   │   │   ├── fix_filter.pyi
│   │   │   │   │   ├── fix_funcattrs.pyi
│   │   │   │   │   ├── fix_future.pyi
│   │   │   │   │   ├── fix_getcwdu.pyi
│   │   │   │   │   ├── fix_has_key.pyi
│   │   │   │   │   ├── fix_idioms.pyi
│   │   │   │   │   ├── fix_import.pyi
│   │   │   │   │   ├── fix_imports.pyi
│   │   │   │   │   ├── fix_imports2.pyi
│   │   │   │   │   ├── fix_input.pyi
│   │   │   │   │   ├── fix_intern.pyi
│   │   │   │   │   ├── fix_isinstance.pyi
│   │   │   │   │   ├── fix_itertools.pyi
│   │   │   │   │   ├── fix_itertools_imports.pyi
│   │   │   │   │   ├── fix_long.pyi
│   │   │   │   │   ├── fix_map.pyi
│   │   │   │   │   ├── fix_metaclass.pyi
│   │   │   │   │   ├── fix_methodattrs.pyi
│   │   │   │   │   ├── fix_ne.pyi
│   │   │   │   │   ├── fix_next.pyi
│   │   │   │   │   ├── fix_nonzero.pyi
│   │   │   │   │   ├── fix_numliterals.pyi
│   │   │   │   │   ├── fix_operator.pyi
│   │   │   │   │   ├── fix_paren.pyi
│   │   │   │   │   ├── fix_print.pyi
│   │   │   │   │   ├── fix_raise.pyi
│   │   │   │   │   ├── fix_raw_input.pyi
│   │   │   │   │   ├── fix_reduce.pyi
│   │   │   │   │   ├── fix_reload.pyi
│   │   │   │   │   ├── fix_renames.pyi
│   │   │   │   │   ├── fix_repr.pyi
│   │   │   │   │   ├── fix_set_literal.pyi
│   │   │   │   │   ├── fix_standarderror.pyi
│   │   │   │   │   ├── fix_sys_exc.pyi
│   │   │   │   │   ├── fix_throw.pyi
│   │   │   │   │   ├── fix_tuple_params.pyi
│   │   │   │   │   ├── fix_types.pyi
│   │   │   │   │   ├── fix_unicode.pyi
│   │   │   │   │   ├── fix_urllib.pyi
│   │   │   │   │   ├── fix_ws_comma.pyi
│   │   │   │   │   ├── fix_xrange.pyi
│   │   │   │   │   ├── fix_xreadlines.pyi
│   │   │   │   │   └── fix_zip.pyi
│   │   │   │   ├── main.pyi
│   │   │   │   ├── pgen2/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── driver.pyi
│   │   │   │   │   ├── grammar.pyi
│   │   │   │   │   ├── literals.pyi
│   │   │   │   │   ├── parse.pyi
│   │   │   │   │   ├── pgen.pyi
│   │   │   │   │   ├── token.pyi
│   │   │   │   │   └── tokenize.pyi
│   │   │   │   ├── pygram.pyi
│   │   │   │   ├── pytree.pyi
│   │   │   │   └── refactor.pyi
│   │   │   ├── linecache.pyi
│   │   │   ├── locale.pyi
│   │   │   ├── logging/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── config.pyi
│   │   │   │   └── handlers.pyi
│   │   │   ├── lzma.pyi
│   │   │   ├── mailbox.pyi
│   │   │   ├── mailcap.pyi
│   │   │   ├── marshal.pyi
│   │   │   ├── math.pyi
│   │   │   ├── mimetypes.pyi
│   │   │   ├── mmap.pyi
│   │   │   ├── modulefinder.pyi
│   │   │   ├── msilib/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── schema.pyi
│   │   │   │   ├── sequence.pyi
│   │   │   │   └── text.pyi
│   │   │   ├── msvcrt.pyi
│   │   │   ├── multiprocessing/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── connection.pyi
│   │   │   │   ├── context.pyi
│   │   │   │   ├── dummy/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   └── connection.pyi
│   │   │   │   ├── forkserver.pyi
│   │   │   │   ├── heap.pyi
│   │   │   │   ├── managers.pyi
│   │   │   │   ├── pool.pyi
│   │   │   │   ├── popen_fork.pyi
│   │   │   │   ├── popen_forkserver.pyi
│   │   │   │   ├── popen_spawn_posix.pyi
│   │   │   │   ├── popen_spawn_win32.pyi
│   │   │   │   ├── process.pyi
│   │   │   │   ├── queues.pyi
│   │   │   │   ├── reduction.pyi
│   │   │   │   ├── resource_sharer.pyi
│   │   │   │   ├── resource_tracker.pyi
│   │   │   │   ├── shared_memory.pyi
│   │   │   │   ├── sharedctypes.pyi
│   │   │   │   ├── spawn.pyi
│   │   │   │   ├── synchronize.pyi
│   │   │   │   └── util.pyi
│   │   │   ├── netrc.pyi
│   │   │   ├── nis.pyi
│   │   │   ├── nntplib.pyi
│   │   │   ├── nt.pyi
│   │   │   ├── ntpath.pyi
│   │   │   ├── nturl2path.pyi
│   │   │   ├── numbers.pyi
│   │   │   ├── opcode.pyi
│   │   │   ├── operator.pyi
│   │   │   ├── optparse.pyi
│   │   │   ├── os/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── path.pyi
│   │   │   ├── ossaudiodev.pyi
│   │   │   ├── parser.pyi
│   │   │   ├── pathlib/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── types.pyi
│   │   │   ├── pdb.pyi
│   │   │   ├── pickle.pyi
│   │   │   ├── pickletools.pyi
│   │   │   ├── pipes.pyi
│   │   │   ├── pkgutil.pyi
│   │   │   ├── platform.pyi
│   │   │   ├── plistlib.pyi
│   │   │   ├── poplib.pyi
│   │   │   ├── posix.pyi
│   │   │   ├── posixpath.pyi
│   │   │   ├── pprint.pyi
│   │   │   ├── profile.pyi
│   │   │   ├── pstats.pyi
│   │   │   ├── pty.pyi
│   │   │   ├── pwd.pyi
│   │   │   ├── py_compile.pyi
│   │   │   ├── pyclbr.pyi
│   │   │   ├── pydoc.pyi
│   │   │   ├── pydoc_data/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── module_docs.pyi
│   │   │   │   └── topics.pyi
│   │   │   ├── pyexpat/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── errors.pyi
│   │   │   │   └── model.pyi
│   │   │   ├── queue.pyi
│   │   │   ├── quopri.pyi
│   │   │   ├── random.pyi
│   │   │   ├── re.pyi
│   │   │   ├── readline.pyi
│   │   │   ├── reprlib.pyi
│   │   │   ├── resource.pyi
│   │   │   ├── rlcompleter.pyi
│   │   │   ├── runpy.pyi
│   │   │   ├── sched.pyi
│   │   │   ├── secrets.pyi
│   │   │   ├── select.pyi
│   │   │   ├── selectors.pyi
│   │   │   ├── shelve.pyi
│   │   │   ├── shlex.pyi
│   │   │   ├── shutil.pyi
│   │   │   ├── signal.pyi
│   │   │   ├── site.pyi
│   │   │   ├── smtpd.pyi
│   │   │   ├── smtplib.pyi
│   │   │   ├── sndhdr.pyi
│   │   │   ├── socket.pyi
│   │   │   ├── socketserver.pyi
│   │   │   ├── spwd.pyi
│   │   │   ├── sqlite3/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── dbapi2.pyi
│   │   │   │   └── dump.pyi
│   │   │   ├── sre_compile.pyi
│   │   │   ├── sre_constants.pyi
│   │   │   ├── sre_parse.pyi
│   │   │   ├── ssl.pyi
│   │   │   ├── stat.pyi
│   │   │   ├── statistics.pyi
│   │   │   ├── string/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── templatelib.pyi
│   │   │   ├── stringprep.pyi
│   │   │   ├── struct.pyi
│   │   │   ├── subprocess.pyi
│   │   │   ├── sunau.pyi
│   │   │   ├── symbol.pyi
│   │   │   ├── symtable.pyi
│   │   │   ├── sys/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── _monitoring.pyi
│   │   │   ├── sysconfig.pyi
│   │   │   ├── syslog.pyi
│   │   │   ├── tabnanny.pyi
│   │   │   ├── tarfile.pyi
│   │   │   ├── telnetlib.pyi
│   │   │   ├── tempfile.pyi
│   │   │   ├── termios.pyi
│   │   │   ├── textwrap.pyi
│   │   │   ├── this.pyi
│   │   │   ├── threading.pyi
│   │   │   ├── time.pyi
│   │   │   ├── timeit.pyi
│   │   │   ├── tkinter/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── colorchooser.pyi
│   │   │   │   ├── commondialog.pyi
│   │   │   │   ├── constants.pyi
│   │   │   │   ├── dialog.pyi
│   │   │   │   ├── dnd.pyi
│   │   │   │   ├── filedialog.pyi
│   │   │   │   ├── font.pyi
│   │   │   │   ├── messagebox.pyi
│   │   │   │   ├── scrolledtext.pyi
│   │   │   │   ├── simpledialog.pyi
│   │   │   │   ├── tix.pyi
│   │   │   │   └── ttk.pyi
│   │   │   ├── token.pyi
│   │   │   ├── tokenize.pyi
│   │   │   ├── tomllib.pyi
│   │   │   ├── trace.pyi
│   │   │   ├── traceback.pyi
│   │   │   ├── tracemalloc.pyi
│   │   │   ├── tty.pyi
│   │   │   ├── turtle.pyi
│   │   │   ├── types.pyi
│   │   │   ├── typing.pyi
│   │   │   ├── typing_extensions.pyi
│   │   │   ├── unicodedata.pyi
│   │   │   ├── unittest/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── _log.pyi
│   │   │   │   ├── async_case.pyi
│   │   │   │   ├── case.pyi
│   │   │   │   ├── loader.pyi
│   │   │   │   ├── main.pyi
│   │   │   │   ├── mock.pyi
│   │   │   │   ├── result.pyi
│   │   │   │   ├── runner.pyi
│   │   │   │   ├── signals.pyi
│   │   │   │   ├── suite.pyi
│   │   │   │   └── util.pyi
│   │   │   ├── urllib/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── error.pyi
│   │   │   │   ├── parse.pyi
│   │   │   │   ├── request.pyi
│   │   │   │   ├── response.pyi
│   │   │   │   └── robotparser.pyi
│   │   │   ├── uu.pyi
│   │   │   ├── uuid.pyi
│   │   │   ├── warnings.pyi
│   │   │   ├── wave.pyi
│   │   │   ├── weakref.pyi
│   │   │   ├── webbrowser.pyi
│   │   │   ├── winreg.pyi
│   │   │   ├── winsound.pyi
│   │   │   ├── wsgiref/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── handlers.pyi
│   │   │   │   ├── headers.pyi
│   │   │   │   ├── simple_server.pyi
│   │   │   │   ├── types.pyi
│   │   │   │   ├── util.pyi
│   │   │   │   └── validate.pyi
│   │   │   ├── xdrlib.pyi
│   │   │   ├── xml/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── dom/
│   │   │   │   │   ├── NodeFilter.pyi
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   ├── domreg.pyi
│   │   │   │   │   ├── expatbuilder.pyi
│   │   │   │   │   ├── minicompat.pyi
│   │   │   │   │   ├── minidom.pyi
│   │   │   │   │   ├── pulldom.pyi
│   │   │   │   │   └── xmlbuilder.pyi
│   │   │   │   ├── etree/
│   │   │   │   │   ├── ElementInclude.pyi
│   │   │   │   │   ├── ElementPath.pyi
│   │   │   │   │   ├── ElementTree.pyi
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   └── cElementTree.pyi
│   │   │   │   ├── parsers/
│   │   │   │   │   ├── __init__.pyi
│   │   │   │   │   └── expat/
│   │   │   │   │       ├── __init__.pyi
│   │   │   │   │       ├── errors.pyi
│   │   │   │   │       └── model.pyi
│   │   │   │   └── sax/
│   │   │   │       ├── __init__.pyi
│   │   │   │       ├── _exceptions.pyi
│   │   │   │       ├── expatreader.pyi
│   │   │   │       ├── handler.pyi
│   │   │   │       ├── saxutils.pyi
│   │   │   │       └── xmlreader.pyi
│   │   │   ├── xmlrpc/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── client.pyi
│   │   │   │   └── server.pyi
│   │   │   ├── xxlimited.pyi
│   │   │   ├── zipapp.pyi
│   │   │   ├── zipfile/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── _path/
│   │   │   │       ├── __init__.pyi
│   │   │   │       └── glob.pyi
│   │   │   ├── zipimport.pyi
│   │   │   ├── zlib.pyi
│   │   │   └── zoneinfo/
│   │   │       ├── __init__.pyi
│   │   │       ├── _common.pyi
│   │   │       └── _tzpath.pyi
│   │   └── stubs/
│   │       ├── librt/
│   │       │   ├── METADATA.toml
│   │       │   └── librt/
│   │       │       ├── __init__.pyi
│   │       │       ├── base64.pyi
│   │       │       ├── internal.pyi
│   │       │       ├── strings.pyi
│   │       │       ├── time.pyi
│   │       │       └── vecs.pyi
│   │       └── mypy-extensions/
│   │           ├── @tests/
│   │           │   └── stubtest_allowlist.txt
│   │           ├── METADATA.toml
│   │           └── mypy_extensions.pyi
│   ├── typestate.py
│   ├── typetraverser.py
│   ├── typevars.py
│   ├── typevartuples.py
│   ├── util.py
│   ├── version.py
│   ├── visitor.py
│   └── xml/
│       ├── mypy-html.css
│       ├── mypy-html.xslt
│       ├── mypy-txt.xslt
│       └── mypy.xsd
├── mypy-requirements.txt
├── mypy_bootstrap.ini
├── mypy_self_check.ini
├── mypyc/
│   ├── .readthedocs.yaml
│   ├── README.md
│   ├── __init__.py
│   ├── __main__.py
│   ├── analysis/
│   │   ├── __init__.py
│   │   ├── attrdefined.py
│   │   ├── blockfreq.py
│   │   ├── capsule_deps.py
│   │   ├── dataflow.py
│   │   ├── ircheck.py
│   │   └── selfleaks.py
│   ├── annotate.py
│   ├── build.py
│   ├── build_setup.py
│   ├── codegen/
│   │   ├── __init__.py
│   │   ├── cstring.py
│   │   ├── emit.py
│   │   ├── emitclass.py
│   │   ├── emitfunc.py
│   │   ├── emitmodule.py
│   │   ├── emitwrapper.py
│   │   └── literals.py
│   ├── common.py
│   ├── crash.py
│   ├── doc/
│   │   ├── Makefile
│   │   ├── bool_operations.rst
│   │   ├── bytearray_operations.rst
│   │   ├── bytes_operations.rst
│   │   ├── compilation_units.rst
│   │   ├── conf.py
│   │   ├── cpython-timings.md
│   │   ├── dev-intro.md
│   │   ├── dict_operations.rst
│   │   ├── differences_from_python.rst
│   │   ├── float_operations.rst
│   │   ├── frozenset_operations.rst
│   │   ├── future.md
│   │   ├── getting_started.rst
│   │   ├── index.rst
│   │   ├── int_operations.rst
│   │   ├── introduction.rst
│   │   ├── list_operations.rst
│   │   ├── make.bat
│   │   ├── native_classes.rst
│   │   ├── native_operations.rst
│   │   ├── performance_tips_and_tricks.rst
│   │   ├── set_operations.rst
│   │   ├── str_operations.rst
│   │   ├── tuple_operations.rst
│   │   └── using_type_annotations.rst
│   ├── errors.py
│   ├── external/
│   │   └── googletest/
│   │       ├── LICENSE
│   │       ├── README.md
│   │       ├── make/
│   │       │   └── Makefile
│   │       └── src/
│   │           ├── gtest-all.cc
│   │           ├── gtest-death-test.cc
│   │           ├── gtest-filepath.cc
│   │           ├── gtest-internal-inl.h
│   │           ├── gtest-port.cc
│   │           ├── gtest-printers.cc
│   │           ├── gtest-test-part.cc
│   │           ├── gtest-typed-test.cc
│   │           ├── gtest.cc
│   │           └── gtest_main.cc
│   ├── ir/
│   │   ├── __init__.py
│   │   ├── class_ir.py
│   │   ├── deps.py
│   │   ├── func_ir.py
│   │   ├── module_ir.py
│   │   ├── ops.py
│   │   ├── pprint.py
│   │   └── rtypes.py
│   ├── irbuild/
│   │   ├── __init__.py
│   │   ├── ast_helpers.py
│   │   ├── builder.py
│   │   ├── callable_class.py
│   │   ├── classdef.py
│   │   ├── constant_fold.py
│   │   ├── context.py
│   │   ├── env_class.py
│   │   ├── expression.py
│   │   ├── for_helpers.py
│   │   ├── format_str_tokenizer.py
│   │   ├── function.py
│   │   ├── generator.py
│   │   ├── ll_builder.py
│   │   ├── main.py
│   │   ├── mapper.py
│   │   ├── match.py
│   │   ├── missingtypevisitor.py
│   │   ├── nonlocalcontrol.py
│   │   ├── prebuildvisitor.py
│   │   ├── prepare.py
│   │   ├── specialize.py
│   │   ├── statement.py
│   │   ├── targets.py
│   │   ├── util.py
│   │   ├── vec.py
│   │   ├── visitor.py
│   │   └── vtable.py
│   ├── lib-rt/
│   │   ├── CPy.h
│   │   ├── base64/
│   │   │   ├── arch/
│   │   │   │   ├── avx/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   └── enc_loop_asm.c
│   │   │   │   ├── avx2/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── dec_loop.c
│   │   │   │   │   ├── dec_reshuffle.c
│   │   │   │   │   ├── enc_loop.c
│   │   │   │   │   ├── enc_loop_asm.c
│   │   │   │   │   ├── enc_reshuffle.c
│   │   │   │   │   └── enc_translate.c
│   │   │   │   ├── avx512/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── enc_loop.c
│   │   │   │   │   └── enc_reshuffle_translate.c
│   │   │   │   ├── generic/
│   │   │   │   │   ├── 32/
│   │   │   │   │   │   ├── dec_loop.c
│   │   │   │   │   │   └── enc_loop.c
│   │   │   │   │   ├── 64/
│   │   │   │   │   │   └── enc_loop.c
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── dec_head.c
│   │   │   │   │   ├── dec_tail.c
│   │   │   │   │   ├── enc_head.c
│   │   │   │   │   └── enc_tail.c
│   │   │   │   ├── neon32/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── dec_loop.c
│   │   │   │   │   ├── enc_loop.c
│   │   │   │   │   ├── enc_reshuffle.c
│   │   │   │   │   └── enc_translate.c
│   │   │   │   ├── neon64/
│   │   │   │   │   ├── codec.c
│   │   │   │   │   ├── dec_loop.c
│   │   │   │   │   ├── enc_loop.c
│   │   │   │   │   ├── enc_loop_asm.c
│   │   │   │   │   └── enc_reshuffle.c
│   │   │   │   ├── sse41/
│   │   │   │   │   └── codec.c
│   │   │   │   ├── sse42/
│   │   │   │   │   └── codec.c
│   │   │   │   └── ssse3/
│   │   │   │       ├── codec.c
│   │   │   │       ├── dec_loop.c
│   │   │   │       ├── dec_reshuffle.c
│   │   │   │       ├── enc_loop.c
│   │   │   │       ├── enc_loop_asm.c
│   │   │   │       ├── enc_reshuffle.c
│   │   │   │       └── enc_translate.c
│   │   │   ├── codec_choose.c
│   │   │   ├── codecs.h
│   │   │   ├── config.h
│   │   │   ├── env.h
│   │   │   ├── lib.c
│   │   │   ├── lib_openmp.c
│   │   │   ├── libbase64.h
│   │   │   ├── librt_base64.c
│   │   │   ├── librt_base64.h
│   │   │   └── tables/
│   │   │       ├── table_dec_32bit.h
│   │   │       ├── table_enc_12bit.h
│   │   │       ├── tables.c
│   │   │       └── tables.h
│   │   ├── build_setup.py
│   │   ├── bytearray_extra_ops.c
│   │   ├── bytearray_extra_ops.h
│   │   ├── bytes_extra_ops.c
│   │   ├── bytes_extra_ops.h
│   │   ├── bytes_ops.c
│   │   ├── byteswriter_extra_ops.c
│   │   ├── byteswriter_extra_ops.h
│   │   ├── dict_ops.c
│   │   ├── exc_ops.c
│   │   ├── float_ops.c
│   │   ├── function_wrapper.c
│   │   ├── generic_ops.c
│   │   ├── getargs.c
│   │   ├── getargsfast.c
│   │   ├── init.c
│   │   ├── int_ops.c
│   │   ├── internal/
│   │   │   ├── librt_internal.c
│   │   │   └── librt_internal.h
│   │   ├── list_ops.c
│   │   ├── misc_ops.c
│   │   ├── module_shim.tmpl
│   │   ├── module_shim_no_gil_multiphase.tmpl
│   │   ├── mypyc_util.h
│   │   ├── pythoncapi_compat.h
│   │   ├── pythonsupport.c
│   │   ├── pythonsupport.h
│   │   ├── set_ops.c
│   │   ├── setup.py
│   │   ├── static_data.c
│   │   ├── static_data.h
│   │   ├── str_extra_ops.c
│   │   ├── str_extra_ops.h
│   │   ├── str_ops.c
│   │   ├── strings/
│   │   │   ├── librt_strings.c
│   │   │   ├── librt_strings.h
│   │   │   └── librt_strings_common.h
│   │   ├── stringwriter_extra_ops.c
│   │   ├── stringwriter_extra_ops.h
│   │   ├── test_capi.cc
│   │   ├── time/
│   │   │   ├── librt_time.c
│   │   │   └── librt_time.h
│   │   ├── tuple_ops.c
│   │   ├── vecs/
│   │   │   ├── librt_vecs.c
│   │   │   ├── librt_vecs.h
│   │   │   ├── vec_bool.c
│   │   │   ├── vec_float.c
│   │   │   ├── vec_i16.c
│   │   │   ├── vec_i32.c
│   │   │   ├── vec_i64.c
│   │   │   ├── vec_nested.c
│   │   │   ├── vec_t.c
│   │   │   ├── vec_template.c
│   │   │   ├── vec_u8.c
│   │   │   └── vecs_internal.h
│   │   ├── vecs_extra_ops.c
│   │   └── vecs_extra_ops.h
│   ├── lower/
│   │   ├── __init__.py
│   │   ├── int_ops.py
│   │   ├── list_ops.py
│   │   ├── misc_ops.py
│   │   └── registry.py
│   ├── namegen.py
│   ├── options.py
│   ├── primitives/
│   │   ├── __init__.py
│   │   ├── bytearray_ops.py
│   │   ├── bytes_ops.py
│   │   ├── dict_ops.py
│   │   ├── exc_ops.py
│   │   ├── float_ops.py
│   │   ├── generic_ops.py
│   │   ├── int_ops.py
│   │   ├── librt_strings_ops.py
│   │   ├── librt_time_ops.py
│   │   ├── librt_vecs_ops.py
│   │   ├── list_ops.py
│   │   ├── misc_ops.py
│   │   ├── registry.py
│   │   ├── set_ops.py
│   │   ├── str_ops.py
│   │   ├── tuple_ops.py
│   │   └── weakref_ops.py
│   ├── py.typed
│   ├── rt_subtype.py
│   ├── sametype.py
│   ├── subtype.py
│   ├── test/
│   │   ├── __init__.py
│   │   ├── config.py
│   │   ├── librt_cache.py
│   │   ├── test_alwaysdefined.py
│   │   ├── test_analysis.py
│   │   ├── test_annotate.py
│   │   ├── test_capsule_deps.py
│   │   ├── test_cheader.py
│   │   ├── test_commandline.py
│   │   ├── test_emit.py
│   │   ├── test_emitclass.py
│   │   ├── test_emitfunc.py
│   │   ├── test_emitwrapper.py
│   │   ├── test_exceptions.py
│   │   ├── test_external.py
│   │   ├── test_irbuild.py
│   │   ├── test_ircheck.py
│   │   ├── test_literals.py
│   │   ├── test_lowering.py
│   │   ├── test_misc.py
│   │   ├── test_namegen.py
│   │   ├── test_optimizations.py
│   │   ├── test_pprint.py
│   │   ├── test_rarray.py
│   │   ├── test_refcount.py
│   │   ├── test_run.py
│   │   ├── test_serialization.py
│   │   ├── test_struct.py
│   │   ├── test_tuplename.py
│   │   ├── test_typeops.py
│   │   └── testutil.py
│   ├── test-data/
│   │   ├── alwaysdefined.test
│   │   ├── analysis.test
│   │   ├── annotate-basic.test
│   │   ├── capsule-deps.test
│   │   ├── commandline.test
│   │   ├── driver/
│   │   │   └── driver.py
│   │   ├── exceptions-freq.test
│   │   ├── exceptions.test
│   │   ├── fixtures/
│   │   │   ├── ir.py
│   │   │   ├── testutil.py
│   │   │   └── typing-full.pyi
│   │   ├── irbuild-any.test
│   │   ├── irbuild-base64.test
│   │   ├── irbuild-basic.test
│   │   ├── irbuild-bool.test
│   │   ├── irbuild-bytes.test
│   │   ├── irbuild-classes.test
│   │   ├── irbuild-constant-fold.test
│   │   ├── irbuild-dict.test
│   │   ├── irbuild-dunders.test
│   │   ├── irbuild-float.test
│   │   ├── irbuild-frozenset.test
│   │   ├── irbuild-generics.test
│   │   ├── irbuild-glue-methods.test
│   │   ├── irbuild-i16.test
│   │   ├── irbuild-i32.test
│   │   ├── irbuild-i64.test
│   │   ├── irbuild-int.test
│   │   ├── irbuild-isinstance.test
│   │   ├── irbuild-librt-strings.test
│   │   ├── irbuild-lists.test
│   │   ├── irbuild-match.test
│   │   ├── irbuild-math.test
│   │   ├── irbuild-nested.test
│   │   ├── irbuild-optional.test
│   │   ├── irbuild-python314.test
│   │   ├── irbuild-set.test
│   │   ├── irbuild-singledispatch.test
│   │   ├── irbuild-statements.test
│   │   ├── irbuild-str.test
│   │   ├── irbuild-strip-asserts.test
│   │   ├── irbuild-time.test
│   │   ├── irbuild-try.test
│   │   ├── irbuild-tuple.test
│   │   ├── irbuild-u8.test
│   │   ├── irbuild-unreachable.test
│   │   ├── irbuild-vec-i64.test
│   │   ├── irbuild-vec-misc.test
│   │   ├── irbuild-vec-nested.test
│   │   ├── irbuild-vec-t.test
│   │   ├── irbuild-vectorcall.test
│   │   ├── irbuild-weakref.test
│   │   ├── lowering-int.test
│   │   ├── lowering-list.test
│   │   ├── opt-copy-propagation.test
│   │   ├── opt-flag-elimination.test
│   │   ├── refcount.test
│   │   ├── run-async.test
│   │   ├── run-attrs.test
│   │   ├── run-base64.test
│   │   ├── run-bench.test
│   │   ├── run-bools.test
│   │   ├── run-bytes.test
│   │   ├── run-classes.test
│   │   ├── run-dicts.test
│   │   ├── run-dunders-special.test
│   │   ├── run-dunders.test
│   │   ├── run-exceptions.test
│   │   ├── run-floats.test
│   │   ├── run-functions.test
│   │   ├── run-generators.test
│   │   ├── run-generics.test
│   │   ├── run-i16.test
│   │   ├── run-i32.test
│   │   ├── run-i64.test
│   │   ├── run-imports.test
│   │   ├── run-integers.test
│   │   ├── run-librt-strings.test
│   │   ├── run-librt-time.test
│   │   ├── run-lists.test
│   │   ├── run-loops.test
│   │   ├── run-match.test
│   │   ├── run-math.test
│   │   ├── run-misc.test
│   │   ├── run-multimodule.test
│   │   ├── run-mypy-sim.test
│   │   ├── run-primitives.test
│   │   ├── run-python312.test
│   │   ├── run-python37.test
│   │   ├── run-python38.test
│   │   ├── run-sets.test
│   │   ├── run-signatures.test
│   │   ├── run-singledispatch.test
│   │   ├── run-strings.test
│   │   ├── run-traits.test
│   │   ├── run-tuples.test
│   │   ├── run-u8.test
│   │   ├── run-vecs-i64-interp.test
│   │   ├── run-vecs-i64.test
│   │   ├── run-vecs-misc-interp.test
│   │   ├── run-vecs-misc.test
│   │   ├── run-vecs-nested-interp.test
│   │   ├── run-vecs-nested.test
│   │   ├── run-vecs-t-interp.test
│   │   ├── run-vecs-t.test
│   │   └── run-weakref.test
│   └── transform/
│       ├── __init__.py
│       ├── copy_propagation.py
│       ├── exceptions.py
│       ├── flag_elimination.py
│       ├── ir_transform.py
│       ├── log_trace.py
│       ├── lower.py
│       ├── refcount.py
│       ├── spill.py
│       └── uninit.py
├── pyproject.toml
├── runtests.py
├── setup.py
├── test-data/
│   ├── packages/
│   │   ├── modulefinder/
│   │   │   ├── nsx-pkg1/
│   │   │   │   └── nsx/
│   │   │   │       └── a/
│   │   │   │           └── __init__.py
│   │   │   ├── nsx-pkg2/
│   │   │   │   └── nsx/
│   │   │   │       └── b/
│   │   │   │           └── __init__.py
│   │   │   ├── nsx-pkg3/
│   │   │   │   └── nsx/
│   │   │   │       └── c/
│   │   │   │           ├── c
│   │   │   │           └── c.py
│   │   │   ├── nsy-pkg1/
│   │   │   │   └── nsy/
│   │   │   │       └── a/
│   │   │   │           ├── __init__.py
│   │   │   │           └── __init__.pyi
│   │   │   ├── nsy-pkg2/
│   │   │   │   └── nsy/
│   │   │   │       ├── b/
│   │   │   │       │   └── __init__.py
│   │   │   │       ├── b.pyi
│   │   │   │       ├── c.py
│   │   │   │       └── c.pyi
│   │   │   ├── pkg1/
│   │   │   │   ├── a
│   │   │   │   └── a.py
│   │   │   ├── pkg2/
│   │   │   │   └── b/
│   │   │   │       └── __init__.py
│   │   │   └── readme.txt
│   │   ├── modulefinder-site-packages/
│   │   │   ├── baz/
│   │   │   │   ├── baz_pkg/
│   │   │   │   │   ├── __init__.py
│   │   │   │   │   └── py.typed
│   │   │   │   └── ns_baz_pkg/
│   │   │   │       ├── a.py
│   │   │   │       └── py.typed
│   │   │   ├── foo/
│   │   │   │   ├── __init__.py
│   │   │   │   └── bar.py
│   │   │   ├── foo-stubs/
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── bar.pyi
│   │   │   │   └── qux.pyi
│   │   │   ├── ns_pkg_typed/
│   │   │   │   ├── a.py
│   │   │   │   ├── b/
│   │   │   │   │   └── c.py
│   │   │   │   └── py.typed
│   │   │   ├── ns_pkg_untyped/
│   │   │   │   ├── a.py
│   │   │   │   └── b/
│   │   │   │       └── c.py
│   │   │   ├── ns_pkg_w_stubs/
│   │   │   │   ├── typed/
│   │   │   │   │   └── __init__.py
│   │   │   │   ├── typed_inline/
│   │   │   │   │   ├── __init__.py
│   │   │   │   │   └── py.typed
│   │   │   │   └── untyped/
│   │   │   │       └── __init__.py
│   │   │   ├── ns_pkg_w_stubs-stubs/
│   │   │   │   └── typed/
│   │   │   │       └── __init__.pyi
│   │   │   ├── pkg_typed/
│   │   │   │   ├── __init__.py
│   │   │   │   ├── a.py
│   │   │   │   ├── b/
│   │   │   │   │   ├── __init__.py
│   │   │   │   │   └── c.py
│   │   │   │   └── py.typed
│   │   │   ├── pkg_typed_w_stubs/
│   │   │   │   ├── __init__.py
│   │   │   │   ├── __init__.pyi
│   │   │   │   ├── py.typed
│   │   │   │   ├── spam.py
│   │   │   │   └── spam.pyi
│   │   │   ├── pkg_typed_w_stubs-stubs/
│   │   │   │   ├── __init__.pyi
│   │   │   │   └── spam.pyi
│   │   │   ├── pkg_untyped/
│   │   │   │   ├── __init__.py
│   │   │   │   ├── a.py
│   │   │   │   └── b/
│   │   │   │       ├── __init__.py
│   │   │   │       └── c.py
│   │   │   └── standalone.py
│   │   ├── modulefinder-src/
│   │   │   ├── neighbor_pkg/
│   │   │   │   ├── __init__.py
│   │   │   │   └── py.typed
│   │   │   └── ns_neighbor_pkg/
│   │   │       ├── a.py
│   │   │       └── py.typed
│   │   ├── typedpkg/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg/
│   │   │       ├── __init__.py
│   │   │       ├── dne.py
│   │   │       ├── pkg/
│   │   │       │   ├── __init__.py
│   │   │       │   ├── aaa.py
│   │   │       │   └── py.typed
│   │   │       ├── py.typed
│   │   │       └── sample.py
│   │   ├── typedpkg-stubs/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg-stubs/
│   │   │       ├── __init__.pyi
│   │   │       ├── py.typed
│   │   │       └── sample.pyi
│   │   ├── typedpkg_ns_a/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg_ns/
│   │   │       ├── __init__.py
│   │   │       └── a/
│   │   │           ├── __init__.py
│   │   │           ├── bbb.py
│   │   │           └── py.typed
│   │   ├── typedpkg_ns_b/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg_ns/
│   │   │       ├── __init__.py
│   │   │       └── b/
│   │   │           ├── __init__.py
│   │   │           └── bbb.py
│   │   ├── typedpkg_ns_b-stubs/
│   │   │   ├── pyproject.toml
│   │   │   └── typedpkg_ns-stubs/
│   │   │       └── b/
│   │   │           ├── __init__.pyi
│   │   │           └── bbb.pyi
│   │   └── typedpkg_ns_nested/
│   │       ├── pyproject.toml
│   │       └── typedpkg_ns/
│   │           ├── a/
│   │           │   ├── __init__.py
│   │           │   └── py.typed
│   │           └── b/
│   │               └── __init__.py
│   ├── pybind11_fixtures/
│   │   ├── expected_stubs_no_docs/
│   │   │   └── pybind11_fixtures/
│   │   │       ├── __init__.pyi
│   │   │       └── demo.pyi
│   │   ├── expected_stubs_with_docs/
│   │   │   └── pybind11_fixtures/
│   │   │       ├── __init__.pyi
│   │   │       └── demo.pyi
│   │   ├── pyproject.toml
│   │   ├── setup.py
│   │   └── src/
│   │       └── main.cpp
│   └── unit/
│       ├── README.md
│       ├── check-abstract.test
│       ├── check-annotated.test
│       ├── check-assert-type-fail.test
│       ├── check-async-await.test
│       ├── check-basic.test
│       ├── check-bound.test
│       ├── check-callable.test
│       ├── check-class-namedtuple.test
│       ├── check-classes.test
│       ├── check-classvar.test
│       ├── check-columns.test
│       ├── check-ctypes.test
│       ├── check-custom-plugin.test
│       ├── check-dataclass-transform.test
│       ├── check-dataclasses.test
│       ├── check-deprecated.test
│       ├── check-dynamic-typing.test
│       ├── check-enum.test
│       ├── check-errorcodes.test
│       ├── check-expressions.test
│       ├── check-fastparse.test
│       ├── check-final.test
│       ├── check-flags.test
│       ├── check-formatting.test
│       ├── check-functions.test
│       ├── check-functools.test
│       ├── check-generic-alias.test
│       ├── check-generic-subtyping.test
│       ├── check-generics.test
│       ├── check-ignore.test
│       ├── check-incomplete-fixture.test
│       ├── check-incremental.test
│       ├── check-inference-context.test
│       ├── check-inference.test
│       ├── check-inline-config.test
│       ├── check-isinstance.test
│       ├── check-itertools.test
│       ├── check-kwargs.test
│       ├── check-lists.test
│       ├── check-literal.test
│       ├── check-lowercase.test
│       ├── check-modules-case.test
│       ├── check-modules-fast.test
│       ├── check-modules.test
│       ├── check-multiple-inheritance.test
│       ├── check-namedtuple.test
│       ├── check-narrowing.test
│       ├── check-native-int.test
│       ├── check-newsemanal.test
│       ├── check-newsyntax.test
│       ├── check-newtype.test
│       ├── check-optional.test
│       ├── check-overloading.test
│       ├── check-parameter-specification.test
│       ├── check-plugin-attrs.test
│       ├── check-plugin-error-codes.test
│       ├── check-possibly-undefined.test
│       ├── check-protocols.test
│       ├── check-python310.test
│       ├── check-python311.test
│       ├── check-python312.test
│       ├── check-python313.test
│       ├── check-python314.test
│       ├── check-python38.test
│       ├── check-python39.test
│       ├── check-recursive-types.test
│       ├── check-redefine.test
│       ├── check-redefine2.test
│       ├── check-reports.test
│       ├── check-selftype.test
│       ├── check-semanal-error.test
│       ├── check-serialize.test
│       ├── check-singledispatch.test
│       ├── check-slots.test
│       ├── check-statements.test
│       ├── check-super.test
│       ├── check-tuples.test
│       ├── check-type-aliases.test
│       ├── check-type-checks.test
│       ├── check-type-object-type-inference.test
│       ├── check-type-promotion.test
│       ├── check-typeddict.test
│       ├── check-typeform.test
│       ├── check-typeguard.test
│       ├── check-typeis.test
│       ├── check-typevar-defaults.test
│       ├── check-typevar-tuple.test
│       ├── check-typevar-unbound.test
│       ├── check-typevar-values.test
│       ├── check-underscores.test
│       ├── check-union-error-syntax.test
│       ├── check-union-or-syntax.test
│       ├── check-unions.test
│       ├── check-unreachable-code.test
│       ├── check-unsupported.test
│       ├── check-varargs.test
│       ├── check-vec.test
│       ├── check-warnings.test
│       ├── cmdline.pyproject.test
│       ├── cmdline.test
│       ├── daemon.test
│       ├── deps-classes.test
│       ├── deps-expressions.test
│       ├── deps-generics.test
│       ├── deps-statements.test
│       ├── deps-types.test
│       ├── deps.test
│       ├── diff.test
│       ├── envvars.test
│       ├── errorstream.test
│       ├── exportjson.test
│       ├── fine-grained-attr.test
│       ├── fine-grained-blockers.test
│       ├── fine-grained-cache-incremental.test
│       ├── fine-grained-cycles.test
│       ├── fine-grained-dataclass-transform.test
│       ├── fine-grained-dataclass.test
│       ├── fine-grained-follow-imports.test
│       ├── fine-grained-inspect.test
│       ├── fine-grained-modules.test
│       ├── fine-grained-python312.test
│       ├── fine-grained-python314.test
│       ├── fine-grained-suggest.test
│       ├── fine-grained.test
│       ├── fixtures/
│       │   ├── __init_subclass__.pyi
│       │   ├── __new__.pyi
│       │   ├── alias.pyi
│       │   ├── any.pyi
│       │   ├── args.pyi
│       │   ├── async_await.pyi
│       │   ├── bool.pyi
│       │   ├── callable.pyi
│       │   ├── classmethod.pyi
│       │   ├── complex.pyi
│       │   ├── complex_tuple.pyi
│       │   ├── dataclasses.pyi
│       │   ├── dict-full.pyi
│       │   ├── dict.pyi
│       │   ├── divmod.pyi
│       │   ├── enum.pyi
│       │   ├── exception.pyi
│       │   ├── f_string.pyi
│       │   ├── fine_grained.pyi
│       │   ├── float.pyi
│       │   ├── floatdict.pyi
│       │   ├── for.pyi
│       │   ├── for_else_exception.pyi
│       │   ├── function.pyi
│       │   ├── isinstance.pyi
│       │   ├── isinstance_python3_10.pyi
│       │   ├── isinstancelist.pyi
│       │   ├── len.pyi
│       │   ├── list.pyi
│       │   ├── literal__new__.pyi
│       │   ├── module.pyi
│       │   ├── module_all.pyi
│       │   ├── narrowing.pyi
│       │   ├── notimplemented.pyi
│       │   ├── object_hashable.pyi
│       │   ├── object_with_init_subclass.pyi
│       │   ├── ops.pyi
│       │   ├── paramspec.pyi
│       │   ├── plugin_attrs.pyi
│       │   ├── primitives.pyi
│       │   ├── property.pyi
│       │   ├── set.pyi
│       │   ├── slice.pyi
│       │   ├── staticmethod.pyi
│       │   ├── transform.pyi
│       │   ├── tuple-simple.pyi
│       │   ├── tuple-typeshed.pyi
│       │   ├── tuple.pyi
│       │   ├── type.pyi
│       │   ├── typing-async.pyi
│       │   ├── typing-full.pyi
│       │   ├── typing-medium.pyi
│       │   ├── typing-namedtuple.pyi
│       │   ├── typing-override.pyi
│       │   ├── typing-typeddict-iror.pyi
│       │   ├── typing-typeddict.pyi
│       │   └── union.pyi
│       ├── hacks.txt
│       ├── lib-stub/
│       │   ├── _decimal.pyi
│       │   ├── _typeshed.pyi
│       │   ├── _weakref.pyi
│       │   ├── abc.pyi
│       │   ├── attr/
│       │   │   ├── __init__.pyi
│       │   │   └── converters.pyi
│       │   ├── attrs/
│       │   │   ├── __init__.pyi
│       │   │   └── converters.pyi
│       │   ├── blocker.pyi
│       │   ├── blocker2.pyi
│       │   ├── broken.pyi
│       │   ├── builtins.pyi
│       │   ├── collections.pyi
│       │   ├── contextlib.pyi
│       │   ├── dataclasses.pyi
│       │   ├── datetime.pyi
│       │   ├── decimal.pyi
│       │   ├── enum.pyi
│       │   ├── functools.pyi
│       │   ├── future/
│       │   │   ├── __init__.pyi
│       │   │   └── utils.pyi
│       │   ├── math.pyi
│       │   ├── mypy_extensions.pyi
│       │   ├── native_internal.pyi
│       │   ├── numbers.pyi
│       │   ├── six.pyi
│       │   ├── string/
│       │   │   ├── __init__.pyi
│       │   │   └── templatelib.pyi
│       │   ├── sys.pyi
│       │   ├── traceback.pyi
│       │   ├── types.pyi
│       │   ├── typing.pyi
│       │   ├── typing_extensions.pyi
│       │   ├── unannotated_lib.pyi
│       │   └── weakref.pyi
│       ├── merge.test
│       ├── native-parser-imports.test
│       ├── native-parser.test
│       ├── outputjson.test
│       ├── parse-errors.test
│       ├── parse-python310.test
│       ├── parse-python312.test
│       ├── parse-python313.test
│       ├── parse-python314.test
│       ├── parse.test
│       ├── pep561.test
│       ├── plugins/
│       │   ├── add_classmethod.py
│       │   ├── add_method.py
│       │   ├── add_overloaded_method.py
│       │   ├── arg_kinds.py
│       │   ├── arg_names.py
│       │   ├── attrhook.py
│       │   ├── attrhook2.py
│       │   ├── badreturn.py
│       │   ├── badreturn2.py
│       │   ├── callable_instance.py
│       │   ├── class_attr_hook.py
│       │   ├── class_callable.py
│       │   ├── common_api_incremental.py
│       │   ├── config_data.py
│       │   ├── custom_errorcode.py
│       │   ├── customentry.py
│       │   ├── customize_mro.py
│       │   ├── decimal_to_int.py
│       │   ├── depshook.py
│       │   ├── descriptor.py
│       │   ├── dyn_class.py
│       │   ├── dyn_class_from_method.py
│       │   ├── fnplugin.py
│       │   ├── fully_qualified_test_hook.py
│       │   ├── function_sig_hook.py
│       │   ├── magic_method.py
│       │   ├── method_in_decorator.py
│       │   ├── method_sig_hook.py
│       │   ├── named_callable.py
│       │   ├── noentry.py
│       │   ├── plugin2.py
│       │   ├── type_anal_hook.py
│       │   └── union_method.py
│       ├── pythoneval-asyncio.test
│       ├── pythoneval.test
│       ├── ref-info.test
│       ├── reports.test
│       ├── semanal-abstractclasses.test
│       ├── semanal-basic.test
│       ├── semanal-classes.test
│       ├── semanal-classvar.test
│       ├── semanal-errors-python310.test
│       ├── semanal-errors.test
│       ├── semanal-expressions.test
│       ├── semanal-lambda.test
│       ├── semanal-literal.test
│       ├── semanal-modules.test
│       ├── semanal-namedtuple.test
│       ├── semanal-python310.test
│       ├── semanal-statements.test
│       ├── semanal-symtable.test
│       ├── semanal-typealiases.test
│       ├── semanal-typeddict.test
│       ├── semanal-typeinfo.test
│       ├── semanal-types.test
│       ├── stubgen.test
│       └── typexport-basic.test
├── test-requirements.in
├── test-requirements.txt
└── tox.ini
Copy disabled (too large) Download .json
Condensed preview — 1832 files, each showing path, character count, and a content snippet. Download the .json file for the full structured content (16,478K chars).
[
  {
    "path": ".editorconfig",
    "chars": 217,
    "preview": "root = true\n\n[*.{py,pyi,c,cpp,h,rst,md,yml,yaml,json,test}]\ntrim_trailing_whitespace = true\ninsert_final_newline = true\n"
  },
  {
    "path": ".git-blame-ignore-revs",
    "chars": 482,
    "preview": "# Adopt black and isort\n97c5ee99bc98dc475512e549b252b23a6e7e0997\n# Use builtin generics and PEP 604 for type annotations"
  },
  {
    "path": ".gitattributes",
    "chars": 96,
    "preview": "# We vendor typeshed from https://github.com/python/typeshed\nmypy/typeshed/** linguist-vendored\n"
  },
  {
    "path": ".github/ISSUE_TEMPLATE/bug.md",
    "chars": 1642,
    "preview": "---\nname: Bug Report\nabout: Submit a bug report\nlabels: \"bug\"\n---\n\n<!--\nIf you're not sure whether what you're experienc"
  },
  {
    "path": ".github/ISSUE_TEMPLATE/config.yml",
    "chars": 356,
    "preview": "contact_links:\n  - about: \"Please check the linked documentation page before filing new issues.\"\n    name: \"Common issue"
  },
  {
    "path": ".github/ISSUE_TEMPLATE/crash.md",
    "chars": 1199,
    "preview": "---\nname: Crash Report\nabout: Crash (traceback or \"INTERNAL ERROR\")\nlabels: \"crash\"\n---\n\n<!--\n  Use this form only if my"
  },
  {
    "path": ".github/ISSUE_TEMPLATE/documentation.md",
    "chars": 167,
    "preview": "---\nname: Documentation\nabout: Report a problem with the documentation\nlabels: \"documentation\"\n---\n\n**Documentation**\n\n("
  },
  {
    "path": ".github/ISSUE_TEMPLATE/feature.md",
    "chars": 310,
    "preview": "---\nname: Feature\nabout: Submit a proposal for a new mypy feature\nlabels: \"feature\"\n---\n\n**Feature**\n\n<!-- Enter a clear"
  },
  {
    "path": ".github/PULL_REQUEST_TEMPLATE.md",
    "chars": 453,
    "preview": "<!-- If this pull request fixes an issue, add \"Fixes #NNN\" with the issue number. -->\n\n(Explain how this PR changes mypy"
  },
  {
    "path": ".github/workflows/build_wheels.yml",
    "chars": 548,
    "preview": "name: Trigger wheel build\n\non:\n  push:\n    branches: [main, master, 'release*']\n    tags: ['*']\n\npermissions:\n  contents"
  },
  {
    "path": ".github/workflows/docs.yml",
    "chars": 1368,
    "preview": "name: Check documentation build\n\non:\n  workflow_dispatch:\n  push:\n    branches: [main, master, 'release*']\n    tags: ['*"
  },
  {
    "path": ".github/workflows/mypy_primer.yml",
    "chars": 2948,
    "preview": "name: Run mypy_primer\n\non:\n  # Only run on PR, since we diff against master\n  pull_request:\n    paths-ignore:\n    - 'doc"
  },
  {
    "path": ".github/workflows/mypy_primer_comment.yml",
    "chars": 3751,
    "preview": "name: Comment with mypy_primer diff\n\non:  # zizmor: ignore[dangerous-triggers]\n  workflow_run:\n    workflows:\n      - Ru"
  },
  {
    "path": ".github/workflows/sync_typeshed.yml",
    "chars": 984,
    "preview": "name: Sync typeshed\n\non:\n  workflow_dispatch:\n  schedule:\n    - cron: \"0 0 1,15 * *\"\n\npermissions: {}\n\njobs:\n  sync_type"
  },
  {
    "path": ".github/workflows/test.yml",
    "chars": 9720,
    "preview": "name: Tests\n\non:\n  workflow_dispatch:\n  push:\n    branches: [main, master, 'release*']\n    tags: ['*']\n  pull_request:\n "
  },
  {
    "path": ".github/workflows/test_stubgenc.yml",
    "chars": 878,
    "preview": "name: Test stubgenc on pybind11_fixtures\n\non:\n  workflow_dispatch:\n  push:\n    branches: [main, master, 'release*']\n    "
  },
  {
    "path": ".gitignore",
    "chars": 599,
    "preview": "build/\n__pycache__\n*.py[cod]\n*~\n/build\n/env*/\ndocs/build/\ndocs/source/_build\nmypyc/doc/_build\n*.iml\n/out/\n.venv*\nvenv/\n."
  },
  {
    "path": ".pre-commit-config.yaml",
    "chars": 2184,
    "preview": "exclude: '^(mypyc/external/)|(mypy/typeshed/)|misc/typeshed_patches'  # Exclude all vendored code from lints\nrepos:\n  - "
  },
  {
    "path": ".readthedocs.yaml",
    "chars": 323,
    "preview": "# Read the Docs configuration file\n# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details\n\nversion:"
  },
  {
    "path": "CHANGELOG.md",
    "chars": 261523,
    "preview": "# Mypy Release Notes\r\n\r\n## Next Release\r\n\r\n### Better narrowing\r\n\r\nMypy's implementation of narrowing has been substanti"
  },
  {
    "path": "CONTRIBUTING.md",
    "chars": 7922,
    "preview": "# Contributing to Mypy\n\nWelcome!  Mypy is a community project that aims to work for a wide\nrange of Python users and Pyt"
  },
  {
    "path": "CREDITS",
    "chars": 1234,
    "preview": "Credits\n-------\n\nFor a full list of contributors you can mine the commit history:\nhttps://github.com/python/mypy/commits"
  },
  {
    "path": "LICENSE",
    "chars": 12841,
    "preview": "Mypy (and mypyc) are licensed under the terms of the MIT license, reproduced below.\n\n= = = = =\n\nThe MIT License\n\nCopyrig"
  },
  {
    "path": "MANIFEST.in",
    "chars": 1183,
    "preview": "# some of the prunes here are so that check-manifest doesn't complain about their exclusion\n# as such, be judicious in y"
  },
  {
    "path": "README.md",
    "chars": 7607,
    "preview": "<img src=\"docs/source/mypy_light.svg\" alt=\"mypy logo\" width=\"300px\"/>\n\nMypy: Static Typing for Python\n=================="
  },
  {
    "path": "action.yml",
    "chars": 2648,
    "preview": "name: \"Mypy\"\ndescription: \"Optional Static Typing for Python.\"\nauthor: \"Jukka Lehtosalo and contributors\"\ninputs:\n  opti"
  },
  {
    "path": "build-requirements.txt",
    "chars": 136,
    "preview": "# NOTE: this needs to be kept in sync with the \"requires\" list in pyproject.toml\n-r mypy-requirements.txt\ntypes-psutil\nt"
  },
  {
    "path": "conftest.py",
    "chars": 585,
    "preview": "from __future__ import annotations\n\nimport os.path\n\npytest_plugins = [\"mypy.test.data\"]\n\n\ndef pytest_configure(config):\n"
  },
  {
    "path": "docs/Makefile",
    "chars": 6768,
    "preview": "# Makefile for Sphinx documentation\n#\n\n# You can set these variables from the command line.\nSPHINXOPTS    =\nSPHINXBUILD "
  },
  {
    "path": "docs/README.md",
    "chars": 1061,
    "preview": "Mypy Documentation\n==================\n\nWhat's this?\n------------\n\nThis directory contains the source code for Mypy docum"
  },
  {
    "path": "docs/make.bat",
    "chars": 6711,
    "preview": "@ECHO OFF\r\n\r\nREM Command file for Sphinx documentation\r\n\r\nif \"%SPHINXBUILD%\" == \"\" (\r\n\tset SPHINXBUILD=sphinx-build\r\n)\r\n"
  },
  {
    "path": "docs/requirements-docs.txt",
    "chars": 107,
    "preview": "-r ../mypy-requirements.txt\nsphinx>=8.1.0\nfuro>=2022.3.4\nmyst-parser>=4.0.0\nsphinx_inline_tabs>=2023.04.21\n"
  },
  {
    "path": "docs/source/additional_features.rst",
    "chars": 16565,
    "preview": "Additional features\n-------------------\n\nThis section discusses various features that did not fit in naturally in one\nof"
  },
  {
    "path": "docs/source/builtin_types.rst",
    "chars": 4133,
    "preview": "Built-in types\n==============\n\nThis chapter introduces some commonly used built-in types. We will\ncover many other kinds"
  },
  {
    "path": "docs/source/changelog.md",
    "chars": 106,
    "preview": "<!-- This file includes mypy/CHANGELOG.md into mypy documentation -->\n```{include} ../../CHANGELOG.md\n```\n"
  },
  {
    "path": "docs/source/cheat_sheet_py3.rst",
    "chars": 13325,
    "preview": ".. _cheat-sheet-py3:\n\nType hints cheat sheet\n======================\n\nThis document is a quick cheat sheet showing how to"
  },
  {
    "path": "docs/source/class_basics.rst",
    "chars": 12606,
    "preview": ".. _class-basics:\n\nClass basics\n============\n\nThis section will help get you started annotating your\nclasses. Built-in c"
  },
  {
    "path": "docs/source/command_line.rst",
    "chars": 47123,
    "preview": ".. _command-line:\n\n.. program:: mypy\n\nThe mypy command line\n=====================\n\nThis section documents mypy's command"
  },
  {
    "path": "docs/source/common_issues.rst",
    "chars": 28480,
    "preview": ".. _common_issues:\n\nCommon issues and solutions\n===========================\n\nThis section has examples of cases when you"
  },
  {
    "path": "docs/source/conf.py",
    "chars": 9471,
    "preview": "# -*- coding: utf-8 -*-\n#\n# Mypy documentation build configuration file, created by\n# sphinx-quickstart on Sun Sep 14 19"
  },
  {
    "path": "docs/source/config_file.rst",
    "chars": 38746,
    "preview": ".. _config-file:\n\nThe mypy configuration file\n===========================\n\nMypy is very configurable. This is most usefu"
  },
  {
    "path": "docs/source/duck_type_compatibility.rst",
    "chars": 1395,
    "preview": "Duck type compatibility\n-----------------------\n\nIn Python, certain types are compatible even though they aren't subclas"
  },
  {
    "path": "docs/source/dynamic_typing.rst",
    "chars": 4597,
    "preview": ".. _dynamic-typing:\n\nDynamically typed code\n======================\n\nIn :ref:`getting-started-dynamic-vs-static`, we disc"
  },
  {
    "path": "docs/source/error_code_list.rst",
    "chars": 42785,
    "preview": ".. _error-code-list:\n\nError codes enabled by default\n==============================\n\nThis section documents various erro"
  },
  {
    "path": "docs/source/error_code_list2.rst",
    "chars": 22452,
    "preview": ".. _error-codes-optional:\n\nError codes for optional checks\n===============================\n\nThis section documents vario"
  },
  {
    "path": "docs/source/error_codes.rst",
    "chars": 4161,
    "preview": ".. _error-codes:\n\nError codes\n===========\n\nMypy can optionally display an error code such as ``[attr-defined]``\nafter ea"
  },
  {
    "path": "docs/source/existing_code.rst",
    "chars": 9911,
    "preview": ".. _existing-code:\n\nUsing mypy with an existing codebase\n====================================\n\nThis section explains how"
  },
  {
    "path": "docs/source/extending_mypy.rst",
    "chars": 9632,
    "preview": ".. _extending-mypy:\n\nExtending and integrating mypy\n==============================\n\n.. _integrating-mypy:\n\nIntegrating m"
  },
  {
    "path": "docs/source/faq.rst",
    "chars": 9222,
    "preview": "Frequently Asked Questions\n==========================\n\nWhy have both dynamic and static typing?\n************************"
  },
  {
    "path": "docs/source/final_attrs.rst",
    "chars": 7038,
    "preview": ".. _final_attrs:\n\nFinal names, methods and classes\n================================\n\nThis section introduces these relat"
  },
  {
    "path": "docs/source/generics.rst",
    "chars": 46018,
    "preview": "Generics\n========\n\nThis section explains how you can define your own generic classes that take\none or more type argument"
  },
  {
    "path": "docs/source/getting_started.rst",
    "chars": 13422,
    "preview": ".. _getting-started:\n\nGetting started\n===============\n\nThis chapter introduces some core concepts of mypy, including fun"
  },
  {
    "path": "docs/source/html_builder.py",
    "chars": 2789,
    "preview": "from __future__ import annotations\n\nimport json\nimport os\nimport textwrap\nfrom pathlib import Path\nfrom typing import An"
  },
  {
    "path": "docs/source/index.rst",
    "chars": 3038,
    "preview": ".. Mypy documentation master file, created by\n   sphinx-quickstart on Sun Sep 14 19:50:35 2014.\n   You can adapt this fi"
  },
  {
    "path": "docs/source/inline_config.rst",
    "chars": 1164,
    "preview": ".. _inline-config:\n\nInline configuration\n====================\n\nMypy supports setting per-file configuration options insi"
  },
  {
    "path": "docs/source/installed_packages.rst",
    "chars": 6559,
    "preview": ".. _installed-packages:\n\nUsing installed packages\n========================\n\nPackages installed with pip can declare that"
  },
  {
    "path": "docs/source/kinds_of_types.rst",
    "chars": 24362,
    "preview": "Kinds of types\n==============\n\nWe've mostly restricted ourselves to built-in types until now. This\nsection introduces se"
  },
  {
    "path": "docs/source/literal_types.rst",
    "chars": 17111,
    "preview": "Literal types and Enums\n=======================\n\n.. _literal_types:\n\nLiteral types\n-------------\n\nLiteral types let you "
  },
  {
    "path": "docs/source/metaclasses.rst",
    "chars": 3481,
    "preview": ".. _metaclasses:\n\nMetaclasses\n===========\n\nA :ref:`metaclass <python:metaclasses>` is a class that describes\nthe constru"
  },
  {
    "path": "docs/source/more_types.rst",
    "chars": 33993,
    "preview": "More types\n==========\n\nThis section introduces a few additional kinds of types, including :py:data:`~typing.NoReturn`,\n:"
  },
  {
    "path": "docs/source/mypy_daemon.rst",
    "chars": 14923,
    "preview": ".. _mypy_daemon:\n\n.. program:: dmypy\n\nMypy daemon (mypy server)\n=========================\n\nInstead of running mypy as a "
  },
  {
    "path": "docs/source/protocols.rst",
    "chars": 18371,
    "preview": ".. _protocol-types:\n\nProtocols and structural subtyping\n==================================\n\nThe Python type system suppo"
  },
  {
    "path": "docs/source/running_mypy.rst",
    "chars": 25248,
    "preview": ".. _running-mypy:\n\nRunning mypy and managing imports\n=================================\n\nThe :ref:`getting-started` page "
  },
  {
    "path": "docs/source/runtime_troubles.rst",
    "chars": 12147,
    "preview": ".. _runtime_troubles:\n\nAnnotation issues at runtime\n============================\n\nIdiomatic use of type annotations can "
  },
  {
    "path": "docs/source/stubgen.rst",
    "chars": 6640,
    "preview": ".. _stubgen:\n\n.. program:: stubgen\n\nAutomatic stub generation (stubgen)\n===================================\n\nA stub file"
  },
  {
    "path": "docs/source/stubs.rst",
    "chars": 5011,
    "preview": ".. _stub-files:\n\nStub files\n==========\n\nA *stub file* is a file containing a skeleton of the public interface\nof that Py"
  },
  {
    "path": "docs/source/stubtest.rst",
    "chars": 7294,
    "preview": ".. _stubtest:\n\n.. program:: stubtest\n\nAutomatic stub testing (stubtest)\n=================================\n\nStub files ar"
  },
  {
    "path": "docs/source/supported_python_features.rst",
    "chars": 937,
    "preview": "Supported Python features\n=========================\n\nA list of unsupported Python features is maintained in the mypy wik"
  },
  {
    "path": "docs/source/type_inference_and_annotations.rst",
    "chars": 9388,
    "preview": ".. _type-inference-and-annotations:\n\nType inference and type annotations\n===================================\n\nType infer"
  },
  {
    "path": "docs/source/type_narrowing.rst",
    "chars": 17731,
    "preview": ".. _type-narrowing:\n\nType narrowing\n==============\n\nThis section is dedicated to several type narrowing\ntechniques which"
  },
  {
    "path": "docs/source/typed_dict.rst",
    "chars": 11491,
    "preview": ".. _typeddict:\n\nTypedDict\n*********\n\nPython programs often use dictionaries with string keys to represent objects.\n``Typ"
  },
  {
    "path": "misc/analyze_cache.py",
    "chars": 6190,
    "preview": "#!/usr/bin/env python\n\nfrom __future__ import annotations\n\nimport json\nimport os\nimport os.path\nfrom collections import "
  },
  {
    "path": "misc/analyze_typeform_stats.py",
    "chars": 3207,
    "preview": "#!/usr/bin/env python3\n\"\"\"\nAnalyze TypeForm parsing efficiency from mypy build stats.\n\nUsage:\n    python3 analyze_typefo"
  },
  {
    "path": "misc/apply-cache-diff.py",
    "chars": 2355,
    "preview": "#!/usr/bin/env python3\n\"\"\"Script for applying a cache diff.\n\nWith some infrastructure, this can allow for distributing s"
  },
  {
    "path": "misc/build-debug-python.sh",
    "chars": 1215,
    "preview": "#!/bin/bash -eux\n\n# Build a debug build of python, install it, and create a venv for it\n# This is mainly intended for us"
  },
  {
    "path": "misc/build_wheel.py",
    "chars": 517,
    "preview": "\"\"\"\nThe main GitHub workflow where wheels are built:\nhttps://github.com/mypyc/mypy_mypyc-wheels/blob/master/.github/work"
  },
  {
    "path": "misc/cherry-pick-typeshed.py",
    "chars": 1977,
    "preview": "\"\"\"Cherry-pick a commit from typeshed.\n\nUsage:\n\n  python3 misc/cherry-pick-typeshed.py --typeshed-dir dir hash\n\"\"\"\n\nfrom"
  },
  {
    "path": "misc/clean-mypyc.sh",
    "chars": 131,
    "preview": "#!/bin/bash\necho \"Cleaning C/C++ build artifacts...\"\n(cd mypyc/lib-rt; make clean)\n(cd mypyc/external/googletest/make; m"
  },
  {
    "path": "misc/convert-cache.py",
    "chars": 1904,
    "preview": "#!/usr/bin/env python3\n\"\"\"Script for converting between cache formats.\n\nWe support a filesystem tree based cache and a s"
  },
  {
    "path": "misc/diff-cache.py",
    "chars": 7605,
    "preview": "#!/usr/bin/env python3\n\"\"\"Produce a diff between mypy caches.\n\nWith some infrastructure, this can allow for distributing"
  },
  {
    "path": "misc/docker/Dockerfile",
    "chars": 235,
    "preview": "FROM ubuntu:latest\n\nWORKDIR /mypy\n\nRUN apt-get update\nRUN apt-get install -y python3 python3-pip clang\n\nCOPY mypy-requir"
  },
  {
    "path": "misc/docker/README.md",
    "chars": 2627,
    "preview": "Running mypy and mypyc tests in a Docker container\n==================================================\n\nThis directory co"
  },
  {
    "path": "misc/docker/build.py",
    "chars": 1498,
    "preview": "\"\"\"Build a \"mypy-test\" Linux Docker container for running mypy/mypyc tests.\n\nThis allows running Linux tests under a non"
  },
  {
    "path": "misc/docker/run-wrapper.sh",
    "chars": 490,
    "preview": "#!/bin/bash\n# Internal wrapper script used to run commands in a container\n\n# Copy all the files we need from the mypy re"
  },
  {
    "path": "misc/docker/run.sh",
    "chars": 489,
    "preview": "#!/bin/bash\n# Run mypy or mypyc tests in a Docker container that was built using misc/docker/build.py.\n#\n# Usage: misc/d"
  },
  {
    "path": "misc/dump-ast.py",
    "chars": 1320,
    "preview": "#!/usr/bin/env python3\n\"\"\"\nParse source files and print the abstract syntax trees.\n\"\"\"\n\nfrom __future__ import annotatio"
  },
  {
    "path": "misc/find_type.py",
    "chars": 3518,
    "preview": "#!/usr/bin/env python3\n# Usage: find_type.py FILENAME START_LINE START_COL END_LINE END_COL MYPY_AND_ARGS\n# Prints out t"
  },
  {
    "path": "misc/gen_blog_post_html.py",
    "chars": 5890,
    "preview": "\"\"\"Converter from CHANGELOG.md (Markdown) to HTML suitable for a mypy blog post.\n\nHow to use:\n\n1. Write release notes in"
  },
  {
    "path": "misc/generate_changelog.py",
    "chars": 6831,
    "preview": "\"\"\"Generate the changelog for a mypy release.\"\"\"\n\nfrom __future__ import annotations\n\nimport argparse\nimport re\nimport s"
  },
  {
    "path": "misc/incremental_checker.py",
    "chars": 17491,
    "preview": "#!/usr/bin/env python3\n\"\"\"\nThis file compares the output and runtime of running normal vs incremental mode\non the histor"
  },
  {
    "path": "misc/log_trace_check.py",
    "chars": 2618,
    "preview": "\"\"\"Compile mypy using mypyc with trace logging enabled, and collect a trace.\n\nThe trace log can be used to analyze low-l"
  },
  {
    "path": "misc/macs.el",
    "chars": 771,
    "preview": "; Example Emacs integration; shows type of expression in region.\n\n(defun mypy-show-region ()\n  \"Show type of variable at"
  },
  {
    "path": "misc/perf_checker.py",
    "chars": 2479,
    "preview": "#!/usr/bin/env python3\n\nfrom __future__ import annotations\n\nimport os\nimport shutil\nimport statistics\nimport subprocess\n"
  },
  {
    "path": "misc/perf_compare.py",
    "chars": 8804,
    "preview": "#! /usr/bin/env python\n\n\"\"\"Compare performance of mypyc-compiled mypy between one or more commits/branches.\n\nSimple usag"
  },
  {
    "path": "misc/profile_check.py",
    "chars": 5108,
    "preview": "\"\"\"Compile mypy using mypyc and profile type checking using perf.\n\nBy default does a self check.\n\nNotes:\n - Only Linux i"
  },
  {
    "path": "misc/self_compile_info.py",
    "chars": 1099,
    "preview": "\"\"\"Print list of files compiled when compiling self (mypy and mypyc).\"\"\"\n\nimport argparse\nimport sys\nfrom typing import "
  },
  {
    "path": "misc/sync-typeshed.py",
    "chars": 8253,
    "preview": "\"\"\"Sync stdlib stubs (and a few other files) from typeshed.\n\nUsage:\n\n  python3 misc/sync-typeshed.py [--commit hash] [--"
  },
  {
    "path": "misc/test-stubgenc.sh",
    "chars": 1254,
    "preview": "#!/bin/bash\n\nset -e\nset -x\n\ncd \"$(dirname \"$0\")/..\"\n\n# Install dependencies, demo project and mypy\npython -m pip install"
  },
  {
    "path": "misc/trigger_wheel_build.sh",
    "chars": 725,
    "preview": "#!/bin/bash -eux\n\n# Trigger a build of mypyc compiled mypy wheels by updating the mypy\n# submodule in the git repo that "
  },
  {
    "path": "misc/typeshed_patches/0001-Adjust-stubs-to-fix-mypy-lookup-error-due-to-circula.patch",
    "chars": 1451,
    "preview": "From 5c922a2484f2e18c7f901e62bb499b6414cf1090 Mon Sep 17 00:00:00 2001\nFrom: Marc Mueller <30130371+cdce8p@users.noreply"
  },
  {
    "path": "misc/typeshed_patches/0001-Partially-revert-Clean-up-argparse-hacks.patch",
    "chars": 1959,
    "preview": "From b6d495c10e79fb56ff64f8fb90c87894090f9cbe Mon Sep 17 00:00:00 2001\nFrom: Marc Mueller <30130371+cdce8p@users.noreply"
  },
  {
    "path": "misc/typeshed_patches/0001-Remove-use-of-LiteralString-in-builtins-13743.patch",
    "chars": 9640,
    "preview": "From b3021cdc4b4c2cf547c5bc2d1d21a5a00ffea001 Mon Sep 17 00:00:00 2001\nFrom: Shantanu <12621235+hauntsaninja@users.norep"
  },
  {
    "path": "misc/typeshed_patches/0001-Revert-Remove-redundant-inheritances-from-Iterator.patch",
    "chars": 12395,
    "preview": "From 69791281c2c5e919cea9a77c4a771f79d9e70384 Mon Sep 17 00:00:00 2001\nFrom: Marc Mueller <30130371+cdce8p@users.noreply"
  },
  {
    "path": "misc/typeshed_patches/0001-Revert-Use-contravariant-type-variable-in-Container.patch",
    "chars": 1508,
    "preview": "From 274a77fe74d961e9885036ed31e5ed46f8d91daa Mon Sep 17 00:00:00 2001\nFrom: Marc Mueller <30130371+cdce8p@users.noreply"
  },
  {
    "path": "misc/typeshed_patches/0001-Revert-sum-literal-integer-change-13961.patch",
    "chars": 1581,
    "preview": "From 0e30b762e8335f02e19977c055ac7b98e707991c Mon Sep 17 00:00:00 2001\nFrom: Shantanu <12621235+hauntsaninja@users.norep"
  },
  {
    "path": "misc/typeshed_patches/0001-Revert-typeshed-ctypes-change.patch",
    "chars": 1323,
    "preview": "From 80a710e0e2c09612c6fc30c644f2052450e69ccd Mon Sep 17 00:00:00 2001\nFrom: AlexWaygood <alex.waygood@gmail.com>\nDate: "
  },
  {
    "path": "misc/typeshed_patches/0001-Temporarily-revert-contextlib-deprecation.patch",
    "chars": 2286,
    "preview": "From ae45edc46f2ca9c939e317648b44ed3372487798 Mon Sep 17 00:00:00 2001\nFrom: Shantanu Jain <hauntsaninja@gmail.com>\nDate"
  },
  {
    "path": "misc/update-stubinfo.py",
    "chars": 2127,
    "preview": "import argparse\nfrom pathlib import Path\n\nimport tomli as tomllib\n\n\ndef main() -> None:\n    parser = argparse.ArgumentPa"
  },
  {
    "path": "misc/upload-pypi.py",
    "chars": 4667,
    "preview": "#!/usr/bin/env python3\n\"\"\"Upload mypy packages to PyPI.\n\nYou must first tag the release, use `git push --tags` and wait "
  },
  {
    "path": "mypy/__init__.py",
    "chars": 37,
    "preview": "# This page intentionally left blank\n"
  },
  {
    "path": "mypy/__main__.py",
    "chars": 1524,
    "preview": "\"\"\"Mypy type checker command line tool.\"\"\"\n\nfrom __future__ import annotations\n\nimport os\nimport sys\nimport traceback\n\nf"
  },
  {
    "path": "mypy/api.py",
    "chars": 2949,
    "preview": "\"\"\"This module makes it possible to use mypy as part of a Python application.\n\nSince mypy still changes, the API was kep"
  },
  {
    "path": "mypy/applytype.py",
    "chars": 12032,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Callable, Iterable, Sequence\n\nimport mypy.subtypes\nfrom "
  },
  {
    "path": "mypy/argmap.py",
    "chars": 11416,
    "preview": "\"\"\"Utilities for mapping between actual and formal arguments (and their types).\"\"\"\n\nfrom __future__ import annotations\n\n"
  },
  {
    "path": "mypy/binder.py",
    "chars": 28610,
    "preview": "from __future__ import annotations\n\nfrom collections import defaultdict\nfrom collections.abc import Iterator\nfrom contex"
  },
  {
    "path": "mypy/bogus_type.py",
    "chars": 816,
    "preview": "\"\"\"A Bogus[T] type alias for marking when we subvert the type system\n\nWe need this for compiling with mypyc, which inser"
  },
  {
    "path": "mypy/build.py",
    "chars": 193903,
    "preview": "\"\"\"Facilities to analyze entire programs, including imported modules.\n\nParse and analyze the source files of a program i"
  },
  {
    "path": "mypy/build_worker/__init__.py",
    "chars": 0,
    "preview": ""
  },
  {
    "path": "mypy/build_worker/__main__.py",
    "chars": 135,
    "preview": "from __future__ import annotations\n\nfrom mypy.build_worker.worker import console_entry\n\nif __name__ == \"__main__\":\n    c"
  },
  {
    "path": "mypy/build_worker/worker.py",
    "chars": 9272,
    "preview": "\"\"\"\nMypy parallel build worker.\n\nThe protocol of communication with the coordinator is as following:\n* Read (pickled) bu"
  },
  {
    "path": "mypy/cache.py",
    "chars": 19278,
    "preview": "\"\"\"\nThis module contains high-level logic for fixed format serialization.\n\nLower-level parts are implemented in C in myp"
  },
  {
    "path": "mypy/checker.py",
    "chars": 430549,
    "preview": "\"\"\"Mypy type checker.\"\"\"\n\nfrom __future__ import annotations\n\nimport itertools\nfrom collections import defaultdict\nfrom "
  },
  {
    "path": "mypy/checker_shared.py",
    "chars": 10613,
    "preview": "\"\"\"Shared definitions used by different parts of type checker.\"\"\"\n\nfrom __future__ import annotations\n\nfrom abc import a"
  },
  {
    "path": "mypy/checker_state.py",
    "chars": 858,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Iterator\nfrom contextlib import contextmanager\nfrom typi"
  },
  {
    "path": "mypy/checkexpr.py",
    "chars": 302671,
    "preview": "\"\"\"Expression type checker. This file is conceptually part of TypeChecker.\"\"\"\n\nfrom __future__ import annotations\n\nimpor"
  },
  {
    "path": "mypy/checkmember.py",
    "chars": 64435,
    "preview": "\"\"\"Type checking of attribute access\"\"\"\n\nfrom __future__ import annotations\n\nfrom collections.abc import Callable, Seque"
  },
  {
    "path": "mypy/checkpattern.py",
    "chars": 36550,
    "preview": "\"\"\"Pattern checker. This file is conceptually part of TypeChecker.\"\"\"\n\nfrom __future__ import annotations\n\nfrom collecti"
  },
  {
    "path": "mypy/checkstrformat.py",
    "chars": 46015,
    "preview": "\"\"\"\nFormat expression type checker.\n\nThis file is conceptually part of ExpressionChecker and TypeChecker. Main functiona"
  },
  {
    "path": "mypy/config_parser.py",
    "chars": 26326,
    "preview": "from __future__ import annotations\n\nimport argparse\nimport configparser\nimport glob as fileglob\nimport os\nimport re\nimpo"
  },
  {
    "path": "mypy/constant_fold.py",
    "chars": 6061,
    "preview": "\"\"\"Constant folding of expressions.\n\nFor example, 3 + 5 can be constant folded into 8.\n\"\"\"\n\nfrom __future__ import annot"
  },
  {
    "path": "mypy/constraints.py",
    "chars": 79294,
    "preview": "\"\"\"Type inference constraints.\"\"\"\n\nfrom __future__ import annotations\n\nfrom collections.abc import Iterable, Sequence\nfr"
  },
  {
    "path": "mypy/copytype.py",
    "chars": 4448,
    "preview": "from __future__ import annotations\n\nfrom typing import Any, cast\n\nfrom mypy.types import (\n    AnyType,\n    CallableType"
  },
  {
    "path": "mypy/defaults.py",
    "chars": 1666,
    "preview": "from __future__ import annotations\n\nimport os\nfrom typing import Final\n\n# Earliest fully supported Python 3.x version. U"
  },
  {
    "path": "mypy/dmypy/__init__.py",
    "chars": 0,
    "preview": ""
  },
  {
    "path": "mypy/dmypy/__main__.py",
    "chars": 128,
    "preview": "from __future__ import annotations\n\nfrom mypy.dmypy.client import console_entry\n\nif __name__ == \"__main__\":\n    console_"
  },
  {
    "path": "mypy/dmypy/client.py",
    "chars": 24276,
    "preview": "\"\"\"Client for mypy daemon mode.\n\nThis manages a daemon process which keeps useful state in memory\nrather than having to "
  },
  {
    "path": "mypy/dmypy_os.py",
    "chars": 1181,
    "preview": "from __future__ import annotations\n\nimport sys\nfrom collections.abc import Callable\nfrom typing import Any\n\nif sys.platf"
  },
  {
    "path": "mypy/dmypy_server.py",
    "chars": 45611,
    "preview": "\"\"\"Server for mypy daemon mode.\n\nThis implements a daemon process which keeps useful state in memory\nto enable fine-grai"
  },
  {
    "path": "mypy/dmypy_util.py",
    "chars": 3006,
    "preview": "\"\"\"Shared code between dmypy.py and dmypy_server.py.\n\nThis should be pretty lightweight and not depend on other mypy cod"
  },
  {
    "path": "mypy/erasetype.py",
    "chars": 11309,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Callable, Container\nfrom typing import cast\n\nfrom mypy.n"
  },
  {
    "path": "mypy/error_formatter.py",
    "chars": 1165,
    "preview": "\"\"\"Defines the different custom formats in which mypy can output.\"\"\"\n\nimport json\nfrom abc import ABC, abstractmethod\nfr"
  },
  {
    "path": "mypy/errorcodes.py",
    "chars": 11892,
    "preview": "\"\"\"Classification of possible errors mypy can detect.\n\nThese can be used for filtering specific errors.\n\"\"\"\n\nfrom __futu"
  },
  {
    "path": "mypy/errors.py",
    "chars": 57154,
    "preview": "from __future__ import annotations\n\nimport os.path\nimport sys\nimport traceback\nfrom collections import defaultdict\nfrom "
  },
  {
    "path": "mypy/evalexpr.py",
    "chars": 6764,
    "preview": "\"\"\"\n\nEvaluate an expression.\n\nUsed by stubtest; in a separate file because things break if we don't\nput it in a mypyc-co"
  },
  {
    "path": "mypy/expandtype.py",
    "chars": 29037,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Iterable, Mapping\nfrom typing import Final, TypeVar, cas"
  },
  {
    "path": "mypy/exportjson.py",
    "chars": 20250,
    "preview": "\"\"\"Tool to convert binary mypy cache files (.ff) to JSON (.ff.json).\n\nUsage:\n   python -m mypy.exportjson .mypy_cache/.."
  },
  {
    "path": "mypy/exprtotype.py",
    "chars": 10598,
    "preview": "\"\"\"Translate an Expression to a Type value.\"\"\"\n\nfrom __future__ import annotations\n\nfrom collections.abc import Callable"
  },
  {
    "path": "mypy/fastparse.py",
    "chars": 87410,
    "preview": "from __future__ import annotations\n\nimport re\nimport sys\nimport warnings\nfrom collections.abc import Callable, Sequence\n"
  },
  {
    "path": "mypy/find_sources.py",
    "chars": 9734,
    "preview": "\"\"\"Routines for finding the sources that mypy will check\"\"\"\n\nfrom __future__ import annotations\n\nimport functools\nimport"
  },
  {
    "path": "mypy/fixup.py",
    "chars": 16600,
    "preview": "\"\"\"Fix up various things after deserialization.\"\"\"\n\nfrom __future__ import annotations\n\nfrom typing import Any, Final\n\nf"
  },
  {
    "path": "mypy/freetree.py",
    "chars": 617,
    "preview": "\"\"\"Generic node traverser visitor\"\"\"\n\nfrom __future__ import annotations\n\nfrom mypy.nodes import Block, MypyFile\nfrom my"
  },
  {
    "path": "mypy/fscache.py",
    "chars": 11102,
    "preview": "\"\"\"Interface for accessing the file system with automatic caching.\n\nThe idea is to cache the results of any file system "
  },
  {
    "path": "mypy/fswatcher.py",
    "chars": 3985,
    "preview": "\"\"\"Watch parts of the file system for changes.\"\"\"\n\nfrom __future__ import annotations\n\nimport os\nfrom collections.abc im"
  },
  {
    "path": "mypy/gclogger.py",
    "chars": 1639,
    "preview": "from __future__ import annotations\n\nimport gc\nimport time\nfrom collections.abc import Mapping\n\n\nclass GcLogger:\n    \"\"\"C"
  },
  {
    "path": "mypy/git.py",
    "chars": 980,
    "preview": "\"\"\"Git utilities.\"\"\"\n\n# Used also from setup.py, so don't pull in anything additional here (like mypy or typing):\nfrom _"
  },
  {
    "path": "mypy/graph_utils.py",
    "chars": 4983,
    "preview": "\"\"\"Helpers for manipulations with graphs.\"\"\"\n\nfrom __future__ import annotations\n\nfrom collections.abc import Iterator, "
  },
  {
    "path": "mypy/indirection.py",
    "chars": 6432,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Iterable\n\nimport mypy.types as types\nfrom mypy.types imp"
  },
  {
    "path": "mypy/infer.py",
    "chars": 2538,
    "preview": "\"\"\"Utilities for type argument inference.\"\"\"\n\nfrom __future__ import annotations\n\nfrom collections.abc import Sequence\nf"
  },
  {
    "path": "mypy/inspections.py",
    "chars": 23813,
    "preview": "from __future__ import annotations\n\nimport os\nfrom collections import defaultdict\nfrom collections.abc import Callable\nf"
  },
  {
    "path": "mypy/ipc.py",
    "chars": 17139,
    "preview": "\"\"\"Cross-platform abstractions for inter-process communication\n\nOn Unix, this uses AF_UNIX sockets.\nOn Windows, this use"
  },
  {
    "path": "mypy/join.py",
    "chars": 39575,
    "preview": "\"\"\"Calculation of the least upper bound types (joins).\"\"\"\n\nfrom __future__ import annotations\n\nfrom collections.abc impo"
  },
  {
    "path": "mypy/literals.py",
    "chars": 9412,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Iterable\nfrom typing import Any, Final, TypeAlias as _Ty"
  },
  {
    "path": "mypy/lookup.py",
    "chars": 2454,
    "preview": "\"\"\"\nThis is a module for various lookup functions:\nfunctions that will find a semantic node by its name.\n\"\"\"\n\nfrom __fut"
  },
  {
    "path": "mypy/main.py",
    "chars": 64329,
    "preview": "\"\"\"Mypy type checker command line tool.\"\"\"\n\nfrom __future__ import annotations\n\nimport argparse\nimport os\nimport platfor"
  },
  {
    "path": "mypy/maptype.py",
    "chars": 4331,
    "preview": "from __future__ import annotations\n\nfrom mypy.expandtype import expand_type_by_instance\nfrom mypy.nodes import TypeInfo\n"
  },
  {
    "path": "mypy/meet.py",
    "chars": 53563,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Callable\n\nfrom mypy import join\nfrom mypy.erasetype impo"
  },
  {
    "path": "mypy/memprofile.py",
    "chars": 4174,
    "preview": "\"\"\"Utility for dumping memory usage stats.\n\nThis is tailored to mypy and knows (a little) about which list objects are\no"
  },
  {
    "path": "mypy/message_registry.py",
    "chars": 17320,
    "preview": "\"\"\"Message constants for generating error messages during type checking.\n\nLiteral messages should be defined as constant"
  },
  {
    "path": "mypy/messages.py",
    "chars": 137038,
    "preview": "\"\"\"Facilities for generating error messages during type checking.\n\nDon't add any non-trivial message construction logic "
  },
  {
    "path": "mypy/metastore.py",
    "chars": 7298,
    "preview": "\"\"\"Interfaces for accessing metadata.\n\nWe provide two implementations.\n * The \"classic\" file system implementation, whic"
  },
  {
    "path": "mypy/mixedtraverser.py",
    "chars": 3852,
    "preview": "from __future__ import annotations\n\nfrom mypy.nodes import (\n    AssertTypeExpr,\n    AssignmentStmt,\n    CastExpr,\n    C"
  },
  {
    "path": "mypy/modulefinder.py",
    "chars": 42875,
    "preview": "\"\"\"Low-level infrastructure to find modules.\n\nThis builds on fscache.py; find_sources.py builds on top of this.\n\"\"\"\n\nfro"
  },
  {
    "path": "mypy/moduleinspect.py",
    "chars": 6326,
    "preview": "\"\"\"Basic introspection of modules.\"\"\"\n\nfrom __future__ import annotations\n\nimport importlib\nimport inspect\nimport os\nimp"
  },
  {
    "path": "mypy/mro.py",
    "chars": 2002,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Callable\n\nfrom mypy.nodes import TypeInfo\nfrom mypy.type"
  },
  {
    "path": "mypy/nativeparse.py",
    "chars": 72662,
    "preview": "# mypy: allow-redefinition-new, local-partial-types\n\"\"\"Python parser that directly constructs a native AST (when compile"
  },
  {
    "path": "mypy/nodes.py",
    "chars": 179975,
    "preview": "\"\"\"Abstract syntax tree node classes (i.e. parse tree).\"\"\"\n\nfrom __future__ import annotations\n\nimport os\nfrom abc impor"
  },
  {
    "path": "mypy/operators.py",
    "chars": 2866,
    "preview": "\"\"\"Information about Python operators\"\"\"\n\nfrom __future__ import annotations\n\nfrom typing import Final\n\n# Map from binar"
  },
  {
    "path": "mypy/options.py",
    "chars": 27389,
    "preview": "from __future__ import annotations\n\nimport pprint\nimport re\nimport sys\nimport sysconfig\nfrom collections.abc import Call"
  },
  {
    "path": "mypy/parse.py",
    "chars": 4996,
    "preview": "from __future__ import annotations\n\nimport os\nimport re\n\nfrom librt.internal import ReadBuffer\n\nfrom mypy import errorco"
  },
  {
    "path": "mypy/partially_defined.py",
    "chars": 26746,
    "preview": "from __future__ import annotations\n\nfrom enum import Enum\n\nfrom mypy import checker, errorcodes\nfrom mypy.messages impor"
  },
  {
    "path": "mypy/patterns.py",
    "chars": 4048,
    "preview": "\"\"\"Classes for representing match statement patterns.\"\"\"\n\nfrom __future__ import annotations\n\nfrom typing import TypeVar"
  },
  {
    "path": "mypy/plugin.py",
    "chars": 36250,
    "preview": "\"\"\"Plugin system for extending mypy.\n\nAt large scale the plugin system works as following:\n\n* Plugins are collected from"
  },
  {
    "path": "mypy/plugins/__init__.py",
    "chars": 0,
    "preview": ""
  },
  {
    "path": "mypy/plugins/attrs.py",
    "chars": 46508,
    "preview": "\"\"\"Plugin for supporting the attrs library (http://www.attrs.org)\"\"\"\n\nfrom __future__ import annotations\n\nfrom collectio"
  },
  {
    "path": "mypy/plugins/common.py",
    "chars": 14117,
    "preview": "from __future__ import annotations\n\nfrom typing import NamedTuple\n\nfrom mypy.argmap import map_actuals_to_formals\nfrom m"
  },
  {
    "path": "mypy/plugins/constants.py",
    "chars": 819,
    "preview": "\"\"\"Constant definitions for plugins kept here to help with import cycles.\"\"\"\n\nfrom typing import Final\n\nfrom mypy.semana"
  },
  {
    "path": "mypy/plugins/ctypes.py",
    "chars": 10675,
    "preview": "\"\"\"Plugin to provide accurate types for some parts of the ctypes module.\"\"\"\n\nfrom __future__ import annotations\n\n# Fully"
  },
  {
    "path": "mypy/plugins/dataclasses.py",
    "chars": 47255,
    "preview": "\"\"\"Plugin that provides support for dataclasses.\"\"\"\n\nfrom __future__ import annotations\n\nfrom collections.abc import Ite"
  },
  {
    "path": "mypy/plugins/default.py",
    "chars": 24118,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Callable\nfrom functools import partial\nfrom typing impor"
  },
  {
    "path": "mypy/plugins/enums.py",
    "chars": 12110,
    "preview": "\"\"\"\nThis file contains a variety of plugins for refining how mypy infers types of\nexpressions involving Enums.\n\nCurrentl"
  },
  {
    "path": "mypy/plugins/functools.py",
    "chars": 15527,
    "preview": "\"\"\"Plugin for supporting the functools standard library module.\"\"\"\n\nfrom __future__ import annotations\n\nfrom typing impo"
  },
  {
    "path": "mypy/plugins/proper_plugin.py",
    "chars": 6574,
    "preview": "\"\"\"\nThis plugin is helpful for mypy development itself.\nBy default, it is not enabled for mypy users.\n\nIt also can be us"
  },
  {
    "path": "mypy/plugins/singledispatch.py",
    "chars": 8151,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Sequence\nfrom typing import NamedTuple, TypeAlias as _Ty"
  },
  {
    "path": "mypy/py.typed",
    "chars": 64,
    "preview": "# Marker file for PEP 561.  The mypy package uses inline types.\n"
  },
  {
    "path": "mypy/pyinfo.py",
    "chars": 3014,
    "preview": "from __future__ import annotations\n\n\"\"\"Utilities to find the site and prefix information of a Python executable.\n\nThis f"
  },
  {
    "path": "mypy/reachability.py",
    "chars": 12977,
    "preview": "\"\"\"Utilities related to determining the reachability of code (in semantic analysis).\"\"\"\n\nfrom __future__ import annotati"
  },
  {
    "path": "mypy/refinfo.py",
    "chars": 2784,
    "preview": "\"\"\"Find line-level reference information from a mypy AST (undocumented feature)\"\"\"\n\nfrom __future__ import annotations\n\n"
  },
  {
    "path": "mypy/renaming.py",
    "chars": 20494,
    "preview": "from __future__ import annotations\n\nfrom collections.abc import Iterator\nfrom contextlib import contextmanager\nfrom typi"
  },
  {
    "path": "mypy/report.py",
    "chars": 34700,
    "preview": "\"\"\"Classes for producing HTML reports about imprecision.\"\"\"\n\nfrom __future__ import annotations\n\nimport collections\nimpo"
  },
  {
    "path": "mypy/scope.py",
    "chars": 4233,
    "preview": "\"\"\"Track current scope to easily calculate the corresponding fine-grained target.\n\nTODO: Use everywhere where we track t"
  }
]

// ... and 1632 more files (download for full content)

About this extraction

This page contains the full source code of the python/mypy GitHub repository, extracted and formatted as plain text for AI agents and large language models (LLMs). The extraction includes 1832 files (17.5 MB), approximately 4.0M tokens. Use this with OpenClaw, Claude, ChatGPT, Cursor, Windsurf, or any other AI tool that accepts text input. You can copy the full output to your clipboard or download it as a .txt file.

Extracted by GitExtract — free GitHub repo to text converter for AI. Built by Nikandr Surkov.

Copied to clipboard!