parseapi 1.11.1__tar.gz → 1.11.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. {parseapi-1.11.1 → parseapi-1.11.3}/CHANGELOG.md +10 -0
  2. {parseapi-1.11.1 → parseapi-1.11.3}/PKG-INFO +7 -4
  3. {parseapi-1.11.1 → parseapi-1.11.3}/README.md +6 -3
  4. {parseapi-1.11.1 → parseapi-1.11.3}/pyproject.toml +1 -1
  5. {parseapi-1.11.1 → parseapi-1.11.3}/src/parseapi/__init__.py +1 -1
  6. {parseapi-1.11.1 → parseapi-1.11.3}/src/parseapi/_client.py +1 -1
  7. parseapi-1.11.3/tests/fixtures/postal-weather.json +75 -0
  8. parseapi-1.11.3/tests/test_postal_weather.py +39 -0
  9. {parseapi-1.11.1 → parseapi-1.11.3}/.github/workflows/publish.yml +0 -0
  10. {parseapi-1.11.1 → parseapi-1.11.3}/.github/workflows/test.yml +0 -0
  11. {parseapi-1.11.1 → parseapi-1.11.3}/.gitignore +0 -0
  12. {parseapi-1.11.1 → parseapi-1.11.3}/LICENSE +0 -0
  13. {parseapi-1.11.1 → parseapi-1.11.3}/api/public.json +0 -0
  14. {parseapi-1.11.1 → parseapi-1.11.3}/scripts/public_api.py +0 -0
  15. {parseapi-1.11.1 → parseapi-1.11.3}/smoke/smoke.py +0 -0
  16. {parseapi-1.11.1 → parseapi-1.11.3}/src/parseapi/city.py +0 -0
  17. {parseapi-1.11.1 → parseapi-1.11.3}/src/parseapi/py.typed +0 -0
  18. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/country-aq.json +0 -0
  19. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/country-corrected.json +0 -0
  20. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/country-de.json +0 -0
  21. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/emoji-artwork.json +0 -0
  22. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/emoji-catalog.json +0 -0
  23. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/iso-contract.json +0 -0
  24. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/measure-response.json +0 -0
  25. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/clean-company-coverage.json +0 -0
  26. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/clean-company-profile.json +0 -0
  27. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/clean-emoji-catalog.json +0 -0
  28. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/clean-emoji-metadata.json +0 -0
  29. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/clean-provider.json +0 -0
  30. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/clean-tariff-search.json +0 -0
  31. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/clean-tariff.json +0 -0
  32. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/clean-time.json +0 -0
  33. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/clean-timezones.json +0 -0
  34. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/standard-company-coverage.json +0 -0
  35. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/standard-company-profile.json +0 -0
  36. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/standard-emoji-catalog.json +0 -0
  37. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/standard-emoji-metadata.json +0 -0
  38. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/standard-provider.json +0 -0
  39. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/standard-tariff-search.json +0 -0
  40. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/standard-tariff.json +0 -0
  41. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/standard-time.json +0 -0
  42. {parseapi-1.11.1 → parseapi-1.11.3}/tests/fixtures/response-fixtures/standard-timezones.json +0 -0
  43. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_card_dx.py +0 -0
  44. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_city_canonical.py +0 -0
  45. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_city_quality.py +0 -0
  46. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_city_query_parity.py +0 -0
  47. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_client.py +0 -0
  48. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_company_directory.py +0 -0
  49. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_country_corrected.py +0 -0
  50. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_email_enrichment.py +0 -0
  51. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_emoji.py +0 -0
  52. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_iso_contract.py +0 -0
  53. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_language.py +0 -0
  54. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_name_formatting.py +0 -0
  55. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_postal_localities.py +0 -0
  56. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_public_api.py +0 -0
  57. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_response_decoding.py +0 -0
  58. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_stack.py +0 -0
  59. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_time_complete.py +0 -0
  60. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_time_gaps.py +0 -0
  61. {parseapi-1.11.1 → parseapi-1.11.3}/tests/test_version.py +0 -0
  62. {parseapi-1.11.1 → parseapi-1.11.3}/tests/typing_company_directory.py +0 -0
@@ -1,5 +1,15 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.11.3 — 2026-11-01
4
+
5
+ - Correct Point and optional Deep documentation to describe existing access. Language facts remain in Core; request behavior and response JSON are unchanged.
6
+
7
+ ## 1.11.2 — 2026-10-31
8
+
9
+ - Correct Postal compact property-tax and Weather minute-rate migration guidance.
10
+ - Verify raw JSON preserves compact records, canonical and earlier minute keys, accumulated History precipitation, zero/null values and collection availability.
11
+ - Keep the Python transport version header consistent with the published package version.
12
+
3
13
  ## 1.10.0 — 2026-10-15
4
14
 
5
15
  - Add compatible City resource/list, spelling-search, geographic-filter, pagination, hierarchy, relationship and distance support.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: parseapi
3
- Version: 1.11.1
3
+ Version: 1.11.3
4
4
  Summary: Official ParseAPI client for Python. One key, minimal JSON, fast.
5
5
  Project-URL: Homepage, https://parseapi.com
6
6
  Project-URL: Documentation, https://parseapi.com/docs
@@ -257,7 +257,9 @@ Country Core contains the everyday reference: `name`, `name_full`, `name_local`,
257
257
 
258
258
  Australian postal lookups include core `localities` with suburb choices (`city`, `state`, `state_name`) on every plan. Null or an omitted field means unknown, while `[]` means the reviewed reference has no eligible choices. `city` stays null when the source is ambiguous, even if there is only one eligible choice. Let the user select their suburb and keep manual entry available. These are geographic choices, not mailing-address verification. [G-NAF source, adaptations and licence](https://parseapi.com/legal/attribution#postal-au).
259
259
 
260
- Postal and District paid profiles include `deep.property_tax` where supported. It contains `annual_median`, `currency` and `period`: median annual property tax payable on owner-occupied homes in the statistical area. The amount is adjusted to the final year of the reporting period (`YYYY-YYYY`). This is an area statistic, not a rate or an individual property bill. Unsupported, missing and censored estimates are null.
260
+ Postal paid profiles include compact `deep.property_tax: { annual_median }` where supported; `deep.currency` supplies the currency. District keeps the richer property-tax record with `annual_median`, `currency` and `period` (`YYYY-YYYY`). Both are area estimates of annual tax payable on owner-occupied homes, not a rate or an individual property bill. Unsupported, missing and censored estimates are null. Earlier nested currency and period values remain available when returned.
261
+
262
+ Weather minute forecasts use `precipitation_rate` (mm/hour) and `precipitation_rate_in` (inches/hour); update earlier minute field reads to those names. History `precipitation` and `precipitation_in` remain accumulated amounts. These clients return the server JSON directly, preserving null collections, known empty arrays and earlier payload keys without translating them.
261
263
 
262
264
  ```python
263
265
  place = parse.postal("28202", country="US", deep=True)
@@ -268,7 +270,7 @@ Read `population` as the source’s count for that place boundary. Keep missing
268
270
 
269
271
  Country deep includes `land_area` and `water_area` in km2, `coastline` in km, and `elevation_average` in meters. `lowest_point` and `highest_point` contain a nullable `name` and an `elevation` in metres. Values below sea level are negative. Missing or null values stay unknown, and zero stays zero.
270
272
 
271
- Point returns the timezone ID with the core location. Its optional deep detail adds terrain and compact nearest-city context on every plan. A nearest city is null when none is within 200 km.
273
+ Point returns the timezone ID with the core location. Its optional Deep adds terrain, compact nearest-city context and supported electoral detail on paid plans. Existing accounts retain their current Deep access. A nearest city is null when none is within 200 km.
272
274
 
273
275
  Weather returns current conditions by default. Paid deep adds specialist current measurements, forecasts and related detail. A past `date` is a UTC day and requires deep: it adds `deep.history` alongside current conditions. Date alone does not request history.
274
276
 
@@ -293,7 +295,8 @@ Choose enrichment for the question you need answered.
293
295
  | IP | Richer IP fields included with a paid plan. No separate check meter. |
294
296
  | Domain | Registration dates, registrar, status and DNSSEC, included with a paid plan. Use `dns` for DNS records and `mx` for mail routing. |
295
297
  | Email | A metered mailbox check with deliverability, catch-all, status, reason and address hints, using included email checks or enabled on-demand usage. |
296
- | Phone, Time, Date, Language, Emoji, Point | Optional detail in the same pooled request on every plan. |
298
+ | Phone, Time, Date, Emoji, Point | Optional detail on paid plans in the same pooled request. Existing accounts retain their current Deep access. |
299
+ | Language | All language facts are in Core; requested Deep is empty. |
297
300
  | Currency | Currency metadata on paid plans; lookup and exchange-rate conversion use pooled requests. |
298
301
  | Country, State, District, City, Postal | The place profile on paid plans, including demographic and tax facts where held. |
299
302
  | Name, Industry | Name evidence or the industry definition profile on paid plans. |
@@ -238,7 +238,9 @@ Country Core contains the everyday reference: `name`, `name_full`, `name_local`,
238
238
 
239
239
  Australian postal lookups include core `localities` with suburb choices (`city`, `state`, `state_name`) on every plan. Null or an omitted field means unknown, while `[]` means the reviewed reference has no eligible choices. `city` stays null when the source is ambiguous, even if there is only one eligible choice. Let the user select their suburb and keep manual entry available. These are geographic choices, not mailing-address verification. [G-NAF source, adaptations and licence](https://parseapi.com/legal/attribution#postal-au).
240
240
 
241
- Postal and District paid profiles include `deep.property_tax` where supported. It contains `annual_median`, `currency` and `period`: median annual property tax payable on owner-occupied homes in the statistical area. The amount is adjusted to the final year of the reporting period (`YYYY-YYYY`). This is an area statistic, not a rate or an individual property bill. Unsupported, missing and censored estimates are null.
241
+ Postal paid profiles include compact `deep.property_tax: { annual_median }` where supported; `deep.currency` supplies the currency. District keeps the richer property-tax record with `annual_median`, `currency` and `period` (`YYYY-YYYY`). Both are area estimates of annual tax payable on owner-occupied homes, not a rate or an individual property bill. Unsupported, missing and censored estimates are null. Earlier nested currency and period values remain available when returned.
242
+
243
+ Weather minute forecasts use `precipitation_rate` (mm/hour) and `precipitation_rate_in` (inches/hour); update earlier minute field reads to those names. History `precipitation` and `precipitation_in` remain accumulated amounts. These clients return the server JSON directly, preserving null collections, known empty arrays and earlier payload keys without translating them.
242
244
 
243
245
  ```python
244
246
  place = parse.postal("28202", country="US", deep=True)
@@ -249,7 +251,7 @@ Read `population` as the source’s count for that place boundary. Keep missing
249
251
 
250
252
  Country deep includes `land_area` and `water_area` in km2, `coastline` in km, and `elevation_average` in meters. `lowest_point` and `highest_point` contain a nullable `name` and an `elevation` in metres. Values below sea level are negative. Missing or null values stay unknown, and zero stays zero.
251
253
 
252
- Point returns the timezone ID with the core location. Its optional deep detail adds terrain and compact nearest-city context on every plan. A nearest city is null when none is within 200 km.
254
+ Point returns the timezone ID with the core location. Its optional Deep adds terrain, compact nearest-city context and supported electoral detail on paid plans. Existing accounts retain their current Deep access. A nearest city is null when none is within 200 km.
253
255
 
254
256
  Weather returns current conditions by default. Paid deep adds specialist current measurements, forecasts and related detail. A past `date` is a UTC day and requires deep: it adds `deep.history` alongside current conditions. Date alone does not request history.
255
257
 
@@ -274,7 +276,8 @@ Choose enrichment for the question you need answered.
274
276
  | IP | Richer IP fields included with a paid plan. No separate check meter. |
275
277
  | Domain | Registration dates, registrar, status and DNSSEC, included with a paid plan. Use `dns` for DNS records and `mx` for mail routing. |
276
278
  | Email | A metered mailbox check with deliverability, catch-all, status, reason and address hints, using included email checks or enabled on-demand usage. |
277
- | Phone, Time, Date, Language, Emoji, Point | Optional detail in the same pooled request on every plan. |
279
+ | Phone, Time, Date, Emoji, Point | Optional detail on paid plans in the same pooled request. Existing accounts retain their current Deep access. |
280
+ | Language | All language facts are in Core; requested Deep is empty. |
278
281
  | Currency | Currency metadata on paid plans; lookup and exchange-rate conversion use pooled requests. |
279
282
  | Country, State, District, City, Postal | The place profile on paid plans, including demographic and tax facts where held. |
280
283
  | Name, Industry | Name evidence or the industry definition profile on paid plans. |
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "parseapi"
7
- version = "1.11.1"
7
+ version = "1.11.3"
8
8
  description = "Official ParseAPI client for Python. One key, minimal JSON, fast."
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -3,5 +3,5 @@
3
3
  from .city import CityAmbiguityCandidate
4
4
  from ._client import AsyncParseAPI, ParseAPI, ParseAPIError
5
5
 
6
- __version__ = "1.11.1"
6
+ __version__ = "1.11.3"
7
7
  __all__ = ["CityAmbiguityCandidate", "ParseAPI", "AsyncParseAPI", "ParseAPIError", "__version__"]
@@ -13,7 +13,7 @@ from urllib.parse import quote
13
13
  import httpx
14
14
  from .city import CityAmbiguityCandidate, city_error_candidates
15
15
 
16
- VERSION = "1.10.6"
16
+ VERSION = "1.11.3"
17
17
  _API_VERSION = "2.0.0"
18
18
  DEFAULT_BASE_URL = "https://api.parseapi.com"
19
19
  DEFAULT_TIMEOUT = 10.0
@@ -0,0 +1,75 @@
1
+ {
2
+ "postal_core": {
3
+ "postal": "10001",
4
+ "country": "US"
5
+ },
6
+ "postal_locked": {
7
+ "postal": "10001",
8
+ "country": "US",
9
+ "deep": {}
10
+ },
11
+ "postal_unknown": {
12
+ "postal": "10001",
13
+ "country": "US",
14
+ "deep": {
15
+ "property_tax": null
16
+ }
17
+ },
18
+ "postal_compact": {
19
+ "postal": "10001",
20
+ "country": "US",
21
+ "deep": {
22
+ "currency": "USD",
23
+ "property_tax": {
24
+ "annual_median": 0
25
+ }
26
+ }
27
+ },
28
+ "weather_current": {
29
+ "latitude": 0,
30
+ "longitude": 0,
31
+ "current": {},
32
+ "deep": {
33
+ "forecast": null,
34
+ "alerts": [],
35
+ "hours": null,
36
+ "days": [],
37
+ "minutes": [
38
+ {
39
+ "at": "2026-10-31T12:00:00Z",
40
+ "precipitation_rate": 1.8,
41
+ "precipitation_rate_in": 0.071,
42
+ "type": "rain"
43
+ },
44
+ {
45
+ "at": "2026-10-31T12:01:00Z",
46
+ "precipitation_rate": 0,
47
+ "precipitation_rate_in": 0,
48
+ "type": null
49
+ },
50
+ {
51
+ "at": "2026-10-31T12:02:00Z",
52
+ "precipitation_rate": null,
53
+ "precipitation_rate_in": null,
54
+ "type": null
55
+ }
56
+ ],
57
+ "history": {
58
+ "precipitation": 12.3,
59
+ "precipitation_in": 0.484
60
+ }
61
+ }
62
+ },
63
+ "weather_earlier": {
64
+ "deep": {
65
+ "minutes": [
66
+ {
67
+ "at": "2026-10-31T12:00:00Z",
68
+ "precipitation": 1.8,
69
+ "precipitation_in": 0.071,
70
+ "type": "rain"
71
+ }
72
+ ]
73
+ }
74
+ }
75
+ }
@@ -0,0 +1,39 @@
1
+ import asyncio
2
+ import json
3
+ from pathlib import Path
4
+
5
+ import httpx
6
+ import pytest
7
+
8
+ from parseapi import AsyncParseAPI, ParseAPI, __version__
9
+
10
+
11
+ @pytest.mark.parametrize("async_mode", [False, True])
12
+ def test_postal_weather_json_and_package_version_header(async_mode):
13
+ fixtures = json.loads((Path(__file__).parent / "fixtures/postal-weather.json").read_text())
14
+ entries = list(fixtures.items())
15
+ calls = []
16
+
17
+ def transport(request):
18
+ calls.append(request)
19
+ return httpx.Response(200, json=entries[len(calls) - 1][1])
20
+
21
+ async def run_async():
22
+ async with AsyncParseAPI("fixture", transport=httpx.MockTransport(transport)) as client:
23
+ for name, expected in entries:
24
+ actual = await client.weather(0, 0, deep=True) if name.startswith("weather") else await client.postal("10001", country="US", deep=True)
25
+ assert actual == expected
26
+
27
+ if async_mode:
28
+ asyncio.run(run_async())
29
+ else:
30
+ with ParseAPI("fixture", transport=httpx.MockTransport(transport)) as client:
31
+ for name, expected in entries:
32
+ actual = client.weather(0, 0, deep=True) if name.startswith("weather") else client.postal("10001", country="US", deep=True)
33
+ assert actual == expected
34
+
35
+ assert len(calls) == len(entries)
36
+ assert all(request.headers["User-Agent"] == f"parseapi-python/{__version__}" for request in calls)
37
+ assert fixtures["postal_compact"]["deep"]["property_tax"] == {"annual_median": 0}
38
+ assert fixtures["weather_current"]["deep"]["forecast"] is None
39
+ assert fixtures["weather_current"]["deep"]["alerts"] == []
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes