Field for storing data as Base64-encoded values.
Base64Field for the main field type and usage instructions.
- exception Base64TypeError(value)¶
Error indicating an invalid value type was provided for the field.
- class Base64DecodedValue¶
An identifiable wrapper around byte string values for Base64Field.
This wraps any values coming from
Base64Field, helping make a distinction between arbitrary strings and decoded strings from the database. It helps prevent double-encoding or double-decoding of data.
- class Base64FieldCreator(field)¶
Property-like class used to store/retrieve Base64 values.
This works much like a property, and takes care of encoding strings for storage and decoding them on retrieval. It’s set internally by
Base64Fieldin place of the normal field attribute.
Initialize the creator.
Base64Field) – The field owning this object.
- __set__(obj, value)¶
Set a new value in the field.
If this is a
Base64DecodedValue, or the model is new and hasn’t yet been persisted to the database, the value will be encoded and stored. Otherwise, if it’s a standard string value or the model is not new, it’s assumed that this is encoded data for storage, and will be stored directly.
- __get__(obj, *args, **kwargs)¶
Return a decoded value from the field.
The decoded value from the field. If no value has yet been stored, this will return
- Return type
- class Base64Field(*args, db_collation=None, **kwargs)¶
A text field for storing Base64-encoded values.
This is used to store data (such as binary data or encoding-sensitive data) to the database in a Base64 encoding. This is useful if you’re dealing with unknown encodings and must guarantee that no modifications to the text occurs and that you can read/write the data in any database with any encoding.
When accessing this field on an instance of a model, a
Base64DecodedValuewill be returned consisting of the decoded data. This is a byte string, and can be treated as such. If set back into the field, it will be re-encoded and stored.
When writing to the field, the behavior changes based on the type of value and the state of the model:
If the model instance is new (has not yet been saved in the database), any string set will be encoded. This allows the value to be passed during a
If the model is not new, any string that’s set will be assumed to be encoded by the caller.
Base64DecodedValuebyte string will always cause the stored data to be encoded.
The field also adds a
get_fieldname_base64()method to the class, which returns the raw Base64 encoded content from the database.
- contribute_to_class(cls, name)¶
Set attributes on a new model class.
This is called when constructing a model class making use of this field. It sets the field’s attribute to a
Base64FieldCreatorand adds a
get_fieldname_base64()method to the class.
Return a value prepared for the field.
This prepares the value for use in database operations (saving or querying). It will convert the value into a Unicode Base64-encoded string.
Return a Python representation of a value for the field.
This will decode the value (if not already decoded) and return it.