pylint-pypy-shim

Pylint on PyPy without the crashes. Patches Astroid's runtime introspection so linting works where CPython assumptions don't hold.

Introduction

Installation

Adoption path 1: Pylint plugin

Adoption path 2: CLI wrapper

Runtime behaviour

Supported versions

Strict mode

Choosing plugin or CLI

Troubleshooting

Source

Source material

Contents

Introduction
- Introduction
Installation
- Installation
Adoption path 1: Pylint plugin
- Adoption path 1: Pylint plugin
Adoption path 2: CLI wrapper
- Adoption path 2: CLI wrapper
Runtime behaviour
- Runtime behaviour
Supported versions
- Supported versions
Strict mode
- Strict mode
Choosing plugin or CLI
- Choosing plugin or CLI
Troubleshooting
- Troubleshooting

Troubleshooting

Updated May 19, 2026

If the patch is not being installed, check these items first:

Confirm the command is running under PyPy, not CPython.
Confirm Pylint is version 4.x and Astroid is version 4.x.
Run with logging enabled and look for pylint_pypy_shim warnings.
On successful PyPy installation, INFO logs report that InspectBuilder.object_build was patched and include the active Pylint version, Astroid version, and runtime name.
Use PYLINT_PYPY_SHIM_STRICT=1 in CI when unsupported versions should stop the job immediately.

If Pylint itself exits with a non-zero status, pylint-pypy propagates that status. Treat it like a normal Pylint failure and inspect the reported diagnostics.