Mina Choi
11d30bb3d1
여러 줄 주석이 설명보다 경위(예전·실측·지적)를 적고 있어 읽는 사람이 결론을 찾기 어려웠다. - ts·tsx·js·mjs·css·py 478개: 여러 줄 주석은 첫 문장 한 줄로, 과거형·날짜 문장은 삭제 - 주석 위치는 TypeScript 파서·파이썬 tokenize/ast 로 찾는다 — 문자열 안의 # · /* 는 건드리지 않는다 - eslint·ts·noqa·type: ignore 같은 지시 주석은 그대로 둔다 파이썬 275개 정리 전후 AST 동일, TS 298개 주석 뺀 토큰 동일(빈 JSX 주석 10곳만 차이). site·frontend·admin tsc, site vitest 105 passed Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
33 lines
1.2 KiB
Python
33 lines
1.2 KiB
Python
"""OpenAPI 스펙을 파일로 뽑는다 — 서버를 띄우지 않고."""
|
|
import argparse
|
|
import json
|
|
import os
|
|
import sys
|
|
|
|
# backend/ 를 import 경로에 올린다(scripts/ 에서 실행해도 동작하게).
|
|
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
|
os.environ.setdefault("APP_ENV", "local")
|
|
|
|
DEFAULT_OUT = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "openapi.json")
|
|
|
|
|
|
def main() -> None:
|
|
parser = argparse.ArgumentParser(description="FastAPI OpenAPI 스펙을 JSON 으로 내보낸다.")
|
|
parser.add_argument("-o", "--out", default=DEFAULT_OUT, help=f"출력 경로 (기본: {DEFAULT_OUT})")
|
|
args = parser.parse_args()
|
|
|
|
# import 시점에 app 이 만들어진다.
|
|
import router.router
|
|
|
|
spec = router.router.app.openapi()
|
|
with open(args.out, "w", encoding="utf-8") as f:
|
|
json.dump(spec, f, ensure_ascii=False, indent=2)
|
|
f.write("\n")
|
|
|
|
ops = sum(len([m for m in item if m in ("get", "post", "put", "patch", "delete")]) for item in spec["paths"].values())
|
|
print(f"{args.out} ({len(spec['paths'])} paths / {ops} operations)")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|