feat: enhance CI pipeline with e2e test support

- Split test execution into unit tests and e2e tests

- Add conditional e2e test execution based on API key availability

- Configure GEOCODIO_API_KEY secret for e2e test authentication

- Add verbose output for e2e tests to aid debugging

- Maintain existing linting step in workflow

- Unit tests run always, e2e tests run only when API key is provided

Author: funkatron

.github/workflows/ci.yml

@@ -27,9 +27,21 @@ jobs:
           uv pip install .
           uv pip install .[dev]
 
-      - name: Run tests
+      - name: Run unit tests
         run: |
-          uv run pytest
+          uv run pytest tests/unit/
+
+      - name: Run e2e tests
+        env:
+          GEOCODIO_API_KEY: ${{ secrets.GEOCODIO_API_KEY }}
+        run: |
+          if [ -n "$GEOCODIO_API_KEY" ]; then
+            echo "Running e2e tests with API key"
+            uv run pytest tests/e2e/ -v
+          else
+            echo "No API key provided, skipping e2e tests"
+            uv run pytest tests/e2e/ --collect-only
+          fi
 
       - name: Lint with flake8
         run: |