chore: prepare release v0.1.0

Author: MiniCodeMonkey

.github/workflows/publish.yml

@@ -53,16 +53,24 @@ jobs:
       run: |
         uv run python -m build
 
-    - name: Publish to TestPyPI
-      if: github.event.inputs.publish_to == 'testpypi' || github.event_name == 'release'
+    - name: Publish to PyPI (on release)
+      if: github.event_name == 'release'
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        uv run twine upload --verbose dist/*
+    
+    - name: Publish to TestPyPI (manual)
+      if: github.event.inputs.publish_to == 'testpypi'
       env:
         TWINE_USERNAME: __token__
         TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
         TWINE_REPOSITORY_URL: https://test.pypi.org/legacy/
       run: |
         uv run twine upload --verbose dist/*
 
-    - name: Publish to PyPI
+    - name: Publish to PyPI (manual)
       if: github.event.inputs.publish_to == 'pypi'
       env:
         TWINE_USERNAME: __token__

CHANGELOG.md

@@ -7,17 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added
-
-### Fixed
-
-### Changed
+## [0.1.0] - 2025-08-08
 
-### Deprecated
-
-### Removed
-
-### Security
+### Added
+- Initial release of the official Python client for the Geocodio API
+- Forward geocoding for single addresses and batch operations (up to 10,000 addresses)
+- Reverse geocoding for single coordinates and batch operations
+- List API support for managing large batch jobs
+- Field appending capabilities (census data, timezone, congressional districts, etc.)
+- Comprehensive error handling with structured exception hierarchy
+- Full test coverage with unit and end-to-end tests
+- Support for Geocodio Enterprise API via hostname parameter
+- Modern async-capable HTTP client using httpx
+- Type hints and dataclass models for better IDE support
+- GitHub Actions CI/CD pipeline for automated testing and publishing
 
 ## Release Process
 
@@ -29,4 +32,5 @@ 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/main...HEAD
+[Unreleased]: https://github.com/Geocodio/geocodio-library-python/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/Geocodio/geocodio-library-python/releases/tag/v0.1.0

README.md

@@ -16,7 +16,7 @@ Installation
 
 Install via pip:
 
-    pip install geocodio
+    pip install geocodio-library-python
 
 Development Installation
 -----------------------

pyproject.toml

@@ -3,17 +3,14 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [project]
-name = "geocodio"
+name = "geocodio-library-python"
 version = "0.1.0"
 description = "A Python client for the Geocodio API"
 readme = "README.md"
 requires-python = ">=3.11"
 license = "MIT"
-authors = [
-    { name = "Your Name", email = "[email protected]" }
-]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
@@ -43,8 +40,8 @@ dev = [
 ]
 
 [project.urls]
-Homepage = "https://geocod.io"
-Documentation = "https://geocodio.readthedocs.io"
+Homepage = "https://www.geocod.io"
+Documentation = "https://www.geocod.io/docs/?python"
 Repository = "https://github.com/geocodio/geocodio-library-python"
 Issues = "https://github.com/geocodio/geocodio-library-python/issues"