#!/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()