parseapi 1.9.1__tar.gz → 1.9.3__tar.gz

{parseapi-1.9.1 → parseapi-1.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: parseapi
-Version: 1.9.1
+Version: 1.9.3
 Summary: Official ParseAPI client for Python. One key, minimal JSON, fast.
 Project-URL: Homepage, https://parseapi.com
 Project-URL: Documentation, https://parseapi.com/docs
@@ -260,6 +260,8 @@ units = parse.measure.units(unit="m")
 
 `amount` is a decimal string, such as `"180.34"`. Without `to`, the API returns the canonical unit for the measurement type. Pass `locale` for number formatting and `system` (`us` or `imperial`) when a customary unit needs context. Ambiguous input returns `valid: false`, a `reason`, and available `choices`. Invalid or incompatible target units use the normal API error.
 
+Successful HTTP JSON contains `measure`, `valid`, `type`, `amount`, and `unit`. Invalid input adds `reason`. `choices` appears only when unit alternatives are available.
+
 Unit discovery accepts optional `query`, `type`, and `unit` filters. `unit` selects compatible targets. Omit the filters for the reviewed catalog. Both operations use pooled requests.
 
 ## Place statistics and optional detail
@@ -287,7 +289,7 @@ parse.weather(40.7128, -74.006, deep=True, date="2026-08-15")
 
 Tariff starts with the general schedule line. Paid deep adds units and the special and other schedule columns. An optional origin then resolves country-specific measures. The three calls below show those successive choices. Without origin, schedule detail is still returned and origin-dependent fields are null. A null effective rate is not a zero rate.
 
-Tariff lookup and search accept an optional `edition` fingerprint and `date` (`YYYY-MM-DD`). The edition pins exact immutable source bytes. A date is accepted only when verified source coverage exists. An edition without a date returns undated schedule context (`date: null`). Default requests use today. Paid detail exposes an open-string `reason` when `effective_rate` is null, including `incomplete_coverage`. A null rate never means zero. Explicit selections fail with `tariff_selection_mismatch` if an older server ignores the requested scope.
+Tariff lookup and search accept the `edition` ID returned by Tariff, such as `ted_3`, and an optional `date` (`YYYY-MM-DD`). The edition pins exact immutable source bytes. A date is accepted only when verified source coverage exists. An edition without a date returns undated schedule context (`date: null`). Default requests use today. Paid detail exposes an open-string `reason` when `effective_rate` is null, including `incomplete_coverage`. A null rate never means zero. Explicit selections fail with `tariff_selection_mismatch` if an older server ignores the requested scope.
 
 Origin means where the goods originate, not where they ship from. The effective rate covers matched stored schedule measures only. It is not complete duty or landed cost.
 

{parseapi-1.9.1 → parseapi-1.9.3}/README.md

@@ -241,6 +241,8 @@ units = parse.measure.units(unit="m")
 
 `amount` is a decimal string, such as `"180.34"`. Without `to`, the API returns the canonical unit for the measurement type. Pass `locale` for number formatting and `system` (`us` or `imperial`) when a customary unit needs context. Ambiguous input returns `valid: false`, a `reason`, and available `choices`. Invalid or incompatible target units use the normal API error.
 
+Successful HTTP JSON contains `measure`, `valid`, `type`, `amount`, and `unit`. Invalid input adds `reason`. `choices` appears only when unit alternatives are available.
+
 Unit discovery accepts optional `query`, `type`, and `unit` filters. `unit` selects compatible targets. Omit the filters for the reviewed catalog. Both operations use pooled requests.
 
 ## Place statistics and optional detail
@@ -268,7 +270,7 @@ parse.weather(40.7128, -74.006, deep=True, date="2026-08-15")
 
 Tariff starts with the general schedule line. Paid deep adds units and the special and other schedule columns. An optional origin then resolves country-specific measures. The three calls below show those successive choices. Without origin, schedule detail is still returned and origin-dependent fields are null. A null effective rate is not a zero rate.
 
-Tariff lookup and search accept an optional `edition` fingerprint and `date` (`YYYY-MM-DD`). The edition pins exact immutable source bytes. A date is accepted only when verified source coverage exists. An edition without a date returns undated schedule context (`date: null`). Default requests use today. Paid detail exposes an open-string `reason` when `effective_rate` is null, including `incomplete_coverage`. A null rate never means zero. Explicit selections fail with `tariff_selection_mismatch` if an older server ignores the requested scope.
+Tariff lookup and search accept the `edition` ID returned by Tariff, such as `ted_3`, and an optional `date` (`YYYY-MM-DD`). The edition pins exact immutable source bytes. A date is accepted only when verified source coverage exists. An edition without a date returns undated schedule context (`date: null`). Default requests use today. Paid detail exposes an open-string `reason` when `effective_rate` is null, including `incomplete_coverage`. A null rate never means zero. Explicit selections fail with `tariff_selection_mismatch` if an older server ignores the requested scope.
 
 Origin means where the goods originate, not where they ship from. The effective rate covers matched stored schedule measures only. It is not complete duty or landed cost.
 

{parseapi-1.9.1 → parseapi-1.9.3}/pyproject.toml

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

{parseapi-1.9.1 → parseapi-1.9.3}/src/parseapi/__init__.py

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

{parseapi-1.9.1 → parseapi-1.9.3}/src/parseapi/_client.py

@@ -12,7 +12,7 @@ from urllib.parse import quote
 
 import httpx
 
-VERSION = "1.9.0"
+VERSION = "1.9.3"
 _API_VERSION = "2.0.0"
 DEFAULT_BASE_URL = "https://api.parseapi.com"
 DEFAULT_TIMEOUT = 10.0
@@ -591,9 +591,13 @@ class _IndustrySync:
         return self._client._get("/industry", {"q": query, "limit": limit, "deep": deep})
 
 
+def _tariff_edition_id(value: Any) -> bool:
+    return isinstance(value, str) and (re.fullmatch(r"[a-f0-9]{64}", value) is not None or (re.fullmatch(r"ted_[1-9][0-9]{0,19}", value) is not None and (len(value) < 24 or value[4:] <= "18446744073709551615")))
+
+
 def _tariff_selection(result: Json, edition: Optional[str], date: Optional[str]) -> Json:
     if (edition is not None or date is not None) and (
-        not isinstance(result.get("edition"), str) or re.fullmatch(r"[a-f0-9]{64}", result["edition"]) is None
+        not _tariff_edition_id(result.get("edition"))
         or (edition is not None and result.get("edition") != edition)
         or (result.get("date") != date)
     ):
@@ -1176,6 +1180,7 @@ class _MeasureSync:
     def __call__(self, measure: str, *, to: Optional[str] = None, locale: Optional[str] = None, system: Optional[str] = None) -> Json:
         """Parse or convert a measurement. Amount is a decimal string. Without to, use the
         type's canonical unit. Locale and system (us or imperial) resolve explicit ambiguity.
+        Successful JSON omits reason and choices. Invalid input adds reason and alternatives add choices.
         Invalid measurements return valid=False and a reason. Invalid targets raise an API error.
         """
         return self._client._get(f"/measure/{_seg(measure)}", {"to": to, "locale": locale, "system": system})
@@ -1192,6 +1197,7 @@ class _MeasureAsync:
     async def __call__(self, measure: str, *, to: Optional[str] = None, locale: Optional[str] = None, system: Optional[str] = None) -> Json:
         """Parse or convert a measurement. Amount is a decimal string. Without to, use the
         type's canonical unit. Locale and system (us or imperial) resolve explicit ambiguity.
+        Successful JSON omits reason and choices. Invalid input adds reason and alternatives add choices.
         Invalid measurements return valid=False and a reason. Invalid targets raise an API error.
         """
         return await self._client._get(f"/measure/{_seg(measure)}", {"to": to, "locale": locale, "system": system})

parseapi-1.9.3/tests/fixtures/measure-response.json

@@ -0,0 +1,51 @@
+[
+  {
+    "measure": "0 m",
+    "valid": true,
+    "type": "length",
+    "amount": "0",
+    "unit": "m"
+  },
+  {
+    "measure": "1.00000000000000000001 m",
+    "valid": true,
+    "type": "length",
+    "amount": "1",
+    "unit": "m"
+  },
+  {
+    "measure": "180",
+    "valid": false,
+    "type": null,
+    "amount": null,
+    "unit": null,
+    "reason": "missing_unit"
+  },
+  {
+    "measure": "1 gallon",
+    "valid": false,
+    "type": null,
+    "amount": null,
+    "unit": null,
+    "reason": "ambiguous_unit",
+    "choices": [
+      {
+        "unit": "gal_us",
+        "name": "US gallon"
+      },
+      {
+        "unit": "gal_imp",
+        "name": "imperial gallon"
+      }
+    ]
+  },
+  {
+    "measure": "0 m",
+    "valid": true,
+    "type": "length",
+    "amount": "0",
+    "unit": "m",
+    "reason": null,
+    "choices": []
+  }
+]

parseapi-1.9.3/tests/test_measure_response.py

@@ -0,0 +1,18 @@
+import asyncio
+import json
+from pathlib import Path
+
+import httpx
+from parseapi import AsyncParseAPI, ParseAPI
+
+CASES = json.loads((Path(__file__).parent / 'fixtures/measure-response.json').read_text())
+
+def test_clean_and_legacy_measure_responses_sync_and_async():
+    for body in CASES:
+        transport = httpx.MockTransport(lambda request: httpx.Response(200, json=body))
+        with ParseAPI('fixture', transport=transport) as client:
+            assert client.measure(body['measure']) == body
+        async def check():
+            async with AsyncParseAPI('fixture', transport=transport) as client:
+                assert await client.measure(body['measure']) == body
+        asyncio.run(check())

parseapi-1.9.3/tests/test_tariff_short_id.py

@@ -0,0 +1,92 @@
+import asyncio
+
+import httpx
+import pytest
+
+from parseapi import AsyncParseAPI, ParseAPI, ParseAPIError
+
+
+@pytest.mark.parametrize("async_client", [False, True])
+@pytest.mark.parametrize("extra", [{}, {"lineage": None}, {"lineage": []}, {"lineage": ["Live horses", "Other horses"]}])
+def test_tariff_search_preserves_parent_context_and_older_results(async_client, extra):
+    body = {"q": "horses & ponies", "revision": "fixture", "lines": [{"hts": "0101.29.00.90", "description": "Other", "general": None, **extra, "future": True}]}
+
+    def respond(request):
+        assert request.url.path == "/tariff"
+        assert dict(request.url.params) == {"q": "horses & ponies"}
+        return httpx.Response(200, json=body)
+
+    transport = httpx.MockTransport(respond)
+    if async_client:
+        async def run():
+            async with AsyncParseAPI("test", transport=transport) as client:
+                assert await client.tariff.search("horses & ponies") == body
+        asyncio.run(run())
+    else:
+        with ParseAPI("test", transport=transport) as client:
+            assert client.tariff.search("horses & ponies") == body
+
+@pytest.mark.parametrize("async_client", [False, True])
+def test_tariff_edition_date_roundtrip(async_client):
+    edition = "ted_18446744073709551615"
+    body = {"hts": "0101", "revision": "fixture", "edition": edition, "date": "2026-09-15", "deep": {"effective_rate": None, "reason": "future_reason", "measures": []}}
+    seen = []
+
+    def respond(request):
+        seen.append(dict(request.url.params))
+        return httpx.Response(200, json={**body, "date": request.url.params.get("date")})
+
+    transport = httpx.MockTransport(respond)
+    if async_client:
+        async def run():
+            async with AsyncParseAPI("test", transport=transport) as client:
+                assert await client.tariff("0101", deep=True, origin="CA", edition=edition, date="2026-09-15") == body
+                assert await client.tariff.search("horses", edition=edition, date="2026-09-15") == body
+                await client.tariff("0101", edition=edition)
+        asyncio.run(run())
+    else:
+        with ParseAPI("test", transport=transport) as client:
+            assert client.tariff("0101", deep=True, origin="CA", edition=edition, date="2026-09-15") == body
+            assert client.tariff.search("horses", edition=edition, date="2026-09-15") == body
+            client.tariff("0101", edition=edition)
+    assert seen == [{"deep": "true", "origin": "CA", "edition": edition, "date": "2026-09-15"}, {"q": "horses", "edition": edition, "date": "2026-09-15"}, {"edition": edition}]
+
+@pytest.mark.parametrize("async_client", [False, True])
+def test_tariff_rejects_ignored_selection(async_client):
+    transport = httpx.MockTransport(lambda request: httpx.Response(200, json={"revision": "old"}))
+    if async_client:
+        async def run():
+            async with AsyncParseAPI("test", transport=transport) as client:
+                with pytest.raises(Exception, match="did not confirm"):
+                    await client.tariff("0101", edition="ted_1")
+                with pytest.raises(Exception, match="did not confirm"):
+                    await client.tariff.search("horses", date="2026-09-15")
+        asyncio.run(run())
+    else:
+        with ParseAPI("test", transport=transport) as client:
+            with pytest.raises(Exception, match="did not confirm"):
+                client.tariff("0101", edition="ted_1")
+            with pytest.raises(Exception, match="did not confirm"):
+                client.tariff.search("horses", date="2026-09-15")
+
+
+@pytest.mark.parametrize("async_client", [False, True])
+@pytest.mark.parametrize("edition", ["legacy", "", "A" * 64, "ted_1\n", "ted_1\r\n", "ted_1 ", "ted_0", "ted_01", "ted_+1", "TED_1", "ted_18446744073709551616"])
+def test_tariff_rejects_invalid_returned_edition(async_client, edition):
+    transport = httpx.MockTransport(lambda request: httpx.Response(200, json={"edition": edition, "date": "2026-09-15"}))
+    if async_client:
+        async def run():
+            async with AsyncParseAPI("test", transport=transport) as client:
+                for operation, value in [(client.tariff, "0101"), (client.tariff.search, "horses")]:
+                    with pytest.raises(ParseAPIError) as error:
+                        await operation(value, date="2026-09-15")
+                    assert error.value.code == "tariff_selection_mismatch"
+                    assert error.value.status == 0
+        asyncio.run(run())
+    else:
+        with ParseAPI("test", transport=transport) as client:
+            for operation, value in [(client.tariff, "0101"), (client.tariff.search, "horses")]:
+                with pytest.raises(ParseAPIError) as error:
+                    operation(value, date="2026-09-15")
+                assert error.value.code == "tariff_selection_mismatch"
+                assert error.value.status == 0