Files
community/scripts/resource-path-rollback.py
T

68 lines
3.3 KiB
Python

#!/usr/bin/env python3
"""将封面路径导出数据转换为供人工执行的回退 SQL;不连接数据库。"""
import argparse
import json
from pathlib import Path
import re
from urllib.parse import quote, urlsplit
def sql_text(value: str) -> str:
return "CONVERT(0x" + value.encode("utf-8").hex() + " USING utf8mb4)"
def generate(rows: list[dict], root: str, public_base: str) -> str:
if not re.fullmatch(r"[A-Za-z0-9_-]+", root):
raise ValueError("环境根目录不合法")
base = urlsplit(public_base)
if (base.scheme != "https" or not base.hostname or base.username is not None
or any(char.isspace() or ord(char) < 32 for char in public_base)
or base.password is not None or "?" in public_base or "#" in public_base
or (base.port is not None and not 1 <= base.port <= 65535)):
raise ValueError("公开基础地址必须是无凭据和参数的 HTTPS 地址")
statements = []
seen = set()
for row in rows:
code = row.get("projectCode", "")
path = row.get("coverPath", "")
if not isinstance(code, str) or not re.fullmatch(r"[a-z0-9]{12}|[a-z0-9]{32}", code):
raise ValueError("项目编码不合法")
if code in seen:
raise ValueError(f"项目编码重复 projectCode={code}")
seen.add(code)
if (not isinstance(path, str) or not path.startswith("/project-covers/")
or any(ord(char) < 32 or ord(char) == 127 for char in path)
or "\\" in path or ":" in path
or any(part in ("", ".", "..") or part.lower() == ".git" for part in path[1:].split("/"))):
raise ValueError(f"封面存储路径异常 projectCode={code}")
full_url = public_base.rstrip("/") + "/" + root + quote(path, safe="/!$&'()*+,;=@-._~")
if len(full_url) > 2048:
raise ValueError(f"编码后的封面地址超过2048字符,无法回退 projectCode={code}")
statements.append("INSERT INTO resource_cover_rollback (project_code, cover_path, full_url) VALUES ("
+ ", ".join(sql_text(value) for value in (code, path, full_url)) + ");")
return "\n".join(statements) + ("\n" if statements else "")
def main() -> None:
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--root", required=True)
parser.add_argument("--public-base-url", required=True)
parser.add_argument("--input", type=Path, required=True)
parser.add_argument("--output", type=Path, required=True)
args = parser.parse_args()
try:
rows = [json.loads(line) for line in args.input.read_text(encoding="utf-8").splitlines() if line.strip()]
result = generate(rows, args.root, args.public_base_url)
# 全部校验成功后才落盘,不输出原始地址或路径。
args.output.write_text(result, encoding="utf-8")
print(f"已生成回退SQL,记录数={len(rows)};请按数据库文档人工执行")
except (ValueError, TypeError, AttributeError, OSError) as error:
if isinstance(error, json.JSONDecodeError):
parser.exit(1, "输入不是合法的JSON Lines,请使用无列头导出\n")
parser.exit(1, f"回退SQL生成失败:{error.__class__.__name__};检查输入文件、地址、路径及字段长度\n")
if __name__ == "__main__":
main()