Parse CLI arguments.
(argv: list[str] | None = None)
| 425 | |
| 426 | |
| 427 | def parse_args(argv: list[str] | None = None) -> argparse.Namespace: |
| 428 | """Parse CLI arguments.""" |
| 429 | parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawTextHelpFormatter) |
| 430 | sub = parser.add_subparsers(dest="command") |
| 431 | sub.add_parser("check", help="verify the manifest and generated files match the docs (default)") |
| 432 | sub.add_parser("sync", help="add placeholder entries for new docs, drop dead entries, and regenerate") |
| 433 | sub.add_parser("generate", help="regenerate llms.txt and llms-full.txt from the manifest") |
| 434 | stamp = sub.add_parser("stamp", help="record that a changed doc's summary has been reviewed, then regenerate") |
| 435 | stamp.add_argument("paths", nargs="+", help="repo-relative doc paths") |
| 436 | validate = sub.add_parser( |
| 437 | "validate", help="ask a small model on the LLM gateway whether summaries match their docs" |
| 438 | ) |
| 439 | validate.add_argument("paths", nargs="*", help="repo-relative doc paths (default: all)") |
| 440 | validate.add_argument("--model", default=DEFAULT_MODEL, help="gateway model (default: %(default)s)") |
| 441 | sub.add_parser("test", help="run unit tests") |
| 442 | args = parser.parse_args(argv) |
| 443 | if not args.command: |
| 444 | args.command = "check" |
| 445 | return args |
| 446 | |
| 447 | |
| 448 | def main(argv: list[str] | None = None) -> int: |