geocodio-library-python 0.7.0__tar.gz → 1.3.0__tar.gz

{geocodio_library_python-0.7.0 → geocodio_library_python-1.3.0}/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-08-25
+
+### Added
+- United Kingdom data append support. The `uk-westminster`, `uk-devolved`, and `uk-local` appends (and their `-next` variants) are now parsed into a typed `UKLegislativeDistrict` model, exposed via `fields.uk_westminster`, `fields.uk_devolved`, and `fields.uk_local`.
+
+## [1.0.0] - 2026-06-05
+
+### Changed
+- **BREAKING**: Migrated to Geocodio API **v2**. The base URL version prefix changed from `v1.x` to `v2` (`https://api.geocod.io/v2/...`).
+- **BREAKING**: Removed the top-level `input` object from `/geocode` and `/reverse` responses. `GeocodingResponse.input` has been removed; parsed address information now lives in `results[].address_components`.
+- **BREAKING**: Renamed `AddressComponents` fields to match API v2:
+  - `zip` → `postal_code`
+  - `state` → `state_province`
+  - Added `unit_type` (was `secondaryunit`) and `unit_number` (was `secondarynumber`)
+- Structured address input now accepts `state_province` (the legacy `state` field is still accepted for compatibility).
+
 ## [0.7.0] - 2026-03-12
 
 ### Changed
@@ -16,7 +32,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - Updated default API version from v1.9 to v1.10
-
 ## [0.5.1] - 2026-02-18
 
 ### Fixed
@@ -69,7 +84,9 @@ When ready to release:
 5. Push tags: `git push --tags`
 6. GitHub Actions will automatically publish to PyPI
 
-[Unreleased]: https://github.com/Geocodio/geocodio-library-python/compare/v0.7.0...HEAD
+[Unreleased]: https://github.com/Geocodio/geocodio-library-python/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/Geocodio/geocodio-library-python/compare/v1.2.0...v1.3.0
+[1.0.0]: https://github.com/Geocodio/geocodio-library-python/compare/v0.7.0...v1.0.0
 [0.7.0]: https://github.com/Geocodio/geocodio-library-python/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/Geocodio/geocodio-library-python/compare/v0.5.1...v0.6.0
 [0.5.1]: https://github.com/Geocodio/geocodio-library-python/compare/v0.5.0...v0.5.1

{geocodio_library_python-0.7.0 → geocodio_library_python-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: geocodio-library-python
-Version: 0.7.0
+Version: 1.3.0
 Summary: A Python client for the Geocodio API
 Project-URL: Homepage, https://www.geocod.io
 Project-URL: Documentation, https://www.geocod.io/docs/?python
@@ -100,6 +100,7 @@ To batch geocode, simply pass a list of addresses or coordinates instead of a si
 response = client.geocode([
     "1109 N Highland St, Arlington VA",
     "525 University Ave, Toronto, ON, Canada",
+    "10 Downing St, London, United Kingdom",
     "4410 S Highway 17 92, Casselberry FL",
     "15000 NE 24th Street, Redmond WA",
     "17015 Walnut Grove Drive, Morgan Hill CA"
@@ -116,15 +117,16 @@ response = client.reverse([
 response = client.geocode({
     "MyId1": "1109 N Highland St, Arlington VA",
     "MyId2": "525 University Ave, Toronto, ON, Canada",
-    "MyId3": "4410 S Highway 17 92, Casselberry FL",
-    "MyId4": "15000 NE 24th Street, Redmond WA",
-    "MyId5": "17015 Walnut Grove Drive, Morgan Hill CA"
+    "MyId3": "10 Downing St, London, United Kingdom",
+    "MyId4": "4410 S Highway 17 92, Casselberry FL",
+    "MyId5": "15000 NE 24th Street, Redmond WA",
+    "MyId6": "17015 Walnut Grove Drive, Morgan Hill CA"
 })
 ```
 
 ### Field appends
 
-Geocodio allows you to append additional data points such as congressional districts, census codes, timezone, ACS survey results and [much more](https://www.geocod.io/docs/#fields).
+Geocodio allows you to append additional data points such as congressional districts, census codes, timezone, ACS survey results, UK constituencies and wards, and [much more](https://www.geocod.io/docs/#fields).
 
 To request additional fields, simply supply them as a list:
 
@@ -138,6 +140,13 @@ response = client.geocode(
 )
 
 response = client.reverse("38.9002898,-76.9990361", fields=["census2010"])
+
+# United Kingdom addresses support UK-specific appends such as Westminster and
+# devolved parliament constituencies, and local authority wards
+response = client.geocode(
+    "10 Downing St, London, United Kingdom",
+    fields=["uk-westminster", "uk-local"]
+)
 ```
 
 ### Address components
@@ -163,6 +172,12 @@ response = client.geocode([
         "city": "Toronto",
         "state": "ON",
         "country": "Canada"
+    },
+    {
+        "street": "10 Downing St",
+        "city": "London",
+        "postal_code": "SW1A 2AA",
+        "country": "United Kingdom"
     }
 ])
 ```

{geocodio_library_python-0.7.0 → geocodio_library_python-1.3.0}/README.md

@@ -65,6 +65,7 @@ To batch geocode, simply pass a list of addresses or coordinates instead of a si
 response = client.geocode([
     "1109 N Highland St, Arlington VA",
     "525 University Ave, Toronto, ON, Canada",
+    "10 Downing St, London, United Kingdom",
     "4410 S Highway 17 92, Casselberry FL",
     "15000 NE 24th Street, Redmond WA",
     "17015 Walnut Grove Drive, Morgan Hill CA"
@@ -81,15 +82,16 @@ response = client.reverse([
 response = client.geocode({
     "MyId1": "1109 N Highland St, Arlington VA",
     "MyId2": "525 University Ave, Toronto, ON, Canada",
-    "MyId3": "4410 S Highway 17 92, Casselberry FL",
-    "MyId4": "15000 NE 24th Street, Redmond WA",
-    "MyId5": "17015 Walnut Grove Drive, Morgan Hill CA"
+    "MyId3": "10 Downing St, London, United Kingdom",
+    "MyId4": "4410 S Highway 17 92, Casselberry FL",
+    "MyId5": "15000 NE 24th Street, Redmond WA",
+    "MyId6": "17015 Walnut Grove Drive, Morgan Hill CA"
 })
 ```
 
 ### Field appends
 
-Geocodio allows you to append additional data points such as congressional districts, census codes, timezone, ACS survey results and [much more](https://www.geocod.io/docs/#fields).
+Geocodio allows you to append additional data points such as congressional districts, census codes, timezone, ACS survey results, UK constituencies and wards, and [much more](https://www.geocod.io/docs/#fields).
 
 To request additional fields, simply supply them as a list:
 
@@ -103,6 +105,13 @@ response = client.geocode(
 )
 
 response = client.reverse("38.9002898,-76.9990361", fields=["census2010"])
+
+# United Kingdom addresses support UK-specific appends such as Westminster and
+# devolved parliament constituencies, and local authority wards
+response = client.geocode(
+    "10 Downing St, London, United Kingdom",
+    fields=["uk-westminster", "uk-local"]
+)
 ```
 
 ### Address components
@@ -128,6 +137,12 @@ response = client.geocode([
         "city": "Toronto",
         "state": "ON",
         "country": "Canada"
+    },
+    {
+        "street": "10 Downing St",
+        "city": "London",
+        "postal_code": "SW1A 2AA",
+        "country": "United Kingdom"
     }
 ])
 ```

{geocodio_library_python-0.7.0 → geocodio_library_python-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "geocodio-library-python"
-version = "0.7.0"
+version = "1.3.0"
 description = "A Python client for the Geocodio API"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -48,6 +48,9 @@ Issues = "https://github.com/geocodio/geocodio-library-python/issues"
 [tool.hatch.build.targets.wheel]
 packages = ["src/geocodio"]
 
+[tool.isort]
+profile = "black"
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 python_files = "test_*.py"

{geocodio_library_python-0.7.0 → geocodio_library_python-1.3.0}/smoke_lists.py

@@ -57,7 +57,7 @@ def main():
     logger.info("Creating a new list...")
     file_content = "Zip\n20003\n20001"
     # --- Capture request details ---
-    logger.info("REQUEST: POST /v1.11/lists")
+    logger.info("REQUEST: POST /v2/lists")
     logger.info(f"Request params: {{'api_key': '***', 'direction': 'forward', 'format': '{{A}}'}}")
     logger.info(f"Request files: {{'file': ('smoke_test_list.csv', {repr(file_content)})}}")
     new_list_response = client.create_list(
@@ -66,7 +66,7 @@ def main():
         format_="{{A}}"
     )
     # --- Capture response details ---
-    logger.info("RESPONSE: POST /v1.11/lists")
+    logger.info("RESPONSE: POST /v2/lists")
     print_headers_and_body("Response", {
         "id": new_list_response.id,
         "file": new_list_response.file,

{geocodio_library_python-0.7.0 → geocodio_library_python-1.3.0}/src/geocodio/_version.py

@@ -1,3 +1,3 @@
 """Version information for geocodio package."""
 
-__version__ = "0.7.0"
+__version__ = "1.3.0"