Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

DRF serializers to handle base64-encoded files

Project description

DRF-Base64 provides a set of serializers to handle Bas64-encoded files.

Compatibility Matrix

DRF-Base64 is compatible with the following matrix

  Py 3.5 Py 3.6 Py 3.7
Django 2.0 DRF 3.7+ DRF 3.7+ DRF 3.7+
Django 2.1 DRF 3.7+ DRF 3.7+ DRF 3.7+
Django 2.2 DRF 3.7+ DRF 3.7+ DRF 3.7+

Installation

DRF-Base64 is compatible with Python 3.5+ as well as Django 2.0+ and DRF 3.7+

For previous versions of Python and/or Django, please see the V1.x branch

With pip

pip install drf-base64

From source

Within the source directory:

python setup.py install

Field Serializers

DRF-Base64 provides a Base64FileField and a Base64ImageField very similar to DRF’s FileField and ImageField with the added functionality of accepting base64-encoded file strings as input. If those serialiers receive an url (ie: when updating a record containing a file without modifying that said file), it will leave the existing value untouched.

Example usage:

from rest_framework import serializers
from base64.fields import Base64ImageField

from .models import Product


class ProductSerializer(serializers.ModelSerializer):

    picture = Base64ImageField(required=False)

    class Meta:
        model = Product
...

Model Serializers

DRF-Base64 also provides a ModelSerializer and an HyperlinkedModelSerializer also similar to DRF’s own ModelSerializer and HyperlinkedModelSerializer with the added functionality of mapping django.db.models.FileField’s to Bas64FileField’s and django.db.models.ImageField’s to Base64ImageField’s.

Example usage:

from drf_base64.serializers import ModelSerializer

from .models import Product


class ProductSerializer(ModelSerializer):

    class Meta:
        model = Product
...

Mixins

drf_base64.fields.Base64FieldMixin

If you’d like to enable base64 uploading of file for other field types than FileField or ImageField, DRF-Base64 provides Base64FieldMixin to let you do just that.

drf_base64.serializers.Base64ModelSerializerMixin

If you wish to use Base64FileField and Base64ImageField as default for model serializers other than the ones provided, DRF-Base64 also provides Base64ModelSerializerMixin that you can apply on any other model serializer as long as they use `serializer_field_mapping <http://www.django-rest-framework.org/api-guide/serializers/#serializer_field_mapping>`__.


License information available here.

Contributors code of conduct is available here. Note that this COC will be enforced.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for drf_base64, version 2.0
Filename, size File type Python version Upload date Hashes
Filename, size drf_base64-2.0.tar.gz (3.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page