#!/usr/bin/env python3 """Read-only postcode search. Python 3.10+, standard library only.""" import json, os, sys from urllib.request import Request, urlopen from urllib.parse import urlencode from urllib.error import HTTPError, URLError def search(postcode, key): url = "https://api.planwire.io/v1/applications?" + urlencode({"postcode": postcode, "limit": 5}) request = Request(url, headers={"X-API-Key": key, "Accept": "application/json"}) try: with urlopen(request, timeout=15) as result: return json.load(result) except HTTPError as error: # An HTTP error is never an empty search. Do not retry 429 in a tight loop. raise RuntimeError(f"PlanWire HTTP {error.code}; check access, limits and query") from None except (URLError, TimeoutError): raise RuntimeError("PlanWire request failed; no empty result inferred") from None if __name__ == "__main__": if len(sys.argv) > 1 and sys.argv[1] == "--fixture": from pathlib import Path result = json.loads(Path(__file__).with_name("response.json").read_text()) else: key = os.environ.get("PLANWIRE_KEY") if not key: sys.exit("Set PLANWIRE_KEY privately; use --fixture for an offline example") try: result = search(sys.argv[1] if len(sys.argv) > 1 else "N16", key) except RuntimeError as error: sys.exit(str(error)) for app in result["data"]: print(json.dumps({"reference": app["reference"], "applicationDate": app.get("applicationDate"), "url": app.get("url")}, ensure_ascii=False))