README.rst

August 20, 2012 · View on GitHub

.. 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@.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>_,