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.
- {parseapi-1.11.0 → parseapi-1.11.2}/CHANGELOG.md +6 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/PKG-INFO +11 -3
- {parseapi-1.11.0 → parseapi-1.11.2}/README.md +10 -2
- {parseapi-1.11.0 → parseapi-1.11.2}/pyproject.toml +1 -1
- {parseapi-1.11.0 → parseapi-1.11.2}/src/parseapi/__init__.py +1 -1
- {parseapi-1.11.0 → parseapi-1.11.2}/src/parseapi/_client.py +1 -1
- parseapi-1.11.2/tests/fixtures/postal-weather.json +75 -0
- parseapi-1.11.2/tests/test_postal_weather.py +39 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/.github/workflows/publish.yml +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/.github/workflows/test.yml +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/.gitignore +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/LICENSE +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/api/public.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/scripts/public_api.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/smoke/smoke.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/src/parseapi/city.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/src/parseapi/py.typed +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/country-aq.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/country-corrected.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/country-de.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/emoji-artwork.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/emoji-catalog.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/iso-contract.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/measure-response.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-company-coverage.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-company-profile.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-emoji-catalog.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-emoji-metadata.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-provider.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-tariff-search.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-tariff.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-time.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-timezones.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-company-coverage.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-company-profile.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-emoji-catalog.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-emoji-metadata.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-provider.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-tariff-search.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-tariff.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-time.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-timezones.json +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_card_dx.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_city_canonical.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_city_quality.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_city_query_parity.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_client.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_company_directory.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_country_corrected.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_email_enrichment.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_emoji.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_iso_contract.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_language.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_name_formatting.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_postal_localities.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_public_api.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_response_decoding.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_stack.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_time_complete.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_time_gaps.py +0 -0
- {parseapi-1.11.0 → parseapi-1.11.2}/tests/test_version.py +0 -0
- {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.
|
|
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,
|
|
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
|
|
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,
|
|
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
|
|
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.
|
|
@@ -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.
|
|
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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-company-coverage.json
RENAMED
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-company-profile.json
RENAMED
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-emoji-catalog.json
RENAMED
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-emoji-metadata.json
RENAMED
|
File without changes
|
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/clean-tariff-search.json
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-company-coverage.json
RENAMED
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-company-profile.json
RENAMED
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-emoji-catalog.json
RENAMED
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-emoji-metadata.json
RENAMED
|
File without changes
|
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-tariff-search.json
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
{parseapi-1.11.0 → parseapi-1.11.2}/tests/fixtures/response-fixtures/standard-timezones.json
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|