"""Google 드라이브에 올려 둔 엑셀(.xlsx) 파일을 시트처럼 고쳐 쓰기(쿠팡 밀크런 출고리스트, 2026-10-23). 구글 시트 문서가 아니라 드라이브의 .xlsx 파일이면 Sheets API 로는 쓸 수 없다. 그래서 파일을 내려받아(openpyxl) 고친 뒤 같은 파일 id 에 내용을 다시 올린다(링크·공유·이름 그대로). - 인증은 google_drive 와 같다(서비스 계정 우선, 없으면 OAuth 리프레시 토큰 — Drive 권한 포함). - `GoogleSheetsWriter` 와 같은 메서드(sheet_titles·read_ranges·append_block·write_table·delete_sheet·lock)를 같은 인자로 제공한다 → cupang 라우터는 어느 쪽인지 몰라도 된다(`file_kind` 로 골라 씀). - `with writer.lock:` 안의 호출은 내려받은 사본 하나를 같이 쓰고, 블록이 끝날 때 바뀐 게 있으면 한 번만 올린다. 잠금 밖에서 부른 메서드는 호출마다 내려받고(바뀌면) 올린다. - 올리기 직전에 파일 version 을 다시 보고, 그 사이 누가 고쳤으면 `XlsxChangedError` — 덮어쓰지 않는다 (호출부가 처음부터 다시 시도). - 비밀값은 로그·화면에 출력하지 않는다. """ from __future__ import annotations import re import threading from io import BytesIO from typing import Any from app.integrations.google_drive import GoogleDriveError, GoogleDriveFiles, _friendly_drive XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" SHEETS_MIME = "application/vnd.google-apps.spreadsheet" _RANGE_RE = re.compile(r"^([A-Z]+)(\d*)(?::([A-Z]+)(\d*))?$") # 같은 파일을 두 요청이 동시에 내려받아 고치면 나중 것이 앞의 것을 지우므로 한 번에 하나씩. _LOCK = threading.RLock() _KIND_CACHE: dict[str, str] = {} class XlsxChangedError(RuntimeError): """내려받은 뒤 올리기 전에 다른 사람이 파일을 고쳤다.""" def _col_num(letters: str) -> int: n = 0 for ch in letters: n = n * 26 + (ord(ch) - 64) return n def _parse_range(a1: str) -> tuple[str, int, int, int | None, int | None]: """"'시트'!F6:F" → (시트, 첫 행, 첫 열, 끝 행|None, 끝 열|None). 끝이 비면 시트 끝까지.""" sheet, _, ref = a1.rpartition("!") if sheet.startswith("'") and sheet.endswith("'"): sheet = sheet[1:-1].replace("''", "'") m = _RANGE_RE.match(ref.upper()) if not sheet or not m: raise ValueError(f"지원하지 않는 범위: {a1}") c1, r1, c2, r2 = m.groups() if c2 is None: # 셀 하나 c2, r2 = c1, r1 return sheet, int(r1 or 1), _col_num(c1), (int(r2) if r2 else None), _col_num(c2) def _text(value: Any) -> str: """Sheets API 의 FORMATTED_VALUE 처럼 문자열로(정수인 실수는 소수점 없이).""" if value is None: return "" if isinstance(value, float) and value.is_integer(): return str(int(value)) return str(value) def _put(cell: Any, value: Any) -> None: """Sheets 의 USER_ENTERED 처럼 앞의 작은따옴표는 "글자 그대로" 표시로 보고 떼어 낸다.""" if isinstance(value, str) and value.startswith("'"): cell.value = value[1:] cell.data_type = "s" # '=' 로 시작해도 수식이 되지 않게 else: cell.value = value class DriveXlsxWriter(GoogleDriveFiles): """드라이브 .xlsx 파일 하나를 GoogleSheetsWriter 처럼 다룬다(spreadsheet_id = 드라이브 파일 id).""" def __init__(self) -> None: super().__init__() self._depth = 0 self._book: dict[str, Any] | None = None # {"id", "wb", "version", "dirty"} # ── 내려받기 / 올리기 ─────────────────────────── def file_kind(self, file_id: str) -> str: """"xlsx" | "sheets" | 그 밖의 mimeType. 실패는 GoogleDriveError(사유).""" if file_id in _KIND_CACHE: return _KIND_CACHE[file_id] meta = self._meta(file_id, "mimeType") mime = str(meta.get("mimeType") or "") kind = "xlsx" if mime == XLSX_MIME else "sheets" if mime == SHEETS_MIME else mime _KIND_CACHE[file_id] = kind return kind def _meta(self, file_id: str, fields: str) -> dict[str, Any]: self._check() try: return self._service().files().get(fileId=file_id, fields=fields, supportsAllDrives=True).execute() except Exception as exc: # noqa: BLE001 raise self._error(exc) from None @staticmethod def _error(exc: Exception) -> GoogleDriveError: text = _friendly_drive(exc).replace("업무 파일 폴더", "출고리스트 엑셀 파일") return GoogleDriveError(text) def _open(self, file_id: str) -> dict[str, Any]: from openpyxl import load_workbook version = str(self._meta(file_id, "version").get("version") or "") try: data = self._service().files().get_media(fileId=file_id, supportsAllDrives=True).execute() except Exception as exc: # noqa: BLE001 raise self._error(exc) from None return {"id": file_id, "wb": load_workbook(BytesIO(data)), "version": version, "dirty": False} def _save(self, book: dict[str, Any]) -> None: from googleapiclient.http import MediaIoBaseUpload now = str(self._meta(book["id"], "version").get("version") or "") if book["version"] and now != book["version"]: raise XlsxChangedError("출고리스트 엑셀 파일이 그 사이 바뀌었습니다.") out = BytesIO() book["wb"].save(out) out.seek(0) try: self._service().files().update( fileId=book["id"], media_body=MediaIoBaseUpload(out, mimetype=XLSX_MIME, resumable=False), fields="id", supportsAllDrives=True, ).execute() except Exception as exc: # noqa: BLE001 raise self._error(exc) from None class _Session: def __init__(self, writer: "DriveXlsxWriter") -> None: self.w = writer def __enter__(self) -> "DriveXlsxWriter": _LOCK.acquire() self.w._depth += 1 return self.w def __exit__(self, exc_type: Any, *_: Any) -> None: w = self.w try: w._depth -= 1 if w._depth == 0: book, w._book = w._book, None if exc_type is None and book is not None and book["dirty"]: w._save(book) finally: _LOCK.release() @property def lock(self) -> "DriveXlsxWriter._Session": """이 블록 안의 호출은 내려받은 사본 하나를 같이 쓰고, 끝날 때 바뀐 게 있으면 한 번 올린다.""" return DriveXlsxWriter._Session(self) def _wb(self, file_id: str) -> Any: if self._book is None or self._book["id"] != file_id: if self._book is not None and self._book["dirty"]: self._save(self._book) self._book = self._open(file_id) return self._book["wb"] def _touch(self) -> None: if self._book is not None: self._book["dirty"] = True @staticmethod def _url(file_id: str) -> str: return f"https://docs.google.com/spreadsheets/d/{file_id}/edit" # ── GoogleSheetsWriter 와 같은 메서드 ──────────── def sheet_titles(self, *, spreadsheet_id: str) -> list[str]: with self.lock: return list(self._wb(spreadsheet_id).sheetnames) def read_ranges(self, *, spreadsheet_id: str, ranges: list[str], chunk: int = 50) -> list[list[list[Any]]]: """범위마다 값의 2차원 목록(문자열) — Sheets API 처럼 뒤쪽 빈 칸·빈 행은 잘라 낸다.""" del chunk with self.lock: wb = self._wb(spreadsheet_id) out: list[list[list[Any]]] = [] for a1 in ranges: title, r1, c1, r2, c2 = _parse_range(a1) if title not in wb.sheetnames: out.append([]) continue ws = wb[title] rows = [ [_text(v) for v in row] for row in ws.iter_rows(min_row=r1, max_row=r2 or ws.max_row, min_col=c1, max_col=c2 or ws.max_column, values_only=True) ] for row in rows: while row and row[-1] == "": row.pop() while rows and not rows[-1]: rows.pop() out.append(rows) return out def append_block( self, *, spreadsheet_id: str, title: str, cells: dict[tuple[int, int], Any], merges: list[tuple[int, int, int, int]], first_row: int, last_row: int, first_col: int, last_col: int, left_cols: tuple[int, ...] = (9,), highlight: str = "", ) -> dict[str, Any]: """이미 있는 시트의 first_row~last_row 에 표 한 덩어리(위쪽 내용은 그대로). 서식은 GoogleSheetsWriter 와 같다.""" from openpyxl.styles import PatternFill with self.lock: wb = self._wb(spreadsheet_id) if title not in wb.sheetnames: raise LookupError(f"시트 '{title}' 이(가) 없습니다.") ws = wb[title] for (r, c), value in cells.items(): _put(ws.cell(row=r, column=c), value) for (r1, c1, r2, c2) in merges: ws.merge_cells(start_row=r1, start_column=c1, end_row=r2, end_column=c2) fill = PatternFill("solid", fgColor=highlight) if highlight else PatternFill(fill_type=None) _style_rows(ws, first_row, last_row, first_col, last_col, left_cols=left_cols, fill=fill) self._touch() return { "created": False, "title": title, "first_row": first_row, "last_row": last_row, "url": self._url(spreadsheet_id), } def delete_sheet(self, *, spreadsheet_id: str, title: str) -> dict[str, Any]: """시트 1장 삭제. 없으면 missing, 문서에 그 하나뿐이면 내용만 비운다(cleared).""" with self.lock: wb = self._wb(spreadsheet_id) if title not in wb.sheetnames: return {"ok": True, "action": "missing", "title": title} if len(wb.sheetnames) <= 1: _replace_sheet(wb, title) action = "cleared" else: wb.remove(wb[title]) wb.active = min(wb.index(wb.active) if wb.active is not None else 0, len(wb.sheetnames) - 1) action = "deleted" self._touch() return {"ok": True, "action": action, "title": title} def write_table( self, *, spreadsheet_id: str, title: str, cells: dict[tuple[int, int], Any], merges: list[tuple[int, int, int, int]], header_row: int, first_data_row: int, last_row: int, first_col: int, last_col: int, title_row: int, widths: dict[int, int], header_bg: str = "", row_highlights: list[tuple[int, int, str]] | None = None, ) -> dict[str, Any]: """시트를 만들고(있으면 새로 갈아 끼우고) 표를 통째로 기록한다. 좌표 1-based, 색은 "RRGGBB".""" from openpyxl.styles import Alignment, Font, PatternFill from openpyxl.utils import get_column_letter with self.lock: wb = self._wb(spreadsheet_id) created = title not in wb.sheetnames ws = _replace_sheet(wb, title) for (r, c), value in cells.items(): _put(ws.cell(row=r, column=c), value) for (r1, c1, r2, c2) in merges: ws.merge_cells(start_row=r1, start_column=c1, end_row=r2, end_column=c2) center = Alignment(horizontal="center", vertical="center", wrap_text=True) head = ws.cell(row=title_row, column=first_col) head.font = Font(size=16, bold=True) head.alignment = center ws.row_dimensions[title_row].height = 28 header_fill = PatternFill("solid", fgColor=header_bg) if header_bg else PatternFill(fill_type=None) _style_rows(ws, header_row, header_row, first_col, last_col, left_cols=(), fill=header_fill) for col in range(first_col, last_col + 1): ws.cell(row=header_row, column=col).font = Font(bold=True) if last_row >= first_data_row: _style_rows(ws, first_data_row, last_row, first_col, last_col, left_cols=(9,), fill=None) for (r1, r2, color) in (row_highlights or []): fill = PatternFill("solid", fgColor=color) for row in range(r1, r2 + 1): for col in range(first_col, last_col + 1): ws.cell(row=row, column=col).fill = fill for col, px in widths.items(): ws.column_dimensions[get_column_letter(col)].width = round(px / 7.0, 2) self._touch() return {"created": created, "title": title, "url": self._url(spreadsheet_id)} def _replace_sheet(wb: Any, title: str) -> Any: """같은 이름의 빈 시트로 갈아 끼운다(탭 위치 유지). 없으면 맨 뒤에 새로.""" if title in wb.sheetnames: index = wb.sheetnames.index(title) wb.remove(wb[title]) return wb.create_sheet(title, index) return wb.create_sheet(title) def _style_rows( ws: Any, r1: int, r2: int, c1: int, c2: int, *, left_cols: tuple[int, ...], fill: Any ) -> None: """가운데 정렬·줄바꿈·얇은 검은 테두리, left_cols 만 왼쪽 정렬. fill 이 None 이면 배경은 그대로.""" from openpyxl.styles import Alignment, Border, Side thin = Side(style="thin", color="000000") box = Border(left=thin, right=thin, top=thin, bottom=thin) center = Alignment(horizontal="center", vertical="center", wrap_text=True) left = Alignment(horizontal="left", vertical="center", wrap_text=True) for row in range(r1, r2 + 1): for col in range(c1, c2 + 1): cell = ws.cell(row=row, column=col) cell.border = box cell.alignment = left if col in left_cols else center if fill is not None: cell.fill = fill _WRITER: DriveXlsxWriter | None = None _WRITER_LOCK = threading.Lock() def get_writer() -> DriveXlsxWriter: """프로세스당 하나(설정이 비어 있으면 매번 다시 확인).""" global _WRITER with _WRITER_LOCK: if _WRITER is None or not _WRITER.enabled: _WRITER = DriveXlsxWriter() return _WRITER