geocodio-library-python 0.1.0__tar.gz → 0.2.0__tar.gz

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2025-08-08
+
+### Changed
+- **BREAKING**: Renamed main client class from `GeocodioClient` to `Geocodio` for simplicity and consistency with other SDKs
+  - Migration: Change imports from `from geocodio import GeocodioClient` to `from geocodio import Geocodio`
+  - Migration: Update instantiation from `client = GeocodioClient(...)` to `client = Geocodio(...)`
+
 ## [0.1.0] - 2025-08-08
 
 ### Added
@@ -32,5 +39,6 @@ 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.1.0...HEAD
+[Unreleased]: https://github.com/Geocodio/geocodio-library-python/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/Geocodio/geocodio-library-python/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/Geocodio/geocodio-library-python/releases/tag/v0.1.0

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geocodio-library-python
-Version: 0.1.0
+Version: 0.2.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
@@ -53,37 +53,16 @@ Install via pip:
 
     pip install geocodio-library-python
 
-Development Installation
------------------------
-
-1. Clone the repository:
-    ```bash
-    git clone https://github.com/geocodio/geocodio-library-python.git
-    cd geocodio-library-python
-    ```
-
-2. Create and activate a virtual environment:
-    ```bash
-    python -m venv venv
-    source venv/bin/activate  # On Windows: venv\Scripts\activate
-    ```
-
-3. Install development dependencies:
-    ```bash
-    pip install -e .
-    pip install -r requirements-dev.txt
-    ```
-
 Usage
 -----
 
 ### Geocoding
 
 ```python
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 
 # Initialize the client with your API key
-client = GeocodioClient("YOUR_API_KEY")
+client = Geocodio("YOUR_API_KEY")
 
 # Single forward geocode
 response = client.geocode("1600 Pennsylvania Ave, Washington, DC")
@@ -115,10 +94,10 @@ print(data.results[0].fields.timezone.name if data.results[0].fields.timezone el
 The List API allows you to manage lists of addresses or coordinates for batch processing.
 
 ```python
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 
 # Initialize the client with your API key
-client = GeocodioClient("YOUR_API_KEY")
+client = Geocodio("YOUR_API_KEY")
 
 # Get all lists
 lists = client.get_lists()
@@ -150,17 +129,17 @@ Error Handling
 --------------
 
 ```python
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 from geocodio.exceptions import AuthenticationError, InvalidRequestError
 
 try:
-    client = GeocodioClient("INVALID_API_KEY")
+    client = Geocodio("INVALID_API_KEY")
     response = client.geocode("1600 Pennsylvania Ave, Washington, DC")
 except AuthenticationError as e:
     print(f"Authentication failed: {e}")
 
 try:
-    client = GeocodioClient("YOUR_API_KEY")
+    client = Geocodio("YOUR_API_KEY")
     response = client.geocode("")  # Empty address
 except InvalidRequestError as e:
     print(f"Invalid request: {e}")
@@ -172,10 +151,10 @@ Geocodio Enterprise
 To use this library with Geocodio Enterprise, pass `api.enterprise.geocod.io` as the `hostname` parameter when initializing the client:
 
 ```python
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 
 # Initialize client for Geocodio Enterprise
-client = GeocodioClient(
+client = Geocodio(
     "YOUR_API_KEY",
     hostname="api.enterprise.geocod.io"
 )
@@ -202,6 +181,27 @@ License
 
 This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
 
+Development Installation
+-----------------------
+
+1. Clone the repository:
+    ```bash
+    git clone https://github.com/geocodio/geocodio-library-python.git
+    cd geocodio-library-python
+    ```
+
+2. Create and activate a virtual environment:
+    ```bash
+    python -m venv venv
+    source venv/bin/activate  # On Windows: venv\Scripts\activate
+    ```
+
+3. Install development dependencies:
+    ```bash
+    pip install -e .
+    pip install -r requirements-dev.txt
+    ```
+
 CI & Publishing
 ---------------
 

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/README.md

@@ -18,37 +18,16 @@ Install via pip:
 
     pip install geocodio-library-python
 
-Development Installation
------------------------
-
-1. Clone the repository:
-    ```bash
-    git clone https://github.com/geocodio/geocodio-library-python.git
-    cd geocodio-library-python
-    ```
-
-2. Create and activate a virtual environment:
-    ```bash
-    python -m venv venv
-    source venv/bin/activate  # On Windows: venv\Scripts\activate
-    ```
-
-3. Install development dependencies:
-    ```bash
-    pip install -e .
-    pip install -r requirements-dev.txt
-    ```
-
 Usage
 -----
 
 ### Geocoding
 
 ```python
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 
 # Initialize the client with your API key
-client = GeocodioClient("YOUR_API_KEY")
+client = Geocodio("YOUR_API_KEY")
 
 # Single forward geocode
 response = client.geocode("1600 Pennsylvania Ave, Washington, DC")
@@ -80,10 +59,10 @@ print(data.results[0].fields.timezone.name if data.results[0].fields.timezone el
 The List API allows you to manage lists of addresses or coordinates for batch processing.
 
 ```python
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 
 # Initialize the client with your API key
-client = GeocodioClient("YOUR_API_KEY")
+client = Geocodio("YOUR_API_KEY")
 
 # Get all lists
 lists = client.get_lists()
@@ -115,17 +94,17 @@ Error Handling
 --------------
 
 ```python
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 from geocodio.exceptions import AuthenticationError, InvalidRequestError
 
 try:
-    client = GeocodioClient("INVALID_API_KEY")
+    client = Geocodio("INVALID_API_KEY")
     response = client.geocode("1600 Pennsylvania Ave, Washington, DC")
 except AuthenticationError as e:
     print(f"Authentication failed: {e}")
 
 try:
-    client = GeocodioClient("YOUR_API_KEY")
+    client = Geocodio("YOUR_API_KEY")
     response = client.geocode("")  # Empty address
 except InvalidRequestError as e:
     print(f"Invalid request: {e}")
@@ -137,10 +116,10 @@ Geocodio Enterprise
 To use this library with Geocodio Enterprise, pass `api.enterprise.geocod.io` as the `hostname` parameter when initializing the client:
 
 ```python
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 
 # Initialize client for Geocodio Enterprise
-client = GeocodioClient(
+client = Geocodio(
     "YOUR_API_KEY",
     hostname="api.enterprise.geocod.io"
 )
@@ -167,6 +146,27 @@ License
 
 This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
 
+Development Installation
+-----------------------
+
+1. Clone the repository:
+    ```bash
+    git clone https://github.com/geocodio/geocodio-library-python.git
+    cd geocodio-library-python
+    ```
+
+2. Create and activate a virtual environment:
+    ```bash
+    python -m venv venv
+    source venv/bin/activate  # On Windows: venv\Scripts\activate
+    ```
+
+3. Install development dependencies:
+    ```bash
+    pip install -e .
+    pip install -r requirements-dev.txt
+    ```
+
 CI & Publishing
 ---------------
 

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/pyproject.toml

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

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/smoke.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 from dotenv import load_dotenv
 import os
 import json
@@ -10,7 +10,7 @@ from dataclasses import asdict
 load_dotenv()
 
 # Initialize the client with your API key
-client = GeocodioClient(os.getenv("GEOCODIO_API_KEY"))
+client = Geocodio(os.getenv("GEOCODIO_API_KEY"))
 
 # Single forward geocode
 print("\nSingle forward geocode:")

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/smoke_lists.py

@@ -3,7 +3,7 @@
 import os
 import time
 import logging
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 from geocodio.models import ListProcessingState
 from dotenv import load_dotenv
 
@@ -51,7 +51,7 @@ def main():
         logger.error("GEOCODIO_API_KEY not set in environment.")
         exit(1)
 
-    client = GeocodioClient(api_key)
+    client = Geocodio(api_key)
 
     # Step 1: Create a list
     logger.info("Creating a new list...")

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/src/geocodio/__init__.py

@@ -4,6 +4,6 @@ A Python client for the Geocodio API.
 """
 
 from ._version import __version__
-from .client import GeocodioClient
+from .client import Geocodio
 
-__all__ = ["GeocodioClient", "__version__"]
+__all__ = ["Geocodio", "__version__"]

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/src/geocodio/_version.py

@@ -1,3 +1,3 @@
 """Version information for geocodio package."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/src/geocodio/client.py

@@ -27,7 +27,7 @@ from geocodio.models import (
 from geocodio.exceptions import InvalidRequestError, AuthenticationError, GeocodioServerError, BadRequestError
 
 
-class GeocodioClient:
+class Geocodio:
     BASE_PATH = "/v1.9"  # keep in sync with Geocodio's current version
     DEFAULT_SINGLE_TIMEOUT = 5.0
     DEFAULT_BATCH_TIMEOUT = 1800.0  # 30 minutes

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/tests/conftest.py

@@ -6,7 +6,7 @@ import os
 import logging
 from dotenv import load_dotenv
 import pytest
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 
 # Load environment variables from .env file
 load_dotenv()
@@ -18,7 +18,7 @@ logger = logging.getLogger(__name__)
 
 @pytest.fixture
 def client(request):
-    """Create a GeocodioClient instance with test configuration"""
+    """Create a Geocodio instance with test configuration"""
     # Use TEST_KEY for all tests except e2e tests
     if "e2e" in request.node.fspath.strpath:
         logger.debug("Running e2e tests - using API key from environment")
@@ -26,7 +26,7 @@ def client(request):
         if not api_key:
             logger.warning("GEOCODIO_API_KEY not set - skipping e2e test")
             pytest.skip("GEOCODIO_API_KEY environment variable not set")
-        return GeocodioClient(api_key=api_key)
+        return Geocodio(api_key=api_key)
     else:
         logger.debug("Running unit tests - using TEST_KEY with api.test hostname")
-        return GeocodioClient(api_key="TEST_KEY", hostname="api.test")
+        return Geocodio(api_key="TEST_KEY", hostname="api.test")

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/tests/e2e/test_api.py

@@ -5,7 +5,7 @@ These tests require a valid GEOCODIO_API_KEY environment variable.
 
 import os
 import pytest
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 from geocodio.exceptions import GeocodioError
 
 
@@ -15,7 +15,7 @@ def client():
     api_key = os.getenv("GEOCODIO_API_KEY")
     if not api_key:
         pytest.skip("GEOCODIO_API_KEY environment variable not set")
-    return GeocodioClient(api_key)
+    return Geocodio(api_key)
 
 
 def test_integration_geocode(client):

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/tests/e2e/test_batch_reverse.py

@@ -3,7 +3,7 @@ End-to-end tests for batch reverse geocoding functionality.
 """
 
 import pytest
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 
 
 def test_batch_reverse_geocoding(client):

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/tests/e2e/test_lists_api.py

@@ -7,7 +7,7 @@ import os
 import pytest
 import time
 from unittest.mock import patch
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 from geocodio.models import ListResponse, PaginatedResponse, ListProcessingState
 from geocodio.exceptions import GeocodioServerError
 import logging
@@ -22,7 +22,7 @@ def client():
     api_key = os.getenv("GEOCODIO_API_KEY")
     if not api_key:
         pytest.skip("GEOCODIO_API_KEY environment variable not set")
-    return GeocodioClient(api_key)
+    return Geocodio(api_key)
 
 
 @pytest.fixture
@@ -59,8 +59,8 @@ def wait_for_list_processed(client, list_id, timeout=120):
 
 def test_create_list(client):
     """
-    Test creating a list with GeocodioClient.create_list()
-    :param client: GeocodioClient instance
+    Test creating a list with Geocodio.create_list()
+    :param client: Geocodio instance
     """
     new_list = client.create_list(file="Zip\n20003\n20001", filename="test_list.csv")
 
@@ -69,8 +69,8 @@ def test_create_list(client):
 
 def test_get_list_status(client, list_response):
     """
-    Test retrieving the status of a list with GeocodioClient.get_list_status()
-    :param client: GeocodioClient instance
+    Test retrieving the status of a list with Geocodio.get_list_status()
+    :param client: Geocodio instance
     :param list_response: List object created in the fixture
     """
     # Get the status of the test list

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/tests/unit/test_client.py

@@ -1,22 +1,22 @@
 """
-Tests for the GeocodioClient class
+Tests for the Geocodio class
 """
 
 import pytest
 import httpx
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 from geocodio.exceptions import AuthenticationError
 
 
 @pytest.fixture
 def mock_request(mocker):
     """Mock the _request method."""
-    return mocker.patch('geocodio.client.GeocodioClient._request')
+    return mocker.patch('geocodio.client.Geocodio._request')
 
 
 def test_client_initialization():
     """Test that the client can be initialized with an API key"""
-    client = GeocodioClient(api_key="test-key")
+    client = Geocodio(api_key="test-key")
     assert client.api_key == "test-key"
     assert client.hostname == "api.geocod.io"
 
@@ -24,7 +24,7 @@ def test_client_initialization():
 def test_client_initialization_with_env_var(monkeypatch):
     """Test that the client can be initialized with an environment variable"""
     monkeypatch.setenv("GEOCODIO_API_KEY", "env-key")
-    client = GeocodioClient()
+    client = Geocodio()
     assert client.api_key == "env-key"
 
 
@@ -33,7 +33,7 @@ def test_client_initialization_no_key(monkeypatch):
     # Ensure environment variable is not set
     monkeypatch.delenv("GEOCODIO_API_KEY", raising=False)
     with pytest.raises(AuthenticationError, match="No API key supplied and GEOCODIO_API_KEY is not set"):
-        GeocodioClient()
+        Geocodio()
 
 
 def test_geocode_with_census_data(mock_request):
@@ -64,7 +64,7 @@ def test_geocode_with_census_data(mock_request):
         }]
     })
 
-    client = GeocodioClient("fake-key")
+    client = Geocodio("fake-key")
     response = client.geocode(
         {"street": "1109 N Highland St", "city": "Arlington", "state": "VA"},
         fields=["census2010"]
@@ -102,7 +102,7 @@ def test_geocode_with_acs_data(mock_request):
         }]
     })
 
-    client = GeocodioClient("fake-key")
+    client = Geocodio("fake-key")
     response = client.geocode(
         {"street": "1109 N Highland St", "city": "Arlington", "state": "VA"},
         fields=["acs"]
@@ -154,7 +154,7 @@ def test_geocode_batch_with_custom_keys(mock_request):
         ]
     })
 
-    client = GeocodioClient("fake-key")
+    client = Geocodio("fake-key")
     response = client.geocode({
         "address1": "1109 N Highland St, Arlington, VA",
         "address2": "525 University Ave, Toronto, ON, Canada"
@@ -193,7 +193,7 @@ def test_geocode_with_congressional_districts(mock_request):
         }]
     })
 
-    client = GeocodioClient("fake-key")
+    client = Geocodio("fake-key")
     response = client.geocode(
         {"street": "1109 N Highland St", "city": "Arlington", "state": "VA"},
         fields=["cd"]
@@ -229,7 +229,7 @@ def test_user_agent_header_in_request(mocker):
         }]
     })
     
-    client = GeocodioClient("test-api-key")
+    client = Geocodio("test-api-key")
     client.geocode("1109 N Highland St, Arlington, VA")
     
     # Verify request was made with correct headers
@@ -247,7 +247,7 @@ def test_user_agent_header_format():
     """Test that the User-Agent header has the correct format."""
     from geocodio import __version__
     
-    client = GeocodioClient("test-api-key")
+    client = Geocodio("test-api-key")
     expected_user_agent = f"geocodio-library-python/{__version__}"
     assert client.USER_AGENT == expected_user_agent
 
@@ -262,7 +262,7 @@ def test_user_agent_header_in_batch_request(mocker):
         "results": []
     })
     
-    client = GeocodioClient("test-api-key")
+    client = Geocodio("test-api-key")
     client.geocode(["Address 1", "Address 2"])
     
     # Verify headers in batch request
@@ -295,7 +295,7 @@ def test_user_agent_header_in_reverse_geocode(mocker):
         }]
     })
     
-    client = GeocodioClient("test-api-key")
+    client = Geocodio("test-api-key")
     client.reverse("38.886665,-77.094733")
     
     # Verify headers in reverse geocode request
@@ -321,7 +321,7 @@ def test_user_agent_header_in_list_api(mocker):
         "per_page": 10
     })
     
-    client = GeocodioClient("test-api-key")
+    client = Geocodio("test-api-key")
     client.get_lists()
     
     # Verify headers in list API request

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/tests/unit/test_geocoding.py

@@ -7,19 +7,19 @@ from typing import List
 import pytest
 from dotenv import load_dotenv
 
-from geocodio import GeocodioClient
+from geocodio import Geocodio
 from geocodio.exceptions import AuthenticationError
 
 # Load environment variables from .env file
 load_dotenv()
 
 @pytest.fixture
-def client() -> GeocodioClient:
-    """Create a GeocodioClient instance for testing."""
+def client() -> Geocodio:
+    """Create a Geocodio instance for testing."""
     api_key = os.getenv("GEOCODIO_API_KEY")
     if not api_key:
         pytest.skip("GEOCODIO_API_KEY environment variable not set")
-    return GeocodioClient(api_key)
+    return Geocodio(api_key)
 
 def test_client_requires_api_key():
     """Test that client raises AuthenticationError when no API key is provided."""
@@ -30,13 +30,13 @@ def test_client_requires_api_key():
 
     try:
         with pytest.raises(AuthenticationError):
-            GeocodioClient("")
+            Geocodio("")
     finally:
         # Restore the environment variable
         if original_key:
             os.environ["GEOCODIO_API_KEY"] = original_key
 
-def test_single_forward_geocode(client: GeocodioClient):
+def test_single_forward_geocode(client: Geocodio):
     """Test forward geocoding of a single address."""
     response = client.geocode("3730 N Clark St, Chicago, IL")
 
@@ -63,7 +63,7 @@ def test_single_forward_geocode(client: GeocodioClient):
     assert components.state == "IL"
     assert components.zip == "60613"
 
-def test_batch_forward_geocode(client: GeocodioClient):
+def test_batch_forward_geocode(client: Geocodio):
     """Test forward geocoding of multiple addresses."""
     addresses: List[str] = [
         "3730 N Clark St, Chicago, IL",
@@ -85,7 +85,7 @@ def test_batch_forward_geocode(client: GeocodioClient):
     assert denver.accuracy > 0.9
     assert denver.accuracy_type == "rooftop"
 
-def test_single_reverse_geocode(client: GeocodioClient):
+def test_single_reverse_geocode(client: Geocodio):
     """Test reverse geocoding of coordinates."""
     response = client.reverse("38.9002898,-76.9990361")
 
@@ -102,7 +102,7 @@ def test_single_reverse_geocode(client: GeocodioClient):
     assert 38.89 < result.location.lat < 38.91
     assert -77.00 < result.location.lng < -76.99
 
-def test_geocode_with_fields(client: GeocodioClient):
+def test_geocode_with_fields(client: Geocodio):
     """Test geocoding with additional data fields."""
     response = client.geocode(
         "3730 N Clark St, Chicago, IL",

{geocodio_library_python-0.1.0 → geocodio_library_python-0.2.0}/uv.lock

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