chore(cafe24): 정리 전 완료된 작업 보존
Cafe24 수정, 테스트 및 DB 마이그레이션 파일을 함께 기록한다.
This commit is contained in:
@@ -45,6 +45,7 @@ from .errors import (
|
||||
Cafe24AuthError,
|
||||
Cafe24ConfigError,
|
||||
Cafe24Error,
|
||||
Cafe24FtpConflict,
|
||||
Cafe24FtpError,
|
||||
Cafe24RateLimitError,
|
||||
)
|
||||
@@ -80,6 +81,7 @@ __all__ = [
|
||||
"Cafe24RateLimitError",
|
||||
"Cafe24ApiError",
|
||||
"Cafe24FtpError",
|
||||
"Cafe24FtpConflict",
|
||||
]
|
||||
|
||||
|
||||
|
||||
@@ -164,6 +164,10 @@ class Cafe24Client:
|
||||
method = method.upper()
|
||||
forced_refresh = False
|
||||
last_error: Exception | None = None
|
||||
# 쓰기 요청이 카페24에 도달했을 수도 있는 시도가 있었나(5xx 응답·응답 전 끊김).
|
||||
# 최종 오류에 실어 호출부가 "반영 여부 모름"을 구분하게 한다(errors.Cafe24ApiError).
|
||||
writes = method in ("PUT", "POST", "DELETE", "PATCH")
|
||||
maybe_applied = False
|
||||
|
||||
for attempt in range(self._max_retries + 1):
|
||||
self._pace()
|
||||
@@ -224,7 +228,9 @@ class Cafe24Client:
|
||||
time.sleep(wait)
|
||||
continue
|
||||
|
||||
error = Cafe24ApiError(message, status=status, endpoint=endpoint)
|
||||
if writes and status >= 500:
|
||||
maybe_applied = True
|
||||
error = Cafe24ApiError(message, status=status, endpoint=endpoint, maybe_applied=maybe_applied)
|
||||
if error.retryable and attempt < self._max_retries:
|
||||
last_error = error
|
||||
time.sleep(min(8.0, 0.5 * (2**attempt)))
|
||||
@@ -241,7 +247,11 @@ class Cafe24Client:
|
||||
http_status=status, result="ERROR", error_message=message,
|
||||
duration_ms=elapsed,
|
||||
)
|
||||
last_error = Cafe24ApiError(message, status=0, endpoint=endpoint)
|
||||
# 연결조차 안 된 경우만 "도달하지 않음"이 확실하다. 그 밖(읽기 타임아웃,
|
||||
# 응답 도중 끊김)은 카페24가 요청을 처리했을 수 있다.
|
||||
if writes and not isinstance(exc, (httpx.ConnectError, httpx.ConnectTimeout)):
|
||||
maybe_applied = True
|
||||
last_error = Cafe24ApiError(message, status=0, endpoint=endpoint, maybe_applied=maybe_applied)
|
||||
if attempt < self._max_retries:
|
||||
time.sleep(min(8.0, 0.5 * (2**attempt)))
|
||||
continue
|
||||
|
||||
@@ -7,15 +7,28 @@ Admin API(OAuth)로는 스킨 파일을 다루지 못한다(`config.py` 상단
|
||||
|
||||
실물 확인(스크린샷): 호스트 `{mall_id}.ftp.cafe24.com`, 포트 21, SSL/TLS 미사용
|
||||
(평문 FTP). 파일은 텍스트(UTF-8)로 다룬다.
|
||||
|
||||
쓰기는 원본에 직접 STOR 하지 않는다 (write_text_file)
|
||||
직접 STOR 는 전송 도중 끊기면 원본이 **앞부분만 남은 채** 잘린다(스킨 템플릿이면
|
||||
모든 상품 페이지가 깨진다). 그래서
|
||||
1) 같은 폴더의 임시 파일에 올리고 (원본은 아직 그대로)
|
||||
2) 다시 받아 바이트 단위로 검증하고
|
||||
3) 교체 직전 원본을 다시 읽어 편집 시작 값과 같은지 확인하고(충돌 방지)
|
||||
4) RNFR/RNTO 로 이름을 바꿔 교체한다
|
||||
서버가 "이미 있는 이름으로 바꾸기"를 거부하면 원본을 옆 이름으로 비킨 뒤 교체하고,
|
||||
실패하면 원본을 제자리로 되돌린다. 이름 바꾸기 자체를 지원하지 않으면 **중단**한다
|
||||
(직접 STOR 로 물러서지 않는다).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import ftplib
|
||||
import io
|
||||
import posixpath
|
||||
import uuid
|
||||
|
||||
from .config import Cafe24FtpConfig
|
||||
from .errors import Cafe24FtpError
|
||||
from .errors import Cafe24FtpConflict, Cafe24FtpError
|
||||
|
||||
# 응답이 없을 때 무한 대기하지 않도록 — 관리 화면 요청 안에서 동기 호출되므로
|
||||
# 너무 길면 안 되지만, 파일 하나(수십 KB) 전송에는 충분히 넉넉해야 한다.
|
||||
@@ -35,37 +48,135 @@ def _connect(config: Cafe24FtpConfig) -> ftplib.FTP:
|
||||
raise Cafe24FtpError(f"FTP 연결/로그인에 실패했습니다: {exc}") from exc
|
||||
|
||||
|
||||
def _close(ftp: ftplib.FTP) -> None:
|
||||
try:
|
||||
ftp.quit()
|
||||
except Exception: # noqa: BLE001 — 정리 실패는 무시
|
||||
ftp.close()
|
||||
|
||||
|
||||
def _retr(ftp: ftplib.FTP, path: str) -> bytes:
|
||||
buf = io.BytesIO()
|
||||
ftp.retrbinary(f"RETR {path}", buf.write)
|
||||
return buf.getvalue()
|
||||
|
||||
|
||||
def _delete_quiet(ftp: ftplib.FTP, path: str) -> None:
|
||||
try:
|
||||
ftp.delete(path)
|
||||
except ftplib.all_errors:
|
||||
pass # 임시 파일 정리 실패는 무시(이름에 cf24tmp 가 붙어 있어 구분된다)
|
||||
|
||||
|
||||
def read_text_file(config: Cafe24FtpConfig, path: str) -> str:
|
||||
"""디자인 보관함의 파일 1개를 읽어 텍스트로 돌려준다."""
|
||||
ftp = _connect(config)
|
||||
try:
|
||||
buf = io.BytesIO()
|
||||
try:
|
||||
ftp.retrbinary(f"RETR {path}", buf.write)
|
||||
raw = _retr(ftp, path)
|
||||
except ftplib.all_errors as exc:
|
||||
raise Cafe24FtpError(f"파일을 읽지 못했습니다({path}): {exc}") from exc
|
||||
try:
|
||||
return buf.getvalue().decode("utf-8")
|
||||
return raw.decode("utf-8")
|
||||
except UnicodeDecodeError as exc:
|
||||
raise Cafe24FtpError(f"파일 인코딩을 UTF-8로 해석하지 못했습니다({path}): {exc}") from exc
|
||||
finally:
|
||||
try:
|
||||
ftp.quit()
|
||||
except Exception: # noqa: BLE001 — 정리 실패는 무시
|
||||
ftp.close()
|
||||
_close(ftp)
|
||||
|
||||
|
||||
def write_text_file(config: Cafe24FtpConfig, path: str, content: str) -> None:
|
||||
"""디자인 보관함의 파일 1개를 통째로 덮어쓴다."""
|
||||
def temp_names(path: str, tag: str) -> tuple[str, str]:
|
||||
"""(임시 업로드 이름, 원본을 잠시 비킬 이름) — 같은 폴더, 원본 이름 + 표식."""
|
||||
folder, name = posixpath.split(path)
|
||||
return (posixpath.join(folder, f"{name}.cf24tmp-{tag}"),
|
||||
posixpath.join(folder, f"{name}.cf24old-{tag}"))
|
||||
|
||||
|
||||
def write_text_file(
|
||||
config: Cafe24FtpConfig, path: str, content: str, *, expected_current: str | None = None
|
||||
) -> None:
|
||||
"""디자인 보관함의 파일 1개를 안전하게 교체한다(모듈 설명 참고).
|
||||
|
||||
expected_current: 편집 시작(또는 백업) 때 읽은 원본. 주면 교체 직전 원본을 다시
|
||||
읽어 다르면 Cafe24FtpConflict 로 멈춘다(원본 그대로).
|
||||
실패 시 Cafe24FtpError — maybe_applied=True 면 원본이 이미 바뀌었을 수 있다.
|
||||
"""
|
||||
data = content.encode("utf-8")
|
||||
tmp, aside = temp_names(path, uuid.uuid4().hex[:10])
|
||||
ftp = _connect(config)
|
||||
try:
|
||||
buf = io.BytesIO(content.encode("utf-8"))
|
||||
# 1) 임시 파일에 올린다 — 원본은 아직 그대로다.
|
||||
try:
|
||||
ftp.storbinary(f"STOR {path}", buf)
|
||||
ftp.storbinary(f"STOR {tmp}", io.BytesIO(data))
|
||||
except ftplib.all_errors as exc:
|
||||
raise Cafe24FtpError(f"파일을 쓰지 못했습니다({path}): {exc}") from exc
|
||||
finally:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(f"임시 파일을 올리지 못했습니다 — 원본은 그대로입니다({path}): {exc}") from exc
|
||||
|
||||
# 2) 검증 — 다시 받아 바이트 단위로 비교한다(전송이 잘렸으면 여기서 잡힌다).
|
||||
try:
|
||||
ftp.quit()
|
||||
except Exception: # noqa: BLE001 — 정리 실패는 무시
|
||||
ftp.close()
|
||||
uploaded = _retr(ftp, tmp)
|
||||
except ftplib.all_errors as exc:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(f"올린 임시 파일을 확인하지 못했습니다 — 원본은 그대로입니다: {exc}") from exc
|
||||
if uploaded != data:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(
|
||||
f"올린 임시 파일이 보낸 내용과 다릅니다({len(uploaded)}/{len(data)}바이트) — 원본은 그대로입니다."
|
||||
)
|
||||
|
||||
# 3) 충돌 확인 — 교체 직전의 원본이 편집 시작 값 그대로인가.
|
||||
if expected_current is not None:
|
||||
try:
|
||||
now = _retr(ftp, path)
|
||||
except ftplib.all_errors as exc:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(f"교체 직전 원본을 다시 읽지 못했습니다 — 원본은 그대로입니다: {exc}") from exc
|
||||
if now != expected_current.encode("utf-8"):
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpConflict(
|
||||
"적용하는 사이 FTP 파일이 바뀌었습니다 — 원본은 그대로입니다. 새로고침해 확인한 뒤 다시 적용하세요."
|
||||
)
|
||||
|
||||
# 4) 교체 — 이름 바꾸기. 덮어쓰기를 거부하는 서버면 원본을 비킨 뒤 교체한다.
|
||||
moved_aside = False
|
||||
try:
|
||||
ftp.rename(tmp, path)
|
||||
except ftplib.all_errors as first:
|
||||
try:
|
||||
ftp.rename(path, aside)
|
||||
except ftplib.all_errors as exc:
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(
|
||||
"이 FTP 서버가 파일 이름 바꾸기(rename)를 지원하지 않아 중단했습니다 — 원본은 그대로입니다. "
|
||||
f"({first} / {exc})"
|
||||
) from exc
|
||||
try:
|
||||
ftp.rename(tmp, path)
|
||||
except ftplib.all_errors as exc:
|
||||
try:
|
||||
ftp.rename(aside, path)
|
||||
except ftplib.all_errors as exc2:
|
||||
raise Cafe24FtpError(
|
||||
f"교체에 실패했고 원본 되돌리기도 실패했습니다. FTP 에서 {aside} 를 {path} 로 "
|
||||
f"직접 되돌리세요: {exc} / {exc2}",
|
||||
maybe_applied=True,
|
||||
) from exc2
|
||||
_delete_quiet(ftp, tmp)
|
||||
raise Cafe24FtpError(f"교체에 실패해 원본을 되돌렸습니다: {exc}") from exc
|
||||
moved_aside = True
|
||||
|
||||
# 5) 확인 — 교체 뒤 원본 경로가 새 내용인가.
|
||||
try:
|
||||
final = _retr(ftp, path)
|
||||
except ftplib.all_errors as exc:
|
||||
raise Cafe24FtpError(
|
||||
f"교체 뒤 확인 조회에 실패했습니다 — 적용됐을 수 있으니 파일을 다시 열어 확인하세요: {exc}",
|
||||
maybe_applied=True,
|
||||
) from exc
|
||||
if final != data:
|
||||
raise Cafe24FtpError(
|
||||
"교체 뒤 파일 내용이 보낸 것과 다릅니다 — 파일을 다시 열어 확인하세요.", maybe_applied=True
|
||||
)
|
||||
if moved_aside:
|
||||
_delete_quiet(ftp, aside)
|
||||
finally:
|
||||
_close(ftp)
|
||||
|
||||
@@ -32,16 +32,35 @@ class Cafe24RateLimitError(Cafe24Error):
|
||||
|
||||
|
||||
class Cafe24FtpError(Cafe24Error):
|
||||
"""디자인 보관함 FTP 연결/전송 실패 (product-swiper.js 편집 등)."""
|
||||
"""디자인 보관함 FTP 연결/전송 실패 (product-swiper.js 편집 등).
|
||||
|
||||
maybe_applied: 원본 경로가 이미 새 내용으로 바뀌었을 수 있다(교체 뒤 확인 단계 실패).
|
||||
False 면 원본은 그대로다(임시 파일 단계에서 멈춤).
|
||||
"""
|
||||
|
||||
def __init__(self, message: str, *, maybe_applied: bool = False):
|
||||
super().__init__(message)
|
||||
self.maybe_applied = maybe_applied
|
||||
|
||||
|
||||
class Cafe24FtpConflict(Cafe24FtpError):
|
||||
"""교체 직전 다시 읽은 원본이 편집 시작 때와 다르다 — 남의 수정을 덮지 않고 멈춘다."""
|
||||
|
||||
|
||||
class Cafe24ApiError(Cafe24Error):
|
||||
"""그 외 API 오류(4xx/5xx). status 로 재시도 가능 여부를 판단한다."""
|
||||
"""그 외 API 오류(4xx/5xx). status 로 재시도 가능 여부를 판단한다.
|
||||
|
||||
def __init__(self, message: str, *, status: int = 0, endpoint: str = ""):
|
||||
maybe_applied: 쓰기 요청(PUT/POST/DELETE)이 카페24에 **도달했을 수도** 있는가.
|
||||
응답을 받기 전에 끊겼거나(읽기 타임아웃 등) 5xx 를 받은 시도가 한 번이라도
|
||||
있으면 True — 반영됐는지 모르므로 호출부는 재적용하지 말고 "확인 필요"로 둔다.
|
||||
연결 자체가 안 된 경우(ConnectError)와 4xx 는 반영되지 않은 것이 확실하다.
|
||||
"""
|
||||
|
||||
def __init__(self, message: str, *, status: int = 0, endpoint: str = "", maybe_applied: bool = False):
|
||||
super().__init__(message)
|
||||
self.status = status
|
||||
self.endpoint = endpoint
|
||||
self.maybe_applied = maybe_applied
|
||||
|
||||
@property
|
||||
def retryable(self) -> bool:
|
||||
|
||||
@@ -22,6 +22,7 @@ from dataclasses import dataclass
|
||||
from typing import Any
|
||||
|
||||
from .client import Cafe24Client
|
||||
from .errors import Cafe24Error
|
||||
|
||||
# 카페24 상품 목록 API 의 1회 최대 조회 수
|
||||
PAGE_LIMIT = 100
|
||||
@@ -476,26 +477,55 @@ def wait_for_variants(
|
||||
return latest
|
||||
|
||||
|
||||
VARIANT_CHUNK = 100 # 카페24 문서상 PUT variants 1회 최대 건수
|
||||
|
||||
# update_variants 행별 결과 상태
|
||||
VARIANT_OK = "ok" # 카페24가 받아들임
|
||||
VARIANT_FAILED = "failed" # 거절 — 반영되지 않음이 확실
|
||||
VARIANT_UNKNOWN = "unknown" # 요청이 도달했을 수 있으나 응답을 못 받음 — 반영 여부 모름
|
||||
|
||||
|
||||
def update_variants(
|
||||
client: Cafe24Client, product_no: int, requests: list[dict[str, Any]]
|
||||
) -> list[dict[str, Any]]:
|
||||
"""여러 품목 부분 수정. 100건씩 나눠 보낸다(문서상 1회 100건 제한)."""
|
||||
"""여러 품목 부분 수정 — **행별 결과**를 돌려준다(요청 순서 그대로).
|
||||
|
||||
[{"variant_code": "...", "status": "ok"|"failed"|"unknown",
|
||||
"error": "", "variant": {카페24 응답의 그 품목 — 없으면 {}}}]
|
||||
|
||||
100건씩 나눠 보낸다(문서상 1회 100건 제한). 한 묶음이 실패해도 멈추지 않고 다음
|
||||
묶음을 보낸다 — 앞 묶음이 이미 반영됐는데 전체를 실패로 알리면 화면과 카페24가
|
||||
어긋나고, 사용자가 반영된 행까지 다시 보내게 된다. 호출부는 ok 인 행만 반영됨으로
|
||||
기록한다.
|
||||
"""
|
||||
no = int(product_no)
|
||||
out: list[dict[str, Any]] = []
|
||||
for start in range(0, len(requests), 100):
|
||||
chunk = requests[start : start + 100]
|
||||
for start in range(0, len(requests), VARIANT_CHUNK):
|
||||
chunk = requests[start : start + VARIANT_CHUNK]
|
||||
if not chunk:
|
||||
continue
|
||||
payload = client.put(
|
||||
f"/admin/products/{no}/variants", json={"shop_no": 1, "requests": chunk}, product_no=no
|
||||
)
|
||||
try:
|
||||
payload = client.put(
|
||||
f"/admin/products/{no}/variants", json={"shop_no": 1, "requests": chunk}, product_no=no
|
||||
)
|
||||
except Cafe24Error as exc:
|
||||
status = VARIANT_UNKNOWN if getattr(exc, "maybe_applied", False) else VARIANT_FAILED
|
||||
for row in chunk:
|
||||
out.append({"variant_code": str(row.get("variant_code") or ""), "status": status,
|
||||
"error": str(exc), "variant": {}})
|
||||
continue
|
||||
result = payload.get("variants") if isinstance(payload, dict) else None
|
||||
returned: list[dict[str, Any]] = []
|
||||
if isinstance(result, list):
|
||||
out.extend(result)
|
||||
returned = [r for r in result if isinstance(r, dict)]
|
||||
elif isinstance(result, dict):
|
||||
out.append(result)
|
||||
elif isinstance(payload.get("variant"), dict):
|
||||
out.append(payload["variant"])
|
||||
returned = [result]
|
||||
elif isinstance(payload, dict) and isinstance(payload.get("variant"), dict):
|
||||
returned = [payload["variant"]]
|
||||
by_code = {str(r.get("variant_code") or ""): r for r in returned}
|
||||
for row in chunk:
|
||||
code = str(row.get("variant_code") or "")
|
||||
out.append({"variant_code": code, "status": VARIANT_OK, "error": "", "variant": by_code.get(code, {})})
|
||||
return out
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user