parseapi 0.1.0__tar.gz → 0.2.1__tar.gz

parseapi-0.2.1/.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - '[0-9]+.[0-9]+.[0-9]+'
+  workflow_dispatch:
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

{parseapi-0.1.0 → parseapi-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: parseapi
-Version: 0.1.0
+Version: 0.2.1
 Summary: Official parseAPI client for Python. One key, minimal JSON, fast.
 Project-URL: Homepage, https://parseapi.com
 Project-URL: Documentation, https://parseapi.com/docs
@@ -42,7 +42,14 @@ One method per endpoint, named after the route.
 parse.ip("8.8.8.8")
 parse.ip.self()
 parse.email("hello@gmail.com")
+parse.vat("DE136695976")
+parse.iban("DE89370400440532013000")
+parse.npi("1881018208")
 parse.phone("+14155552671")
+parse.carrier("+14155552671")
+parse.caller("+14155552671")
+parse.hlr("+14155552671")
+parse.postal("SW1A 1AA")
 parse.postal("28202", country="US")
 parse.postal.nearby("28202", country="US", radius=40)
 parse.postal.distance("28202", "10001", country="US")
@@ -50,8 +57,10 @@ parse.city("charlotte", country="US")
 parse.city.id("city_mb8mbqrkz8zb")
 parse.city.search("char", country="US", limit=10)
 parse.city.nearest(35.2271, -80.8431)
+parse.city.nearby("denver", radius=8, unit="mi")
 parse.country("US")
 parse.country.states("US")
+parse.state("colorado")
 parse.state("NC", country="US")
 parse.state.districts("NC", country="US")
 parse.district("37081")
@@ -60,6 +69,7 @@ parse.continent.countries("NA")
 parse.currency("USD")
 parse.currency.rate("USD", "EUR")
 parse.language("en")
+parse.name("BILLY OSHALL")
 parse.timezone("America/New_York")
 parse.holiday("US", year=2026)
 parse.holiday.date("US", "2026-12-25")
@@ -69,6 +79,7 @@ parse.weather(40.7128, -74.006)
 parse.domain("example.com")
 parse.mx("example.com")
 parse.useragent(ua_string)
+parse.vin("1HGCM82633A004352")
 parse.emoji("rocket")
 parse.emoji.search("fire")
 ```

{parseapi-0.1.0 → parseapi-0.2.1}/README.md

@@ -23,7 +23,14 @@ One method per endpoint, named after the route.
 parse.ip("8.8.8.8")
 parse.ip.self()
 parse.email("hello@gmail.com")
+parse.vat("DE136695976")
+parse.iban("DE89370400440532013000")
+parse.npi("1881018208")
 parse.phone("+14155552671")
+parse.carrier("+14155552671")
+parse.caller("+14155552671")
+parse.hlr("+14155552671")
+parse.postal("SW1A 1AA")
 parse.postal("28202", country="US")
 parse.postal.nearby("28202", country="US", radius=40)
 parse.postal.distance("28202", "10001", country="US")
@@ -31,8 +38,10 @@ parse.city("charlotte", country="US")
 parse.city.id("city_mb8mbqrkz8zb")
 parse.city.search("char", country="US", limit=10)
 parse.city.nearest(35.2271, -80.8431)
+parse.city.nearby("denver", radius=8, unit="mi")
 parse.country("US")
 parse.country.states("US")
+parse.state("colorado")
 parse.state("NC", country="US")
 parse.state.districts("NC", country="US")
 parse.district("37081")
@@ -41,6 +50,7 @@ parse.continent.countries("NA")
 parse.currency("USD")
 parse.currency.rate("USD", "EUR")
 parse.language("en")
+parse.name("BILLY OSHALL")
 parse.timezone("America/New_York")
 parse.holiday("US", year=2026)
 parse.holiday.date("US", "2026-12-25")
@@ -50,6 +60,7 @@ parse.weather(40.7128, -74.006)
 parse.domain("example.com")
 parse.mx("example.com")
 parse.useragent(ua_string)
+parse.vin("1HGCM82633A004352")
 parse.emoji("rocket")
 parse.emoji.search("fire")
 ```

{parseapi-0.1.0 → parseapi-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "parseapi"
-version = "0.1.0"
+version = "0.2.1"
 description = "Official parseAPI client for Python. One key, minimal JSON, fast."
 readme = "README.md"
 license = "MIT"

{parseapi-0.1.0 → parseapi-0.2.1}/smoke/smoke.py

@@ -51,6 +51,16 @@ expect_ok("ip", lambda: parse.ip("8.8.8.8"), lambda r: None if r["ip"] == "8.8.8
 expect_ok("ip.self", lambda: parse.ip.self(), lambda r: None if r.get("ip") else "no ip")
 expect_ok("continent", lambda: parse.continent("NA"), lambda r: None if r["name"] == "North America" else "wrong name")
 expect_ok("continent.countries", lambda: parse.continent.countries("NA"), lambda r: None if r["countries"] else "empty")
+expect_ok(
+    "bloc",
+    lambda: parse.bloc("EU"),
+    lambda r: None if r["name"] == "European Union" and r["members"] == 27 else "wrong bloc",
+)
+expect_ok(
+    "bloc.countries",
+    lambda: parse.bloc.countries("SCHENGEN"),
+    lambda r: None if r["countries"] and len(r["countries"]) == 29 else "wrong members",
+)
 expect_ok("country", lambda: parse.country("US"), lambda r: None if r["iso3"] == "USA" else "wrong iso3")
 expect_ok("country.states", lambda: parse.country.states("US"), lambda r: None if len(r["states"]) >= 50 else "too few")
 expect_ok("state", lambda: parse.state("NC", country="US"), lambda r: None if r["name"] == "North Carolina" else "wrong")
@@ -72,10 +82,37 @@ expect_ok(
     lambda r: None if 800 < r["distance"] < 1000 else f"distance {r['distance']}",
 )
 expect_ok("email", lambda: parse.email("hello@gmail.com"), lambda r: None if r["valid"] is True else "not valid")
-expect_ok("phone", lambda: parse.phone("+14155552671"), lambda r: None if r["e164"] == "+14155552671" else "wrong e164")
+expect_ok(
+    "vat",
+    lambda: parse.vat("DE136695976"),
+    lambda r: None if r.get("valid") is True and r.get("country") == "DE" else "not valid DE",
+)
+expect_ok(
+    "iban",
+    lambda: parse.iban("DE89370400440532013000"),
+    lambda r: None if r.get("valid") is True and r.get("country") == "DE" and r.get("bank") == "37040044" else "not valid DE",
+)
+expect_ok("iban junk", lambda: parse.iban("hello"), lambda r: None if r.get("valid") is False else "expected invalid")
+expect_ok(
+    "npi",
+    lambda: parse.npi("1881018208"),
+    lambda r: None if r.get("valid") is True and r.get("registered") is True else "not registered",
+)
+expect_ok("npi junk", lambda: parse.npi("hello"), lambda r: None if r.get("valid") is False else "expected invalid")
+expect_ok("phone", lambda: parse.phone("+14155552671"), lambda r: None if r["phone"] == "+14155552671" else "wrong phone")
+# Metered core siblings: junk numbers answer 200 valid false, free, no vendor dip.
+expect_ok("carrier junk free", lambda: parse.carrier("555-0100"), lambda r: None if r["valid"] is False else "expected invalid")
+expect_ok("caller junk free", lambda: parse.caller("555-0100"), lambda r: None if r["valid"] is False else "expected invalid")
+expect_ok("hlr junk free", lambda: parse.hlr("555-0100"), lambda r: None if r["valid"] is False else "expected invalid")
 expect_ok("domain", lambda: parse.domain("gmail.com"), lambda r: None if r["available"] is False else "gmail available?")
 expect_ok("mx", lambda: parse.mx("gmail.com"), lambda r: None if r["mx"] else "no mx")
 expect_ok("useragent", lambda: parse.useragent(UA), lambda r: None if r["browser"] == "Chrome" else f"browser {r['browser']}")
+expect_ok(
+    "vin",
+    lambda: parse.vin("1HGCM82633A004352"),
+    lambda r: None if r.get("valid") is True and r.get("make") == "Honda" and r.get("year") == 2003 else "wrong decode",
+)
+expect_ok("vin junk", lambda: parse.vin("1HGCM82613A004352"), lambda r: None if r.get("valid") is False else "expected invalid")
 expect_ok("currency", lambda: parse.currency("USD"), lambda r: None if r["symbol"] == "$" else "wrong symbol")
 expect_ok("currency.rate", lambda: parse.currency.rate("USD", "EUR"), lambda r: None if 0 < r["rate"] < 10 else "bad rate")
 expect_ok(
@@ -83,6 +120,11 @@ expect_ok(
     lambda: parse.language("en"),
     lambda r: None if r.get("language") == "en" and r.get("name") == "English" else "wrong language",
 )
+expect_ok(
+    "name",
+    lambda: parse.name("BILLY O'SHALL"),
+    lambda r: None if r["name"] == "Billy O'Shall" and r["valid"] is True and r["gender"] == "male" else "wrong name",
+)
 expect_ok(
     "timezone",
     lambda: parse.timezone("America/New_York"),
@@ -97,7 +139,7 @@ expect_ok(
 expect_ok("holiday null", lambda: parse.holiday.date("US", "2026-08-12"), lambda r: None if r["holiday"] is None else "expected null")
 expect_ok("elevation", lambda: parse.elevation(35.2271, -80.8431), lambda r: None if isinstance(r["elevation"], (int, float)) else "no elevation")
 expect_ok("point", lambda: parse.point(36.0726, -79.792), lambda r: None if r["country"] == "US" else f"country {r['country']}")
-expect_ok("weather", lambda: parse.weather(40.7128, -74.006), lambda r: None if r.get("station") else "no station")
+expect_ok("weather", lambda: parse.weather(40.7128, -74.006), lambda r: None if (r.get("station") or {}).get("id") else "no station")
 expect_ok("emoji", lambda: parse.emoji("rocket"), lambda r: None if r["emoji"] == "\U0001F680" else "wrong emoji")
 expect_ok("emoji.search", lambda: parse.emoji.search("fire", limit=5), lambda r: None if r["emojis"] else "empty")
 expect_ok("point deep triad", lambda: parse.point(36.0726, -79.792, deep=True), lambda r: None if isinstance(r.get("deep"), dict) else "deep missing")

{parseapi-0.1.0 → parseapi-0.2.1}/src/parseapi/__init__.py

@@ -2,5 +2,5 @@
 
 from ._client import AsyncParseAPI, ParseAPI, ParseAPIError
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"
 __all__ = ["ParseAPI", "AsyncParseAPI", "ParseAPIError", "__version__"]

{parseapi-0.1.0 → parseapi-0.2.1}/src/parseapi/_client.py

@@ -8,7 +8,7 @@ from urllib.parse import quote
 
 import httpx
 
-VERSION = "0.1.0"
+VERSION = "0.2.1"
 DEFAULT_BASE_URL = "https://api.parseapi.com"
 DEFAULT_TIMEOUT = 10.0
 DEFAULT_RETRIES = 2
@@ -107,6 +107,7 @@ class ParseAPI:
         )
         self.ip = _IpSync(self)
         self.continent = _ContinentSync(self)
+        self.bloc = _BlocSync(self)
         self.country = _CountrySync(self)
         self.state = _StateSync(self)
         self.city = _CitySync(self)
@@ -114,6 +115,7 @@ class ParseAPI:
         self.currency = _CurrencySync(self)
         self.holiday = _HolidaySync(self)
         self.emoji = _EmojiSync(self)
+        self.tariff = _TariffSync(self)
 
     def close(self) -> None:
         self._http.close()
@@ -145,15 +147,40 @@ class ParseAPI:
 
     # Plain methods (no subresources)
 
-    def district(self, code: str, *, country: Optional[str] = None) -> Json:
-        return self._get(f"/district/{_seg(code)}", {"country": country})
+    def district(self, code: str, *, country: Optional[str] = None, state: Optional[str] = None) -> Json:
+        return self._get(f"/district/{_seg(code)}", {"country": country, "state": state})
 
     def email(self, email: str, *, deep: bool = False) -> Json:
         return self._get(f"/email/{_seg(email)}", {"deep": deep})
 
+    def vat(
+        self,
+        number: str,
+        *,
+        country: Optional[str] = None,
+        deep: bool = False,
+        from_vat: Optional[str] = None,
+    ) -> Json:
+        return self._get(f"/vat/{_seg(number)}", {"country": country, "deep": deep, "from": from_vat})
+
+    def iban(self, iban: str, *, country: Optional[str] = None) -> Json:
+        return self._get(f"/iban/{_seg(iban)}", {"country": country})
+
+    def npi(self, npi: str, *, deep: bool = False) -> Json:
+        return self._get(f"/npi/{_seg(npi)}", {"deep": deep})
+
     def phone(self, number: str, *, country: Optional[str] = None, deep: bool = False) -> Json:
         return self._get(f"/phone/{_seg(number)}", {"country": country, "deep": deep})
 
+    def carrier(self, number: str, *, country: Optional[str] = None) -> Json:
+        return self._get(f"/carrier/{_seg(number)}", {"country": country})
+
+    def caller(self, number: str, *, country: Optional[str] = None) -> Json:
+        return self._get(f"/caller/{_seg(number)}", {"country": country})
+
+    def hlr(self, number: str, *, country: Optional[str] = None) -> Json:
+        return self._get(f"/hlr/{_seg(number)}", {"country": country})
+
     def domain(self, domain: str, *, deep: bool = False) -> Json:
         return self._get(f"/domain/{_seg(domain)}", {"deep": deep})
 
@@ -163,12 +190,18 @@ class ParseAPI:
     def useragent(self, ua: str, *, deep: bool = False) -> Json:
         return self._get("/useragent", {"deep": deep}, headers={"User-Agent": ua})
 
+    def vin(self, vin: str, *, deep: bool = False) -> Json:
+        return self._get(f"/vin/{_seg(vin)}", {"deep": deep})
+
     def timezone(self, id: str, *, at: Optional[str] = None) -> Json:
         return self._get(f"/timezone/{_seg(id)}", {"at": at})
 
     def language(self, code: str) -> Json:
         return self._get(f"/language/{_seg(code)}")
 
+    def name(self, name: str) -> Json:
+        return self._get(f"/name/{_seg(name)}")
+
     def elevation(self, lat: float, lon: float) -> Json:
         return self._get("/elevation", {"lat": lat, "lon": lon})
 
@@ -201,6 +234,17 @@ class _ContinentSync:
         return self._client._get(f"/continent/{_seg(code)}/countries")
 
 
+class _BlocSync:
+    def __init__(self, client: ParseAPI):
+        self._client = client
+
+    def __call__(self, code: str) -> Json:
+        return self._client._get(f"/bloc/{_seg(code)}")
+
+    def countries(self, code: str) -> Json:
+        return self._client._get(f"/bloc/{_seg(code)}/countries")
+
+
 class _CountrySync:
     def __init__(self, client: ParseAPI):
         self._client = client
@@ -216,10 +260,10 @@ class _StateSync:
     def __init__(self, client: ParseAPI):
         self._client = client
 
-    def __call__(self, code: str, *, country: str) -> Json:
+    def __call__(self, code: str, *, country: Optional[str] = None) -> Json:
         return self._client._get(f"/state/{_seg(code)}", {"country": country})
 
-    def districts(self, code: str, *, country: str) -> Json:
+    def districts(self, code: str, *, country: Optional[str] = None) -> Json:
         return self._client._get(f"/state/{_seg(code)}/districts", {"country": country})
 
 
@@ -246,25 +290,40 @@ class _CitySync:
     def nearest(self, lat: float, lon: float) -> Json:
         return self._client._get("/city", {"lat": lat, "lon": lon})
 
+    def nearby(
+        self,
+        name: str,
+        *,
+        radius: Optional[float] = None,
+        unit: Optional[str] = None,
+        country: Optional[str] = None,
+        state: Optional[str] = None,
+        limit: Optional[int] = None,
+    ) -> Json:
+        return self._client._get(
+            f"/city/{_seg(name)}/nearby",
+            {"radius": radius, "unit": unit, "country": country, "state": state, "limit": limit},
+        )
+
 
 class _PostalSync:
     def __init__(self, client: ParseAPI):
         self._client = client
 
-    def __call__(self, code: str, *, country: str) -> Json:
+    def __call__(self, code: str, *, country: Optional[str] = None) -> Json:
         return self._client._get(f"/postal/{_seg(code)}", {"country": country})
 
     def nearby(
         self,
         code: str,
         *,
-        country: str,
+        country: Optional[str] = None,
         radius: Optional[float] = None,
         unit: Optional[str] = None,
     ) -> Json:
         return self._client._get(f"/postal/{_seg(code)}/nearby", {"country": country, "radius": radius, "unit": unit})
 
-    def distance(self, from_postal: str, to_postal: str, *, country: str) -> Json:
+    def distance(self, from_postal: str, to_postal: str, *, country: Optional[str] = None) -> Json:
         return self._client._get(f"/postal/{_seg(from_postal)}/distance/{_seg(to_postal)}", {"country": country})
 
 
@@ -275,8 +334,12 @@ class _CurrencySync:
     def __call__(self, code: str) -> Json:
         return self._client._get(f"/currency/{_seg(code)}")
 
-    def rate(self, base: str, quote_currency: str) -> Json:
-        return self._client._get(f"/currency/{_seg(base)}/{_seg(quote_currency)}")
+    def rate(
+        self, base: str, quote_currency: str, *, date: Optional[str] = None, amount: Optional[float] = None
+    ) -> Json:
+        return self._client._get(
+            f"/currency/{_seg(base)}/{_seg(quote_currency)}", {"date": date, "amount": amount}
+        )
 
 
 class _HolidaySync:
@@ -301,6 +364,17 @@ class _EmojiSync:
         return self._client._get("/emoji", {"q": q, "limit": limit})
 
 
+class _TariffSync:
+    def __init__(self, client: ParseAPI):
+        self._client = client
+
+    def __call__(self, code: str, *, deep: bool = False, origin: Optional[str] = None) -> Json:
+        return self._client._get(f"/tariff/{_seg(code)}", {"deep": deep, "origin": origin})
+
+    def search(self, q: str) -> Json:
+        return self._client._get("/tariff", {"q": q})
+
+
 class AsyncParseAPI:
     """Async client. `parse = AsyncParseAPI()` reads PARSEAPI_KEY from the env."""
 
@@ -322,6 +396,7 @@ class AsyncParseAPI:
         )
         self.ip = _IpAsync(self)
         self.continent = _ContinentAsync(self)
+        self.bloc = _BlocAsync(self)
         self.country = _CountryAsync(self)
         self.state = _StateAsync(self)
         self.city = _CityAsync(self)
@@ -329,6 +404,7 @@ class AsyncParseAPI:
         self.currency = _CurrencyAsync(self)
         self.holiday = _HolidayAsync(self)
         self.emoji = _EmojiAsync(self)
+        self.tariff = _TariffAsync(self)
 
     async def close(self) -> None:
         await self._http.aclose()
@@ -362,15 +438,40 @@ class AsyncParseAPI:
                 continue
             raise _error_from(response)
 
-    async def district(self, code: str, *, country: Optional[str] = None) -> Json:
-        return await self._get(f"/district/{_seg(code)}", {"country": country})
+    async def district(self, code: str, *, country: Optional[str] = None, state: Optional[str] = None) -> Json:
+        return await self._get(f"/district/{_seg(code)}", {"country": country, "state": state})
 
     async def email(self, email: str, *, deep: bool = False) -> Json:
         return await self._get(f"/email/{_seg(email)}", {"deep": deep})
 
+    async def vat(
+        self,
+        number: str,
+        *,
+        country: Optional[str] = None,
+        deep: bool = False,
+        from_vat: Optional[str] = None,
+    ) -> Json:
+        return await self._get(f"/vat/{_seg(number)}", {"country": country, "deep": deep, "from": from_vat})
+
+    async def iban(self, iban: str, *, country: Optional[str] = None) -> Json:
+        return await self._get(f"/iban/{_seg(iban)}", {"country": country})
+
+    async def npi(self, npi: str, *, deep: bool = False) -> Json:
+        return await self._get(f"/npi/{_seg(npi)}", {"deep": deep})
+
     async def phone(self, number: str, *, country: Optional[str] = None, deep: bool = False) -> Json:
         return await self._get(f"/phone/{_seg(number)}", {"country": country, "deep": deep})
 
+    async def carrier(self, number: str, *, country: Optional[str] = None) -> Json:
+        return await self._get(f"/carrier/{_seg(number)}", {"country": country})
+
+    async def caller(self, number: str, *, country: Optional[str] = None) -> Json:
+        return await self._get(f"/caller/{_seg(number)}", {"country": country})
+
+    async def hlr(self, number: str, *, country: Optional[str] = None) -> Json:
+        return await self._get(f"/hlr/{_seg(number)}", {"country": country})
+
     async def domain(self, domain: str, *, deep: bool = False) -> Json:
         return await self._get(f"/domain/{_seg(domain)}", {"deep": deep})
 
@@ -380,12 +481,18 @@ class AsyncParseAPI:
     async def useragent(self, ua: str, *, deep: bool = False) -> Json:
         return await self._get("/useragent", {"deep": deep}, headers={"User-Agent": ua})
 
+    async def vin(self, vin: str, *, deep: bool = False) -> Json:
+        return await self._get(f"/vin/{_seg(vin)}", {"deep": deep})
+
     async def timezone(self, id: str, *, at: Optional[str] = None) -> Json:
         return await self._get(f"/timezone/{_seg(id)}", {"at": at})
 
     async def language(self, code: str) -> Json:
         return await self._get(f"/language/{_seg(code)}")
 
+    async def name(self, name: str) -> Json:
+        return await self._get(f"/name/{_seg(name)}")
+
     async def elevation(self, lat: float, lon: float) -> Json:
         return await self._get("/elevation", {"lat": lat, "lon": lon})
 
@@ -418,6 +525,17 @@ class _ContinentAsync:
         return await self._client._get(f"/continent/{_seg(code)}/countries")
 
 
+class _BlocAsync:
+    def __init__(self, client: AsyncParseAPI):
+        self._client = client
+
+    async def __call__(self, code: str) -> Json:
+        return await self._client._get(f"/bloc/{_seg(code)}")
+
+    async def countries(self, code: str) -> Json:
+        return await self._client._get(f"/bloc/{_seg(code)}/countries")
+
+
 class _CountryAsync:
     def __init__(self, client: AsyncParseAPI):
         self._client = client
@@ -433,10 +551,10 @@ class _StateAsync:
     def __init__(self, client: AsyncParseAPI):
         self._client = client
 
-    async def __call__(self, code: str, *, country: str) -> Json:
+    async def __call__(self, code: str, *, country: Optional[str] = None) -> Json:
         return await self._client._get(f"/state/{_seg(code)}", {"country": country})
 
-    async def districts(self, code: str, *, country: str) -> Json:
+    async def districts(self, code: str, *, country: Optional[str] = None) -> Json:
         return await self._client._get(f"/state/{_seg(code)}/districts", {"country": country})
 
 
@@ -463,19 +581,34 @@ class _CityAsync:
     async def nearest(self, lat: float, lon: float) -> Json:
         return await self._client._get("/city", {"lat": lat, "lon": lon})
 
+    async def nearby(
+        self,
+        name: str,
+        *,
+        radius: Optional[float] = None,
+        unit: Optional[str] = None,
+        country: Optional[str] = None,
+        state: Optional[str] = None,
+        limit: Optional[int] = None,
+    ) -> Json:
+        return await self._client._get(
+            f"/city/{_seg(name)}/nearby",
+            {"radius": radius, "unit": unit, "country": country, "state": state, "limit": limit},
+        )
+
 
 class _PostalAsync:
     def __init__(self, client: AsyncParseAPI):
         self._client = client
 
-    async def __call__(self, code: str, *, country: str) -> Json:
+    async def __call__(self, code: str, *, country: Optional[str] = None) -> Json:
         return await self._client._get(f"/postal/{_seg(code)}", {"country": country})
 
     async def nearby(
         self,
         code: str,
         *,
-        country: str,
+        country: Optional[str] = None,
         radius: Optional[float] = None,
         unit: Optional[str] = None,
     ) -> Json:
@@ -483,7 +616,7 @@ class _PostalAsync:
             f"/postal/{_seg(code)}/nearby", {"country": country, "radius": radius, "unit": unit}
         )
 
-    async def distance(self, from_postal: str, to_postal: str, *, country: str) -> Json:
+    async def distance(self, from_postal: str, to_postal: str, *, country: Optional[str] = None) -> Json:
         return await self._client._get(f"/postal/{_seg(from_postal)}/distance/{_seg(to_postal)}", {"country": country})
 
 
@@ -494,8 +627,12 @@ class _CurrencyAsync:
     async def __call__(self, code: str) -> Json:
         return await self._client._get(f"/currency/{_seg(code)}")
 
-    async def rate(self, base: str, quote_currency: str) -> Json:
-        return await self._client._get(f"/currency/{_seg(base)}/{_seg(quote_currency)}")
+    async def rate(
+        self, base: str, quote_currency: str, *, date: Optional[str] = None, amount: Optional[float] = None
+    ) -> Json:
+        return await self._client._get(
+            f"/currency/{_seg(base)}/{_seg(quote_currency)}", {"date": date, "amount": amount}
+        )
 
 
 class _HolidayAsync:
@@ -518,3 +655,14 @@ class _EmojiAsync:
 
     async def search(self, q: str, *, limit: Optional[int] = None) -> Json:
         return await self._client._get("/emoji", {"q": q, "limit": limit})
+
+
+class _TariffAsync:
+    def __init__(self, client: AsyncParseAPI):
+        self._client = client
+
+    async def __call__(self, code: str, *, deep: bool = False, origin: Optional[str] = None) -> Json:
+        return await self._client._get(f"/tariff/{_seg(code)}", {"deep": deep, "origin": origin})
+
+    async def search(self, q: str) -> Json:
+        return await self._client._get("/tariff", {"q": q})

{parseapi-0.1.0 → parseapi-0.2.1}/tests/test_client.py

@@ -28,16 +28,24 @@ URL_TABLE = [
     (lambda p: p.ip("8.8.8.8", deep=True), "https://api.parseapi.com/ip/8.8.8.8?deep=true"),
     (lambda p: p.continent("NA"), "https://api.parseapi.com/continent/NA"),
     (lambda p: p.continent.countries("NA"), "https://api.parseapi.com/continent/NA/countries"),
+    (lambda p: p.bloc("EU"), "https://api.parseapi.com/bloc/EU"),
+    (lambda p: p.bloc.countries("SCHENGEN"), "https://api.parseapi.com/bloc/SCHENGEN/countries"),
     (lambda p: p.country("US"), "https://api.parseapi.com/country/US"),
     (lambda p: p.country.states("US"), "https://api.parseapi.com/country/US/states"),
     (lambda p: p.state("NC", country="US"), "https://api.parseapi.com/state/NC?country=US"),
+    (lambda p: p.state("colorado"), "https://api.parseapi.com/state/colorado"),
     (lambda p: p.state.districts("NC", country="US"), "https://api.parseapi.com/state/NC/districts?country=US"),
     (lambda p: p.district("37081"), "https://api.parseapi.com/district/37081"),
     (lambda p: p.city("charlotte", state="NC"), "https://api.parseapi.com/city/charlotte?state=NC"),
     (lambda p: p.city.id("city_mb8mbqrkz8zb"), "https://api.parseapi.com/city/id/city_mb8mbqrkz8zb"),
     (lambda p: p.city.search("char", country="US", limit=10), "https://api.parseapi.com/city?q=char&country=US&limit=10"),
     (lambda p: p.city.nearest(35.2271, -80.8431), "https://api.parseapi.com/city?lat=35.2271&lon=-80.8431"),
+    (
+        lambda p: p.city.nearby("denver", radius=8, unit="mi", limit=3),
+        "https://api.parseapi.com/city/denver/nearby?radius=8&unit=mi&limit=3",
+    ),
     (lambda p: p.postal("28202", country="US"), "https://api.parseapi.com/postal/28202?country=US"),
+    (lambda p: p.postal("SW1A 1AA"), "https://api.parseapi.com/postal/SW1A%201AA"),
     (
         lambda p: p.postal.nearby("28202", country="US", radius=40, unit="km"),
         "https://api.parseapi.com/postal/28202/nearby?country=US&radius=40&unit=km",
@@ -47,13 +55,40 @@ URL_TABLE = [
         "https://api.parseapi.com/postal/28202/distance/10001?country=US",
     ),
     (lambda p: p.email("a@b.com"), "https://api.parseapi.com/email/a%40b.com"),
+    (
+        lambda p: p.vat("DE136695976", from_vat="IE6388047V", deep=True),
+        "https://api.parseapi.com/vat/DE136695976?deep=true&from=IE6388047V",
+    ),
+    (
+        lambda p: p.iban("DE89370400440532013000"),
+        "https://api.parseapi.com/iban/DE89370400440532013000",
+    ),
+    (
+        lambda p: p.iban("89370400440532013000", country="DE"),
+        "https://api.parseapi.com/iban/89370400440532013000?country=DE",
+    ),
+    (lambda p: p.npi("1881018208"), "https://api.parseapi.com/npi/1881018208"),
+    (lambda p: p.npi("1881018208", deep=True), "https://api.parseapi.com/npi/1881018208?deep=true"),
     (lambda p: p.phone("+14155552671", deep=True), "https://api.parseapi.com/phone/%2B14155552671?deep=true"),
+    (lambda p: p.carrier("+14155552671"), "https://api.parseapi.com/carrier/%2B14155552671"),
+    (lambda p: p.caller("4155552671", country="US"), "https://api.parseapi.com/caller/4155552671?country=US"),
+    (lambda p: p.hlr("+447712345678"), "https://api.parseapi.com/hlr/%2B447712345678"),
     (lambda p: p.domain("example.com"), "https://api.parseapi.com/domain/example.com"),
     (lambda p: p.mx("example.com"), "https://api.parseapi.com/mx/example.com"),
     (lambda p: p.useragent("TestUA/1.0"), "https://api.parseapi.com/useragent"),
+    (lambda p: p.vin("1HGCM82633A004352"), "https://api.parseapi.com/vin/1HGCM82633A004352"),
+    (
+        lambda p: p.vin("1HGCM82633A004352", deep=True),
+        "https://api.parseapi.com/vin/1HGCM82633A004352?deep=true",
+    ),
     (lambda p: p.currency("USD"), "https://api.parseapi.com/currency/USD"),
     (lambda p: p.currency.rate("USD", "EUR"), "https://api.parseapi.com/currency/USD/EUR"),
+    (
+        lambda p: p.currency.rate("USD", "JPY", date="2026-08-28", amount=100),
+        "https://api.parseapi.com/currency/USD/JPY?date=2026-08-28&amount=100",
+    ),
     (lambda p: p.language("en"), "https://api.parseapi.com/language/en"),
+    (lambda p: p.name("Smith, John"), "https://api.parseapi.com/name/Smith%2C%20John"),
     (lambda p: p.timezone("America/New_York"), "https://api.parseapi.com/timezone/America%2FNew_York"),
     (lambda p: p.holiday("US", year=1955), "https://api.parseapi.com/holiday/US?year=1955"),
     (lambda p: p.holiday.date("US", "2026-12-25"), "https://api.parseapi.com/holiday/US/2026-12-25"),