parseapi 1.9.2__tar.gz → 1.9.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: parseapi
-Version: 1.9.2
+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
@@ -289,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.2 → parseapi-1.9.3}/README.md

@@ -270,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.2 → parseapi-1.9.3}/pyproject.toml

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

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

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

{parseapi-1.9.2 → 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)
     ):

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