chore: update Python version to 3.9 and enhance type hints in geocode functions

Author: aialok

.github/workflows/ci.yml

@@ -0,0 +1,93 @@
+name: Monorepo CI
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - "libs/javascript/**"
+      - "libs/python/**"
+      - ".github/workflows/**"
+  pull_request:
+    paths:
+      - "libs/javascript/**"
+      - "libs/python/**"
+      - ".github/workflows/**"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  changes:
+    runs-on: ubuntu-latest
+    outputs:
+      javascript: ${{ steps.filter.outputs.javascript }}
+      python: ${{ steps.filter.outputs.python }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Detect changed paths
+        id: filter
+        uses: dorny/paths-filter@v3
+        with:
+          filters: |
+            javascript:
+              - 'libs/javascript/**'
+            python:
+              - 'libs/python/**'
+
+  javascript:
+    name: JavaScript checks
+    needs: changes
+    if: needs.changes.outputs.javascript == 'true'
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: libs/javascript
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: "1.2.20"
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Run checks
+        run: bun run check
+
+  python:
+    name: Python checks
+    needs: changes
+    if: needs.changes.outputs.python == 'true'
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: libs/python
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run lint
+        run: ruff check .
+
+      - name: Run type check
+        run: mypy lakhua --ignore-missing-imports
+
+      - name: Run tests
+        run: pytest
+

libs/python/lakhua/__init__.py

@@ -4,6 +4,8 @@
 This library provides in-memory reverse geocoding using H3 spatial indexing.
 """
 
+from typing import Optional
+
 from lakhua.core import (
     DATA_DIR_NAME,
     DATA_FILE_PREFIX,
@@ -43,8 +45,8 @@
 def geocode(
     lat: float,
     lon: float,
-    options: GeocodeOptions | None = None,
-) -> GeocodeResult | None:
+    options: Optional[GeocodeOptions] = None,
+) -> Optional[GeocodeResult]:
     """
     Reverse geocodes latitude/longitude into India location metadata.
 
@@ -69,8 +71,8 @@ def geocode(
 
 def geocode_h3(
     h3_index: str,
-    options: GeocodeOptions | None = None,
-) -> GeocodeResult | None:
+    options: Optional[GeocodeOptions] = None,
+) -> Optional[GeocodeResult]:
     """
     Reverse geocodes an H3 cell index directly.
 

libs/python/lakhua/core/constants.py

@@ -8,7 +8,7 @@
 
 import json
 from pathlib import Path
-from typing import Dict
+from typing import Dict, cast
 
 # Resolution configuration
 MIN_RESOLUTION: int = 4
@@ -87,5 +87,5 @@ def read_reverse_geo_store(resolution: int) -> Dict[str, Dict[str, str]]:
         return {}
 
     with open(file_path, encoding="utf-8") as f:
-        return json.load(f)
+        return cast(Dict[str, Dict[str, str]], json.load(f))
 

libs/python/pyproject.toml

@@ -58,7 +58,7 @@ select = ["E", "F", "I", "N", "W", "UP"]
 ignore = []
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.9"
 strict = true
 warn_return_any = true
 warn_unused_configs = true