parseapi 0.2.0__tar.gz → 0.3.0__tar.gz

{parseapi-0.2.0 → parseapi-0.3.0}/.github/workflows/publish.yml

@@ -18,6 +18,7 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
-      - run: pip install build
+      - run: pip install -e . pytest build
+      - run: python -m pytest -q
       - run: python -m build
       - uses: pypa/gh-action-pypi-publish@release/v1

parseapi-0.3.0/.github/workflows/test.yml

@@ -0,0 +1,21 @@
+name: SDK checks
+on: [push, pull_request]
+permissions:
+  contents: read
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ['3.9', '3.13']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install -e . pytest build
+      - run: python -m pytest -q
+      - run: python scripts/public_api.py
+      - run: python -m build
+      - name: Verify wheel typing marker
+        run: python -c "import glob,zipfile; z=zipfile.ZipFile(glob.glob('dist/*.whl')[0]); assert 'parseapi/py.typed' in z.namelist()"

{parseapi-0.2.0 → parseapi-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: parseapi
-Version: 0.2.0
+Version: 0.3.0
 Summary: Official parseAPI client for Python. One key, minimal JSON, fast.
 Project-URL: Homepage, https://parseapi.com
 Project-URL: Documentation, https://parseapi.com/docs
@@ -53,6 +53,9 @@ parse.postal("SW1A 1AA")
 parse.postal("28202", country="US")
 parse.postal.nearby("28202", country="US", radius=40)
 parse.postal.distance("28202", "10001", country="US")
+parse.address("1600 Pennsylvania Ave NW, Washington DC", country="US")
+parse.address.search("1600 Pennsylvania", country="US", postal="20500")
+parse.company("51 824 753 556", country="AU")
 parse.city("charlotte", country="US")
 parse.city.id("city_mb8mbqrkz8zb")
 parse.city.search("char", country="US", limit=10)
@@ -66,35 +69,45 @@ parse.state.districts("NC", country="US")
 parse.district("37081")
 parse.continent("NA")
 parse.continent.countries("NA")
+parse.bloc("EU")
+parse.bloc.countries("EU")
 parse.currency("USD")
 parse.currency.rate("USD", "EUR")
 parse.language("en")
 parse.name("BILLY OSHALL")
 parse.timezone("America/New_York")
+parse.timezone("America/New_York", at="2026-09-05T15:00:00", to="Europe/London")
+parse.timezone.at(39.77, -104.9)
+parse.date("03/04/2026", format="mdy")
+parse.date.today()
 parse.holiday("US", year=2026)
 parse.holiday.date("US", "2026-12-25")
 parse.elevation(35.2271, -80.8431)
 parse.point(36.0726, -79.792)
 parse.weather(40.7128, -74.006)
 parse.domain("example.com")
+parse.asn("AS13335")
+parse.mac("00:1B:63:84:45:E6")
 parse.mx("example.com")
 parse.useragent(ua_string)
 parse.vin("1HGCM82633A004352")
+parse.tariff("8471.30.01.00")
+parse.tariff.search("sunglasses")
 parse.emoji("rocket")
 parse.emoji.search("fire")
 ```
 
-Responses are plain dicts, exactly the JSON the API returns.
+Responses are plain dicts, exactly the JSON the API returns. `country.states("US")` requests states directly; it does not fetch a country first. Required inputs are positional and optional behavior uses keyword arguments, leaving room for new options without changing existing calls. Reuse a client across calls. Use `with ParseAPI(...) as parse:` or call `parse.close()` when finished.
 
 ## Async
 
-Same surface, `await` everything.
+Same lookup methods and keyword arguments, with `await`. Use a context manager to close the client when the work is done.
 
 ```python
 from parseapi import AsyncParseAPI
 
-parse = AsyncParseAPI("your-api-key")
-country = await parse.country("US")
+async with AsyncParseAPI("your-api-key") as parse:
+    country = await parse.country("US")
 ```
 
 ## Deep
@@ -120,18 +133,23 @@ except ParseAPIError as err:
         ...  # no such city
 ```
 
+Network and decoding failures keep their native error types. Responses such as `valid: false` are successful API answers, not exceptions.
+
 ## Options
 
 ```python
 parse = ParseAPI(
     "your-api-key",
-    timeout=10.0,  # per-attempt timeout in seconds
-    retries=2,     # automatic retries on network errors, 429, and 5xx
+    timeout=10.0,  # timeout for each connect, read, write, or pool phase
 )
 ```
 
 Requires Python 3.9 or later. One dependency (httpx).
 
+Ordinary lookups retry network failures, 429, and 500/502/503/504 responses twice by default. Carrier, caller, HLR, and email or VAT with `deep=True` make one attempt by default. Address with `deep=True` also uses one attempt, reserving the same behavior for future verification.
+
+An explicit client `retries` setting overrides those defaults; `retries=0` always makes one attempt. Another attempt can consume additional usage if the earlier response was lost. Cancelling an async task stops the call and any retry wait. Automatic redirects are disabled.
+
 ## Docs
 
 Full field reference for every endpoint: [parseapi.com/docs](https://parseapi.com/docs)

{parseapi-0.2.0 → parseapi-0.3.0}/README.md

@@ -34,6 +34,9 @@ parse.postal("SW1A 1AA")
 parse.postal("28202", country="US")
 parse.postal.nearby("28202", country="US", radius=40)
 parse.postal.distance("28202", "10001", country="US")
+parse.address("1600 Pennsylvania Ave NW, Washington DC", country="US")
+parse.address.search("1600 Pennsylvania", country="US", postal="20500")
+parse.company("51 824 753 556", country="AU")
 parse.city("charlotte", country="US")
 parse.city.id("city_mb8mbqrkz8zb")
 parse.city.search("char", country="US", limit=10)
@@ -47,35 +50,45 @@ parse.state.districts("NC", country="US")
 parse.district("37081")
 parse.continent("NA")
 parse.continent.countries("NA")
+parse.bloc("EU")
+parse.bloc.countries("EU")
 parse.currency("USD")
 parse.currency.rate("USD", "EUR")
 parse.language("en")
 parse.name("BILLY OSHALL")
 parse.timezone("America/New_York")
+parse.timezone("America/New_York", at="2026-09-05T15:00:00", to="Europe/London")
+parse.timezone.at(39.77, -104.9)
+parse.date("03/04/2026", format="mdy")
+parse.date.today()
 parse.holiday("US", year=2026)
 parse.holiday.date("US", "2026-12-25")
 parse.elevation(35.2271, -80.8431)
 parse.point(36.0726, -79.792)
 parse.weather(40.7128, -74.006)
 parse.domain("example.com")
+parse.asn("AS13335")
+parse.mac("00:1B:63:84:45:E6")
 parse.mx("example.com")
 parse.useragent(ua_string)
 parse.vin("1HGCM82633A004352")
+parse.tariff("8471.30.01.00")
+parse.tariff.search("sunglasses")
 parse.emoji("rocket")
 parse.emoji.search("fire")
 ```
 
-Responses are plain dicts, exactly the JSON the API returns.
+Responses are plain dicts, exactly the JSON the API returns. `country.states("US")` requests states directly; it does not fetch a country first. Required inputs are positional and optional behavior uses keyword arguments, leaving room for new options without changing existing calls. Reuse a client across calls. Use `with ParseAPI(...) as parse:` or call `parse.close()` when finished.
 
 ## Async
 
-Same surface, `await` everything.
+Same lookup methods and keyword arguments, with `await`. Use a context manager to close the client when the work is done.
 
 ```python
 from parseapi import AsyncParseAPI
 
-parse = AsyncParseAPI("your-api-key")
-country = await parse.country("US")
+async with AsyncParseAPI("your-api-key") as parse:
+    country = await parse.country("US")
 ```
 
 ## Deep
@@ -101,18 +114,23 @@ except ParseAPIError as err:
         ...  # no such city
 ```
 
+Network and decoding failures keep their native error types. Responses such as `valid: false` are successful API answers, not exceptions.
+
 ## Options
 
 ```python
 parse = ParseAPI(
     "your-api-key",
-    timeout=10.0,  # per-attempt timeout in seconds
-    retries=2,     # automatic retries on network errors, 429, and 5xx
+    timeout=10.0,  # timeout for each connect, read, write, or pool phase
 )
 ```
 
 Requires Python 3.9 or later. One dependency (httpx).
 
+Ordinary lookups retry network failures, 429, and 500/502/503/504 responses twice by default. Carrier, caller, HLR, and email or VAT with `deep=True` make one attempt by default. Address with `deep=True` also uses one attempt, reserving the same behavior for future verification.
+
+An explicit client `retries` setting overrides those defaults; `retries=0` always makes one attempt. Another attempt can consume additional usage if the earlier response was lost. Cancelling an async task stops the call and any retry wait. Automatic redirects are disabled.
+
 ## Docs
 
 Full field reference for every endpoint: [parseapi.com/docs](https://parseapi.com/docs)