django-autocomplete-light 4.0.3

Fresh autocompletes for Django

Features

• Python 3.11–3.14 and Django 4.2–6.0+ support

• Django (multiple) choice support,

• Django (multiple) model choice support,

• Django generic foreign key support (through django-querysetsequence),

• Multiple widget support: select2.js, easy to add more.

• Creating choices that don’t exist in the autocomplete,

• Offering choices that depend on other fields in the form, in an elegant and innovative way,

• Dynamic widget creation (ie. inlines), supports YOUR custom scripts too,

• Provides a test API for your awesome autocompletes, to support YOUR custom use cases too,

• A documented automatically tested example for each use case in test_project.

Upgrade from 3.12.1 to 4.0.0

DAL 4.0.0 is a breaking release focused on modern supported runtimes and removing unmaintained integration packages.

Before upgrading, make sure your application runs on Python 3.11 or newer and Django 4.2 or newer. Then upgrade the package:

pip install -U "django-autocomplete-light<5"

If you use optional integrations, install the matching extra explicitly:

pip install -U "django-autocomplete-light[gfk]<5"     # GenericForeignKey support
pip install -U "django-autocomplete-light[tags]<5"    # django-taggit support
pip install -U "django-autocomplete-light[nested]<5"  # django-nested-admin support

Remove the following packages from INSTALLED_APPS and imports; they are no longer shipped in DAL 4.0.0:

• dal_genericm2m

• dal_genericm2m_queryset_sequence

• dal_gm2m

• dal_gm2m_queryset_sequence

• dal_select2_tagging

• dal_legacy_static

The genericm2m extra was removed. Generic foreign key support remains available through django-autocomplete-light[gfk] and dal_queryset_sequence. django-taggit support remains available through django-autocomplete-light[tags] and dal_select2_taggit.

If your deployment or packaging scripts build DAL from source, switch from setup.py entry points to the PEP 517 build backend:

python -m build

After upgrading, test forms that render existing Select2 values, multiple Select2 submissions, clearable placeholders, HTMX swaps, and any custom attrs=None widget construction. These areas changed between 3.12.1 and 4.0.0.

Resources

• **Documentation** graciously hosted by RTFD

• Mailing list graciously hosted by Google

• For Security issues, please contact security@<our github group name>.org

• Git graciously hosted by GitHub,

• Package graciously hosted by PyPi,