{"id":13415484,"url":"https://github.com/django-import-export/django-import-export","last_synced_at":"2025-05-13T18:04:44.264Z","repository":{"id":5504966,"uuid":"6704888","full_name":"django-import-export/django-import-export","owner":"django-import-export","description":"Django application and library for importing and exporting data with admin integration.","archived":false,"fork":false,"pushed_at":"2025-04-02T13:51:46.000Z","size":5995,"stargazers_count":3192,"open_issues_count":25,"forks_count":809,"subscribers_count":61,"default_branch":"main","last_synced_at":"2025-05-06T17:13:29.735Z","etag":null,"topics":["csv","django","import-export","json","python","xls"],"latest_commit_sha":null,"homepage":"https://django-import-export.readthedocs.org/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/django-import-export.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["django-import-export"],"open_collective":"django-import-export"}},"created_at":"2012-11-15T13:12:22.000Z","updated_at":"2025-05-06T11:02:10.000Z","dependencies_parsed_at":"2024-02-20T12:48:19.816Z","dependency_job_id":"3394a275-3e0a-492b-9704-1c1684695a9f","html_url":"https://github.com/django-import-export/django-import-export","commit_stats":{"total_commits":1175,"total_committers":227,"mean_commits":5.176211453744493,"dds":0.6629787234042553,"last_synced_commit":"d96484a842b02586b69b9d85b21a27004ff8af60"},"previous_names":[],"tags_count":114,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-import-export%2Fdjango-import-export","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-import-export%2Fdjango-import-export/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-import-export%2Fdjango-import-export/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-import-export%2Fdjango-import-export/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/django-import-export","download_url":"https://codeload.github.com/django-import-export/django-import-export/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252973681,"owners_count":21834107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csv","django","import-export","json","python","xls"],"created_at":"2024-07-30T21:00:49.615Z","updated_at":"2025-05-13T18:04:44.233Z","avatar_url":"https://github.com/django-import-export.png","language":"Python","funding_links":["https://github.com/sponsors/django-import-export","https://opencollective.com/django-import-export"],"categories":["Third-Party Packages","Import/Export","Python","Best Django Admin Interface Resources","Django Utilities","Packages to install at your project","Admin Enhancements"],"sub_categories":["Admin","**📊 Data Import/Export**","Actions","Podcasts"],"readme":"====================\ndjango-import-export\n====================\n\n.. |build| image:: https://github.com/django-import-export/django-import-export/actions/workflows/release.yml/badge.svg\n    :target: https://github.com/django-import-export/django-import-export/actions/workflows/release.yml\n    :alt: Build status on Github\n\n.. |coveralls| image:: https://coveralls.io/repos/github/django-import-export/django-import-export/badge.svg?branch=main\n    :target: https://coveralls.io/github/django-import-export/django-import-export?branch=main\n\n.. |pypi| image:: https://img.shields.io/pypi/v/django-import-export.svg\n    :target: https://pypi.org/project/django-import-export/\n    :alt: Current version on PyPi\n\n.. |docs| image:: http://readthedocs.org/projects/django-import-export/badge/?version=stable\n    :target: https://django-import-export.readthedocs.io/en/stable/\n    :alt: Documentation\n\n.. |pyver| image:: https://img.shields.io/pypi/pyversions/django-import-export\n    :alt: PyPI - Python Version\n\n.. |djangover| image:: https://img.shields.io/pypi/djversions/django-import-export\n    :alt: PyPI - Django Version\n\n.. |downloads| image:: https://static.pepy.tech/personalized-badge/django-import-export?period=month\u0026units=international_system\u0026left_color=black\u0026right_color=blue\u0026left_text=Downloads/month\n    :target: https://pepy.tech/project/django-import-export\n\n.. |xfollow| image:: https://img.shields.io/twitter/url/https/twitter.com/django_import.svg?style=social\u0026label=Follow%20%40django_import\n   :alt: Follow us on X\n   :target: https://twitter.com/django_import\n\n.. |discord|  image:: https://img.shields.io/discord/1240294048653119508?style=flat\n   :alt: Discord\n\n|build| |coveralls| |pypi| |docs| |pyver| |djangover| |downloads| |xfollow| |discord|\n\nIntroduction\n============\n\nStraightforward, reliable and comprehensive file import / export for your Django application.\n\n*django-import-export* is an application and library which lets you manage import / export from / to a variety of sources (csv, xlsx, json etc).\n\nCan be run programmatically, or with optional integration with the Django Admin site:\n\n..\n  source of this video uploaded to this issue comment:\n  https://github.com/django-import-export/django-import-export/pull/1833#issuecomment-2118777440\n\nhttps://github.com/django-import-export/django-import-export/assets/6249838/ab56d8ba-c307-4bdf-8fa9-225669c72b37\n\n`Screenshots \u003chttps://django-import-export.readthedocs.io/en/latest/screenshots.html\u003e`_\n\nFeatures\n========\n\n* Import / export via `Admin UI Integration \u003chttps://django-import-export.readthedocs.io/en/latest/admin_integration.html\u003e`_ or `programmatically \u003chttps://django-import-export.readthedocs.io/en/latest/getting_started.html#importing-data\u003e`_\n* Import to and from a variety of file formats (csv, json, xlsx, pandas, HTML, YAML... and anything else that `tablib \u003chttps://github.com/jazzband/tablib\u003e`_ supports)\n* `Preview \u003chttps://django-import-export.readthedocs.io/en/latest/screenshots.html/\u003e`_ data before importing in Admin UI\n* Support for `bulk import \u003chttps://django-import-export.readthedocs.io/en/latest/bulk_import.html\u003e`_\n* Handles `CRUD (and 'skip') operations during import \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html#create-or-update-model-instances\u003e`_\n* Flexible handling of `foreign key \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html#importing-model-relations\u003e`_ relationships\n* `Many-to-many relationship \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html#many-to-many-relations\u003e`_ support\n* `Validation \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html#validation-during-import\u003e`_ of imported data\n* Define custom `transformations \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html#advanced-data-manipulation-on-export\u003e`_ for exported data\n* Import / export the same model instance as `different views \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html#customize-resource-options\u003e`_\n* Export using `natural keys \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html#django-natural-keys\u003e`__ for portability between environments\n* `Select items for export \u003chttps://django-import-export.readthedocs.io/en/latest/screenshots.html/\u003e`_ via the Admin UI object list\n* `Select fields for export \u003chttps://django-import-export.readthedocs.io/en/latest/screenshots.html/\u003e`_ via the export form\n* `Export single object instances \u003chttps://django-import-export.readthedocs.io/en/latest/admin_integration.html#export-from-model-instance-change-form\u003e`_\n* Use `django permissions \u003chttps://django-import-export.readthedocs.io/en/latest/installation.html#import-export-import-permission-code\u003e`_ to control import / export authorization\n* Internationalization support\n* Based on `tablib \u003chttps://github.com/jazzband/tablib\u003e`__\n* Support for MySQL / PostgreSQL / SQLite\n* Extensible - `add custom logic to control import / export \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html\u003e`_\n* Handle import from various character encodings\n* `Celery \u003chttps://django-import-export.readthedocs.io/en/latest/celery.html\u003e`_ integration\n* Test locally with `Docker \u003chttps://django-import-export.readthedocs.io/en/latest/testing.html\u003e`_\n* Comprehensive `documentation \u003chttps://django-import-export.readthedocs.io/en/latest/index.html\u003e`__\n* `Extensible API \u003chttps://django-import-export.readthedocs.io/en/latest/api_admin.html\u003e`_\n* test coverage :100:\n* Supports dark mode :rocket:\n\nExample use-cases\n=================\n\n*django-import-export* is designed to be extensible and can be used to support a variety of operations.\nHere are some examples of how it has been used in the wild:\n\n* Configure external cron jobs to run an import or export at set times\n* Use `permissions \u003chttps://django-import-export.readthedocs.io/en/latest/installation.html#import-export-import-permission-code\u003e`_ to define a subset of users able to import and export project data\n* Safely update project reference data by importing from version controlled csv\n* Create portable data to transfer between environments using `natural keys \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html#django-natural-keys\u003e`_\n* Manage user access to an application by importing externally version controlled auth user lists\n* Add `hooks \u003chttps://django-import-export.readthedocs.io/en/latest/advanced_usage.html#advanced-data-manipulation-on-export\u003e`_ to anonymize data on export\n* `Modify import / export UI forms \u003chttps://django-import-export.readthedocs.io/en/latest/admin_integration.html#customize-admin-import-forms\u003e`_ to add dynamic filtering on import / export.\n* Build a migration layer between platforms, for example take a `Wordpress \u003chttps://wordpress.org/\u003e`_ export and import to `Wagtail \u003chttps://wagtail.org/\u003e`_\n\nGetting started\n===============\n\n* `Installation \u003chttps://django-import-export.readthedocs.io/en/latest/installation.html\u003e`_\n* `Getting started \u003chttps://django-import-export.readthedocs.io/en/latest/getting_started.html\u003e`__\n* `Example application \u003chttps://django-import-export.readthedocs.io/en/latest/installation.html#exampleapp\u003e`_\n\nHelp and support\n================\n\n* `Documentation \u003chttps://django-import-export.readthedocs.io/en/latest/\u003e`_\n* `FAQ \u003chttps://django-import-export.readthedocs.io/en/latest/faq.html\u003e`_\n* `Getting help \u003chttps://django-import-export.readthedocs.io/en/latest/faq.html#what-s-the-best-way-to-communicate-a-problem-question-or-suggestion\u003e`_\n* `Contributing \u003chttps://django-import-export.readthedocs.io/en/latest/faq.html#how-can-i-help\u003e`_\n* Become a `sponsor \u003chttps://github.com/sponsors/django-import-export\u003e`_\n* Join our `discord \u003chttps://discord.gg/aCcec52kY4\u003e`_\n* Tutorial videos on `YouTube \u003chttps://www.youtube.com/results?search_query=django-import-export\u003e`_\n* `Raise a security issue \u003chttps://github.com/django-import-export/django-import-export/blob/main/SECURITY.md\u003e`_\n\nCommercial support\n==================\n\nCommercial support is provided by `Bellaport Systems Ltd \u003chttps://www.bellaport.co.uk\u003e`_\n\nReleases\n========\n\n* `Release notes \u003chttps://django-import-export.readthedocs.io/en/latest/release_notes.html\u003e`_\n* `Changelog \u003chttps://django-import-export.readthedocs.io/en/latest/changelog.html\u003e`_\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-import-export%2Fdjango-import-export","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjango-import-export%2Fdjango-import-export","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-import-export%2Fdjango-import-export/lists"}