"""scripts/verify-httpclient-docs.py의 시험. 코드의 이름이 문서에서 빠지면 실패하는지 본다. python3 -m unittest discover -s scripts/tests """ from __future__ import annotations import importlib.util import io import sys import unittest from contextlib import redirect_stdout from pathlib import Path SCRIPTS = Path(__file__).resolve().parent.parent _spec = importlib.util.spec_from_file_location("verify_httpclient_docs", SCRIPTS / "verify-httpclient-docs.py") verify_httpclient_docs = importlib.util.module_from_spec(_spec) sys.modules["verify_httpclient_docs"] = verify_httpclient_docs _spec.loader.exec_module(verify_httpclient_docs) class HttpclientDocsTest(unittest.TestCase): # No case runs the verifier over the real tree and expects 0: that is the release workflow's # check, and this suite runs in the pull-request gate (documentCheck). def test_a_metric_missing_from_the_documentation_fails_naming_it(self) -> None: # given metric = verify_httpclient_docs.metric_names()[0] original = verify_httpclient_docs.read_docs verify_httpclient_docs.read_docs = lambda: original().replace(metric, "") output = io.StringIO() try: # when with redirect_stdout(output): rc = verify_httpclient_docs.main() finally: verify_httpclient_docs.read_docs = original # then self.assertEqual(rc, 1) self.assertIn(f"metric '{metric}'", output.getvalue()) if __name__ == "__main__": unittest.main()