django_sorcery.viewsets.mixins module

Django REST Framework like viewset mixins for common model sqlalchemy actions.

class django_sorcery.viewsets.mixins.CreateModelMixin

Bases: django_sorcery.viewsets.mixins.ModelFormMixin

A mixin for supporting creating objects.

When used with router, it will map the following operations to actions on the viewset

Method	Path	Action	Route Name
POST	/	create	<resource name>-list
GET	/new/	new	<resource name>-new

create(request, *args, **kwargs)

Create action for creating an object.

get_create_context_data(**kwargs)

Returns new context data for template rendering.

new(request, *args, **kwargs)

New action for displaying a form for creating an object.

class django_sorcery.viewsets.mixins.DeleteModelMixin

Bases: django_sorcery.viewsets.mixins.RetrieveModelMixin

A mixin for supporting deleting objects.

When used with router, it will map the following operations to actions on the viewset

Method	Path	Action	Route Name
GET	/<pk>/delete/	confirm_destoy	<resource name>-delete
POST	/<pk>/delete/	destroy	<resource name>-delete
DELETE	/<pk>/	destroy	<resource name>-detail

confirm_destroy(request, *args, **kwargs)

Confirm_destory action for displaying deletion confirmation for an object.

destroy(request, *args, **kwargs)

Destroy action for deletion of an object.

destroy_success_url = None

get_destroy_context_data(**kwargs)

Returns destory context data for rendering deletion confirmation page.

get_destroy_success_url()

Return the url to redirect to after successful deletion of an object.

perform_destoy(obj)

Performs the deletion operation.

class django_sorcery.viewsets.mixins.ListModelMixin

Bases: django_sorcery.views.base.BaseMultipleObjectMixin

A mixin for displaying a list of objects.

When used with router, it will map the following operations to actions on the viewset

Method	Path	Action	Route Name
GET	/	list	<resource name>-list

get_list_context_data(**kwargs)

Returns context data for list action.

get_list_context_object_name(object_list)

Get the name to use for the object.

list(request, *args, **kwargs)

List action for displaying a list of objects.

class django_sorcery.viewsets.mixins.ModelFormMixin

Bases: django.views.generic.edit.FormMixin, django_sorcery.viewsets.mixins.RetrieveModelMixin

Common mixin for handling sqlalchemy model forms in viewsets.

fields = None

form_class = None

form_invalid(form)

Handles invalid form.

form_valid(form)

Processes a valid form.

get_form_class()

Returns the form class to be used.

get_form_context_data(**kwargs)

Return form context data for template rendering.

get_form_kwargs()

Returns the keyword arguments for instantiating the form.

get_success_url()

Return the URL to redirect to after processing a valid form.

process_form(form)

Checks if form is valid and processes accordingly.

success_url = None

class django_sorcery.viewsets.mixins.RetrieveModelMixin

Bases: django_sorcery.views.base.BaseSingleObjectMixin

A mixin for displaying a single object.

When used with router, it will map the following operations to actions on the viewset

Method	Path	Action	Route Name
GET	/<pk>/	retrieve	<resource name>-detail

get_detail_context_data(**kwargs)

Returns detail context data for template rendering.

get_detail_context_object_name(obj)

Get the name to use for the object.

get_url_kwargs(obj)

retrieve(request, *args, **kwargs)

List action for displaying a single object.

class django_sorcery.viewsets.mixins.UpdateModelMixin

Bases: django_sorcery.viewsets.mixins.ModelFormMixin

A mixin for supporting updating objects.

When used with router, it will map the following operations to actions on the viewset

Method	Path	Action	Route Name
GET	/<pk>/edit/	edit	<resource name>-edit
POST	/<pk>/	update	<resource name>-detail
PUT	/<pk>/	update	<resource name>-detail
PATCH	/<pk>/	update	<resource name>-detail

edit(request, *args, **kwargs)

Edit action for displaying a form for editing an object.

get_update_context_data(**kwargs)

Returns edit context data for template rendering.

update(request, *args, **kwargs)

Update action for updating an object.