Skip to main content

Django package that handles exporting of data

Project description

# UNICEF Rest Export

Django Rest Framework data export package that handles export/rendering to JSON, CSV, XLS, and HTML


## Installation

pip install unicef-rest-export


## Setup

Add ``unicef_rest_export`` to ``INSTALLED_APPS`` in settings

INSTALLED_APPS = [
...
'unicef_rest_export',
]


## Usage

A sample model view;

class AuthorView(ExportView):
queryset = Author.objects.all()
serializer_class = serializers.AuthorSerializer


A sample model viewset;

class AuthorViewSet(ExportViewSet):
queryset = Author.objects.all()
serializer_class = serializers.AuthorSerializer


To override or limit the renderers allowed, add ``EXPORT_RENDERERS`` to settings.
The current default is;

EXPORT_RENDERERS = (
"unicef_rest_export.renderers.ExportHTMLRenderer",
"unicef_rest_export.renderers.ExportCSVRenderer",
"unicef_rest_export.renderers.ExportJSONRenderer",
"unicef_rest_export.renderers.ExportExcelRenderer",
)

The following is a sample of transforming data;

class AuthorTransformView(ExportView):
queryset = Author.objects.all()
serializer_class = serializers.AuthorSerializer

def transform_books(self, data):
return [d["name"] for d in data]

def transform_dataset(self, dataset):
dataset.add_formatter("books", self.transform_books)
return dataset


## Contributing

### Environment Setup

To install the necessary libraries

$ make install


### Coding Standards

See [PEP 8 Style Guide for Python Code](https://www.python.org/dev/peps/pep-0008/) for complete details on the coding standards.

To run checks on the code to ensure code is in compliance

$ make lint


### Testing

Testing is important and tests are located in `tests/` directory and can be run with;

$ make test

Coverage report is viewable in `build/coverage` directory, and can be generated with;


### Project Links

- Continuos Integration - https://circleci.com/gh/unicef/unicef-rest-export/tree/develop
- Source Code - https://github.com/unicef/unicef-rest-export


## Thanks to

[django-rest-pandas](https://github.com/wq/django-rest-pandas) as a lot of the code was borrowed from that package.

Project details


Download files

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

Source Distribution

unicef_rest_export-0.5.3.tar.gz (22.0 kB view details)

Uploaded Source

File details

Details for the file unicef_rest_export-0.5.3.tar.gz.

File metadata

  • Download URL: unicef_rest_export-0.5.3.tar.gz
  • Upload date:
  • Size: 22.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/3.6

File hashes

Hashes for unicef_rest_export-0.5.3.tar.gz
Algorithm Hash digest
SHA256 e1eca4d0a053743488d81d18b0a237c0a9a545772647874c86909babbc542c7f
MD5 0fb11e1480d81ad0219e38399f6eee06
BLAKE2b-256 1e8dd60a6f02a09e74dcc7e8a38682cc2e0ba76b2a4db58ef495063c54725940

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page