Django-choices

------------------

This will (likely) be the final release, ever. Django has been shipping native choices
support since version 3.0, so we are sunsetting this library. Many thanks to every
contributor in any matter - documentation, issues, ideas, patches... You have all
made valuable contribution.

That said, this final (hopefully) release aims to assist in taking those last hurdles.
We've provide some tooling to help you migrate (see the "migrating" documentation) and
updated the project to work on supported Django and Python versions.

Breaking changes
----------------

* Drop support for Django 1.11, 2.2, 3.0, 3.1 (EOL)
* Drop support for Python 2.7, 3.5, 3.6, 3.7 (EOL)

Older Django versions and Python 3.6+ likely still work, but they are not tested in CI
anymore.

Other changes
-------------

* Confirm support for Django 4.1 & 4.2
* Confirm support for Python 3.10 and 3.11
* Added a management command to generate equivalent native django choice definitions
* Documented how to migrate to native choices
* Documented the (approximately) equivalent usage of Django Choices/native choices.

------------------

CI maintenance release. There are no actual Python code changes in this release.

* Added explicit support for Django 3.1 and 3.2
* Added explicit support for Python 3.8 and 3.9
* Migrated from Travis CI to Github Actions
* Added Black as code formatter
* Dropped Python 3.4 support since it's not available on Github Actions.

------------------

* Added support for Django 3.0
* Added dependency on non-vendored six

------------------

* Added ``DjangoChoices.get_order_expression`` class method
* Added support for Python 3.7 and Django 2.2
* Dropped support for Django 1.8, Django 1.9 and Django 1.10

------------------

* documentation code blocks are now syntax highlighted (bashu in 55)
* ``DjangoChoices`` subclasses are now directly iterable (yielding the choice
tuples) (brianjbuck in 53)
* documentation of ``DjangoChoices.labels`` is fixed (54)
* typo fixed in docs (nielznl in 57)

-----

* Added support for custom attributes to ``ChoiceItem``.
* Added ``DjangoChoices.get_choice`` as public API to retrieve a ``ChoiceItem``
instance.

See the docs for example usage.