unis_manager/app/export.py

135 lines
5.0 KiB
Python
Executable File
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

"""Excel 导出。
统一用 openpyxl 生成带格式的工作簿:表头加粗底色、冻结首行、自动筛选、列宽自适应。
"""
from __future__ import annotations
import re
from datetime import datetime
from io import BytesIO
from typing import Any, Iterable, Sequence
from urllib.parse import quote
from openpyxl import Workbook
from openpyxl.styles import Alignment, Border, Font, PatternFill, Side
from openpyxl.utils import get_column_letter
HEAD_FILL = PatternFill("solid", fgColor="EEF2F8")
HEAD_FONT = Font(bold=True, color="1F2430", size=11)
TITLE_FONT = Font(bold=True, size=14)
THIN = Side(style="thin", color="D8DEE8")
BORDER = Border(left=THIN, right=THIN, top=THIN, bottom=THIN)
NUM_FMT = "#,##0.00"
# 正文支持简单富文本(加粗 / 下划线 / 斜体 / 语义色,前后端约定见 web/src/utils/richtext.ts)。
# Excel 不认这套标记,出表前统一降级成纯文本:换行标记变成真换行,其余标签剥掉、实体还原。
# 只在我们自己的标签出现时才动手,项目名里带个尖括号不会被误伤。
RICH_TAG = re.compile(r"</?(?:b|i|u|br|p|div|span)\b[^>]{0,60}?>", re.I)
_BREAK_TAG = re.compile(r"<br\s*/?>|</(?:p|div)>", re.I)
_ADJACENT_BLOCK = re.compile(r"</(?:p|div)>\s*<(?:p|div)\b[^>]{0,60}?>", re.I)
_ENTITIES = {"&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": '"', "&#39;": "'", "&nbsp;": " "}
def plain(value: Any) -> Any:
"""富文本 → 纯文本;不是字符串或不含标记时原样返回。
换行口径和前端 utils/richtext.richToText 保持一致:相邻段落之间只算一个换行
(编辑器产出 <p>一行</p><p>一行</p>,开闭标签各断一次行会凭空多出空行),
块开头也断行是为了兼容早年 Chrome 留下的「裸文本 + <div>」这种混排。
"""
if not isinstance(value, str) or not RICH_TAG.search(value):
return value
s = _ADJACENT_BLOCK.sub("\n", value)
s = _BREAK_TAG.sub("\n", s)
s = re.sub(r"<(?:p|div)\b[^>]{0,60}?>", "\n", s, flags=re.I)
s = re.sub(r"<[^>]{0,80}?>", "", s)
for k, v in _ENTITIES.items():
s = s.replace(k, v)
return re.sub(r"\n{3,}", "\n\n", s).strip()
def _cell_width(value: Any) -> int:
"""按中文字符占 2 个宽度估算显示宽度。"""
s = "" if value is None else str(value)
w = 0
for ch in s:
w += 2 if ord(ch) > 127 else 1
return w
def build_xlsx(
sheet_name: str,
headers: Sequence[str],
rows: Iterable[Sequence[Any]],
widths: Sequence[int] | None = None,
title: str | None = None,
money_cols: Sequence[int] = (),
) -> bytes:
"""生成 xlsx 字节流。
money_cols 中的列索引按 1 开始计(对应 headers 的下标 + 1)。
"""
wb = Workbook()
ws = wb.active
ws.title = sheet_name[:31] or "Sheet1"
rows = list(rows)
offset = 0
if title:
ws.cell(row=1, column=1, value=title).font = TITLE_FONT
ws.cell(row=2, column=1, value=f"导出时间:{datetime.now():%Y-%m-%d %H:%M}")
ws.cell(row=2, column=1).font = Font(size=9, color="7A8394")
offset = 2
head_row = offset + 1
for c, h in enumerate(headers, 1):
cell = ws.cell(row=head_row, column=c, value=h)
cell.fill = HEAD_FILL
cell.font = HEAD_FONT
cell.border = BORDER
cell.alignment = Alignment(horizontal="center", vertical="center", wrap_text=True)
for r, row in enumerate(rows, head_row + 1):
for c, v in enumerate(row, 1):
cell = ws.cell(row=r, column=c, value=plain(v)) # 富文本降级成纯文本再入表
cell.border = BORDER
cell.alignment = Alignment(vertical="top", wrap_text=False)
if c in money_cols and isinstance(v, (int, float)):
cell.number_format = NUM_FMT
# 列宽:显式指定优先,否则按内容估算
n_cols = len(headers)
for c in range(1, n_cols + 1):
if widths and c <= len(widths):
width = widths[c - 1]
else:
longest = _cell_width(headers[c - 1])
for row in rows:
if c <= len(row):
longest = max(longest, _cell_width(row[c - 1]))
width = min(max(longest + 4, 10), 60)
ws.column_dimensions[get_column_letter(c)].width = width
ws.freeze_panes = ws.cell(row=head_row + 1, column=1)
ws.auto_filter.ref = (
f"A{head_row}:{get_column_letter(n_cols)}{head_row + max(len(rows), 1)}"
)
buf = BytesIO()
wb.save(buf)
return buf.getvalue()
def xlsx_response(content: bytes, filename: str) -> tuple[bytes, dict]:
"""返回 (内容, 响应头),中文文件名用 RFC 5987 编码。"""
stamp = datetime.now().strftime("%Y%m%d_%H%M")
full = f"{filename}_{stamp}.xlsx"
headers = {
"Content-Disposition": f"attachment; filename=\"{quote(full)}\"; filename*=UTF-8''{quote(full)}",
"Content-Type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"Access-Control-Expose-Headers": "Content-Disposition",
}
return content, headers