apple-maps-api 0.2.0__tar.gz → 0.2.1__tar.gz

{apple_maps_api-0.2.0 → apple_maps_api-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: apple-maps-api
-Version: 0.2.0
+Version: 0.2.1
 Summary: A modern Python client for the Apple Maps Server API with automatic JWT management and type safety
 Keywords: apple-maps,geocoding,search,geolocation
 Author: Michael Bianco
@@ -12,6 +12,7 @@ Requires-Dist: httpx2>=2.7.0
 Requires-Dist: funcy>=2.0
 Requires-Python: >=3.11
 Project-URL: Repository, https://github.com/iloveitaly/apple-maps-api
+Project-URL: Documentation, https://iloveitaly.github.io/python-apple-maps-api/
 Description-Content-Type: text/markdown
 
 [![Release Notes](https://img.shields.io/github/release/iloveitaly/apple-maps-api)](https://github.com/iloveitaly/apple-maps-api/releases)
@@ -49,7 +50,7 @@ uv add apple-maps-api
 
 ### Basic Setup
 
-You'll need your Team ID, Key ID, and the private key from your Apple Developer account.
+You'll need your Team ID, Key ID, and the private key from your Apple Developer account. Step-by-step portal setup (Maps ID, MapKit JS key, domains/localhost): [`docs/mapkit-js-credential-setup.md`](docs/mapkit-js-credential-setup.md).
 
 ```python
 from apple_maps_api import AppleMapsClient
@@ -59,7 +60,7 @@ client = AppleMapsClient(
     key_id="YOUR_KEY_ID",
     private_key="""-----BEGIN PRIVATE KEY-----
 ...
------END PRIVATE KEY-----"""
+-----END PRIVATE KEY-----""",
 )
 ```
 

{apple_maps_api-0.2.0 → apple_maps_api-0.2.1}/README.md

@@ -33,7 +33,7 @@ uv add apple-maps-api
 
 ### Basic Setup
 
-You'll need your Team ID, Key ID, and the private key from your Apple Developer account.
+You'll need your Team ID, Key ID, and the private key from your Apple Developer account. Step-by-step portal setup (Maps ID, MapKit JS key, domains/localhost): [`docs/mapkit-js-credential-setup.md`](docs/mapkit-js-credential-setup.md).
 
 ```python
 from apple_maps_api import AppleMapsClient
@@ -43,7 +43,7 @@ client = AppleMapsClient(
     key_id="YOUR_KEY_ID",
     private_key="""-----BEGIN PRIVATE KEY-----
 ...
------END PRIVATE KEY-----"""
+-----END PRIVATE KEY-----""",
 )
 ```
 

{apple_maps_api-0.2.0 → apple_maps_api-0.2.1}/apple_maps_api/__init__.py

@@ -27,11 +27,8 @@ from .models import (
 from .version import __version__
 
 __all__ = [
-    "__version__",
-    "AppleMapsClient",
-    "geocode_coordinates",
-    "geocode_postal_code",
     "AddressCategory",
+    "AppleMapsClient",
     "AutocompleteResult",
     "GeocodeResult",
     "Location",
@@ -47,4 +44,7 @@ __all__ = [
     "SearchResultType",
     "StructuredAddress",
     "TokenResponse",
+    "__version__",
+    "geocode_coordinates",
+    "geocode_postal_code",
 ]

{apple_maps_api-0.2.0 → apple_maps_api-0.2.1}/apple_maps_api/exceptions.py

@@ -1,14 +1,10 @@
 class AppleMapsError(Exception):
     """Base exception for all Apple Maps API errors."""
 
-    pass
-
 
 class AppleMapsAuthError(AppleMapsError):
     """Raised when authentication fails (e.g., invalid JWT, expired token)."""
 
-    pass
-
 
 class AppleMapsRequestError(AppleMapsError):
     """Raised when the API returns a client error (4xx besides 429)."""
@@ -22,8 +18,6 @@ class AppleMapsRequestError(AppleMapsError):
 class AppleMapsRateLimitError(AppleMapsRequestError):
     """Raised when the API returns a 429 Too Many Requests error."""
 
-    pass
-
 
 class AppleMapsServerError(AppleMapsError):
     """Raised when the API returns a 5xx server error."""

apple_maps_api-0.2.1/pyproject.toml

@@ -0,0 +1,74 @@
+[project]
+name = "apple-maps-api"
+version = "0.2.1"
+description = "A modern Python client for the Apple Maps Server API with automatic JWT management and type safety"
+keywords = [
+    "apple-maps",
+    "geocoding",
+    "search",
+    "geolocation",
+]
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "pydantic>=2.12.3",
+    "tenacity>=9.1.2",
+    "PyJWT[crypto]>=2.9.0",
+    "httpx2>=2.7.0",
+    "funcy>=2.0",
+]
+
+[[project.authors]]
+name = "Michael Bianco"
+email = "mike@mikebian.co"
+
+[project.urls]
+Repository = "https://github.com/iloveitaly/apple-maps-api"
+Documentation = "https://iloveitaly.github.io/python-apple-maps-api/"
+
+[build-system]
+requires = ["uv_build>=0.11.17,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = ""
+
+[tool.pyright]
+exclude = [
+    "examples/",
+    "playground/",
+    "tmp/",
+    ".venv/",
+]
+reportCallIssue = "error"
+
+[tool.pytest.ini_options]
+addopts = "--cov --cov-report=term-missing --cov-report=html:tmp/htmlcov"
+
+[tool.coverage.run]
+plugins = ["covdefaults"]
+source = ["apple_maps_api"]
+
+[tool.coverage.report]
+fail_under = 50
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3.4",
+    "pyright[nodejs]>=1.1.408",
+    "ruff>=0.15.15",
+    "coverage>=7.14.1",
+    "pytest-cov>=7.0.0",
+    "covdefaults>=2.3.0",
+    "pytest-httpx2>=1.0.0",
+]
+docs = [
+    "sphinx>=7.1.2",
+    "shibuya",
+    "myst-parser>=2.0.0",
+    "sphinx-design>=0.5.0",
+    "sphinx-copybutton>=0.5.2",
+    "sphinx-autobuild",
+    "sphinx-autoapi",
+    "sphinx-llm",
+]

apple_maps_api-0.2.0/pyproject.toml → apple_maps_api-0.2.1/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "apple-maps-api"
-version = "0.2.0"
+version = "0.2.1"
 description = "A modern Python client for the Apple Maps Server API with automatic JWT management and type safety"
 keywords = ["apple-maps", "geocoding", "search", "geolocation"]
 readme = "README.md"
@@ -14,10 +14,10 @@ dependencies = [
 ]
 
 authors = [{ name = "Michael Bianco", email = "mike@mikebian.co" }]
-urls = { "Repository" = "https://github.com/iloveitaly/apple-maps-api" }
+urls = { "Repository" = "https://github.com/iloveitaly/apple-maps-api", "Documentation" = "https://iloveitaly.github.io/python-apple-maps-api/" }
 
 [build-system]
-requires = ["uv_build>=0.11.17,<0.12"]
+requires = ["uv_build>=0.11.17,<0.13"]
 build-backend = "uv_build"
 
 [tool.uv.build-backend]
@@ -34,6 +34,17 @@ dev = [
     "covdefaults>=2.3.0",
     "pytest-httpx2>=1.0.0",
 ]
+# Sphinx toolchain for local/CI docs builds — not a published package extra
+docs = [
+    "sphinx>=7.1.2",
+    "shibuya",
+    "myst-parser>=2.0.0",
+    "sphinx-design>=0.5.0",
+    "sphinx-copybutton>=0.5.2",
+    "sphinx-autobuild",
+    "sphinx-autoapi",
+    "sphinx-llm",
+]
 
 [tool.pyright]
 exclude = ["examples/", "playground/", "tmp/", ".venv/"]