[derek73]

Summary

Lets the command line try a rule on one name, to see whether a Policy switch already resolves a parse problem.

• --two-given-names, --two-family-names, --middle-as-family, --lenient-comma-suffixes, --unlisted-dotted-suffixes, each with a --no- form (argparse.BooleanOptionalAction), and --unlisted-caps-suffixes {off,after-comma,everywhere}, its choices read from CapsSuffixes.
• Flags are spelled as the field they set. Like --order, each is written into the --locale pack's own PolicyPatch, so it replaces the pack's setting (--locale es --no-two-family-names) and a flag left out keeps the pack's value.
• The other Policy fields stay off the command line on purpose, listed in _NOT_ON_THE_COMMAND_LINE: script_orders, segment_scripts, patronymic_rules and the three delimiter sets need real setup, and strip_emoji/strip_bidi are input clean-up. test_cli_sorts_every_policy_field_into_a_flag_or_a_reason holds the tables to dataclasses.fields(Policy), so a new field fails until someone decides.

$ python -m nameparser --two-given-names --json "Juan Carlos García"
{"title": "", "given": "Juan Carlos", "middle": "", "family": "García", ...}
$ python -m nameparser --locale es --no-two-family-names --json "Gabriel García Márquez"
{"title": "", "given": "Gabriel", "middle": "García", "family": "Márquez", ...}

No parser behavior changes, so no rules docs move; docs/usage.rst's command-line section and the release log gain a paragraph and a bullet.

Test plan

• Each switch in both directions, with a row-coverage check against _SWITCHES
• Each --unlisted-caps-suffixes value on a comma name and a trailing-capitals name, with a row-coverage check against CapsSuffixes
• A flag overriding a pack's setting, a flag left out keeping it, a flag combined with --order
• A stand-in pack per flag setting its field against the default: left out, the pack's value holds; given the other way, the flag wins. Forcing an omitted flag to the Policy default fails it for every field that mutation reaches
• uv run pytest (38,961 passed), uv run mypy, uv run ruff check

🤖 Generated with Claude Code