==================== django-import-export

.. image:: https://travis-ci.org/django-import-export/django-import-export.svg?branch=master :target: https://travis-ci.org/django-import-export/django-import-export :alt: Build status on Travis-CI

.. image:: https://coveralls.io/repos/github/django-import-export/django-import-export/badge.svg?branch=master :target: https://coveralls.io/github/django-import-export/django-import-export?branch=master

.. image:: https://img.shields.io/pypi/v/django-import-export.svg :target: https://pypi.org/project/django-import-export/ :alt: Current version on PyPi

.. image:: http://readthedocs.org/projects/django-import-export/badge/?version=stable :target: https://django-import-export.readthedocs.io/en/stable/ :alt: Documentation

django-import-export is a Django application and library for importing and exporting data with included admin integration.

Features:

• support multiple formats (Excel, CSV, JSON, ... and everything else that tablib_ support)

• admin integration for importing

• preview import changes

• admin integration for exporting

• export data respecting admin filters

.. image:: docs/_static/images/django-import-export-change.png

• Documentation: https://django-import-export.readthedocs.io/en/stable/
• GitHub: https://github.com/django-import-export/django-import-export/
• Free software: BSD license
• PyPI: https://pypi.org/project/django-import-export/

Requirements

• Python 3.5+
• Django 2.0+
• tablib (dev or 0.9.11)

django-import-export requires Python 3.5 and Django 2.0 or newer. See the 1.x branch for older Python and Django versions where fixes for security issues and critical errors continue to be released for all officially supported Django versions.

Example app

::

cd tests
./manage.py migrate
./manage.py createsuperuser
./manage.py runserver

Contribute

If you'd like to contribute, simply fork the repository, commit your changes to the develop branch (or branch off of it), and send a pull request. Make sure you add yourself to AUTHORS.

As most projects, we try to follow PEP8_ as closely as possible. Please bear in mind that most pull requests will be rejected without proper unit testing.

.. _PEP8: https://www.python.org/dev/peps/pep-0008/ .. _tablib: https://github.com/kennethreitz/tablib .. _the repository: https://github.com/django-import-export/django-import-export/ .. _AUTHORS: https://github.com/django-import-export/django-import-export/blob/master/AUTHORS