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

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

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-03-12
+
+### Changed
+- Updated default API version to v1.11
+
 ## [0.6.0] - 2026-02-24
 
 ### Changed
@@ -64,7 +69,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.6.0...HEAD
+[Unreleased]: https://github.com/Geocodio/geocodio-library-python/compare/v0.7.0...HEAD
+[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
 [0.5.0]: https://github.com/Geocodio/geocodio-library-python/compare/v0.4.0...v0.5.0

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geocodio-library-python
-Version: 0.6.0
+Version: 0.7.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

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "geocodio-library-python"
-version = "0.6.0"
+version = "0.7.0"
 description = "A Python client for the Geocodio API"
 readme = "README.md"
 requires-python = ">=3.11"

{geocodio_library_python-0.6.0 → geocodio_library_python-0.7.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.9/lists")
+    logger.info("REQUEST: POST /v1.11/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.9/lists")
+    logger.info("RESPONSE: POST /v1.11/lists")
     print_headers_and_body("Response", {
         "id": new_list_response.id,
         "file": new_list_response.file,

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

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

{geocodio_library_python-0.6.0 → geocodio_library_python-0.7.0}/src/geocodio/client.py

@@ -43,7 +43,7 @@ from geocodio.exceptions import InvalidRequestError, AuthenticationError, Geocod
 
 
 class Geocodio:
-    BASE_PATH = "/v1.10"  # keep in sync with Geocodio's current version
+    BASE_PATH = "/v1.11"  # keep in sync with Geocodio's current version
     DEFAULT_SINGLE_TIMEOUT = 5.0
     DEFAULT_BATCH_TIMEOUT = 1800.0  # 30 minutes
     LIST_API_TIMEOUT = 60.0

{geocodio_library_python-0.6.0 → geocodio_library_python-0.7.0}/src/geocodio/models.py

@@ -82,8 +82,8 @@ class Timezone(ApiModelMixin):
 @dataclass(slots=True, frozen=True)
 class CongressionalDistrict(ApiModelMixin):
     name: str
-    district_number: int
-    congress_number: str
+    district_number: Any = None
+    congress_number: Optional[str] = None
     ocd_id: Optional[str] = None
     extras: Dict[str, Any] = field(default_factory=dict, repr=False)
 
@@ -95,8 +95,8 @@ class StateLegislativeDistrict(ApiModelMixin):
     """
 
     name: str
-    district_number: int
-    chamber: str  # 'house' or 'senate'
+    district_number: Any = None
+    chamber: Optional[str] = None  # 'house' or 'senate'
     ocd_id: Optional[str] = None
     proportion: Optional[float] = None  # Proportion of overlap with the address
     extras: Dict[str, Any] = field(default_factory=dict, repr=False)

{geocodio_library_python-0.6.0 → geocodio_library_python-0.7.0}/tests/e2e/test_api.py

@@ -111,7 +111,7 @@ def test_integration_with_fields(client):
     if fields.congressional_districts:
         cd = fields.congressional_districts[0]
         assert cd.name is not None
-        assert isinstance(cd.district_number, int)
+        assert cd.district_number is not None
         assert cd.congress_number is not None
 
     if fields.census2020:
@@ -205,23 +205,23 @@ def test_integration_with_state_legislative_districts(client):
     if fields.state_legislative_districts:
         district = fields.state_legislative_districts[0]
         assert district.name is not None
-        assert isinstance(district.district_number, int)
+        assert district.district_number is not None
         assert district.chamber in ["house", "senate"]
         if district.ocd_id:
             assert isinstance(district.ocd_id, str)
         if district.proportion:
-            assert isinstance(district.proportion, float)
+            assert isinstance(district.proportion, (int, float))
 
     # Check upcoming state legislative districts
     if fields.state_legislative_districts_next:
         district = fields.state_legislative_districts_next[0]
         assert district.name is not None
-        assert isinstance(district.district_number, int)
+        assert district.district_number is not None
         assert district.chamber in ["house", "senate"]
         if district.ocd_id:
             assert isinstance(district.ocd_id, str)
         if district.proportion:
-            assert isinstance(district.proportion, float)
+            assert isinstance(district.proportion, (int, float))
 
 
 def test_integration_with_school_districts(client):
@@ -249,7 +249,7 @@ def test_integration_with_school_districts(client):
         district = fields.school_districts[0]
         assert district.name is not None
         if district.district_number:
-            assert isinstance(district.district_number, str)
+            assert district.district_number is not None
         if district.lea_id:
             assert isinstance(district.lea_id, str)
         if district.nces_id:
@@ -676,7 +676,7 @@ def test_integration_with_congressional_district_variants(client):
     if fields.congressional_districts:
         for district in fields.congressional_districts:
             assert district.name is not None
-            assert isinstance(district.district_number, int)
+            assert district.district_number is not None
             assert district.congress_number is not None
             if district.ocd_id:
                 assert isinstance(district.ocd_id, str)

{geocodio_library_python-0.6.0 → geocodio_library_python-0.7.0}/tests/unit/test_distance.py

@@ -213,7 +213,7 @@ class TestDistance:
         """Test basic distance calculation."""
         def response_callback(request):
             assert request.method == "GET"
-            assert "/v1.10/distance" in str(request.url)
+            assert "/v1.11/distance" in str(request.url)
             return httpx.Response(200, json=sample_distance_response())
 
         httpx_mock.add_callback(callback=response_callback)
@@ -464,7 +464,7 @@ def sample_job_status_response():
             "name": "My Job",
             "status": "COMPLETED",
             "progress": 100,
-            "download_url": "https://api.geocod.io/v1.10/distance-jobs/123/download",
+            "download_url": "https://api.geocod.io/v1.11/distance-jobs/123/download",
             "total_calculations": 4,
             "calculations_completed": 4,
             "origins_count": 2,
@@ -502,7 +502,7 @@ def sample_jobs_list_response():
         "current_page": 1,
         "from": 1,
         "to": 2,
-        "path": "/v1.10/distance-jobs",
+        "path": "/v1.11/distance-jobs",
         "per_page": 10
     }
 
@@ -656,7 +656,7 @@ class TestGeocodeWithDistance:
         """Test geocode with destination parameter."""
         def response_callback(request):
             url_str = str(request.url)
-            assert "/v1.10/geocode" in url_str
+            assert "/v1.11/geocode" in url_str
             assert "destinations%5B%5D" in url_str or "destinations[]" in url_str.replace("%5B", "[").replace("%5D", "]")
             return httpx.Response(200, json=sample_geocode_with_distance_response())
 
@@ -673,7 +673,7 @@ class TestGeocodeWithDistance:
         """Test geocode with distance mode parameter."""
         def response_callback(request):
             url_str = str(request.url)
-            assert "/v1.10/geocode" in url_str
+            assert "/v1.11/geocode" in url_str
             assert "distance_mode=driving" in url_str
             return httpx.Response(200, json=sample_geocode_with_distance_response())
 
@@ -689,7 +689,7 @@ class TestGeocodeWithDistance:
         """Test geocode with distance units parameter."""
         def response_callback(request):
             url_str = str(request.url)
-            assert "/v1.10/geocode" in url_str
+            assert "/v1.11/geocode" in url_str
             assert "distance_units=km" in url_str
             return httpx.Response(200, json=sample_geocode_with_distance_response())
 
@@ -714,7 +714,7 @@ class TestReverseWithDistance:
         """Test reverse geocode with destination parameter."""
         def response_callback(request):
             url_str = str(request.url)
-            assert "/v1.10/reverse" in url_str
+            assert "/v1.11/reverse" in url_str
             assert "destinations%5B%5D" in url_str or "destinations[]" in url_str.replace("%5B", "[").replace("%5D", "]")
             return httpx.Response(200, json=sample_geocode_with_distance_response())
 
@@ -731,7 +731,7 @@ class TestReverseWithDistance:
         """Test reverse geocode with distance mode parameter."""
         def response_callback(request):
             url_str = str(request.url)
-            assert "/v1.10/reverse" in url_str
+            assert "/v1.11/reverse" in url_str
             assert "distance_mode=straightline" in url_str
             return httpx.Response(200, json=sample_geocode_with_distance_response())
 

{geocodio_library_python-0.6.0 → geocodio_library_python-0.7.0}/tests/unit/test_errors.py

@@ -9,7 +9,7 @@ def _add_err(httpx_mock, status_code):
     # this should actually make the request and see and error response
     # but we are mocking it here for testing purposes
     httpx_mock.add_response(
-        url=httpx.URL("https://api.test/v1.10/geocode", params={"q": "bad input"}),
+        url=httpx.URL("https://api.test/v1.11/geocode", params={"q": "bad input"}),
         match_headers={"Authorization": "Bearer TEST_KEY"},
         json={"error": "boom"},
         status_code=status_code,

{geocodio_library_python-0.6.0 → geocodio_library_python-0.7.0}/tests/unit/test_geocode.py

@@ -57,7 +57,7 @@ def test_geocode_single(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=response_callback,
-        url=httpx.URL("https://api.test/v1.10/geocode", params={"q": "1109 N Highland St, Arlington, VA"}),
+        url=httpx.URL("https://api.test/v1.11/geocode", params={"q": "1109 N Highland St, Arlington, VA"}),
         match_headers={"Authorization": "Bearer TEST_KEY"},
     )
 
@@ -140,7 +140,7 @@ def test_geocode_batch(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=batch_response_callback,
-        url=httpx.URL("https://api.test/v1.10/geocode"),
+        url=httpx.URL("https://api.test/v1.11/geocode"),
         match_headers={"Authorization": "Bearer TEST_KEY"},
     )
 
@@ -172,7 +172,7 @@ def test_geocode_structured_address(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=response_callback,
-        url=httpx.URL("https://api.test/v1.10/geocode", params={
+        url=httpx.URL("https://api.test/v1.11/geocode", params={
             "street": "1109 N Highland St",
             "city": "Arlington",
             "state": "VA"
@@ -229,7 +229,7 @@ def test_geocode_with_fields(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=response_callback,
-        url=httpx.URL("https://api.test/v1.10/geocode", params={
+        url=httpx.URL("https://api.test/v1.11/geocode", params={
             "q": "1109 Highland St, Arlington, VA",
             "fields": "timezone,cd"
         }),
@@ -292,7 +292,7 @@ def test_geocode_with_limit(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=response_callback,
-        url=httpx.URL("https://api.test/v1.10/geocode", params={
+        url=httpx.URL("https://api.test/v1.11/geocode", params={
             "q": "1109 Highland St, Arlington, VA",
             "limit": "2"
         }),
@@ -371,7 +371,7 @@ def test_geocode_batch_with_nested_response(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=batch_response_callback,
-        url=httpx.URL("https://api.test/v1.10/geocode"),
+        url=httpx.URL("https://api.test/v1.11/geocode"),
         match_headers={"Authorization": "Bearer TEST_KEY"},
     )
 
@@ -478,7 +478,7 @@ def test_geocode_batch_with_fields(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=batch_response_callback,
-        url=httpx.URL("https://api.test/v1.10/geocode", params={"fields": "timezone,cd"}),
+        url=httpx.URL("https://api.test/v1.11/geocode", params={"fields": "timezone,cd"}),
         match_headers={"Authorization": "Bearer TEST_KEY"},
     )
 
@@ -558,7 +558,7 @@ def test_geocode_with_census_fields(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=response_callback,
-        url=httpx.URL("https://api.test/v1.10/geocode", params={
+        url=httpx.URL("https://api.test/v1.11/geocode", params={
             "street": "1640 Main St",
             "city": "Sheldon",
             "state": "VT",
@@ -671,7 +671,7 @@ def test_geocode_with_stateleg_fields(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=response_callback,
-        url=httpx.URL("https://api.test/v1.10/geocode", params={
+        url=httpx.URL("https://api.test/v1.11/geocode", params={
             "q": "600 Santa Ray Ave, Oakland CA 94610",
             "fields": "stateleg"
         }),

{geocodio_library_python-0.6.0 → geocodio_library_python-0.7.0}/tests/unit/test_reverse.py

@@ -32,7 +32,7 @@ def test_reverse_single_coordinate(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=response_callback,
-        url=httpx.URL("https://api.test/v1.10/reverse", params={"q": "38.886672,-77.094735"}),
+        url=httpx.URL("https://api.test/v1.11/reverse", params={"q": "38.886672,-77.094735"}),
         match_headers={"Authorization": "Bearer TEST_KEY"},
     )
 
@@ -110,7 +110,7 @@ def test_reverse_batch_coordinates(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=batch_response_callback,
-        url=httpx.URL("https://api.test/v1.10/reverse"),
+        url=httpx.URL("https://api.test/v1.11/reverse"),
         match_headers={"Authorization": "Bearer TEST_KEY"},
     )
 
@@ -162,7 +162,7 @@ def test_reverse_with_fields(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=response_callback,
-        url=httpx.URL("https://api.test/v1.10/reverse", params={
+        url=httpx.URL("https://api.test/v1.11/reverse", params={
             "q": "38.886672,-77.094735",
             "fields": "timezone,cd"
         }),
@@ -225,7 +225,7 @@ def test_reverse_with_limit(client, httpx_mock):
 
     httpx_mock.add_callback(
         callback=response_callback,
-        url=httpx.URL("https://api.test/v1.10/reverse", params={
+        url=httpx.URL("https://api.test/v1.11/reverse", params={
             "q": "38.886672,-77.094735",
             "limit": "2"
         }),
@@ -244,7 +244,7 @@ def test_reverse_with_limit(client, httpx_mock):
 def test_reverse_invalid_coordinate(client, httpx_mock):
     # Arrange: stub the API call with error response
     httpx_mock.add_response(
-        url=httpx.URL("https://api.test/v1.10/reverse", params={
+        url=httpx.URL("https://api.test/v1.11/reverse", params={
             "q": "invalid,coordinate"
         }),
         match_headers={"Authorization": "Bearer TEST_KEY"},

{geocodio_library_python-0.6.0 → geocodio_library_python-0.7.0}/uv.lock

@@ -149,7 +149,7 @@ wheels = [
 
 [[package]]
 name = "geocodio-library-python"
-version = "0.6.0"
+version = "0.7.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },