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

.. image:: https://github.com/django-import-export/django-import-export/actions/workflows/django-import-export-ci.yml/badge.svg :target: https://github.com/django-import-export/django-import-export/actions/workflows/django-import-export-ci.yml :alt: Build status on Github

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

.. 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

.. image:: https://img.shields.io/pypi/pyversions/django-import-export :alt: PyPI - Python Version

.. image:: https://img.shields.io/pypi/djversions/django-import-export :alt: PyPI - Django Version

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_ supports)

• admin integration for importing

• preview import changes

• admin integration for exporting

• export data respecting admin filters

.. image:: https://raw.githubusercontent.com/django-import-export/django-import-export/main/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/

Example app

To run the demo app::

cd tests
./manage.py makemigrations
./manage.py migrate
./manage.py createsuperuser
./manage.py loaddata category book
./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