.. role:: python(code)
:language: python
django-richenum
===============
.. image:: https://travis-ci.org/hearsaycorp/django-richenum.png?branch=master
:alt: Build Status
:target: https://travis-ci.org/hearsaycorp/django-richenum
.. image:: https://img.shields.io/pypi/v/django-richenum.svg
:alt: Latest PyPI Version
:target: https://pypi.python.org/pypi/django-richenum/
.. image:: https://img.shields.io/pypi/pyversions/django-richenum.svg
:alt: Python versions
:target: https://pypi.org/project/django-richenum/
.. image:: https://img.shields.io/pypi/dm/django-richenum.svg
:alt: Pypi Downloads
:target: https://pypi.org/project/django-richenum/
About
=====
A Django extension of richenum for Python. If you're unfamiliar with richenums, please read up on them (see `Related Packages`_) before using django-richenum.
Model Fields
------------
IndexEnumField
Store ints in DB, but expose OrderedRichEnumValues in Python.
CanonicalNameEnumField
Store varchar in DB, but expose RichEnumValues in Python.
We recommend that you use IndexEnumField for storage and query efficiency.
LaxIndexEnumField
Like IndexEnumField, but also allows casting to and from canonical names.
Mainly used to help migrate existing code that uses strings as database values.
Form Fields
-----------
CanonicalEnumField
Uses the RichEnum/OrderedRichEnum canonical_name as form field values.
IndexEnumField
Uses the OrderedRichEnum index as form field values.
Django Admin
------------
RichEnumFieldListFilter
Enables filtering by RichEnum model fields in the Django admin UI
Links
-----
| `GitHub: django-richenum <https://github.com/hearsaycorp/django-richenum>`_
| `PyPi: django-richenum <https://pypi.python.org/pypi/django-richenum/>`_
Installation
============
.. code:: bash
$ pip install django-richenum
Example Usage
=============
IndexEnumField
--------------
.. code:: python
>>> from richenum import OrderedRichEnum, OrderedRichEnumValue
>>> class MyOrderedRichEnum(OrderedRichEnum):
... FOO = OrderedRichEnumValue(index=1, canonical_name="foo", display_name="Foo")
... BAR = OrderedRichEnumValue(index=2, canonical_name="bar", display_name="Bar")
...
>>> from django.db import models
>>> from django_richenum.models import IndexEnumField
>>> class MyModel(models.Model):
... my_enum = IndexEnumField(MyOrderedRichEnum, default=MyOrderedRichEnum.FOO)
...
>>> m = MyModel.objects.create(my_enum=MyOrderedRichEnum.BAR)
>>> m.save()
>>> m.my_enum
OrderedRichEnumValue - idx: 2 canonical_name: 'bar' display_name: 'Bar'
>>> MyModel.objects.filter(my_enum=MyOrderedRichEnum.BAR)
CanonicalNameEnumField
----------------------
.. code:: python
>>> from richenum import RichEnum, RichEnumValue
>>> class MyRichEnum(RichEnum):
... FOO = RichEnumValue(canonical_name="foo", display_name="Foo")
... BAR = RichEnumValue(canonical_name="bar", display_name="Bar")
...
>>> from django.db import models
>>> from django_richenum.models import CanonicalNameEnumField
>>> class MyModel(models.Model):
... my_enum = CanonicalNameEnumField(MyRichEnum, default=MyRichEnum.FOO)
...
>>> m = MyModel.objects.create(my_enum=MyRichEnum.BAR)
>>> m.save()
>>> m.my_enum
RichEnumValue - canonical_name: 'bar' display_name: 'Bar'
>>> MyModel.objects.filter(my_enum=MyRichEnum.BAR)
RichEnumFieldListFilter
-----------------------
.. code:: python
>>> from django_richenum.admin import register_admin_filters
>>> register_admin_filters()
Related Packages
================
richenum
Package implementing RichEnum and OrderedRichEnum that django-richenum depends on.
| `GitHub: richenum <https://github.com/hearsaycorp/richenum>`_
| `PyPi: richenum <https://pypi.python.org/pypi/richenum/>`_
Notes
=====
If you're using Django 1.7+, you'll need to use the :python:`@deconstructible` decorator for your :python:`RichEnumValue` and :python:`OrderedRichEnumValue` classes so Django's migration framework knows how to serialize your :python:`RichEnumValue` and :python:`OrderedRichEnumValue`.
.. code:: python
>>> from django.utils.deconstruct import deconstructible
>>> from richenum import RichEnumValue, OrderedRichEnumValue
>>> @deconstructible
... class CustomRichEnumValue(RichEnumValue):
... pass
...
>>> @deconstructible
... class CustomOrderedRichEnumValue(OrderedRichEnumValue):
... pass
...
Contributing
============
#. Fork the repo from `GitHub <https://github.com/hearsaycorp/django-richenum>`_.
#. Make your changes.
#. Add unittests for your changes.
#. Run `pep8 <https://pypi.python.org/pypi/pep8>`_, `pyflakes <https://pypi.python.org/pypi/pyflakes>`_, and `pylint <https://pypi.python.org/pypi/pyflakes>`_ to make sure your changes follow the Python style guide and doesn't have any errors.
#. Add yourself to the AUTHORS file (in alphabetical order).
#. Send a pull request from your fork to the main repo.
Changelog
=========
4.1.0 (2023-12-12)
------------------
- Support for Django 4.2
- Support for Python 3.11
- Remove support for Django 2.2, 3.0, 3.1
- Remove support for Python 3.7
- Require MySQL 8 and Postgres 12
3.7.0 (2019-09-05)
------------------
- Support for Django 2.3
3.6.0 (2019-07-09)
------------------
- Support for Django 2.2
- Support for Python 3.7
- Remove support for Django 2.0
3.5.0 (2018-09-10)
------------------
- Fix [deprecation of context param for Field.from_db_value](https://code.djangoproject.com/ticket/28370)
- Support for Django 2.1
- Switch tests suite to use pytest
- Remove pylint-django plugin, no longer needed
3.4.0 (2018-02-10)
------------------
- Drop support for old Django versions
3.3.0 (2018-01-21)
------------------
- removed Python 3.4
- add support for Python 3.6
- add support for Django 2.0
- Properly mark raw strings (used as regex)
3.2.0 (2016-08-22)
------------------
- Python 3.4 & 3.5 support
3.1.0 (2015-08-02)
------------------
- Django 1.10 support
3.0.1 (2015-07-13)
------------------
- Prepare for python 3 support
2.4.1 (2015-05-04)
------------------
- replace mysql client library (for tests)
- stop using lambdas
2.3.0 (2015-05-04)
------------------
- Support Django 1.8
2.2.0 (2015-03-11)
------------------
- Support ModelForms for non-SQLite DB backends
2.1.0 (2014-11-01)
------------------
- Support migration in Django 1.7
2.0.0 (2014-09-04)
------------------
- Support Django 1.7, drop support for Python 2.6.
1.2.2 (2014-08-02)
------------------
- Support Django 1.3
1.2.1 (2014-06-02)
------------------
- Remove uses of BaseException.message.
1.2.0 (2013-12-03)
------------------
- Add enum-aware versions of TypedMultipleChoiceField.
1.1.0 (2013-12-03)
------------------
- Fix form fields to support Django 1.6 (while maintaining
compatibility with 1.4 and 1.5).
1.0.2 (2013-11-05)
------------------
- Make EnumField.run_validators a no-op.
This stops some warnings from type comparison, and it doesn't seem
useful in an EnumField context.
1.0.1 (2013-09-10)
------------------
- Support South.
1.0.0 (2013-08-16)
------------------
- Initial public release.
Developed and maintained by `Hearsay Social, Inc.
<https://hearsaysocial.com>`_.
Contributors
============
| `Adam DePue <https://github.com/adepue>`_
| `Akshay Shah <https://github.com/akshayjshah>`_
| `Dale Hui <https://github.com/dhui>`_
| `Robert MacCloy <https://github.com/rbm>`_
| `Ben Lopatin <https://github.com/bennylope>`_
| `Asher Foa <https://github.com/asherf>`_
| `Krisztian Csizmazia <https://github.com/csizmaziakiki>`_
Raw data
{
"_id": null,
"home_page": "https://github.com/hearsaycorp/django-richenum",
"name": "django-richenum",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python django enum richenum",
"author": "Hearsay Social",
"author_email": "opensource@hearsaysocial.com",
"download_url": "https://files.pythonhosted.org/packages/3d/48/ea9d6f98a45f9ed684a38bb1690beb3245fdbda7fe4ba5135d8baba07e1d/django-richenum-5.0.0.tar.gz",
"platform": null,
"description": ".. role:: python(code)\n :language: python\n\ndjango-richenum\n===============\n\n.. image:: https://travis-ci.org/hearsaycorp/django-richenum.png?branch=master\n :alt: Build Status\n :target: https://travis-ci.org/hearsaycorp/django-richenum\n\n.. image:: https://img.shields.io/pypi/v/django-richenum.svg\n :alt: Latest PyPI Version\n :target: https://pypi.python.org/pypi/django-richenum/\n\n.. image:: https://img.shields.io/pypi/pyversions/django-richenum.svg\n :alt: Python versions\n :target: https://pypi.org/project/django-richenum/\n\n.. image:: https://img.shields.io/pypi/dm/django-richenum.svg\n :alt: Pypi Downloads\n :target: https://pypi.org/project/django-richenum/\n\nAbout\n=====\nA Django extension of richenum for Python. If you're unfamiliar with richenums, please read up on them (see `Related Packages`_) before using django-richenum.\n\nModel Fields\n------------\nIndexEnumField\n Store ints in DB, but expose OrderedRichEnumValues in Python.\nCanonicalNameEnumField\n Store varchar in DB, but expose RichEnumValues in Python.\n We recommend that you use IndexEnumField for storage and query efficiency.\nLaxIndexEnumField\n Like IndexEnumField, but also allows casting to and from canonical names.\n Mainly used to help migrate existing code that uses strings as database values.\n\nForm Fields\n-----------\nCanonicalEnumField\n Uses the RichEnum/OrderedRichEnum canonical_name as form field values.\nIndexEnumField\n Uses the OrderedRichEnum index as form field values.\n\nDjango Admin\n------------\nRichEnumFieldListFilter\n Enables filtering by RichEnum model fields in the Django admin UI\n\nLinks\n-----\n| `GitHub: django-richenum <https://github.com/hearsaycorp/django-richenum>`_\n| `PyPi: django-richenum <https://pypi.python.org/pypi/django-richenum/>`_\n\nInstallation\n============\n.. code:: bash\n\n $ pip install django-richenum\n\nExample Usage\n=============\n\nIndexEnumField\n--------------\n.. code:: python\n\n >>> from richenum import OrderedRichEnum, OrderedRichEnumValue\n >>> class MyOrderedRichEnum(OrderedRichEnum):\n ... FOO = OrderedRichEnumValue(index=1, canonical_name=\"foo\", display_name=\"Foo\")\n ... BAR = OrderedRichEnumValue(index=2, canonical_name=\"bar\", display_name=\"Bar\")\n ...\n >>> from django.db import models\n >>> from django_richenum.models import IndexEnumField\n >>> class MyModel(models.Model):\n ... my_enum = IndexEnumField(MyOrderedRichEnum, default=MyOrderedRichEnum.FOO)\n ...\n >>> m = MyModel.objects.create(my_enum=MyOrderedRichEnum.BAR)\n >>> m.save()\n >>> m.my_enum\n OrderedRichEnumValue - idx: 2 canonical_name: 'bar' display_name: 'Bar'\n >>> MyModel.objects.filter(my_enum=MyOrderedRichEnum.BAR)\n\n\nCanonicalNameEnumField\n----------------------\n.. code:: python\n\n >>> from richenum import RichEnum, RichEnumValue\n >>> class MyRichEnum(RichEnum):\n ... FOO = RichEnumValue(canonical_name=\"foo\", display_name=\"Foo\")\n ... BAR = RichEnumValue(canonical_name=\"bar\", display_name=\"Bar\")\n ...\n >>> from django.db import models\n >>> from django_richenum.models import CanonicalNameEnumField\n >>> class MyModel(models.Model):\n ... my_enum = CanonicalNameEnumField(MyRichEnum, default=MyRichEnum.FOO)\n ...\n >>> m = MyModel.objects.create(my_enum=MyRichEnum.BAR)\n >>> m.save()\n >>> m.my_enum\n RichEnumValue - canonical_name: 'bar' display_name: 'Bar'\n >>> MyModel.objects.filter(my_enum=MyRichEnum.BAR)\n\nRichEnumFieldListFilter\n-----------------------\n.. code:: python\n\n >>> from django_richenum.admin import register_admin_filters\n >>> register_admin_filters()\n\n\nRelated Packages\n================\n\nrichenum\n Package implementing RichEnum and OrderedRichEnum that django-richenum depends on.\n\n | `GitHub: richenum <https://github.com/hearsaycorp/richenum>`_\n\n | `PyPi: richenum <https://pypi.python.org/pypi/richenum/>`_\n\nNotes\n=====\n\nIf you're using Django 1.7+, you'll need to use the :python:`@deconstructible` decorator for your :python:`RichEnumValue` and :python:`OrderedRichEnumValue` classes so Django's migration framework knows how to serialize your :python:`RichEnumValue` and :python:`OrderedRichEnumValue`.\n\n.. code:: python\n\n >>> from django.utils.deconstruct import deconstructible\n >>> from richenum import RichEnumValue, OrderedRichEnumValue\n >>> @deconstructible\n ... class CustomRichEnumValue(RichEnumValue):\n ... pass\n ...\n >>> @deconstructible\n ... class CustomOrderedRichEnumValue(OrderedRichEnumValue):\n ... pass\n ...\n\nContributing\n============\n\n#. Fork the repo from `GitHub <https://github.com/hearsaycorp/django-richenum>`_.\n#. Make your changes.\n#. Add unittests for your changes.\n#. Run `pep8 <https://pypi.python.org/pypi/pep8>`_, `pyflakes <https://pypi.python.org/pypi/pyflakes>`_, and `pylint <https://pypi.python.org/pypi/pyflakes>`_ to make sure your changes follow the Python style guide and doesn't have any errors.\n#. Add yourself to the AUTHORS file (in alphabetical order).\n#. Send a pull request from your fork to the main repo.\n\n\nChangelog\n=========\n\n4.1.0 (2023-12-12)\n------------------\n - Support for Django 4.2\n - Support for Python 3.11\n - Remove support for Django 2.2, 3.0, 3.1\n - Remove support for Python 3.7\n - Require MySQL 8 and Postgres 12 \n\n3.7.0 (2019-09-05)\n------------------\n - Support for Django 2.3\n\n3.6.0 (2019-07-09)\n------------------\n - Support for Django 2.2\n - Support for Python 3.7\n - Remove support for Django 2.0\n\n3.5.0 (2018-09-10)\n------------------\n - Fix [deprecation of context param for Field.from_db_value](https://code.djangoproject.com/ticket/28370)\n - Support for Django 2.1\n - Switch tests suite to use pytest\n - Remove pylint-django plugin, no longer needed\n\n3.4.0 (2018-02-10)\n------------------\n - Drop support for old Django versions\n\n\n3.3.0 (2018-01-21)\n------------------\n - removed Python 3.4\n - add support for Python 3.6\n - add support for Django 2.0\n - Properly mark raw strings (used as regex)\n\n3.2.0 (2016-08-22)\n------------------\n - Python 3.4 & 3.5 support\n\n3.1.0 (2015-08-02)\n------------------\n - Django 1.10 support\n\n3.0.1 (2015-07-13)\n------------------\n - Prepare for python 3 support\n\n2.4.1 (2015-05-04)\n------------------\n - replace mysql client library (for tests)\n - stop using lambdas\n\n2.3.0 (2015-05-04)\n------------------\n - Support Django 1.8\n\n2.2.0 (2015-03-11)\n------------------\n - Support ModelForms for non-SQLite DB backends\n\n2.1.0 (2014-11-01)\n------------------\n - Support migration in Django 1.7\n\n2.0.0 (2014-09-04)\n------------------\n - Support Django 1.7, drop support for Python 2.6.\n\n1.2.2 (2014-08-02)\n------------------\n - Support Django 1.3\n\n1.2.1 (2014-06-02)\n------------------\n - Remove uses of BaseException.message.\n\n1.2.0 (2013-12-03)\n------------------\n - Add enum-aware versions of TypedMultipleChoiceField.\n\n1.1.0 (2013-12-03)\n------------------\n - Fix form fields to support Django 1.6 (while maintaining\n compatibility with 1.4 and 1.5).\n\n1.0.2 (2013-11-05)\n------------------\n - Make EnumField.run_validators a no-op.\n This stops some warnings from type comparison, and it doesn't seem\n useful in an EnumField context.\n\n1.0.1 (2013-09-10)\n------------------\n - Support South.\n\n1.0.0 (2013-08-16)\n------------------\n - Initial public release.\n\n\nDeveloped and maintained by `Hearsay Social, Inc.\n<https://hearsaysocial.com>`_.\n\nContributors\n============\n| `Adam DePue <https://github.com/adepue>`_\n| `Akshay Shah <https://github.com/akshayjshah>`_\n| `Dale Hui <https://github.com/dhui>`_\n| `Robert MacCloy <https://github.com/rbm>`_\n| `Ben Lopatin <https://github.com/bennylope>`_\n| `Asher Foa <https://github.com/asherf>`_\n| `Krisztian Csizmazia <https://github.com/csizmaziakiki>`_\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Django Enum library for python.",
"version": "5.0.0",
"project_urls": {
"Homepage": "https://github.com/hearsaycorp/django-richenum"
},
"split_keywords": [
"python",
"django",
"enum",
"richenum"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0f27b0f6d64ae33153d9dcb4c3c332448ac03a1db9569db4bc683b24520f3616",
"md5": "0c427dba55509574236af7a48458872c",
"sha256": "59dd00267d89ea97f69bf002a95ab9a809205010f9a14ee92f17faf1d4ecb457"
},
"downloads": -1,
"filename": "django_richenum-5.0.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "0c427dba55509574236af7a48458872c",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 11172,
"upload_time": "2023-12-13T16:36:26",
"upload_time_iso_8601": "2023-12-13T16:36:26.150290Z",
"url": "https://files.pythonhosted.org/packages/0f/27/b0f6d64ae33153d9dcb4c3c332448ac03a1db9569db4bc683b24520f3616/django_richenum-5.0.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3d48ea9d6f98a45f9ed684a38bb1690beb3245fdbda7fe4ba5135d8baba07e1d",
"md5": "be6cba36b9e03cc8bb97401fcfc4786f",
"sha256": "b33eeb46409e2d69a9f9306c11918e05f79cd9a6fe3375a1b4979cadc6e00d64"
},
"downloads": -1,
"filename": "django-richenum-5.0.0.tar.gz",
"has_sig": false,
"md5_digest": "be6cba36b9e03cc8bb97401fcfc4786f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14052,
"upload_time": "2023-12-13T16:36:28",
"upload_time_iso_8601": "2023-12-13T16:36:28.284654Z",
"url": "https://files.pythonhosted.org/packages/3d/48/ea9d6f98a45f9ed684a38bb1690beb3245fdbda7fe4ba5135d8baba07e1d/django-richenum-5.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-13 16:36:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hearsaycorp",
"github_project": "django-richenum",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "django-richenum"
}
JSON
