Add test infrastructure and GitHub Actions workflow

This commit adds comprehensive test suite and CI/CD setup:

- Add GitHub Actions workflow for automated testing
  - Tests on Python 3.9-3.13 (ordered by real-world likelihood)
  - Includes linting (flake8), formatting (black), import sorting (isort), and type checking (mypy)
  - Uploads coverage to Codecov

- Add comprehensive test suite covering:
  - Client initialization and HTTP methods
  - Error handling (auth, network, API errors)
  - Environment configurations
  - Custom exception classes
  - Data models (BaseModel, BaseResponse)
  - Pools resource operations

- Update pyproject.toml:
  - Switch to Hatchling build backend
  - Add requests dependency
  - Add dev dependencies (pytest, black, flake8, isort, mypy)
  - Configure tool settings for linting and testing
  - Fix TOML syntax for project URLs

Tests are expected to fail until source code is added.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: inntran

.github/workflows/test.yml

@@ -0,0 +1,62 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop, staging ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.14", "3.12", "3.13", "3.9", "3.10", "3.11" ]
+
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+        cache: 'pip'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Lint with flake8
+      run: |
+        # Stop the build if there are Python syntax errors or undefined names
+        flake8 src/tmo_api --count --select=E9,F63,F7,F82 --show-source --statistics
+        # Exit-zero treats all errors as warnings
+        flake8 src/tmo_api --count --exit-zero --max-line-length=88 --extend-ignore=E203,W503 --statistics
+
+    - name: Check formatting with black
+      run: |
+        black --check src/tmo_api tests/
+
+    - name: Check import sorting with isort
+      run: |
+        isort --check-only src/tmo_api tests/
+
+    - name: Type check with mypy
+      run: |
+        mypy src/tmo_api --ignore-missing-imports
+      continue-on-error: true
+
+    - name: Run tests with pytest
+      run: |
+        pytest tests/ -v --cov=tmo_api --cov-report=xml --cov-report=term
+
+    - name: Upload coverage to Codecov
+      if: matrix.python-version == '3.11'
+      uses: codecov/codecov-action@v5
+      env:
+        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: false

pyproject.toml

@@ -8,7 +8,9 @@ authors = [
     { name = "Yinchuan Song", email = "songyinchuan@gmail.com" }
 ]
 requires-python = ">=3.9"
-dependencies = []
+dependencies = [
+    "requests>=2.25.0,<3.0.0",
+]
 keywords = ["TMO", "The Mortgage Office", "Mortgage Pools", "Mortgage Pool Shares"]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -29,9 +31,40 @@ classifiers = [
 ]
 
 [project.urls]
-Repository = https://github.com/inntran/tmo-api-python
-Issues = https://github.com/inntran/tmo-api-python/issues
+Repository = "https://github.com/inntran/tmo-api-python"
+Issues = "https://github.com/inntran/tmo-api-python/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "flake8>=6.0.0",
+    "isort>=5.12.0",
+    "mypy>=1.0.0",
+]
 
 [build-system]
-requires = ["uv_build>=0.9.5,<0.10.0"]
-build-backend = "uv_build"
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tmo_api"]
+
+[tool.black]
+line-length = 100
+target-version = ['py39', 'py310', 'py311', 'py312', 'py313', 'py314']
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=tmo_api --cov-report=term-missing --cov-report=xml"

tests/__init__.py

@@ -0,0 +1 @@
+"""Tests for tmo_api package."""

tests/conftest.py

@@ -0,0 +1,57 @@
+"""Pytest configuration and fixtures."""
+
+import pytest
+
+
+@pytest.fixture
+def mock_token():
+    """Mock API token for testing."""
+    return "test_token_12345"
+
+
+@pytest.fixture
+def mock_database():
+    """Mock database name for testing."""
+    return "test_database"
+
+
+@pytest.fixture
+def mock_pool_account():
+    """Mock pool account for testing."""
+    return "POOL001"
+
+
+@pytest.fixture
+def mock_api_response_success():
+    """Mock successful API response."""
+    return {
+        "Status": 0,
+        "ErrorMessage": None,
+        "ErrorNumber": None,
+        "Data": {"rec_id": 1, "account": "POOL001", "name": "Test Pool"},
+    }
+
+
+@pytest.fixture
+def mock_api_response_error():
+    """Mock error API response."""
+    return {
+        "Status": 1,
+        "ErrorMessage": "Test error message",
+        "ErrorNumber": 500,
+        "Data": None,
+    }
+
+
+@pytest.fixture
+def mock_pools_response():
+    """Mock pools list response."""
+    return {
+        "Status": 0,
+        "ErrorMessage": None,
+        "ErrorNumber": None,
+        "Data": [
+            {"rec_id": 1, "account": "POOL001", "name": "Pool 1"},
+            {"rec_id": 2, "account": "POOL002", "name": "Pool 2"},
+        ],
+    }