Migrate to Geocodio API v2

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"