"""Minimal CLI: `python -m cepis 01001000`. It exists for one concrete case — quickly confirming a local instance answers before pointing code at it:: python -m cepis --base-url http://localhost:8080 01001000 A single CEP goes through the unit lookup, which carries `geo`; several go through the batch, which is one request instead of N and has no `geo`. It is not the library's main interface; for that, import :mod:`cepis`. """ from __future__ import annotations import argparse import dataclasses import json import sys from . import DEFAULT_URL, CepisError, Client def main(argv: list[str] | None = None) -> int: """Run the CLI. Returns the process exit code.""" parser = argparse.ArgumentParser( prog="python -m cepis", description="Look CEPs up against the cep.is API.", ) parser.add_argument("cep", nargs="+", help="one or more CEPs, masked or not") parser.add_argument( "--base-url", default=DEFAULT_URL, help=f"API URL (default: {DEFAULT_URL}) — use it to point at a local instance", ) parser.add_argument( "--timeout", type=float, default=10.0, help="per-socket timeout, in seconds" ) args = parser.parse_args(argv) client = Client(base_url=args.base_url, timeout=args.timeout) try: if len(args.cep) == 1: addresses = [client.lookup(args.cep[0])] else: addresses = client.lookup_many(args.cep) except CepisError as exc: print(f"error: {exc}", file=sys.stderr) return 1 output = [None if a is None else dataclasses.asdict(a) for a in addresses] for item in output: if item is not None: item.pop("raw", None) print(json.dumps(output if len(output) > 1 else output[0], ensure_ascii=False, indent=2)) return 0 if __name__ == "__main__": raise SystemExit(main())