django-import-export

Added CachedForeignKeyWidget ( 2142 )

Add Ukrainian translation ( 2132 )

Fix: file_name is None in before_import_row when skip_import_confirm=True ( 2129 )

Minor documentation fix

Fix for export not retaining URI query params ( 2097 )

Improved field value extraction for dict-based querysets ( 2098 )

Performance improvements for membership checks ( 2090 )

Fix ForeignKeyWidget export issue ( 2117 )

Improved documentation for clean() methods ( 2115 )

Documentation updates: JSONField export with attribute syntax ( 2100 )

Documentation updates: handling TooManyFieldsSent ( 2103 )

Updated Turkish translation ( 2101 )

Updated Czech translation ( 2111 )

Allow specifying meta options in the model_resourcefactory ( 2078 )

Allow custom fields and methods in model_resourcefactory ( 2081 )

FAQ update to describe how to customize Excel exports ( 2088 )

ui: fix error display twice issue on export field select page ( 2066 )

ui: add ‘select all’ fields toggle on export page ( 2068 )

Add Hebrew translation ( 2071 )

ui: fix display of non field errors on import ( 2075 )

Update French translation ( 2042 )

Add flag to ignore empty rows in XLSX import ( 2028 )

Add support for Django 5.2 ( 2037 )

Fix Chinese translation ( 2040 )

Clarify documentation on creating non-existent relations ( 2029 )

Update Turkish translations ( 2031 )

Handle QuerySets called with values() on export ( 2011 )

Update all translations ( 2014 )

Updated Farsi translation ( 2008 )

Updated German translation ( 2012 )

Fix imports for openpyxl ( 2005 )

Addition of import & export management commands ( 1992 )

Handle IllegalCharacterError in xlsx exports ( 2001 )

Add repr method to InvalidRow for improved debugging ( 2003 )

Removed dependency files in favour of pyproject.toml ( 1982 )

Documentation updates ( 1989 )

Fix crash on export of tz-aware datetime to binary formats ( 1995 )

This release contains breaking changes. Please refer to release notes .

Upgraded tablib version ( 1627 )

Document overriding formats ( 1868 )

Consistent queryset creation in ModelAdmin export mixin ( 1890 )

Deprecated get_valid_export_item_pks() in favour of get_queryset() ( 1890 )

Improve deprecation warning for ExportViewFormMixin to report at point of class definition ( 1900 )

Fix export for fields with custom declared name ( 1903 )

Hide the “Resource” form when it only has one option ( 1908 )

Update date, time and datetime widget render method to handle derived instance ( 1918 )

Add support for Django 5.1 ( 1926 )

Accept numbers using the numeric separators of the current language in number widgets ( FloatWidget() , IntegerWidget() , DecimalWidget() ) ( 1927 )

Added warning for declared fields excluded from fields whitelist ( 1930 )

Fix v3 regression: handle native types on export to spreadsheet ( 1939 )

Fix export button displayed on change screen when export permission not assigned ( 1942 )

Fix crash for Django 5.1 when rows are skipped ( 1944 )

Allow callable in dehydrate method ( 1950 )

Fix crash when Resource fields declared incorrectly ( 1963 )

Updated dependencies ( 1979 )

This release contains breaking changes. Please refer to release notes.

• Upgraded tablib version (1627)

• Document overriding formats (1868)

• Consistent queryset creation in ModelAdmin export mixin (1890)

• Deprecated ~import_export.admin.ExportMixin.get_valid_export_item_pks in favour of ~import_export.admin.ExportMixin.get_queryset (1890)

• Improve deprecation warning for ExportViewFormMixin to report at point of class definition (1900)

• Fix export for fields with custom declared name (1903)

• Hide the "Resource" form when it only has one option (1908)

• Update date, time and datetime widget render method to handle derived instance (1918)

• Add support for Django 5.1 (1926)

• Accept numbers using the numeric separators of the current language in number widgets (~import_export.widgets.FloatWidget, ~import_export.widgets.IntegerWidget, ~import_export.widgets.DecimalWidget) (1927)

• Added warning for declared fields excluded from fields whitelist (1930)

• Fix v3 regression: handle native types on export to spreadsheet (1939)

• Fix export button displayed on change screen when export permission not assigned (1942)

• Fix crash for Django 5.1 when rows are skipped (1944)

• Allow callable in dehydrate method (1950)

• Fix crash when Resource fields declared incorrectly (1963)

• Updated dependencies (1979)

Restore return value for deprecated method get_fields() ( 1897 )

• Restore return value for deprecated method ~import_export.resources.Resource.get_fields (1897)

Improve Error class ( 1882 )

Fix response content assertions ( 1883 )

Admin UI: display checkboxes before labels in export form ( 1884 )

deprecated unused method: get_fields() ( 1885 )

• Improve Error class (1882)

• Fix response content assertions (1883)

• Admin UI: display checkboxes before labels in export form (1884)

• deprecated unused method: ~import_export.resources.Resource.get_fields (1885)

remove django version check for custom storages ( 1889 )

docs: clarify for_delete() documentation ( 1877 )

fix default Field returns empty string instead of ‘None’ ( 1872 )

revert setting default value for attribute ( 1875 )

• docs: clarify ~import_export.resources.Resource.for_delete documentation (1877)

• fix default Field returns empty string instead of 'None' (1872)

• revert setting default value for attribute (1875)

docs: clarify widget configuration ( 1865 )

Enable skip export confirm page ( 1867 )

fix documentation to show correct method for reading form data on export ( 1859 )

Admin UI: display both field name and column name on export ( 1857 )

fix export declared field with custom column name ( 1861 )

fix declared fields do not have correct Widget class set ( 1861 )

docs: clarify changes to CharWidget in v4 ( 1862 )

refactor Resource to remove code duplication in export ( 1863 )

Added additional test for export field order ( 1848 )

fix crash on import when relation has custom PK ( 1853 )

fix crash on export from action when instance has custom PK ( 1854 )

Fix for invalid build due to malformed README.rst ( 1851 )

Support widgets with CSS and JS media in ImportForm ( 1807 )

Documentation updates ( 1833 )

Clarified documentation when importing with import_id_fields ( 1836 )

re-add resource_class deprecation warning ( 1837 )

fixed Arabic translation for ‘import’ word ( 1838 )

fix export with custom column name ( 1821 )

fix allow column_name to be declared in fields list ( 1822 )

fix clash between key_is_id and use_natural_foreign_keys ( 1824 )

remove unreachable code ( 1825 )

fix issue with widget assignment for custom ForeignKey subclasses ( 1826 )

performance: select of valid pks for export restricted to action exports ( 1827 )

fix crash on export with custom column name ( 1828 )

remove outdated datetime formatting logic ( 1830 )

fix crash on export when model has no id ( 1802 )

fix Widget crash when django Field subclass is used ( 1805 )

fix regression: allow imports when default import_id_field is not present ( 1813 )

Deprecations 

Removed v3 deprecations ( 1629 )

Deprecation of ExportViewFormMixin ( 1666 )

Enhancements 

Refactor ordering logic ( 1626 )

Refactor ‘diff’ logic to avoid calling dehydrate methods

Refactor declarations of fields , import_order and export_order to fix ordering issues

refactor to export HTML / formulae escaping updates ( 1638 )

removed unused variable Result.new_record ( 1640 )

Refactor resources.py to standardise method args ( 1641 )

added specific check for missing import_id_fields ( 1645 )

Enable optional tablib dependencies ( 1647 )

added get_lookup_kwargs() to make it easier to override object lookup ( 1651 )

Standardised interface of render() ( 1657 )

Fix declaring existing model field(s) in ModelResource altering export order ( 1663 )

Added do_instance_save() helper method ( 1668 )

Enable defining Resource model as a string ( 1669 )

Support multiple Resources for export ( 1671 )

Support export from model change form ( 1687 )

Import form defaults to read-only field if only one format defined ( 1690 )

Updated Admin UI to track deleted and skipped Imports ( 1691 )

Added customizable MediaStorage ( 1708 )

Added customization of Admin UI import error messages ( 1727 )

Improve output of error messages ( 1729 )

Added feature: selectable fields for admin export view ( 1734 )

Added specific check for declared import_id_fields not in dataset ( 1735 )

added try / catch to add_instance_info() to handle unserializable instances ( 1767 )

Add form error if source file contains invalid header ( 1780 )

Remove unneeded format method overrides ( 1785 )

Support dynamic selection of Resource class based on request property ( 1787 )

Fixes 

dynamic widget parameters for CharField fixes ‘NOT NULL constraint’ error in xlsx ( 1485 )

fix cooperation with adminsortable2 ( 1633 )

Removed unused method utils.original()

Fix deprecated log_action method ( 1673 )

fix multiple inheritance not setting options ( 1696 )

Fix issue where declared Resource fields not defined in fields are still imported ( 1702 )

Fixed handling of FieldError during Admin import ( 1755 )

Fixed handling of django FieldError during Admin export ( 1756 )

Add check for type to render() ( 1757 )

fix: YAML export does not work with SafeString ( 1762 )

fix: render() crashes if value is None ( 1771 )

fix form not being passed to get_import_resource_kwargs() ( 1789 )

Fix: Missing default widget for PositiveBigIntegerField ( 1795 )

Development 

Refactor build process ( 1630 )

Refactored test_admin_integration() : split into smaller test modules ( 1662 )

Refactored test_resources() : split into smaller test modules ( 1672 )

Updated docker-compose command with latest version syntax in runtests.sh ( 1686 )

Refactored resources into separate modules for declarative and options ( 1695 )

Refactored tests to remove dependencies between tests ( 1703 )

Handle python3.12 datetime deprecations ( 1705 )

Refactor test_resources.py into smaller modules ( 1733 )

Updated test coverage to include error row when collect_failed_rows is True ( 1753 )

Removed support for django 3.2 ( 1790 )

Added test for widgets generating by model fields 1795 )

Documentation 

Clarified skip_diff documentation ( 1655 )

Improved documentation relating to validation on import ( 1665 )

Added FAQ entry for exporting large datasets ( 1706 )

Relocated admin integration section from advanced_usage.rst into new file ( 1713 )

Updated Admin integration documentation to clarify how to save custom form values ( 1746 )

Performance 

Fix slow export with ForeignKey id ( 1717 )

i18n 

updated translations for release-4 ( 1775 )

Update translations for Russian language ( 1797 )

Add additional django template block for extending import page ( 1776 )

Pass get_export_resource_kwargs() to Resource constructor export_action() ( 1739 )

Fix issue with model class passed to Resource constructor crashing on export ( 1745 )

Fix indentation for skip_row docstring ( 1743 )

Return kwargs by default from get_resource_kwargs() ( 1748 )

• Pass ~import_export.mixins.BaseExportMixin.get_export_resource_kwargs to Resource constructor ~import_export.admin.ExportMixin.export_action (1739)

• Fix issue with model class passed to Resource constructor crashing on export (1745)

• Fix indentation for skip_row docstring (1743)

• Return kwargs by default from ~import_export.mixins.BaseImportExportMixin.get_resource_kwargs (1748)

Fix issue with highlight when using ‘light’ color scheme ( 1728 )

Remove unnecessary ChangeList queries to speed up export via Admin UI ( 1715 )

Respect color scheme override ( 1720 )

Update FAQ to cover skipping rows with validation errors ( 1721 )

export_admin_action() can be overridden by subclassing it in the ModelAdmin ( 1681 )

• ~import_export.admin.ExportActionMixin.export_admin_action can be overridden by subclassing it in the ModelAdmin (1681)

Updated Spanish translations ( 1639 )

Added documentation and tests for retrieving instance information after import ( 1643 )

render() returns None as empty string if coerce_to_string is True ( 1650 )

Updated documentation to describe how to select for export in Admin UI ( 1670 )

Added catch for django5 deprecation warning ( 1676 )

Updated and compiled message files ( 1678 )

• Updated Spanish translations (1639)

• Added documentation and tests for retrieving instance information after import (1643)

• ~import_export.widgets.NumberWidget.render returns None as empty string if coerce_to_string is True (1650)

• Updated documentation to describe how to select for export in Admin UI (1670)

• Added catch for django5 deprecation warning (1676)

• Updated and compiled message files (1678)