bma-opendata 0.1.0

Typed SDK for the Bangkok Open Data CKAN Action API

Bangkok Open Data Python SDK

ไทย.

---

Lightweight wrapper around the Bangkok CKAN Action API with typed models, caching, and friendly error handling.

Installation

pip install bma-opendata

# or install from a local checkout for development
pip install -e .

Usage

import logging
from bma_opendata import BangkokOpenDataClient

logging.basicConfig(level=logging.INFO)

with BangkokOpenDataClient() as client:
    ids = client.list_datasets().result
    if ids:
        dataset = client.get_dataset(name=ids[0]).result
        logging.info("Dataset %s has %s resources", dataset.title, len(dataset.resources))

Examples

Additional runnable examples live under examples/ and cover listing datasets and searching with filters. Run them with your preferred tool, e.g.:

uv run python -m examples.list_datasets
uv run python -m examples.search_by_format --query water --format JSON

Headers & authentication

The portal occasionally blocks default python-requests clients.
The SDK now sends a browser-like User-Agent automatically; override it with the BMA_OPENDATA_USER_AGENT environment variable or by passing headers={"User-Agent": "..."}.
If you have a CKAN API token, either set BMA_OPENDATA_API_KEY or pass api_key= to the client to authorize requests.