Developer Guides

If you are interested in becoming a contributor, it's useful to go through these guides first.

First of all, read the README.md file in the repository.

• Learning Resources: What to read if you want to understand mypy internals.

• Implementation Overview: An introduction to the structure of the implementation. Subsections:

  • Build Manager
  • Python Parser
  • Semantic Analyzer
  • Type Checker
  • Mypy Daemon
  • Typeshed

• Getting Started Developing: Some basic hints for developers.

• Code Conventions: Follow these code conventions when writing code.

• Mypy Tests: How to write mypy tests using .test files.

• Using git and GitHub for mypy development: Getting started with GitHub (for GitHub novices).

• Anatomy of a good pull request: How to get your code merged more quickly.

• How to decide what to work on and issue tracker instructions: Pick a task and start coding!

• Creating Stubs For Python Modules: You can add support to a Python module by creating interface stubs. This page contains the documentation.

• Profiling Mypy: Profiling mypy requires special tooling, since mypy is compiled to extension modules.

Feel free to contact the developers (either file an issue on GitHub or email directly) if something is unclear or if you have ideas for changing how things work.

Python Community Code of Conduct does a great job of presenting more general, common sense guidelines that apply equally well to the mypy project.