triv: #26243 added per column cell format (#140)

* triv: #no-task fixing admin

* triv: #26243 added per column cell format

* triv: #26243 added per column cell format

* triv: #26243 added per column cell format

* triv: #26243 added SBAdminXLSXFormat support in cell_format

* triv: #26243 added SBAdminXLSXFormat support in cell_format

Author: LuboZ

AGENTS.md

@@ -17,6 +17,7 @@ This document provides key patterns and gotchas for developers and AI assistants
 | [Selection Actions](#selection-actions-bulk-actions) | Modal forms for bulk operations, `ListActionModalView`, confirmation modals, `SBAdminCustomAction` params, per-action permissions, success/error handling |
 | [Row Actions](#row-actions-per-row-list-buttons) | Per-row icon buttons with `SBAdminRowAction`, `RowActionModalView`, and row-aware enablement |
 | [Field Formatters](#field-formatters) | Badge formatters, `array_badge_formatter`, `BadgeType` options |
+| [XLSX Export Field Formatting](#xlsx-export-field-formatting) | Per-column Excel cell formats via `XLSXFieldOptions.cell_format` (named, dict, or `SBAdminXLSXFormat`) |
 | [View on Site link in list](#view-on-site-link-in-list) | List column with "View on site" icon via admin method, redirect view, `view_on_site_link_formatter` |
 | [Performance Optimization](#performance-optimization) | `Subquery` patterns, `ArrayAgg`, avoiding N+1 queries |
 | [Common Errors](#common-errors) | Frequent errors and solutions |
@@ -44,6 +45,7 @@ This document provides key patterns and gotchas for developers and AI assistants
 - **Adding a column?** → [SBAdminField](#sbadminfield---list-display-columns)
 - **When should I set `filter_field`?** → [When to set `filter_field`](#when-to-set-filter_field)
 - **Extra data for formatters?** → [sbadmin_list_display_data](#sbadmin_list_display_data---extra-data-fields)
+- **XLSX custom formatting per column?** → [XLSX Export Field Formatting](#xlsx-export-field-formatting)
 - **Filtering by related model?** → [Filter Widgets](#filter-widgets) (filter_query_lambda)
 - **Comma-separated tags input?** → [Form Widgets](#form-widgets)
 - **Schema-driven JSON editor (array/object editing)?** → [`SBAdminJsonEditorWidget`](#sbadminjsoneditorwidget--schema-driven-json-editor)
@@ -1830,6 +1832,54 @@ format_array(["Published", "Featured"], badge_type=BadgeType.SUCCESS)
 
 ---
 
+## XLSX Export Field Formatting
+
+Use `XLSXFieldOptions.cell_format` to apply an Excel format to one exported column.
+
+Supported `cell_format` values:
+- `str` — key from `SBAdminXLSXOptions.cell_formats`
+- `dict` — raw xlsxwriter format props
+- `SBAdminXLSXFormat` — class-based format definition
+
+```python
+from django_smartbase_admin.engine.field import SBAdminField, XLSXFieldOptions
+from django_smartbase_admin.services.xlsx_export import SBAdminXLSXFormat
+
+class ArticleAdmin(SBAdmin):
+    sbadmin_list_display = (
+        SBAdminField(
+            name="price",
+            title="Price",
+            xlsx_options=XLSXFieldOptions(
+                cell_format=SBAdminXLSXFormat(
+                    num_format='#,##0.00 "€"',
+                    align="right",
+                )
+            ),
+        ),
+    )
+```
+
+Named lookup via `cell_formats`:
+
+```python
+class ArticleAdmin(SBAdmin):
+    def get_sbadmin_xlsx_options(self, request):
+        options = super().get_sbadmin_xlsx_options(request)
+        options.cell_formats = {
+            "money": {"num_format": '#,##0.00 "€"', "align": "right"},
+        }
+        return options
+
+    sbadmin_list_display = (
+        SBAdminField(
+            name="price",
+            xlsx_options=XLSXFieldOptions(cell_format="money"),
+        ),
+    )
+```
+---
+
 ## Performance Optimization
 
 ### Preventing N+1 Queries with Subqueries

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "django-smartbase-admin"
-version = "1.3.2"
+version = "1.3.3"
 description = ""
 authors = ["SmartBase <info@smartbase.sk>"]
 readme = "README.md"

src/django_smartbase_admin/engine/field.py

@@ -28,6 +28,7 @@
     AutocompleteFilterWidget,
 )
 from django_smartbase_admin.services.translations import SBAdminTranslationsService
+from django_smartbase_admin.services.xlsx_export import SBAdminXLSXFormat
 from django_smartbase_admin.utils import JSONSerializableMixin
 
 
@@ -77,19 +78,22 @@ class XLSXFieldOptions(JSONSerializableMixin):
     field: str | None = None
     formatter: Formatter | None = None
     python_formatter: Callable[[int, Any], Any] | None = None
+    cell_format: str | dict | SBAdminXLSXFormat | None = None
 
     def __init__(
         self,
         title: str | None = None,
         field: str | None = None,
         formatter: Formatter | None = None,
         python_formatter: Callable[[int, Any], Any] | None = None,
+        cell_format: str | dict | SBAdminXLSXFormat | None = None,
     ) -> None:
         super().__init__()
         self.title = title
         self.field = field
         self.formatter = formatter
         self.python_formatter = python_formatter
+        self.cell_format = cell_format
 
 
 class SBAdminField(JSONSerializableMixin):

src/django_smartbase_admin/services/xlsx_export.py

@@ -1,5 +1,6 @@
 import datetime
 import io
+import numbers
 import re
 from copy import copy
 from html import unescape
@@ -53,6 +54,15 @@ def write_workbook(cls, export_file, data, columns, options=None):
         cell_formats_dict = {}
         for cell_format_key, cell_format in cell_format_options.items():
             cell_formats_dict[cell_format_key] = workbook.add_format(cell_format)
+        per_column_formats = {}
+        for idx, column in enumerate(columns):
+            cell_format = column.get("cell_format")
+            if isinstance(cell_format, str):
+                per_column_formats[idx] = cell_formats_dict[cell_format]
+            elif isinstance(cell_format, dict):
+                per_column_formats[idx] = workbook.add_format(cell_format)
+            elif isinstance(cell_format, SBAdminXLSXFormat):
+                per_column_formats[idx] = workbook.add_format(cell_format.to_json())
         for (
             conditional_format_range,
             conditional_format,
@@ -84,34 +94,39 @@ def write_workbook(cls, export_file, data, columns, options=None):
                 data_col = data_row.get(column["field"], "")
                 column_formatter = column.get("formatter", None)
                 image_write = False
+                is_datetime_like = (
+                    isinstance(data_col, datetime.datetime)
+                    or isinstance(data_col, datetime.date)
+                    or isinstance(data_col, datetime.time)
+                    or isinstance(data_col, datetime.timedelta)
+                )
                 if column_formatter == Formatter.IMAGE.value:
                     if row >= header_rows_count:
                         try:
                             worksheet.write_formula(
                                 row,
                                 col,
                                 f'=_xlfn.IMAGE("{data_col}")',
-                                cell_format=default_cell_format,
+                                cell_format=per_column_formats.get(
+                                    col, default_cell_format
+                                ),
                             )
                             image_write = True
                         except ValueError:
                             pass
                 if column_formatter == Formatter.HTML.value:
-                    # remove newlines
-                    data_col = re.sub(r"\n", "", str(data_col))
-                    data_col = re.sub(r"\r\n", "", str(data_col))
-                    # replace all possible variants of <br> with new line
-                    data_col = re.sub(r"<br\s*/?>", "\n", str(data_col))
-                    # unescape
-                    data_col = unescape(data_col)
-                    data_col = strip_tags(data_col).strip()
-                if not image_write:
                     if (
-                        isinstance(data_col, datetime.datetime)
-                        or isinstance(data_col, datetime.date)
-                        or isinstance(data_col, datetime.time)
-                        or isinstance(data_col, datetime.timedelta)
+                        data_col is not None
+                        and not is_datetime_like
+                        and not isinstance(data_col, numbers.Number)
                     ):
+                        data_col = re.sub(r"\n", "", str(data_col))
+                        data_col = re.sub(r"\r\n", "", str(data_col))
+                        data_col = re.sub(r"<br\s*/?>", "\n", str(data_col))
+                        data_col = unescape(data_col)
+                        data_col = strip_tags(data_col).strip()
+                if not image_write:
+                    if is_datetime_like:
                         worksheet.write_datetime(
                             row, col, data_col, default_cell_datetime_format
                         )
@@ -121,7 +136,7 @@ def write_workbook(cls, export_file, data, columns, options=None):
                             col,
                             data_col,
                             (
-                                default_cell_format
+                                per_column_formats.get(col, default_cell_format)
                                 if row >= header_rows_count
                                 else header_cell_format
                             ),