Skip to main content

Define views, serializers and routers as the PumpWood format

Project description

Extends Django and Rest FrameWork exceptions in order to give a better detail over model miss-especification and permit serialization of the error data to facilitate front-end debug.

Quick start

  1. Add “pumpwood_viewutils” to your Django INSTALLED_APPS setting like this:



Each model exposed by a PumpWood View have nine basic end-poitns exposed througth PumpWood router.

  • list, served as POST: {slugfied model_name}/list
  • list_without_pag, served as POST: {slugfied model_name}/list-without-pag
  • retrieve, served as POST: {slugfied model_name}/retrieve/(?pk)
  • delete, served as DELETE: {slugfied model_name}/retrieve/(?pk)
  • save, served as POST, PUT: {slugfied model_name}/save/
  • list_actions, served as GET {slugfied model_name}/actions/
  • execute_action, served as POST {slugfied model_name}/execute_action/(?pk)
  • list_search_options, served as GET {slugfied model_name}/options
  • list_options, served as POST {slugfied model_name}/options


Returns a list of objects acording with the filter dict passed as msg body. List is retricted with the maximum length defined on REST_FRAMEWORK[[‘PAGINATE_BY’]]


Returns a list of objects acording with the filter dict passed as msg body, but without length limit


Returns the object as a dictionary, serialized by retrive_serializer. Usualy, when an object is retrieved it have more information than when it is listed.


Delete de object. For security reason, the url is maped but the code for deleting the object is not implemented (it raises an error, must be overrided).


Save and updates an object acording to msg body dictionary. If msg body have a pk the object with this pk will be updated, other wise it will be created


List Class functions that have been marked with @rest_function wrapper. Returns a list with the path of the action, a short description, an indication for an icon to be used in the front end and necessary parameter, optional parameter and what the function will return.


Execute an action over an object, if pk was filled, or a class method. Returns a dictionary with the results, the action name, parameters used in the action and the object on which the action was performed.


Return options to be user in dropdowns and other filter to be used in the search of the object.


List the options on the object creation according to parcial filment of the object.

This project is on beta phase, use it with carefull.

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 pumpwood-viewutils, version
Filename, size File type Python version Upload date Hashes
Filename, size pumpwood-viewutils- (234.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page