Question 1

How do I fix 'TypeError: type object is not subscriptable' with QuerySet in django-stubs?

Accepted Answer

Install django-stubs-ext and use its monkeypatch function to enable generic types, or fall back to string annotations like 'QuerySet[MyModel]'. This workaround is necessary because Django's classes lack runtime subscript support.

Question 2

django-stubs vs using plain type hints for Django?

Accepted Answer

django-stubs provides accurate stubs and a plugin that understands Django's dynamic patterns, reducing false positives and enabling type checking for complex ORM code, whereas plain hints often miss Django-specific magic and lead to imprecise types.

Question 3

How to configure django-stubs for dynamic Django settings like django-split-settings?

Accepted Answer

Set strict_settings to false in your mypy configuration (e.g., in pyproject.toml) to allow Any type for settings attributes, preventing errors when settings are loaded from non-standard or runtime sources.

Question 4

Why does mypy crash when I run it with django-stubs plugin installed?

Accepted Answer

The plugin depends on Django's runtime to extract model info, so if your Django app is broken (e.g., manage.py crashes), mypy will too. Fix your Django code first or use mypy's --tb option for debugging.

Question 5

How to type custom model managers in django-stubs to avoid incompatible return errors?

Accepted Answer

Declare your manager with generics, e.g., class MyManager(models.Manager['MyModel']), to specify the model type and ensure method return types align, as explained in the FAQ section on custom managers.

Question 6

Is django-stubs compatible with Django 5.x or 6.x?

Accepted Answer

Yes, check the version compatibility table in the README; for example, django-stubs 6.0.x supports Django 6.0, but note that partial support for older versions may have limitations, and mypy version constraints apply.

django-stubs

What is django-stubs?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions