Migrate to Geocodio API v2 (#23)

* Migrate to Geocodio API v2

Breaking change: migrate the client to the Geocodio v2 API.

- Bump base URL version prefix from v1.x to v2 (BASE_PATH = "/v2").
- Remove the top-level `input` object from /geocode and /reverse response
  parsing. GeocodingResponse.input has been removed; parsed address data
  now lives in results[].address_components.
- Rename AddressComponents fields to match v2:
  - zip -> postal_code
  - state -> state_province
  - add unit_type (was secondaryunit) and unit_number (was secondarynumber)
- Structured address input now accepts state_province (legacy `state`
  still accepted for compatibility).
- Bump version 0.5.1 -> 1.0.0 (pyproject.toml + _version.py); update
  CHANGELOG.md and smoke_lists.py version references.
- Update unit-test fixtures and assertions for the v2 response shape.
- Add isort black profile so black/isort agree on import formatting.

* Update e2e test assertions to v2 address-component names

The unit tests were migrated to v2 but tests/e2e/test_api.py still
asserted on the removed .state/.zip attributes, raising KeyError
against the live v2 API. Rename to .state_province/.postal_code.

* Fix pre-existing state-legislative district_number type assertion

The live API returns state-legislative district_number as a string
(model types it as Any); the e2e test wrongly asserted int. Assert
presence instead. Unrelated to v2; surfaced now that e2e runs green
on geocode/reverse. Congressional district_number (int) left as-is.

* Relax state-leg proportion assertion to accept int or float

API returns proportion as int (1) for whole-district representation;
test asserted float only. Accept (int, float). Same pre-existing
type-assertion class as district_number, unrelated to v2.

Author: MiniCodeMonkey

CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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 +27,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 +79,8 @@ 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.0.0...HEAD
+[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

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "geocodio-library-python"
-version = "0.7.0"
+version = "1.0.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"

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,

src/geocodio/__init__.py

@@ -8,24 +8,24 @@
 
 # Distance API exports
 from .distance import (
-    Coordinate,
-    DISTANCE_MODE_STRAIGHTLINE,
     DISTANCE_MODE_DRIVING,
     DISTANCE_MODE_HAVERSINE,
-    DISTANCE_UNITS_MILES,
-    DISTANCE_UNITS_KM,
+    DISTANCE_MODE_STRAIGHTLINE,
     DISTANCE_ORDER_BY_DISTANCE,
     DISTANCE_ORDER_BY_DURATION,
     DISTANCE_SORT_ASC,
     DISTANCE_SORT_DESC,
+    DISTANCE_UNITS_KM,
+    DISTANCE_UNITS_MILES,
+    Coordinate,
 )
 from .models import (
-    DistanceResponse,
-    DistanceMatrixResponse,
     DistanceDestination,
-    DistanceOrigin,
     DistanceJobResponse,
+    DistanceMatrixResponse,
     DistanceMatrixResult,
+    DistanceOrigin,
+    DistanceResponse,
 )
 
 __all__ = [

src/geocodio/_version.py

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