====================
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 thattablib_ 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 0.14+
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/jazzband/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