flake8-pyi
A plugin for Flake8 that provides specializations for type hinting stub files, especially interesting for linting typeshed.
Refer to this documentation for more details on stub files.
Functionality
-
Adds the
.pyiextension to the default value of the--filenamecommand-line argument to Flake8. This means stubs are linted by default with this plugin enabled, without needing to explicitly list every file. -
Modifies PyFlakes runs for
.pyifiles to defer checking type annotation expressions after the entire file has been read. This enables support for first-class forward references that stub files use. -
Provides a number of
.pyi-specific warnings that enforce typeshed's style guide.
Note: Be careful when using this plugin in the same environment as other flake8
plugins, as they might generate errors that are inappropriate for
.pyi files (e.g., about missing docstrings). We recommend running
flake8-pyi in a dedicated environment in your CI.
Lints provided
This plugin reserves codes starting with Y0. For a full list of lints currently provided by flake8-pyi, see the list of error codes.
Note that several error codes recommend using types from typing_extensions or
_typeshed. Strictly speaking, these packages are not part of the standard
library. However, these packages are included in typeshed's stdlib/
directory, meaning that type checkers believe them to be part of the standard
library even if this does not reflect the reality at runtime. As such, since
stubs are never executed at runtime, types from typing_extensions and
_typeshed can be used freely in a stubs package, even if the package does not
have an explicit dependency on either typing_extensions or typeshed.
Flake8-pyi's checks may produce false positives on stubs that aim to support Python 2.
License
MIT
Authors
Originally created by Łukasz Langa and now maintained by Jelle Zijlstra, Alex Waygood, Sebastian Rittau, Akuli, and Shantanu.
See also
2 maintainers
Release files for flake8-pyi 26.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| flake8_pyi-26.5.0.tar.gz | 61.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| flake8_pyi-26.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 86.4 kB
Release files / flake8_pyi-26.5.0.tar.gz
| Download URL | flake8_pyi-26.5.0.tar.gz |
|---|---|
| Size | 61.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6e846efa7bdf4221cbf35c5123b8e8882ab1220578e89db2294a077368ac4885
|
|
BLAKE2b-256 checksum How to use checksums |
288dc31a6bd3d74a4ec81c7d52ca50ce51288b60f50b39d36cbf3eee4bfbd88b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.13 {"installer":{"name":"uv","version":"0.11.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / flake8_pyi-26.5.0-py3-none-any.whl
| Download URL | flake8_pyi-26.5.0-py3-none-any.whl |
|---|---|
| Size | 25.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
24fa143364f78d919930d04f9d99e01ac6666c096f9d01eb9436c469a5b777cb
|
|
BLAKE2b-256 checksum How to use checksums |
33141c30394b49b7e600c12d89e1fe3c33dbec0b1b0532a0f16ccb5eab403b78
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.13 {"installer":{"name":"uv","version":"0.11.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
