pylint-django

What it is and what it does

pylint-django is a Pylint plugin that teaches Pylint how to understand Django's dynamic code patterns. When you run Pylint on Django projects, it normally complains about attributes that don't exist in the static code—like Model.objects or View.request—because Django creates them at runtime. This plugin suppresses those false positives and improves type inference for Django ORM fields, forms, and migrations.

You install it alongside Pylint and activate it by passing --load-plugins pylint_django to your linting command. For best results, you point it to your Django settings module so it can use Django's own machinery to resolve model references and understand your project structure. It also includes an optional migrations checker that flags potentially problematic patterns like adding fields with defaults to large tables.

Use it for

• Linting a Django project without drowning in false positives about missing Model attributes and ORM field methods.
• Validating Django ModelForm and Model Meta classes without spurious warnings about informational-only attributes.
• Catching dangerous patterns in migrations, such as adding fields with defaults that could lock large tables during deployment.
• Integrating Django code quality checks into CI/CD pipelines via Prospector, which auto-detects and uses this plugin.
• Improving type inference for ForeignKey and other relational field attributes during static analysis.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

pylint-django on PyPI

Before you install

Low friction install with only two runtime dependencies (pylint and pylint-plugin-utils). Actively maintained with a release 34 days ago and recent commits. Django itself is not installed by default to avoid environment conflicts; install with [with-django] extra if needed.

Requires a Django settings module (via DJANGO_SETTINGS_MODULE env var or --django-settings-module flag) to access Django internals for accurate type inference; without it, linting is less accurate.

License in practice

Licensed under GPLv2 or later (copyleft). Any code that imports and uses this plugin in a proprietary project must comply with copyleft obligations—consult your legal team if you have restrictions on GPL dependencies.

Quickstart

pip install pylint-django

DJANGO_SETTINGS_MODULE=your.app.settings pylint --load-plugins pylint_django <path_to_sources>

# Or with Django auto-installed:
pip install pylint-django[with-django]

Package facts

Evidence: pylint_django-2.8.0-py3-none-any.whl

Tags

More Quality Assurance packages

See also prospector · pylint · pylint-celery · pylint-flask · pylint-odoo · pylint-plugin-utils · pylint-pytest · pylint-pydantic · pylint-flask-sqlalchemy · pylint-protobuf