Metadata-Version: 2.0
Name: django-export
Version: 1.11.0
Summary: Django app allowing for filtered exporting of model data.
Home-page: http://github.com/praekelt/django-export
Author: Praekelt Consulting
Author-email: dev@praekelt.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: BSD License
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Dist: django-object-tools
Requires-Dist: pyyaml (>=3.11)

Django Export
=============
**Django app allowing for filtered exporting of model object data.**

.. image:: https://travis-ci.org/praekelt/django-export.svg
    :target: https://travis-ci.org/praekelt/django-export

django-export allows you to export model objects in a wide range of serialized formats (JSON, CSV, XML, YAML). Exports can be filtered and ordered on any of the particular model's fields.

django-export utilizes `django-object-tools <http://pypi.python.org/pypi/django-object-tools>`_ to hook into Django's admin interface and take care of user permissions.

.. contents:: Contents
    :depth: 5


Installation
------------

#. Install ``django-object-tools`` as described `here <http://pypi.python.org/pypi/django-object-tools#id3>`_.

#. Install or add ``django-export`` to your Python path.

#. Add ``export`` to your ``INSTALLED_APPS`` setting.

#. Optionally for exporting in CSV you need to add ``export.serializers.csv_serializer`` to your ``SERIALIZATION_MODULES`` setting, i.e.:

   .. code-block:: python

    SERIALIZATION_MODULES = {
        'csv': 'export.serializers.csv_serializer'
    }

Usage
-----

Once installed you should see an **Export** object tool enabled on all admin change list views.

.. image:: docs/images/export_example.png

If you don't see the tool make sure the logged in user has the appropriate export user permission assigned (or set user as superuser).

Clicking the **Export** tool link takes you to an export page on which you can specify format, ordering and filtering of the objects you want to export. The export is delivered as a download in whichever format you select.
Authors
=======

Praekelt Consulting
-------------------

* Shaun Sephton

Changelog
=========

1.11.0
------
#. Django 1.11 compatibility.
#. Deprecate support for Django < 1.8.

1.9.2
-----
#. Restore full set of export fields. This fixes a bug introduced in 1.9.1.

1.9.1
-----
#. Fix case where an empty list of fields is passed resulting in a blank form.

1.9
---
#. Include fields that are non-editable as potential filter fields.
#. Make it possible for subclasses of the ``Export`` form to provide a set of filter fields.
#. Django 1.9 compatibility.

1.0.3 (2014-10-17)
------------------
#. Improved celery support

1.0.2 (2014-10-17)
------------------
#. Moved serializer into celery task

1.0.1 (2014-10-15)
------------------
#. Add celery support to move email task to a background process

1.0.0 (2014-10-13)
------------------
#. CSV serialiser (included into project)
#. Email exported data to logged in user
#. Django 1.7 Compatability
#. Travis/tox integration

0.0.4 (2011-09-09)
------------------
#. Indent output making it human readable, thanks bevenky.
#. Note on enabling CSV.

0.0.3 (2011-08-23)
------------------
#. More robust field lookup for fields defined outside of Django.

0.0.2 (2011-08-19)
------------------
#. Supports all Field types.

0.0.1 (2011-08-11)
------------------

#. Initial release.


