ADRest Mixins ¶

ADRest based on mixin classes. You can use adrest.views.ResourceView as base for your REST controlers. Or you can use a ADRest’s mixins separately.

Contents

ADRest Mixins

Common Options ¶

class adrest.utils.meta.Meta¶

Base options for all ADRest mixins.

With Meta options you can setup your resources.

model = None¶: Setup Django ORM model. Value could be a model class or string path like ‘app.model’.

EmitterMixin ¶

class adrest.mixin.emitter.EmitterMixin¶

Serialize response.

class Meta¶

Emitter options. Setup parameters for resource’s serialization.

class SomeResource(EmitterMixin, View):

    class Meta:
        emitters = JSONEmitter

Meta.emit_format = 'django'¶

Serialization format. Set ‘django’ for django like view:

{
    'pk': ...,
    'model': ...,
    'fields': {
        'name': ...,
        ...
    }
}

Or set ‘simple’ for simpliest serialization:

{
    'id': ...,
    'name': ...,
}

Meta.emit_models = None¶

Dictionary with emitter’s options for relations

emit_models[‘fields’] – Set serialized fields by manual
emit_models[‘exclude’] – Exclude some fields
emit_models[‘include’] – Include some fields
emit_models[‘related’] – Options for relations.

Example:

class SomeResource(EmitterMixin, View):
    class Meta:
        model = Role
        emit_models = dict(
             include = 'group_count',
             exclude = ['password', 'service'],
             related = dict(
                 user = dict(
                     fields = 'username'
                 )
             )

         )

You can use a shortcuts for emit_models option, as is emit_fields or emit_include. That same as bellow:

class SomeResource(EmitterMixin, View):
    class Meta:
        model = Role
        emit_include = 'group_count'
        emit_exclude = 'password', 'service'
        emit_related = dict(
            user = dict(
                    fields = 'username'
            )
        )

Meta.emit_options = None¶

Options for low-level serialization Example for JSON serialization

class SomeResource(EmitterMixin, View):
    class Meta:
        emit_options = dict(indent=2, sort_keys=True)

Meta.emit_template = None¶: Define template for template-based emitters by manualy Otherwise template name will be generated from resource name (or resource.Meta.model)

Meta.emitters¶

adrest.utils.Emitter (or collection of them) Defined available emitters for resource.

class SomeResource(EmitterMixin, View):
    class Meta:
        emitters = JSONEmitter, XMLEmitter

alias of JSONEmitter

Example:

class SomeResource():
    class Meta:
        emit_fields = ['pk', 'user', 'customfield']
        emit_related = {
            'user': {
                fields: ['username']
            }
        }

    def to_simple__customfield(self, user):
        return "I'm hero! " + user.username

class EmitterMixin.Meta

Emitter options. Setup parameters for resource’s serialization.

class SomeResource(EmitterMixin, View):

    class Meta:
        emitters = JSONEmitter

emitters¶: alias of JSONEmitter

classmethod EmitterMixin.determine_emitter(request)¶

Get emitter for request.

Return emitter:	Instance of adrest.utils.emitters.BaseEmitter

EmitterMixin.emit(content, request=None, emitter=None)¶

Serialize response.

Return response:
	Instance of django.http.Response

static EmitterMixin.to_simple(content, simple, serializer=None)¶

Abstract method for modification a structure before serialization.

Parameters:	content – response from called method simple – structure is prepared to serialization serializer – current serializer
Return object:	structure for serialization

class SomeResource(ResourceView):
    def get(self, request, **resources):
        return dict(true=False)

    def to_simple(self, content, simple, serializer):
        simple['true'] = True
        return simple

ParserMixin ¶

class adrest.mixin.parser.ParserMixin¶: Parse user data.

ThrottleMixin ¶

class adrest.mixin.throttle.ThrottleMixin¶: Throttle request.

AuthMixin ¶

class adrest.mixin.auth.AuthMixin(*args, **kwargs)¶: Adds pluggable authentication behaviour.

DynamicMixin ¶

class adrest.mixin.handler.DynamicMixin(*args, **kwargs)¶

Implement filters and sorting.

ADRest DynamicMixin supports filtering and sorting collection from query params.

HandlerMixin ¶

class adrest.mixin.handler.HandlerMixin(*args, **kwargs)¶

Implement REST API.

class Meta¶

Handler options. Setup parameters for REST implementation.

class SomeResource(HandlerMixin, View):

    class Meta:
        allowed_methods = 'get', 'post'
        model = 'app.model'

Meta.allowed_methods = ('GET',)¶: List of allowed methods (or simple one)

Meta.callmap = {'HEAD': 'head', 'GET': 'get', 'PATCH': 'patch', 'PUT': 'put', 'POST': 'post', 'OPTIONS': 'options', 'DELETE': 'delete'}¶: Map HTTP methods to handler methods

Meta.form = None¶: Set form for resource by manual

Meta.form_exclude = None¶: Exclude field’s names for automatic a model form

Meta.form_fields = None¶: Specify field’s names for automatic a model form

Example:

class SomeResource(HandlerMixin, View):

    class Meta:
        allowed_methods = 'get', 'post'
        model = 'app.model'

    def dispatch(self, request, **resources):

        self.check_method_allowed(request)

        resources = self.get_resources(request, **resources)

        return self.handle_request(request, **resources)