parseapi 1.11.0__tar.gz → 1.11.2__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.0 → parseapi-1.11.2}/CHANGELOG.md +6 -0
  2. {parseapi-1.11.0 → parseapi-1.11.2}/PKG-INFO +11 -3
  3. {parseapi-1.11.0 → parseapi-1.11.2}/README.md +10 -2
  4. {parseapi-1.11.0 → parseapi-1.11.2}/pyproject.toml +1 -1
  5. {parseapi-1.11.0 → parseapi-1.11.2}/src/parseapi/__init__.py +1 -1
  6. {parseapi-1.11.0 → parseapi-1.11.2}/src/parseapi/_client.py +1 -1
  7. parseapi-1.11.2/tests/fixtures/postal-weather.json +75 -0
  8. parseapi-1.11.2/tests/test_postal_weather.py +39 -0
  9. {parseapi-1.11.0 → parseapi-1.11.2}/.github/workflows/publish.yml +0 -0
  10. {parseapi-1.11.0 → parseapi-1.11.2}/.github/workflows/test.yml +0 -0
  11. {parseapi-1.11.0 → parseapi-1.11.2}/.gitignore +0 -0
  12. {parseapi-1.11.0 → parseapi-1.11.2}/LICENSE +0 -0
  13. {parseapi-1.11.0 → parseapi-1.11.2}/api/public.json +0 -0
  14. {parseapi-1.11.0 → parseapi-1.11.2}/scripts/public_api.py +0 -0
  15. {parseapi-1.11.0 → parseapi-1.11.2}/smoke/smoke.py +0 -0
  16. {parseapi-1.11.0 → parseapi-1.11.2}/src/parseapi/city.py +0 -0
  17. {parseapi-1.11.0 → parseapi-1.11.2}/src/parseapi/py.typed +0 -0
  18. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/country-aq.json +0 -0
  19. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/country-corrected.json +0 -0
  20. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/country-de.json +0 -0
  21. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/emoji-artwork.json +0 -0
  22. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/emoji-catalog.json +0 -0
  23. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/iso-contract.json +0 -0
  24. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/measure-response.json +0 -0
  25. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-company-coverage.json +0 -0
  26. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-company-profile.json +0 -0
  27. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-emoji-catalog.json +0 -0
  28. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-emoji-metadata.json +0 -0
  29. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-provider.json +0 -0
  30. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-tariff-search.json +0 -0
  31. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-tariff.json +0 -0
  32. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-time.json +0 -0
  33. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-timezones.json +0 -0
  34. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-company-coverage.json +0 -0
  35. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-company-profile.json +0 -0
  36. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-emoji-catalog.json +0 -0
  37. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-emoji-metadata.json +0 -0
  38. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-provider.json +0 -0
  39. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-tariff-search.json +0 -0
  40. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-tariff.json +0 -0
  41. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-time.json +0 -0
  42. {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-timezones.json +0 -0
  43. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_card_dx.py +0 -0
  44. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_city_canonical.py +0 -0
  45. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_city_quality.py +0 -0
  46. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_city_query_parity.py +0 -0
  47. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_client.py +0 -0
  48. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_company_directory.py +0 -0
  49. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_country_corrected.py +0 -0
  50. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_email_enrichment.py +0 -0
  51. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_emoji.py +0 -0
  52. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_iso_contract.py +0 -0
  53. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_language.py +0 -0
  54. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_name_formatting.py +0 -0
  55. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_postal_localities.py +0 -0
  56. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_public_api.py +0 -0
  57. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_response_decoding.py +0 -0
  58. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_stack.py +0 -0
  59. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_time_complete.py +0 -0
  60. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_time_gaps.py +0 -0
  61. {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_version.py +0 -0
  62. {parseapi-1.11.0 → parseapi-1.11.2}/tests/typing_company_directory.py +0 -0
@@ -1,5 +1,11 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.11.2 — 2026-10-31
4
+
5
+ - Correct Postal compact property-tax and Weather minute-rate migration guidance.
6
+ - Verify raw JSON preserves compact records, canonical and earlier minute keys, accumulated History precipitation, zero/null values and collection availability.
7
+ - Keep the Python transport version header consistent with the published package version.
8
+
3
9
  ## 1.10.0 — 2026-10-15
4
10
 
5
11
  - 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.0
3
+ Version: 1.11.2
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
@@ -253,11 +253,13 @@ Source deep adds `standard_offset`, `standard_offset_seconds`, signed `dst_offse
253
253
 
254
254
  ## Place statistics and optional detail
255
255
 
256
- Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym, `iso_alpha3` and `iso_numeric` country identifiers, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, lat, lon }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
256
+ Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym, `iso_alpha3` and `iso_numeric` country identifiers, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, latitude, longitude }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
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)
@@ -499,3 +501,9 @@ Coverage by country and available fields is described at https://parseapi.com/ci
499
501
 
500
502
 
501
503
  Conditional `If-None-Match` reads and GeoJSON currently use HTTP directly. A matching City ETag returns 304 without a body; ordinary billing and rate limits apply. These JSON client methods do not supply conditional-cache handling.
504
+
505
+ ## Capital coordinate migration
506
+
507
+ Country and State capital coordinates use `latitude` and `longitude`. Update
508
+ `capital.lat` and `capital.lon` reads to `capital.latitude` and
509
+ `capital.longitude` when adopting this release.
@@ -234,11 +234,13 @@ Source deep adds `standard_offset`, `standard_offset_seconds`, signed `dst_offse
234
234
 
235
235
  ## Place statistics and optional detail
236
236
 
237
- Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym, `iso_alpha3` and `iso_numeric` country identifiers, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, lat, lon }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
237
+ Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym, `iso_alpha3` and `iso_numeric` country identifiers, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, latitude, longitude }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
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)
@@ -480,3 +482,9 @@ Coverage by country and available fields is described at https://parseapi.com/ci
480
482
 
481
483
 
482
484
  Conditional `If-None-Match` reads and GeoJSON currently use HTTP directly. A matching City ETag returns 304 without a body; ordinary billing and rate limits apply. These JSON client methods do not supply conditional-cache handling.
485
+
486
+ ## Capital coordinate migration
487
+
488
+ Country and State capital coordinates use `latitude` and `longitude`. Update
489
+ `capital.lat` and `capital.lon` reads to `capital.latitude` and
490
+ `capital.longitude` when adopting this release.
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "parseapi"
7
- version = "1.11.0"
7
+ version = "1.11.2"
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.0"
6
+ __version__ = "1.11.2"
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.2"
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