1
0
mirror of https://github.com/django/django.git synced 2025-10-23 21:59:11 +00:00

Add a BinaryField model field

Thanks Michael Jung, Charl Botha and Florian Apolloner for review
and help on the patch.
This commit is contained in:
Claude Paroz
2012-12-13 22:11:06 +01:00
parent 0f306cad84
commit 8ee1eddb7e
10 changed files with 85 additions and 2 deletions

View File

@@ -347,6 +347,22 @@ A 64 bit integer, much like an :class:`IntegerField` except that it is
guaranteed to fit numbers from -9223372036854775808 to 9223372036854775807. The
default form widget for this field is a :class:`~django.forms.TextInput`.
``BinaryField``
-------------------
.. class:: BinaryField([**options])
.. versionadded:: 1.6
A field to store raw binary data. It only supports ``bytes`` assignment. Be
aware that this field has limited functionality. For example, it is not possible
to filter a queryset on a ``BinaryField`` value.
.. admonition:: Abusing ``BinaryField``
Although you might think about storing files in the database, consider that
it is bad design in 99% of the cases. This field is *not* a replacement for
proper :ref.`static files <static-files> handling.
``BooleanField``
----------------

View File

@@ -53,6 +53,12 @@ UTC. This limitation was lifted in Django 1.6. Use :meth:`QuerySet.datetimes()
<django.db.models.query.QuerySet.datetimes>` to perform time zone aware
aggregation on a :class:`~django.db.models.DateTimeField`.
``BinaryField`` model field
~~~~~~~~~~~~~~~~~~~~~~~~~~~
A new :class:`django.db.models.BinaryField` model field allows to store raw
binary data in the database.
Minor features
~~~~~~~~~~~~~~