How to Build an Adapter to Translate External API Responses in Python

import json
from typing import Dict, Any


class ExternalAPI:
    """Mock external service returning a different data shape."""
    def get_user(self, user_id: int) -> Dict[str, Any]:
        return {
            "id": user_id,
            "full_name": "Jane Doe",
            "email_address": "jane@example.com",
            "phn": "555-1234"
        }


class UserAdapter:
    """Adapts ExternalAPI response to the expected internal format."""
    def __init__(self, external_api: ExternalAPI):
        self._api = external_api

    def get_user(self, user_id: int) -> Dict[str, Any]:
        raw = self._api.get_user(user_id)
        return {
            "user_id": raw["id"],
            "name": raw["full_name"],
            "email": raw["email_address"],
            "phone": raw["phn"]
        }


if __name__ == "__main__":
    adapter = UserAdapter(ExternalAPI())
    result = adapter.get_user(101)
    print(json.dumps(result, indent=2))