.. image:: https://img.shields.io/pypi/dm/django-autocomplete-light.svg
   :target: https://pypi.python.org/pypi/django-autocomplete-light
.. image:: https://badge.fury.io/py/django-autocomplete-light.png
   :target: http://badge.fury.io/py/django-autocomplete-light
.. image:: https://codecov.io/github/yourlabs/django-autocomplete-light/coverage.svg?branch=master
    :target: https://codecov.io/github/yourlabs/django-autocomplete-light?branch=master

Features
--------

- **Python 3.11–3.14 and Django 5.2–6.0+ support**
- **``dal_alight`` widget media uses ``type="module"`` scripts** on Django
  5.2+ (via ``django.forms.widgets.Script`` or a small backport in
  ``dal_alight.media``) so merged form media does not double-execute web
  component registration.
- Django (multiple) choice support,
- Django (multiple) model choice support,
- Django generic foreign key support (through django-querysetsequence),
- Multiple widget support: native web component (``dal_alight``), select2.js (``dal_select2``).
- 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.

Compatibility
-------------

.. warning:: 4.0.1 Introduced too many breaking changes from 4.0, and was
             re-released as 5.0.

.. admonition:: Did I unexpectedly break your build?

   Do you have an issue that may be affecting everyone's build? I am likely to
   miss your issue or not catch it in time, **DO TEXT ME** in this kind of
   emergency case, I can always yank a release, if you don't have any reply in
   24h, feel free to **TEXT AGAIN**. My cell number has been on the
   yourlabs.org footer for years (TECH section) and is meant to stay. All the
   spamers of the world have it already so why not use it to do something
   useful together ? Or have a drink ofc

Use this matrix to pick the django-autocomplete-light version series for your
Django version:

.. list-table::
   :header-rows: 1

   * - django-autocomplete-light
     - Django
     - Purpose
     - Upgrade
   * - 5.x
     - 5.2, 6.0+
     - `WebComponent support <https://django-autocomplete-light.readthedocs.io/en/master/alight.html>`_
     - `v4 to v5 <https://django-autocomplete-light.readthedocs.io/en/master/upgrade_from_v4_to_v5.html>`_
   * - 4.x
     - 4.2, 5.2, 6.0+
     - modernization & cleanup
     - `v3 to v4 <https://django-autocomplete-light.readthedocs.io/en/master/upgrade_from_v3_to_v4.html>`_
   * - 3.12.x
     - 3.2 to 5.2
     -
     -

Resources
---------

- `**Documentation** graciously hosted
  <http://django-autocomplete-light.rtfd.org>`_ by `RTFD
  <http://rtfd.org>`_
- `Mailing list graciously hosted
  <http://groups.google.com/group/yourlabs>`_ by `Google
  <http://groups.google.com>`_
- For **Security** issues, please contact security@<our github group name>.org
- `Git graciously hosted
  <https://github.com/yourlabs/django-autocomplete-light/>`_ by `GitHub
  <http://github.com>`_,
- `Package graciously hosted
  <http://pypi.python.org/pypi/django-autocomplete-light/>`_ by `PyPi
  <http://pypi.python.org/pypi>`_,