fix(scripts)!: httpclient 문서 검사가 설정 필드를 절과 표 위치로 대조한다 #88

Merged
donghyeon.kang merged 3 commits from fix/httpclient-docs-field-match into main 2026-11-21 21:12:03 +00:00
3 Commits
Author SHA1 Message Date
donghyeon.kang ea5c4f5e87 Merge branch 'main' into fix/httpclient-docs-field-match
pr / done (pull_request) Successful in 1m54s
2026-11-21 19:32:20 +00:00
donghyeon.kang b64f11b71c Merge branch 'main' into fix/httpclient-docs-field-match
pr / done (pull_request) Successful in 2m26s
2026-11-21 18:32:11 +00:00
DongHyeonka ea25f624b2 fix(scripts)!: httpclient 문서 검사가 설정 필드를 절과 표 위치로 대조한다
pr / done (pull_request) Canceled after 0s
verify-httpclient-docs.py는 manifest 필드를 마지막 마디로 줄이고
(clients[N].tls.enabled → enabled) 아홉 문서를 이은 글에서 부분 문자열로
찾는다. 마지막 마디가 겹치는 이름이 여섯 종(enabled 셋, name, type,
protocols, allowed-hosts, allowed-ports)이라 그 이름의 새 필드는 문서 없이
통과한다. 「지운 설정」 표에만 적힌 key도 통과한다. 다섯 종류 추출 어느
것도 0개를 실패로 보지 않고, transport 정규식은 숫자를 빼서 HTTP3 꼴
상수를 뽑지 못한다.

설정 필드는 configuration-reference.md의 속성 표(머리 첫 칸 「속성」)를
제목과 첫 칸으로 읽어(documented_properties) 전체 경로로 대조한다. ##
제목의 app.httpclient.<block>이 블록, ### 제목의 코드 표기가 묶음이다.
지운 key 표·설명 표와 코드 블록 안 표는 세지 않는다. manifest 필드는 끝
[N]·[M]만 뗀다. 종류마다 0개면 실패하고, transport 정규식에 숫자를
넣었다. 이 대조로 처음 드러난 최상위 rotation-drain-timeout 행을 설정
참조에 더했다. 버린 안: 마지막 두 마디 대조. 표가 절 아래 leaf만 적어서
51개 필드의 두 마디가 문서에 같이 나오지 않아, 문서 표 형식부터 바꿔야
했다.

위험: 설정 필드는 이제 configuration-reference.md 속성 표에 있어야 한다.
다른 여덟 문서에만 있으면 실패다. 나머지 네 종류는 전처럼 부분 문자열로
찾는다. 실제 트리 대조는 여전히 release job에서만 돈다. 시험은 고정
설정 참조와 manifest를 써서 실제 트리에 필드를 더해도 빨개지지 않는다.

검증: 새 시험을 main 판 검사기에 얹어 FAIL 4·ERROR 1(새 필드·속성 표
밖 key·빈 manifest·숫자 transport가 rc=0으로 통과, 파서 시험은 함수
없음). 고친 뒤 python3 -m unittest discover -s scripts/tests OK(313),
python3 scripts/verify-httpclient-docs.py rc=0(설정 필드 74, 문서 쪽
남는 경로 0), 검사기 변이 15개 중 14개를 시험이 잡고 1개는 등가,
check-docs.py·check-work-docs.py rc=0.

Refs: REV-BE-0013
BREAKING CHANGE: app.httpclient 필드를 더한 파생 서비스는 그 필드를
  configuration-reference.md의 자기 절 속성 표에 적어야 release 문서
  검사를 통과한다. docs/upgrade/2026-11-httpclient-docs-check.md를 본다.
2026-11-22 03:11:04 +09:00