flake8-no-pep420 1.1.0

A flake8 plugin to ban PEP-420 implicit namespace packages.

A flake8 plugin to ban PEP-420 implicit namespace packages.

Requirements

Python 3.6 to 3.10 supported.

Installation

First, install with pip:

python -m pip install flake8-no-pep420

Second, check that flake8 lists the plugin in its version line:

$ flake8 --version
3.8.4 (flake8-no-pep420: 1.0.0, mccabe: 0.6.1, pycodestyle: 2.5.0, pyflakes: 2.1.1) CPython 3.8.0 on Darwin

Third, add the INP prefix to your select list. For example, if you have your configuration in setup.cfg:

[flake8]
select = E,F,W,INP

---

Linting a Django project? Check out my book Speed Up Your Django Tests which covers loads of best practices so you can write faster, more accurate tests.

---

Rationale

Implicit namespace packages are folders of Python files without an __init__.py. They’re valid and importable, but unfortunately they’re not discovered by many code quality tools:

• coverage.py

• Django’s test runner

• mypy without its –namespace-packages option

Such silent failure leads to a false sense of security. PEP-420’s algorithm is non-trivial which is probably why such tools haven’t (yet) implemented it.

Rules

INP001: File is part of an implicit namespace package.

flake8-no-pep420 will trigger this on the first line of any file that sits in a folder without a __init__.py file.

Often projects have a few root files not in packages, for which an __init__.py file should not be added. For example on a Django project there’s the manage.py file. In these cases you should add # noqa: INP001 on the first line of the file.