dev_harness/dev_scripts/sync_wiki_docs.py

"""从 Gitea Wiki 单向导出配置中的核心 docs 镜像。"""

from __future__ import annotations

import argparse
from pathlib import Path

from wiki_docs import DEFAULT_CONFIG, WikiClient, WikiDocsError, load_config, sync_all


def main() -> int:
    parser = argparse.ArgumentParser(description="从 Gitea Wiki 单向同步核心 docs 镜像")
    parser.add_argument(
        "--check", action="store_true", help="只检查 Wiki 与镜像是否一致，不写文件"
    )
    parser.add_argument(
        "--config", default=str(DEFAULT_CONFIG), help="Wiki 页面映射 JSON 文件"
    )
    args = parser.parse_args()
    try:
        config = load_config(Path(args.config).resolve())
        messages = sync_all(config, WikiClient(config), check=args.check)
    except WikiDocsError as exc:
        print(f"错误：{exc}")
        return 1
    for message in messages:
        print(message)
    print("Wiki 镜像检查通过" if args.check else "Wiki 镜像同步完成")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())