././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9685056 django-multiselectfield-0.1.12/0000755000174500017450000000000014363341605016344 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/CHANGES.rst0000644000174500017450000000566014012243172020144 0ustar00janitorjanitor0.1.12 (2020-02-20) ------------------- * Optimize multiselectfield to_python method * Thanks to: * `daimon99 `_ 0.1.11 (2019-12-19) ------------------- * Added support for Django 3 * Added support for Python 3.8 * Thanks to: * `thijsBoehme `_ 0.1.9 (2019-10-02) ------------------ * Added support for Django 2 * Added support for Python 3.6 * Drop support for Python (2.6, 3.3) * Thanks to: * `hirokinko `_ 0.1.6 (2017-05-10) ------------------ * Added support for Django 1.11 * Added support for Python 3.6 * Improved rendering in Django admin * Improved documentation * Thanks to: * `atten `_ * `ixc `_ * `LeilaniAnn `_ 0.1.5 (2017-01-02) ------------------ * Added support for Django 1.8-1.10 * Added support for named groups in choices * Added support for min_choices argument * Various fixes * More tests * Thanks to: * `danilogbotelho `_ * `dmitry-krasilnikov `_ * `Kamil Dębowski `_ 0.1.4 (2016-02-23) ------------------ * Fixed warning about SubfieldBase * Added support for Django 1.8+ * Added support for named groups * We now play nice with django-dynamic-fixture * More tests 0.1.3 (2014-10-13) ------------------ * Support to Django 1.7 (I'm sorry to the delay) * Adding get_FIELD_list function * Fix an error when a MultiSelectField was reandonly at the admin site * Thanks to: * `Hernil `_ * `Vasyl Stanislavchuk `_ * `Litchfield `_ * `Chris-erickson `_ 0.1.2 (2014-04-04) ------------------ * Include the spanish translations to the pypi egg * Improvements in the readme file * Windows OS compatibility * Thanks to: * `StillNewb `_ * `Diego Yungh `_ 0.1.1 (2013-12-04) ------------------ * Move the multiselectfield app to parent folder * Details 0.1.0 (2013-11-30) ------------------ * Test/example project * Now works if the first composant of the list of tuple is an integer * Now max_length is not required, the Multiselect field calculate it automatically. * The max_choices attr can be a attr in the model field * Refactor the code * Spanish translations * Support to python2.6 * Thanks to: * `Daniele Procida `_ 0.0.3 (2013-09-11) ------------------ * Python 3 compatible * Fix an error, the snippet had another error when the choices were translatables * Improvements in the README file 0.0.2 (2012-09-28) ------------------ * Fix an error, the snippet had an error. 0.0.1 (2012-09-27) ------------------ * Initial version from the next `snippet `_ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/COPYING.LGPLv30000644000174500017450000001672114012243172020403 0ustar00janitorjanitor GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. This version of the GNU Lesser General Public License incorporates the terms and conditions of version 3 of the GNU General Public License, supplemented by the additional permissions listed below. 0. Additional Definitions. As used herein, "this License" refers to version 3 of the GNU Lesser General Public License, and the "GNU GPL" refers to version 3 of the GNU General Public License. "The Library" refers to a covered work governed by this License, other than an Application or a Combined Work as defined below. An "Application" is any work that makes use of an interface provided by the Library, but which is not otherwise based on the Library. Defining a subclass of a class defined by the Library is deemed a mode of using an interface provided by the Library. A "Combined Work" is a work produced by combining or linking an Application with the Library. The particular version of the Library with which the Combined Work was made is also called the "Linked Version". The "Minimal Corresponding Source" for a Combined Work means the Corresponding Source for the Combined Work, excluding any source code for portions of the Combined Work that, considered in isolation, are based on the Application, and not on the Linked Version. The "Corresponding Application Code" for a Combined Work means the object code and/or source code for the Application, including any data and utility programs needed for reproducing the Combined Work from the Application, but excluding the System Libraries of the Combined Work. 1. Exception to Section 3 of the GNU GPL. You may convey a covered work under sections 3 and 4 of this License without being bound by section 3 of the GNU GPL. 2. Conveying Modified Versions. If you modify a copy of the Library, and, in your modifications, a facility refers to a function or data to be supplied by an Application that uses the facility (other than as an argument passed when the facility is invoked), then you may convey a copy of the modified version: a) under this License, provided that you make a good faith effort to ensure that, in the event an Application does not supply the function or data, the facility still operates, and performs whatever part of its purpose remains meaningful, or b) under the GNU GPL, with none of the additional permissions of this License applicable to that copy. 3. Object Code Incorporating Material from Library Header Files. The object code form of an Application may incorporate material from a header file that is part of the Library. You may convey such object code under terms of your choice, provided that, if the incorporated material is not limited to numerical parameters, data structure layouts and accessors, or small macros, inline functions and templates (ten or fewer lines in length), you do both of the following: a) Give prominent notice with each copy of the object code that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the object code with a copy of the GNU GPL and this license document. 4. Combined Works. You may convey a Combined Work under terms of your choice that, taken together, effectively do not restrict modification of the portions of the Library contained in the Combined Work and reverse engineering for debugging such modifications, if you also do each of the following: a) Give prominent notice with each copy of the Combined Work that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the Combined Work with a copy of the GNU GPL and this license document. c) For a Combined Work that displays copyright notices during execution, include the copyright notice for the Library among these notices, as well as a reference directing the user to the copies of the GNU GPL and this license document. d) Do one of the following: 0) Convey the Minimal Corresponding Source under the terms of this License, and the Corresponding Application Code in a form suitable for, and under terms that permit, the user to recombine or relink the Application with a modified version of the Linked Version to produce a modified Combined Work, in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source. 1) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (a) uses at run time a copy of the Library already present on the user's computer system, and (b) will operate properly with a modified version of the Library that is interface-compatible with the Linked Version. e) Provide Installation Information, but only if you would otherwise be required to provide such information under section 6 of the GNU GPL, and only to the extent that such information is necessary to install and execute a modified version of the Combined Work produced by recombining or relinking the Application with a modified version of the Linked Version. (If you use option 4d0, the Installation Information must accompany the Minimal Corresponding Source and Corresponding Application Code. If you use option 4d1, you must provide the Installation Information in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.) 5. Combined Libraries. You may place library facilities that are a work based on the Library side by side in a single library together with other library facilities that are not Applications and are not covered by this License, and convey such a combined library under terms of your choice, if you do both of the following: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities, conveyed under the terms of this License. b) Give prominent notice with the combined library that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 6. Revised Versions of the GNU Lesser General Public License. The Free Software Foundation may publish revised and/or new versions of the GNU Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library as you received it specifies that a certain numbered version of the GNU Lesser General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that published version or of any later version published by the Free Software Foundation. If the Library as you received it does not specify a version number of the GNU Lesser General Public License, you may choose any version of the GNU Lesser General Public License ever published by the Free Software Foundation. If the Library as you received it specifies that a proxy can decide whether future versions of the GNU Lesser General Public License shall apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Library.././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/MANIFEST.in0000644000174500017450000000016014012243172020066 0ustar00janitorjanitorinclude README.rst include CHANGES.rst include COPYING.LGPLv3 include multiselectfield/locale/*/LC_MESSAGES/*.* ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9645057 django-multiselectfield-0.1.12/PKG-INFO0000644000174500017450000002167714363341605017456 0ustar00janitorjanitorMetadata-Version: 2.1 Name: django-multiselectfield Version: 0.1.12 Summary: Django multiple select field Home-page: https://github.com/goinnn/django-multiselectfield Author: Pablo Martin Author-email: goinnn@gmail.com License: LGPL 3 Keywords: django,multiple,select,field,choices Classifier: Development Status :: 4 - Beta Classifier: Framework :: Django Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL) Classifier: Programming Language :: Python :: 2 Classifier: Programming Language :: Python :: 2.6 Classifier: Programming Language :: Python :: 2.7 Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.3 Classifier: Programming Language :: Python :: 3.4 Classifier: Programming Language :: Python :: 3.5 Classifier: Programming Language :: Python :: 3.6 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 License-File: COPYING.LGPLv3 django-multiselectfield ======================= .. image:: https://travis-ci.org/goinnn/django-multiselectfield.png?branch=master :target: https://travis-ci.org/goinnn/django-multiselectfield .. image:: https://coveralls.io/repos/goinnn/django-multiselectfield/badge.png?branch=master :target: https://coveralls.io/r/goinnn/django-multiselectfield .. image:: https://badge.fury.io/py/django-multiselectfield.png :target: https://badge.fury.io/py/django-multiselectfield A new model field and form field. With this you can get a multiple select from a choices. Stores to the database as a CharField of comma-separated values. This egg is inspired by this `snippet `_. Supported Python versions: 2.7, 3.4+ Supported Django versions: 1.4-2.0+ Installation ============ Install with pip ---------------- .. code-block:: bash $ pip install django-multiselectfield Configure your models.py ------------------------ .. code-block:: python from multiselectfield import MultiSelectField # ... MY_CHOICES = (('item_key1', 'Item title 1.1'), ('item_key2', 'Item title 1.2'), ('item_key3', 'Item title 1.3'), ('item_key4', 'Item title 1.4'), ('item_key5', 'Item title 1.5')) MY_CHOICES2 = ((1, 'Item title 2.1'), (2, 'Item title 2.2'), (3, 'Item title 2.3'), (4, 'Item title 2.4'), (5, 'Item title 2.5')) class MyModel(models.Model): # ..... my_field = MultiSelectField(choices=MY_CHOICES) my_field2 = MultiSelectField(choices=MY_CHOICES2, max_choices=3, max_length=3) In your settings.py ------------------- Only you need it, if you want the translation of django-multiselectfield .. code-block:: python INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'django.contrib.admin', #.....................# 'multiselectfield', ) Customizing templates --------------------- It is possible to customize the HTML of this widget in your form template. To do so, you will need to loop through ``form.{field}.field.choices``. Here is an example that displays the field label underneath/after the checkbox for a ``MultiSelectField`` called ``providers``: .. code-block:: HTML+Django {% for value, text in form.providers.field.choices %}
{% endfor %} Django REST Framework --------------------- Django REST Framework comes with a ``MultipleChoiceField`` that works perfectly with this: .. code-block:: python from rest_framework import fields, serializers from myapp.models import MY_CHOICES, MY_CHOICES2 class MyModelSerializer(serializers.HyperlinkedModelSerializer): # ... my_field = fields.MultipleChoiceField(choices=MY_CHOICES) my_field2 = fields.MultipleChoiceField(choices=MY_CHOICES2) # ... Known Bugs and Limitations ========================== All tests pass on Django 1.4, 1.5, and 1.8+, so if you can, use a modern version of Django. However, if you must use Django 1.6 or 1.7 there are two known issues you will need to be aware of: 1. `Named groups `_ do not render properly in Django 1.6. The workaround is to manually render the field in your form or use a custom widget. If your workaround is suitably generic, please submit a pull request with it. 2. Only in Django 1.6 and 1.7, due to `Django bug #9619 `_, passing a MultiSelectField to ``values()`` or ``values_list()`` will return the database representation of the field (a string of comma-separated values). The workaround is to manually call ``.split(',')`` on the result. The Django bug was introduced in Django 1.6 and is fixed in Django 1.8 and onward, so ``values()`` and ``values_list()`` return a vanilla Python list of values for Django <= 1.5 and Django >= 1.8. See `issue #40 `_ for discussion about this bug. Development =========== You can get the last bleeding edge version of django-multiselectfield by doing a clone of its git repository: .. code-block:: bash git clone https://github.com/goinnn/django-multiselectfield Example project =============== There is a fully configured example project in the `example directory `_. You can run it as usual: .. code-block:: bash python manage.py migrate # or python manage.py syncdb --noinput python manage.py loaddata app_data python manage.py runserver 0.1.12 (2020-02-20) ------------------- * Optimize multiselectfield to_python method * Thanks to: * `daimon99 `_ 0.1.11 (2019-12-19) ------------------- * Added support for Django 3 * Added support for Python 3.8 * Thanks to: * `thijsBoehme `_ 0.1.9 (2019-10-02) ------------------ * Added support for Django 2 * Added support for Python 3.6 * Drop support for Python (2.6, 3.3) * Thanks to: * `hirokinko `_ 0.1.6 (2017-05-10) ------------------ * Added support for Django 1.11 * Added support for Python 3.6 * Improved rendering in Django admin * Improved documentation * Thanks to: * `atten `_ * `ixc `_ * `LeilaniAnn `_ 0.1.5 (2017-01-02) ------------------ * Added support for Django 1.8-1.10 * Added support for named groups in choices * Added support for min_choices argument * Various fixes * More tests * Thanks to: * `danilogbotelho `_ * `dmitry-krasilnikov `_ * `Kamil Dębowski `_ 0.1.4 (2016-02-23) ------------------ * Fixed warning about SubfieldBase * Added support for Django 1.8+ * Added support for named groups * We now play nice with django-dynamic-fixture * More tests 0.1.3 (2014-10-13) ------------------ * Support to Django 1.7 (I'm sorry to the delay) * Adding get_FIELD_list function * Fix an error when a MultiSelectField was reandonly at the admin site * Thanks to: * `Hernil `_ * `Vasyl Stanislavchuk `_ * `Litchfield `_ * `Chris-erickson `_ 0.1.2 (2014-04-04) ------------------ * Include the spanish translations to the pypi egg * Improvements in the readme file * Windows OS compatibility * Thanks to: * `StillNewb `_ * `Diego Yungh `_ 0.1.1 (2013-12-04) ------------------ * Move the multiselectfield app to parent folder * Details 0.1.0 (2013-11-30) ------------------ * Test/example project * Now works if the first composant of the list of tuple is an integer * Now max_length is not required, the Multiselect field calculate it automatically. * The max_choices attr can be a attr in the model field * Refactor the code * Spanish translations * Support to python2.6 * Thanks to: * `Daniele Procida `_ 0.0.3 (2013-09-11) ------------------ * Python 3 compatible * Fix an error, the snippet had another error when the choices were translatables * Improvements in the README file 0.0.2 (2012-09-28) ------------------ * Fix an error, the snippet had an error. 0.0.1 (2012-09-27) ------------------ * Initial version from the next `snippet `_ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/README.rst0000644000174500017450000001207714012243172020031 0ustar00janitorjanitordjango-multiselectfield ======================= .. image:: https://travis-ci.org/goinnn/django-multiselectfield.png?branch=master :target: https://travis-ci.org/goinnn/django-multiselectfield .. image:: https://coveralls.io/repos/goinnn/django-multiselectfield/badge.png?branch=master :target: https://coveralls.io/r/goinnn/django-multiselectfield .. image:: https://badge.fury.io/py/django-multiselectfield.png :target: https://badge.fury.io/py/django-multiselectfield A new model field and form field. With this you can get a multiple select from a choices. Stores to the database as a CharField of comma-separated values. This egg is inspired by this `snippet `_. Supported Python versions: 2.7, 3.4+ Supported Django versions: 1.4-2.0+ Installation ============ Install with pip ---------------- .. code-block:: bash $ pip install django-multiselectfield Configure your models.py ------------------------ .. code-block:: python from multiselectfield import MultiSelectField # ... MY_CHOICES = (('item_key1', 'Item title 1.1'), ('item_key2', 'Item title 1.2'), ('item_key3', 'Item title 1.3'), ('item_key4', 'Item title 1.4'), ('item_key5', 'Item title 1.5')) MY_CHOICES2 = ((1, 'Item title 2.1'), (2, 'Item title 2.2'), (3, 'Item title 2.3'), (4, 'Item title 2.4'), (5, 'Item title 2.5')) class MyModel(models.Model): # ..... my_field = MultiSelectField(choices=MY_CHOICES) my_field2 = MultiSelectField(choices=MY_CHOICES2, max_choices=3, max_length=3) In your settings.py ------------------- Only you need it, if you want the translation of django-multiselectfield .. code-block:: python INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'django.contrib.admin', #.....................# 'multiselectfield', ) Customizing templates --------------------- It is possible to customize the HTML of this widget in your form template. To do so, you will need to loop through ``form.{field}.field.choices``. Here is an example that displays the field label underneath/after the checkbox for a ``MultiSelectField`` called ``providers``: .. code-block:: HTML+Django {% for value, text in form.providers.field.choices %}
{% endfor %} Django REST Framework --------------------- Django REST Framework comes with a ``MultipleChoiceField`` that works perfectly with this: .. code-block:: python from rest_framework import fields, serializers from myapp.models import MY_CHOICES, MY_CHOICES2 class MyModelSerializer(serializers.HyperlinkedModelSerializer): # ... my_field = fields.MultipleChoiceField(choices=MY_CHOICES) my_field2 = fields.MultipleChoiceField(choices=MY_CHOICES2) # ... Known Bugs and Limitations ========================== All tests pass on Django 1.4, 1.5, and 1.8+, so if you can, use a modern version of Django. However, if you must use Django 1.6 or 1.7 there are two known issues you will need to be aware of: 1. `Named groups `_ do not render properly in Django 1.6. The workaround is to manually render the field in your form or use a custom widget. If your workaround is suitably generic, please submit a pull request with it. 2. Only in Django 1.6 and 1.7, due to `Django bug #9619 `_, passing a MultiSelectField to ``values()`` or ``values_list()`` will return the database representation of the field (a string of comma-separated values). The workaround is to manually call ``.split(',')`` on the result. The Django bug was introduced in Django 1.6 and is fixed in Django 1.8 and onward, so ``values()`` and ``values_list()`` return a vanilla Python list of values for Django <= 1.5 and Django >= 1.8. See `issue #40 `_ for discussion about this bug. Development =========== You can get the last bleeding edge version of django-multiselectfield by doing a clone of its git repository: .. code-block:: bash git clone https://github.com/goinnn/django-multiselectfield Example project =============== There is a fully configured example project in the `example directory `_. You can run it as usual: .. code-block:: bash python manage.py migrate # or python manage.py syncdb --noinput python manage.py loaddata app_data python manage.py runserver ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9645057 django-multiselectfield-0.1.12/django_multiselectfield.egg-info/0000755000174500017450000000000014363341605024716 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674429316.0 django-multiselectfield-0.1.12/django_multiselectfield.egg-info/PKG-INFO0000644000174500017450000002167714363341604026027 0ustar00janitorjanitorMetadata-Version: 2.1 Name: django-multiselectfield Version: 0.1.12 Summary: Django multiple select field Home-page: https://github.com/goinnn/django-multiselectfield Author: Pablo Martin Author-email: goinnn@gmail.com License: LGPL 3 Keywords: django,multiple,select,field,choices Classifier: Development Status :: 4 - Beta Classifier: Framework :: Django Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL) Classifier: Programming Language :: Python :: 2 Classifier: Programming Language :: Python :: 2.6 Classifier: Programming Language :: Python :: 2.7 Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.3 Classifier: Programming Language :: Python :: 3.4 Classifier: Programming Language :: Python :: 3.5 Classifier: Programming Language :: Python :: 3.6 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 License-File: COPYING.LGPLv3 django-multiselectfield ======================= .. image:: https://travis-ci.org/goinnn/django-multiselectfield.png?branch=master :target: https://travis-ci.org/goinnn/django-multiselectfield .. image:: https://coveralls.io/repos/goinnn/django-multiselectfield/badge.png?branch=master :target: https://coveralls.io/r/goinnn/django-multiselectfield .. image:: https://badge.fury.io/py/django-multiselectfield.png :target: https://badge.fury.io/py/django-multiselectfield A new model field and form field. With this you can get a multiple select from a choices. Stores to the database as a CharField of comma-separated values. This egg is inspired by this `snippet `_. Supported Python versions: 2.7, 3.4+ Supported Django versions: 1.4-2.0+ Installation ============ Install with pip ---------------- .. code-block:: bash $ pip install django-multiselectfield Configure your models.py ------------------------ .. code-block:: python from multiselectfield import MultiSelectField # ... MY_CHOICES = (('item_key1', 'Item title 1.1'), ('item_key2', 'Item title 1.2'), ('item_key3', 'Item title 1.3'), ('item_key4', 'Item title 1.4'), ('item_key5', 'Item title 1.5')) MY_CHOICES2 = ((1, 'Item title 2.1'), (2, 'Item title 2.2'), (3, 'Item title 2.3'), (4, 'Item title 2.4'), (5, 'Item title 2.5')) class MyModel(models.Model): # ..... my_field = MultiSelectField(choices=MY_CHOICES) my_field2 = MultiSelectField(choices=MY_CHOICES2, max_choices=3, max_length=3) In your settings.py ------------------- Only you need it, if you want the translation of django-multiselectfield .. code-block:: python INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'django.contrib.admin', #.....................# 'multiselectfield', ) Customizing templates --------------------- It is possible to customize the HTML of this widget in your form template. To do so, you will need to loop through ``form.{field}.field.choices``. Here is an example that displays the field label underneath/after the checkbox for a ``MultiSelectField`` called ``providers``: .. code-block:: HTML+Django {% for value, text in form.providers.field.choices %}
{% endfor %} Django REST Framework --------------------- Django REST Framework comes with a ``MultipleChoiceField`` that works perfectly with this: .. code-block:: python from rest_framework import fields, serializers from myapp.models import MY_CHOICES, MY_CHOICES2 class MyModelSerializer(serializers.HyperlinkedModelSerializer): # ... my_field = fields.MultipleChoiceField(choices=MY_CHOICES) my_field2 = fields.MultipleChoiceField(choices=MY_CHOICES2) # ... Known Bugs and Limitations ========================== All tests pass on Django 1.4, 1.5, and 1.8+, so if you can, use a modern version of Django. However, if you must use Django 1.6 or 1.7 there are two known issues you will need to be aware of: 1. `Named groups `_ do not render properly in Django 1.6. The workaround is to manually render the field in your form or use a custom widget. If your workaround is suitably generic, please submit a pull request with it. 2. Only in Django 1.6 and 1.7, due to `Django bug #9619 `_, passing a MultiSelectField to ``values()`` or ``values_list()`` will return the database representation of the field (a string of comma-separated values). The workaround is to manually call ``.split(',')`` on the result. The Django bug was introduced in Django 1.6 and is fixed in Django 1.8 and onward, so ``values()`` and ``values_list()`` return a vanilla Python list of values for Django <= 1.5 and Django >= 1.8. See `issue #40 `_ for discussion about this bug. Development =========== You can get the last bleeding edge version of django-multiselectfield by doing a clone of its git repository: .. code-block:: bash git clone https://github.com/goinnn/django-multiselectfield Example project =============== There is a fully configured example project in the `example directory `_. You can run it as usual: .. code-block:: bash python manage.py migrate # or python manage.py syncdb --noinput python manage.py loaddata app_data python manage.py runserver 0.1.12 (2020-02-20) ------------------- * Optimize multiselectfield to_python method * Thanks to: * `daimon99 `_ 0.1.11 (2019-12-19) ------------------- * Added support for Django 3 * Added support for Python 3.8 * Thanks to: * `thijsBoehme `_ 0.1.9 (2019-10-02) ------------------ * Added support for Django 2 * Added support for Python 3.6 * Drop support for Python (2.6, 3.3) * Thanks to: * `hirokinko `_ 0.1.6 (2017-05-10) ------------------ * Added support for Django 1.11 * Added support for Python 3.6 * Improved rendering in Django admin * Improved documentation * Thanks to: * `atten `_ * `ixc `_ * `LeilaniAnn `_ 0.1.5 (2017-01-02) ------------------ * Added support for Django 1.8-1.10 * Added support for named groups in choices * Added support for min_choices argument * Various fixes * More tests * Thanks to: * `danilogbotelho `_ * `dmitry-krasilnikov `_ * `Kamil DÄ™bowski `_ 0.1.4 (2016-02-23) ------------------ * Fixed warning about SubfieldBase * Added support for Django 1.8+ * Added support for named groups * We now play nice with django-dynamic-fixture * More tests 0.1.3 (2014-10-13) ------------------ * Support to Django 1.7 (I'm sorry to the delay) * Adding get_FIELD_list function * Fix an error when a MultiSelectField was reandonly at the admin site * Thanks to: * `Hernil `_ * `Vasyl Stanislavchuk `_ * `Litchfield `_ * `Chris-erickson `_ 0.1.2 (2014-04-04) ------------------ * Include the spanish translations to the pypi egg * Improvements in the readme file * Windows OS compatibility * Thanks to: * `StillNewb `_ * `Diego Yungh `_ 0.1.1 (2013-12-04) ------------------ * Move the multiselectfield app to parent folder * Details 0.1.0 (2013-11-30) ------------------ * Test/example project * Now works if the first composant of the list of tuple is an integer * Now max_length is not required, the Multiselect field calculate it automatically. * The max_choices attr can be a attr in the model field * Refactor the code * Spanish translations * Support to python2.6 * Thanks to: * `Daniele Procida `_ 0.0.3 (2013-09-11) ------------------ * Python 3 compatible * Fix an error, the snippet had another error when the choices were translatables * Improvements in the README file 0.0.2 (2012-09-28) ------------------ * Fix an error, the snippet had an error. 0.0.1 (2012-09-27) ------------------ * Initial version from the next `snippet `_ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674429316.0 django-multiselectfield-0.1.12/django_multiselectfield.egg-info/SOURCES.txt0000644000174500017450000000124514363341604026603 0ustar00janitorjanitorCHANGES.rst COPYING.LGPLv3 MANIFEST.in README.rst setup.py django_multiselectfield.egg-info/PKG-INFO django_multiselectfield.egg-info/SOURCES.txt django_multiselectfield.egg-info/dependency_links.txt django_multiselectfield.egg-info/not-zip-safe django_multiselectfield.egg-info/requires.txt django_multiselectfield.egg-info/top_level.txt multiselectfield/__init__.py multiselectfield/apps.py multiselectfield/utils.py multiselectfield/validators.py multiselectfield/db/__init__.py multiselectfield/db/fields.py multiselectfield/forms/__init__.py multiselectfield/forms/fields.py multiselectfield/locale/es/LC_MESSAGES/django.mo multiselectfield/locale/es/LC_MESSAGES/django.po././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674429316.0 django-multiselectfield-0.1.12/django_multiselectfield.egg-info/dependency_links.txt0000644000174500017450000000000114363341604030763 0ustar00janitorjanitor ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674429316.0 django-multiselectfield-0.1.12/django_multiselectfield.egg-info/not-zip-safe0000644000174500017450000000000114363341604027143 0ustar00janitorjanitor ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674429316.0 django-multiselectfield-0.1.12/django_multiselectfield.egg-info/requires.txt0000644000174500017450000000001414363341604027310 0ustar00janitorjanitordjango>=1.4 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674429316.0 django-multiselectfield-0.1.12/django_multiselectfield.egg-info/top_level.txt0000644000174500017450000000002114363341604027440 0ustar00janitorjanitormultiselectfield ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9645057 django-multiselectfield-0.1.12/multiselectfield/0000755000174500017450000000000014363341605021702 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/__init__.py0000644000174500017450000000033114012243172023777 0ustar00janitorjanitorfrom multiselectfield.db.fields import MultiSelectField # noqa: F401 from multiselectfield.forms.fields import MultiSelectFormField # noqa: F401 default_app_config = 'multiselectfield.apps.MultiSelectFieldConfig' ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/apps.py0000644000174500017450000000022214012243172023202 0ustar00janitorjanitorfrom django.apps import AppConfig class MultiSelectFieldConfig(AppConfig): name = 'multiselectfield' verbose_name = 'Multiselect Field' ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9645057 django-multiselectfield-0.1.12/multiselectfield/db/0000755000174500017450000000000014363341605022267 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/db/__init__.py0000644000174500017450000000000014012243172024355 0ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/db/fields.py0000644000174500017450000001662014012243172024103 0ustar00janitorjanitor# -*- coding: utf-8 -*- # Copyright (c) 2012 by Pablo Martín # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with this programe. If not, see . import sys from django import VERSION from django.db import models from django.utils.text import capfirst from django.core import exceptions from ..forms.fields import MultiSelectFormField, MinChoicesValidator, MaxChoicesValidator from ..utils import MSFList, get_max_length from ..validators import MaxValueMultiFieldValidator if sys.version_info < (3,): string_type = unicode # noqa: F821 else: string_type = str # Code from six egg https://bitbucket.org/gutworth/six/src/a3641cb211cc360848f1e2dd92e9ae6cd1de55dd/six.py?at=default def add_metaclass(metaclass): """Class decorator for creating a class with a metaclass.""" def wrapper(cls): orig_vars = cls.__dict__.copy() orig_vars.pop('__dict__', None) orig_vars.pop('__weakref__', None) for slots_var in orig_vars.get('__slots__', ()): orig_vars.pop(slots_var) return metaclass(cls.__name__, cls.__bases__, orig_vars) return wrapper class MultiSelectField(models.CharField): """ Choice values can not contain commas. """ def __init__(self, *args, **kwargs): self.min_choices = kwargs.pop('min_choices', None) self.max_choices = kwargs.pop('max_choices', None) super(MultiSelectField, self).__init__(*args, **kwargs) self.max_length = get_max_length(self.choices, self.max_length) self.validators[0] = MaxValueMultiFieldValidator(self.max_length) if self.min_choices is not None: self.validators.append(MinChoicesValidator(self.min_choices)) if self.max_choices is not None: self.validators.append(MaxChoicesValidator(self.max_choices)) def _get_flatchoices(self): flat_choices = super(MultiSelectField, self)._get_flatchoices() class MSFFlatchoices(list): # Used to trick django.contrib.admin.utils.display_for_field into # not treating the list of values as a dictionary key (which errors # out) def __bool__(self): return False __nonzero__ = __bool__ return MSFFlatchoices(flat_choices) flatchoices = property(_get_flatchoices) def get_choices_default(self): return self.get_choices(include_blank=False) def get_choices_selected(self, arr_choices): named_groups = arr_choices and isinstance(arr_choices[0][1], (list, tuple)) choices_selected = [] if named_groups: for choice_group_selected in arr_choices: for choice_selected in choice_group_selected[1]: choices_selected.append(string_type(choice_selected[0])) else: for choice_selected in arr_choices: choices_selected.append(string_type(choice_selected[0])) return choices_selected def value_to_string(self, obj): try: value = self._get_val_from_obj(obj) except AttributeError: value = super(MultiSelectField, self).value_from_object(obj) return self.get_prep_value(value) def validate(self, value, model_instance): arr_choices = self.get_choices_selected(self.get_choices_default()) for opt_select in value: if (opt_select not in arr_choices): if VERSION >= (1, 6): raise exceptions.ValidationError(self.error_messages['invalid_choice'] % {"value": value}) else: raise exceptions.ValidationError(self.error_messages['invalid_choice'] % value) def get_default(self): default = super(MultiSelectField, self).get_default() if isinstance(default, int): default = string_type(default) return default def formfield(self, **kwargs): defaults = {'required': not self.blank, 'label': capfirst(self.verbose_name), 'help_text': self.help_text, 'choices': self.choices, 'flat_choices': self.flatchoices, 'max_length': self.max_length, 'max_choices': self.max_choices} if self.has_default(): defaults['initial'] = self.get_default() defaults.update(kwargs) return MultiSelectFormField(**defaults) def get_prep_value(self, value): return '' if value is None else ",".join(map(str, value)) def get_db_prep_value(self, value, connection, prepared=False): if not prepared and not isinstance(value, string_type): value = self.get_prep_value(value) return value def to_python(self, value): choices = dict(self.flatchoices) if value: if isinstance(value, list): return value elif isinstance(value, string_type): value_list = map(lambda x: x.strip(), value.replace(u'，', ',').split(',')) return MSFList(choices, value_list) elif isinstance(value, (set, dict)): return MSFList(choices, list(value)) return MSFList(choices, []) if VERSION < (2, ): def from_db_value(self, value, expression, connection, context): if value is None: return value return self.to_python(value) else: def from_db_value(self, value, expression, connection): if value is None: return value return self.to_python(value) def contribute_to_class(self, cls, name): super(MultiSelectField, self).contribute_to_class(cls, name) if self.choices: def get_list(obj): fieldname = name choicedict = dict(self.choices) display = [] if getattr(obj, fieldname): for value in getattr(obj, fieldname): item_display = choicedict.get(value, None) if item_display is None: try: item_display = choicedict.get(int(value), value) except (ValueError, TypeError): item_display = value display.append(string_type(item_display)) return display def get_display(obj): return ", ".join(get_list(obj)) get_display.short_description = self.verbose_name setattr(cls, 'get_%s_list' % self.name, get_list) setattr(cls, 'get_%s_display' % self.name, get_display) if VERSION < (1, 8): MultiSelectField = add_metaclass(models.SubfieldBase)(MultiSelectField) try: from south.modelsinspector import add_introspection_rules add_introspection_rules([], ['^multiselectfield\.db.fields\.MultiSelectField']) except ImportError: pass ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9645057 django-multiselectfield-0.1.12/multiselectfield/forms/0000755000174500017450000000000014363341605023030 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/forms/__init__.py0000644000174500017450000000000014012243172025116 0ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/forms/fields.py0000644000174500017450000000350014012243172024635 0ustar00janitorjanitor# -*- coding: utf-8 -*- # Copyright (c) 2012 by Pablo Martín # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with this programe. If not, see . from django import forms from ..utils import MSFList, get_max_length from ..validators import MaxValueMultiFieldValidator, MinChoicesValidator, MaxChoicesValidator class MultiSelectFormField(forms.MultipleChoiceField): widget = forms.CheckboxSelectMultiple def __init__(self, *args, **kwargs): self.min_choices = kwargs.pop('min_choices', None) self.max_choices = kwargs.pop('max_choices', None) self.max_length = kwargs.pop('max_length', None) self.flat_choices = kwargs.pop('flat_choices') super(MultiSelectFormField, self).__init__(*args, **kwargs) self.max_length = get_max_length(self.choices, self.max_length) self.validators.append(MaxValueMultiFieldValidator(self.max_length)) if self.max_choices is not None: self.validators.append(MaxChoicesValidator(self.max_choices)) if self.min_choices is not None: self.validators.append(MinChoicesValidator(self.min_choices)) def to_python(self, value): return MSFList(dict(self.flat_choices), super(MultiSelectFormField, self).to_python(value)) ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9645057 django-multiselectfield-0.1.12/multiselectfield/locale/0000755000174500017450000000000014363341605023141 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9645057 django-multiselectfield-0.1.12/multiselectfield/locale/es/0000755000174500017450000000000014363341605023550 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9645057 django-multiselectfield-0.1.12/multiselectfield/locale/es/LC_MESSAGES/0000755000174500017450000000000014363341605025335 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/locale/es/LC_MESSAGES/django.mo0000644000174500017450000000106414012243172027124 0ustar00janitorjanitorÞ•,<P6Qkˆ?ôYou must select a maximum of %(limit_value)d choices.Project-Id-Version: 1.0.0 Report-Msgid-Bugs-To: POT-Creation-Date: 2013-11-30 20:06-0500 PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE Last-Translator: Pablo Martín Language-Team: Es Language: Es MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Plural-Forms: nplurals=2; plural=(n != 1); Tu debes de seleccionar un máximo de %(limit_value)d opciones.././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/locale/es/LC_MESSAGES/django.po0000644000174500017450000000140214012243172027123 0ustar00janitorjanitor# django-multiselectfield. # Copyright (C) 2012-2013 # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , 2012. # msgid "" msgstr "" "Project-Id-Version: 1.0.0\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2013-11-30 20:06-0500\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Pablo Martín \n" "Language-Team: Es \n" "Language: Es\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: validators.py:28 #, python-format msgid "You must select a maximum of %(limit_value)d choices." msgstr "Tu debes de seleccionar un máximo de %(limit_value)d opciones." ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/utils.py0000644000174500017450000000310714012243172023404 0ustar00janitorjanitor# -*- coding: utf-8 -*- # Copyright (c) 2013 by Pablo Martín # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with this programe. If not, see . import sys if sys.version_info[0] == 2: string = basestring # noqa: F821 string_type = unicode # noqa: F821 else: string = str string_type = string class MSFList(list): def __init__(self, choices, *args, **kwargs): self.choices = choices super(MSFList, self).__init__(*args, **kwargs) def __str__(msgl): msg_list = [msgl.choices.get(int(i)) if i.isdigit() else msgl.choices.get(i) for i in msgl] return u', '.join([string_type(s) for s in msg_list]) if sys.version_info < (3,): def __unicode__(self, msgl): return self.__str__(msgl) def get_max_length(choices, max_length, default=200): if max_length is None: if choices: return len(','.join([string_type(key) for key, label in choices])) else: return default return max_length ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/multiselectfield/validators.py0000644000174500017450000000243614012243172024420 0ustar00janitorjanitor# -*- coding: utf-8 -*- # Copyright (c) 2013 by Pablo Martín # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with this programe. If not, see . from django.core import validators from django.utils.translation import gettext_lazy as _ class MaxValueMultiFieldValidator(validators.MaxLengthValidator): code = 'max_multifield_value' def clean(self, x): return len(','.join(x)) class MinChoicesValidator(validators.MinLengthValidator): message = _(u'You must select a minimum of %(limit_value)d choices.') code = 'min_choices' class MaxChoicesValidator(validators.MaxLengthValidator): message = _(u'You must select a maximum of %(limit_value)d choices.') code = 'max_choices' ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674429316.9685056 django-multiselectfield-0.1.12/setup.cfg0000644000174500017450000000004614363341605020165 0ustar00janitorjanitor[egg_info] tag_build = tag_date = 0 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1613317754.0 django-multiselectfield-0.1.12/setup.py0000644000174500017450000000444514012243172020054 0ustar00janitorjanitor# -*- coding: utf-8 -*- # Copyright (c) 2012 by Pablo Martín # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with this programe. If not, see . # Initial code got from http://djangosnippets.org/users/danielroseman/ import codecs import os from setuptools import setup, find_packages def read(*rnames): with codecs.open( os.path.join(os.path.dirname(__file__), *rnames), 'r', 'utf-8', ) as f: return f.read() setup( name="django-multiselectfield", version="0.1.12", author="Pablo Martin", author_email="goinnn@gmail.com", description="Django multiple select field", long_description=(read('README.rst') + '\n\n' + read('CHANGES.rst')), classifiers=[ 'Development Status :: 4 - Beta', 'Framework :: Django', 'License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)', 'Programming Language :: Python :: 2', 'Programming Language :: Python :: 2.6', 'Programming Language :: Python :: 2.7', 'Programming Language :: Python :: 3', 'Programming Language :: Python :: 3.3', 'Programming Language :: Python :: 3.4', 'Programming Language :: Python :: 3.5', 'Programming Language :: Python :: 3.6', 'Programming Language :: Python :: 3.7', 'Programming Language :: Python :: 3.8', ], license="LGPL 3", keywords="django,multiple,select,field,choices", url='https://github.com/goinnn/django-multiselectfield', packages=find_packages(), include_package_data=True, tests_require=[ 'django>=1.4', 'tox', 'coverage', 'flake8', ], install_requires=[ 'django>=1.4', ], zip_safe=False, )