Reimplement the CLI over the new API with --json

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: derek73

nameparser/__main__.py

@@ -1,31 +1,30 @@
-"""Command-line debug helper: parse a name and print the result.
-
-Usage:
+"""Command-line debug helper over the 2.0 API (migration spec §6).
 
     python -m nameparser "Dr. Juan Q. Xavier de la Vega III"
+    python -m nameparser --json "Doe, John"
 """
-import logging
-import sys
+import argparse
+import json
 
-from nameparser import HumanName
+from nameparser import parse
 
 
-def main() -> None:
-    if len(sys.argv) <= 1:
-        print('Usage: python -m nameparser "Name String"')
-        raise SystemExit(1)
-    log = logging.getLogger('HumanName')
-    log.setLevel(logging.ERROR)
-    log.addHandler(logging.StreamHandler())
-    name_string = sys.argv[1]
-    hn = HumanName(name_string)
-    print(repr(hn))
-    hn.capitalize()
-    print(repr(hn))
-    # Use comma rather than concatenation: initials() returns
-    # empty_attribute_default (possibly None) when there are no initials.
-    print("Initials:", hn.initials())
+def main(argv: list[str] | None = None) -> int:
+    ap = argparse.ArgumentParser(
+        prog="nameparser", description="Parse a personal name.")
+    ap.add_argument("name", help="the name string to parse")
+    ap.add_argument("--json", action="store_true",
+                    help="print the component dict as JSON")
+    args = ap.parse_args(argv)
+    n = parse(args.name)
+    if args.json:
+        print(json.dumps(n.as_dict(), ensure_ascii=False))
+        return 0
+    print(repr(n))
+    print(repr(n.capitalized()))
+    print("Initials:", n.initials())
+    return 0
 
 
-if __name__ == '__main__':
-    main()
+if __name__ == "__main__":
+    raise SystemExit(main())

tests/v2/test_cli.py

@@ -0,0 +1,26 @@
+import json
+import subprocess
+import sys
+
+
+def _run(*args: str) -> subprocess.CompletedProcess:
+    return subprocess.run([sys.executable, "-m", "nameparser", *args],
+                          capture_output=True, text=True)
+
+
+def test_cli_prints_repr_capitalized_and_initials() -> None:
+    out = _run("dr. juan de la vega iii").stdout
+    assert "juan" in out                      # raw repr first
+    assert "Juan" in out                      # capitalized repr second
+    assert "Initials:" in out
+
+
+def test_cli_json() -> None:
+    proc = _run("John Smith", "--json")
+    data = json.loads(proc.stdout)
+    assert data["given"] == "John" and data["family"] == "Smith"
+
+
+def test_cli_no_args_usage() -> None:
+    proc = _run()
+    assert proc.returncode != 0

tests/v2/test_layering.py

@@ -78,6 +78,9 @@
     # v1 import-path preservation: thin re-exports of the facade/shim
     "parser.py": ("nameparser._facade",),
     "config/__init__.py": ("nameparser._config_shim",),
+    # CLI (migration spec §6): imports only the public package, same as
+    # any other consumer -- no access to internal modules.
+    "__main__.py": ("nameparser",),
 }