2012-11-15 16:30:09 +01:00
|
|
|
====================
|
|
|
|
|
django-import-export
|
|
|
|
|
====================
|
2012-11-16 08:51:32 +01:00
|
|
|
|
2015-05-28 18:36:52 +02:00
|
|
|
.. 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
|
2016-03-03 15:56:38 +01:00
|
|
|
:alt: Build status on Travis-CI
|
|
|
|
|
|
2017-11-17 10:55:14 +01:00
|
|
|
.. image:: https://coveralls.io/repos/github/django-import-export/django-import-export/badge.svg?branch=coveralls
|
|
|
|
|
:target: https://coveralls.io/github/django-import-export/django-import-export?branch=coveralls
|
|
|
|
|
|
2015-11-12 10:04:50 +01:00
|
|
|
.. image:: https://img.shields.io/pypi/v/django-import-export.svg
|
2018-06-25 15:46:00 +02:00
|
|
|
:target: https://pypi.org/project/django-import-export/
|
2016-03-03 15:56:38 +01:00
|
|
|
:alt: Current version on PyPi
|
|
|
|
|
|
2016-08-25 11:21:25 +02:00
|
|
|
.. image:: http://readthedocs.org/projects/django-import-export/badge/?version=stable
|
2018-11-05 08:57:43 +01:00
|
|
|
:target: https://django-import-export.readthedocs.io/en/stable/
|
2017-02-02 16:36:04 +01:00
|
|
|
:alt: Documentation
|
2013-01-15 05:30:23 +01:00
|
|
|
|
2012-12-17 12:06:40 +01:00
|
|
|
django-import-export is a Django application and library for importing
|
|
|
|
|
and exporting data with included admin integration.
|
2012-11-26 14:35:55 +01:00
|
|
|
|
2012-12-17 12:06:40 +01:00
|
|
|
Features:
|
2012-11-26 14:35:55 +01:00
|
|
|
|
2012-12-17 12:06:40 +01:00
|
|
|
* support multiple formats (Excel, CSV, JSON, ...
|
|
|
|
|
and everything else that `tablib`_ support)
|
2012-11-26 14:35:55 +01:00
|
|
|
|
2012-12-17 12:06:40 +01:00
|
|
|
* admin integration for importing
|
|
|
|
|
|
|
|
|
|
* preview import changes
|
2012-11-26 14:35:55 +01:00
|
|
|
|
2012-12-17 12:06:40 +01:00
|
|
|
* admin integration for exporting
|
|
|
|
|
|
|
|
|
|
* export data respecting admin filters
|
2012-11-26 14:35:55 +01:00
|
|
|
|
2016-03-04 11:39:41 +01:00
|
|
|
.. image:: docs/_static/images/django-import-export-change.png
|
2013-08-26 14:39:06 +02:00
|
|
|
|
2012-12-17 12:49:58 +01:00
|
|
|
|
2018-11-05 08:57:43 +01:00
|
|
|
* Documentation: https://django-import-export.readthedocs.io/en/stable/
|
2015-05-19 17:09:37 +02:00
|
|
|
* GitHub: https://github.com/django-import-export/django-import-export/
|
2014-01-21 08:34:23 +01:00
|
|
|
* Free software: BSD license
|
2018-06-25 15:46:00 +02:00
|
|
|
* PyPI: https://pypi.org/project/django-import-export/
|
2012-12-17 12:49:58 +01:00
|
|
|
|
2014-01-30 08:51:46 +01:00
|
|
|
Requirements
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
* Python 2.7+ or Python 3.3+
|
2017-11-24 17:09:41 +01:00
|
|
|
* Django 1.8+
|
2014-01-30 08:51:46 +01:00
|
|
|
* tablib (dev or 0.9.11)
|
|
|
|
|
|
2012-11-16 08:51:32 +01:00
|
|
|
Example app
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
::
|
2012-11-26 14:35:55 +01:00
|
|
|
|
2012-11-16 08:51:32 +01:00
|
|
|
cd tests && ./manage.py runserver
|
|
|
|
|
|
|
|
|
|
Username and password for admin are 'admin', 'password'.
|
2012-12-17 12:08:30 +01:00
|
|
|
|
2014-01-21 08:34:23 +01:00
|
|
|
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_.
|
2012-12-17 12:08:30 +01:00
|
|
|
|
2016-03-03 15:56:38 +01:00
|
|
|
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/
|
2012-12-17 12:08:30 +01:00
|
|
|
.. _`tablib`: https://github.com/kennethreitz/tablib
|
2015-05-19 17:09:37 +02:00
|
|
|
.. _`the repository`: https://github.com/django-import-export/django-import-export/
|
|
|
|
|
.. _AUTHORS: https://github.com/django-import-export/django-import-export/blob/master/AUTHORS
|
