API Client Generator

Generated a standalone Python client based on your OpenAPI spec. The code uses urllib.request and dataclasses for zero-dependency integration.

Python API Client (petstore_client.py)

import json
import time
import urllib.request
import urllib.error
from dataclasses import dataclass, asdict
from typing import List, Optional, Dict, Any

class APIError(Exception):
    def __init__(self, message, status_code=None):
        self.message = message
        self.status_code = status_code
        super().__init__(self.message)

@dataclass
class Pet:
    id: int
    name: str
    tag: Optional[str] = None

class PetStoreClient:
    def __init__(self, base_url: str, token: str = None, timeout: int = 30):
        self.base_url = base_url.rstrip('/')
        self.token = token
        self.timeout = timeout

    def _request(self, method: str, path: str, params: Dict = None, data: Any = None):
        url = f"{self.base_url}{path}"
        if params:
            query = urllib.parse.urlencode(params)
            url += f"?{query}"
        
        req = urllib.request.Request(url, method=method)
        if self.token:
            req.add_header("Authorization", f"Bearer {self.token}")
        if data:
            req.add_header("Content-Type", "application/json")
            req_data = json.dumps(data).encode("utf-8")
        else:
            req_data = None

        retries = 3
        for attempt in range(retries):
            try:
                with urllib.request.urlopen(req, data=req_data, timeout=self.timeout) as resp:
                    return json.loads(resp.read().decode("utf-8"))
            except urllib.error.HTTPError as e:
                if (e.code == 429 or e.code >= 500) and attempt < retries - 1:
                    time.sleep(2 ** attempt)
                    continue
                raise APIError(e.reason, e.code)
            except Exception as e:
                raise APIError(str(e))

    def list_pets(self, limit: int = 10) -> List[Pet]:
        """List all pets"""
        res = self._request("GET", "/pets", params={"limit": limit})
        return [Pet(**item) for item in res]

    def get_pet(self, pet_id: str) -> Pet:
        """Find pet by ID"""
        res = self._request("GET", f"/pets/{pet_id}")
        return Pet(**res)

Next steps

1. Save the code to petstore_client.py.
2. Initialize with client = PetStoreClient(base_url="https://api.petstore.com", token="YOUR_KEY").
3. Call client.list_pets() to fetch data with full type hinting.