ausdata-sdk 0.2.0__tar.gz

ausdata_sdk-0.2.0/.gitignore

@@ -0,0 +1,30 @@
+# Build artefacts
+dist/
+build/
+*.egg-info/
+*.egg
+__pycache__/
+*.pyc
+*.pyo
+
+# Virtual envs
+.venv/
+venv/
+env/
+
+# Tooling caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# uv lock retained but exclude editor/system files
+.DS_Store
+.idea/
+.vscode/
+*.swp
+
+# Local env files
+.env
+.env.local

ausdata_sdk-0.2.0/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+All notable changes to this project are documented here. Versioning follows
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] — 2026-05-17
+
+### Distribution
+
+- **PyPI distribution name changed:** `ausdata` → `ausdata-sdk` (the
+  short `ausdata` name was taken by another project on PyPI). The
+  **import path stays `from ausdata import Client`** — no code changes
+  required for existing users. Install command:
+  `pip install ausdata-sdk` (was `pip install ausdata`).
+
+### Added
+
+- `client.whoami()` / `AsyncClient.whoami()` — caller introspection.
+- `client.describe(source, dataset_id)` / async equivalent — schema lookup.
+- `client.list_datasets(source)` / async equivalent — enumerate a source's
+  curated datasets.
+- `client.get_data(source, dataset_id, **filters)` / async equivalent —
+  generic data fetch with kwargs for source-specific dimension filters.
+- `WhoamiResponse` typed model.
+- Drift-detection tests (`tests/test_model_drift.py`) — fail CI when the
+  SDK model fields diverge from the live API response shape.
+
+### Changed
+
+- Default base URL is now `https://ausdata-api.fly.dev` (was the unconfigured
+  `https://api.ausdata.io`). Override via `AUSDATA_BASE_URL` env var or the
+  `base_url` constructor arg.
+- `EconomicDashboard` model gained `consumer_spending_yoy_pct`. The old
+  `lending_housing_change_qoq_pct` field is kept as a deprecated alias and
+  will be removed in v0.2.
+
+## [0.1.0] — 2026-05-16
+
+Initial scaffold.
+
+### Added
+- Synchronous `Client` and asynchronous `AsyncClient` over httpx.
+- API-key resolution: constructor arg, then `AUSDATA_API_KEY` env var.
+- Typed response models mirroring the ausdata-api `ApiResponse` envelope
+  (`Meta`, `Links`, `SourceCitation`, plus per-endpoint payload shapes).
+- Endpoint methods for the v1 MVP surface:
+  - `health()`
+  - `account.api_key()` / `account.rotate_key()`
+  - `search_datasets(q, source, limit)`
+  - `real_wages(start, end, seasonal_adjustment)`
+  - `economic_dashboard(period)`
+- Convenience: `ApiResponse.to_dataframe()` (requires `pandas` extra),
+  `to_csv(path=None)`, `to_json()`.
+- Typed exception hierarchy (`AusdataError`, `AuthenticationError`,
+  `PermissionError`, `RateLimitError`, `ValidationError`, `UpstreamError`,
+  `AusdataServerError`) — each carries the API's hint string.
+- Automatic retry policy: 5xx and 429 retried with exponential backoff,
+  `Retry-After` header respected up to 60s, configurable via constructor.
+- `py.typed` marker so downstream users get full IDE type completion.
+- Test suite (40+ tests) covering successful parsing, auth, errors, retries,
+  pandas integration, and the async surface. All mocked — no live calls.

ausdata_sdk-0.2.0/CLAUDE.md

@@ -0,0 +1,115 @@
+# ausdata-sdk — developer notes
+
+The official Python client library for the hosted REST API at
+[ausdata.io](https://ausdata.io). Layer 3's public face — thin HTTP wrapper,
+not a data engine.
+
+**One-line value prop:** `pip install ausdata-sdk` (imports as `from ausdata import Client`) and call typed methods against
+the hosted API; no MCP runtime, no SDMX parsing, no upstream credentials.
+
+## License
+
+**MIT.** This package is intentionally MIT (not FSL like `ausdata-api`)
+because the SDK is a trivial HTTP wrapper — the moat lives in the API
+backend, not here. Permissive licensing maximises adoption + makes
+enterprise legal teams happy.
+
+The upstream FastAPI in `../ausdata-api/` is FSL-1.1-MIT; that's where
+competitors would lift code and the licence does the work.
+
+## Layout
+
+```
+src/ausdata/
+├── __init__.py        Re-exports Client, AsyncClient, models, exceptions
+├── client.py          Synchronous Client (httpx.Client)
+├── async_client.py    AsyncClient (httpx.AsyncClient)
+├── models.py          Pydantic ApiResponse envelope + per-endpoint payloads
+├── exceptions.py      AusdataError + 6 typed subclasses
+├── py.typed           PEP 561 marker — full IDE type completion downstream
+└── _internal/
+    ├── http.py        API-key resolution, default headers, error mapping
+    └── retry.py       RetryPolicy (5xx + 429 with Retry-After)
+
+tests/
+├── conftest.py        Canned API response fixtures (all mocked via pytest-httpx)
+├── test_client.py     Sync client construction + headers + base_url
+├── test_async_client.py
+├── test_endpoints.py  Success-path test per public method
+├── test_exceptions.py 4xx/5xx → typed exception mapping
+├── test_retry.py      Backoff math + end-to-end retry behaviour
+└── test_to_dataframe.py  pandas/CSV/JSON conversions
+```
+
+## Cross-links
+
+- **API spec** (private): `../API_DESIGN_V1.md` — every endpoint here mirrors
+  what the API exposes. If you add an endpoint method, update both files.
+- **API server** (private): `../ausdata-api/` — when its response shape
+  changes, mirror the change in `models.py` here. Add new optional fields
+  rather than breaking changes whenever possible so old SDK versions stay
+  compatible with new servers.
+- **Portfolio strategy** (private): `../STRATEGY.md` — the SDK is intentionally
+  separate from the 9 sister MCP packages on PyPI; don't blur the line.
+
+## Development
+
+```bash
+cd ausdata-sdk
+uv sync --extra dev
+uv run pytest -q
+uv run ruff check src tests
+uv build
+```
+
+All tests use `pytest-httpx` — there are zero live API calls in the suite.
+This is deliberate: SDK tests should run in CI without secrets and in <2s.
+
+## Test patterns
+
+- One success-path test per endpoint method (see `test_endpoints.py`)
+- One typed-exception test per HTTP status the API uses (`test_exceptions.py`)
+- Retry behaviour is tested both unit-style (`RetryPolicy` math) and
+  integration-style (full `Client.health()` calls with mocked 500s)
+- pandas import failure is tested by patching `builtins.__import__` so the
+  test runs even if pandas is installed in the dev environment
+
+## Anti-patterns — don't do these
+
+- **Don't auto-publish to PyPI.** The user runs `uv publish` when ready.
+  CI here only lints + tests; no Trusted Publishing workflow yet.
+- **Don't push to a public GitHub remote** until the user explicitly creates
+  it. Local commits only for now.
+- **Don't add new runtime dependencies beyond `httpx` + `pydantic`** (plus
+  `pandas` as an optional extra). The SDK's value is being lightweight.
+- **Don't import from any sister MCP package** (`abs_mcp`, `rba_mcp`, etc.).
+  The SDK talks to the hosted API only — that's the whole point of the
+  layered architecture.
+- **Don't build a CLI here.** A future `ausdata-cli` package can wrap this
+  SDK; keep them separate.
+- **Don't reimplement data parsing.** All shaping happens in `ausdata-api`'s
+  composers + the sister MCPs they call.
+- **Don't echo tokens or API keys** in logs, errors, or test output.
+
+## Adding a new endpoint method
+
+1. Confirm the API supports it (`../ausdata-api/src/ausdata_api/routers/`).
+2. Add the payload shape to `src/ausdata/models.py` if it isn't already
+   there. Prefer optional fields so older SDK versions don't break.
+3. Add a method to both `Client` and `AsyncClient` (parameters mirror
+   the API query string, kwarg-only where it improves readability).
+4. Add at least one success-path test (`test_endpoints.py`) and any
+   relevant error-path test (`test_exceptions.py`).
+5. Update `README.md` (endpoint table) + `CHANGELOG.md` (new entry).
+
+## Releasing (when the user is ready)
+
+1. Bump `version` in `pyproject.toml` + `src/ausdata/__init__.py`.
+2. Update `CHANGELOG.md`.
+3. `uv run pytest -q` 10x — zero flakes.
+4. `uv run ruff check src tests` — clean.
+5. `uv build` — wheel + sdist build cleanly.
+6. `uv publish` — **user runs this**, not Claude.
+
+PyPI new-project rate limit: 5 per account per 24h. Plan first publish
+accordingly; the user handles this.

ausdata_sdk-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harry Vass
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ausdata_sdk-0.2.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: ausdata-sdk
+Version: 0.2.0
+Summary: Python SDK for the Australian public data API. Free tier available at ausdata.io.
+Project-URL: Homepage, https://ausdata.io
+Project-URL: Documentation, https://docs.ausdata.io
+Project-URL: Repository, https://github.com/Bigred97/ausdata-sdk
+Project-URL: Issues, https://github.com/Bigred97/ausdata-sdk/issues
+Author: Harry Vass
+License: MIT License
+        
+        Copyright (c) 2026 Harry Vass
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: api,australia,client,mcp,public-data,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.7
+Provides-Extra: dev
+Requires-Dist: pandas>=2.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: pandas
+Requires-Dist: pandas>=2.0; extra == 'pandas'
+Description-Content-Type: text/markdown
+
+# ausdata — Python SDK for the Australian public data API
+
+The official Python client for [ausdata.io](https://ausdata.io). One auth key,
+one uniform response envelope, every major Australian government data source.
+
+```bash
+pip install ausdata-sdk
+# or, with pandas convenience:
+pip install "ausdata-sdk[pandas]"
+```
+
+## Why?
+
+The chart you spend 90 minutes building in Excel — one HTTP call.
+
+```bash
+# Before — wrangling SDMX XML by hand
+curl 'https://api.data.abs.gov.au/data/WPI/...'
+
+# After — typed, normalised, attribution-tagged
+```
+
+```python
+from ausdata import Client
+
+client = Client(api_key="ak_xxx")
+result = client.real_wages(start="2019-Q1", end="2024-Q4")
+
+print(result.data[0])
+# RealWageRow(period='2024-Q4', wpi_annual_change_pct=3.2,
+#             cpi_annual_change_pct=2.4, real_wages_gap_pct=0.8,
+#             real_wages_direction='growing')
+
+df = result.to_dataframe()       # pandas (optional extra)
+result.to_csv("real_wages.csv")  # Datawrapper-friendly
+```
+
+## Async client
+
+```python
+import asyncio
+from ausdata import AsyncClient
+
+async def main():
+    async with AsyncClient(api_key="ak_xxx") as client:
+        snapshot = await client.economic_dashboard()
+        print(snapshot.data.cash_rate_pct, snapshot.data.unemployment_rate_pct)
+
+asyncio.run(main())
+```
+
+## Endpoints
+
+| Method | API endpoint | What you get |
+|---|---|---|
+| `client.health()` | `GET /v1/health` | Service status (no quota cost) |
+| `client.whoami()` | `GET /v1/whoami` | Tier + monthly usage (works for API keys or JWTs) |
+| `client.account.api_key()` | `GET /v1/account/api-key` | Your key + tier + monthly usage (JWT-only) |
+| `client.account.rotate_key()` | `POST /v1/account/api-key` | Rotate the key, get new plaintext (JWT-only) |
+| `client.search_datasets(q=...)` | `GET /v1/search-datasets` | Search across all 9 AU sources |
+| `client.list_datasets(source)` | `GET /v1/datasets/{source}` | Enumerate curated datasets for one source |
+| `client.describe(source, id)` | `GET /v1/describe/{source}/{id}` | Schema: dimensions, valid filters, valid values |
+| `client.get_data(source, id, **filters)` | `GET /v1/data/{source}/{id}` | Fetch any dataset with source-specific filters |
+| `client.real_wages(start=...)` | `GET /v1/real-wages` | WPI YoY minus CPI YoY (composed) |
+| `client.economic_dashboard()` | `GET /v1/economic-dashboard` | 5-source headline macro snapshot (composed) |
+
+The full discover → introspect → fetch loop is:
+
+```python
+r = client.search_datasets(q="unemployment rate")  # find dataset
+schema = client.describe("abs", "LF")              # see valid filters
+data = client.get_data("abs", "LF",                # fetch with right filters
+                       measure="unemployment_rate",
+                       region="nsw", start="2024-01")
+```
+
+Every data response is wrapped in the same `ApiResponse` envelope so you
+always know where to find the payload (`.data`), the attribution (`.meta.sources`),
+and the audit trail (`.meta.retrieved_at`, `.meta.stale`).
+
+## Pricing
+
+| Tier | Price | Calls/mo | Notes |
+|---|---|---|---|
+| Free | $0 | 100 | 1y history, attribution required |
+| Analyst | $29 | 10,000 | 10y history, no attribution |
+| Pro | $99 | 100,000 | Webhooks, priority support |
+| Enterprise | custom | unlimited | SLA, white-label, custom queries |
+
+Sign up + get a free key at [ausdata.io](https://ausdata.io).
+
+## Configuration
+
+```python
+from ausdata import Client
+
+# API key resolution order:
+#   1. explicit api_key= argument
+#   2. AUSDATA_API_KEY environment variable
+client = Client(
+    api_key="ak_xxx",
+    base_url="https://api.ausdata.io",   # override for staging
+    timeout=30.0,                         # per-request timeout (seconds)
+    max_retries=3,                        # 5xx + 429 retry budget
+    retry_backoff_factor=2.0,             # exponential delay multiplier
+)
+```
+
+## Errors
+
+```python
+from ausdata import Client
+from ausdata.exceptions import (
+    AusdataError,         # base
+    AuthenticationError,  # 401
+    PermissionError,      # 403, 402 (tier-blocked)
+    RateLimitError,       # 429 with retry_after
+    ValidationError,      # 400
+    UpstreamError,        # 502/503
+    AusdataServerError,   # 5xx fallback
+)
+
+try:
+    result = client.real_wages(start="not-a-quarter")
+except ValidationError as e:
+    print(e.message, "Hint:", e.hint)
+```
+
+Every error carries the API's message plus the actionable `hint` when
+available (e.g. `"Did you mean 2024-Q1?"`).
+
+## Links
+
+- **Docs**: [docs.ausdata.io](https://docs.ausdata.io)
+- **API reference**: [api.ausdata.io/docs](https://api.ausdata.io/docs)
+- **Issues**: [github.com/Bigred97/ausdata-sdk/issues](https://github.com/Bigred97/ausdata-sdk/issues)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

ausdata_sdk-0.2.0/README.md

@@ -0,0 +1,140 @@
+# ausdata — Python SDK for the Australian public data API
+
+The official Python client for [ausdata.io](https://ausdata.io). One auth key,
+one uniform response envelope, every major Australian government data source.
+
+```bash
+pip install ausdata-sdk
+# or, with pandas convenience:
+pip install "ausdata-sdk[pandas]"
+```
+
+## Why?
+
+The chart you spend 90 minutes building in Excel — one HTTP call.
+
+```bash
+# Before — wrangling SDMX XML by hand
+curl 'https://api.data.abs.gov.au/data/WPI/...'
+
+# After — typed, normalised, attribution-tagged
+```
+
+```python
+from ausdata import Client
+
+client = Client(api_key="ak_xxx")
+result = client.real_wages(start="2019-Q1", end="2024-Q4")
+
+print(result.data[0])
+# RealWageRow(period='2024-Q4', wpi_annual_change_pct=3.2,
+#             cpi_annual_change_pct=2.4, real_wages_gap_pct=0.8,
+#             real_wages_direction='growing')
+
+df = result.to_dataframe()       # pandas (optional extra)
+result.to_csv("real_wages.csv")  # Datawrapper-friendly
+```
+
+## Async client
+
+```python
+import asyncio
+from ausdata import AsyncClient
+
+async def main():
+    async with AsyncClient(api_key="ak_xxx") as client:
+        snapshot = await client.economic_dashboard()
+        print(snapshot.data.cash_rate_pct, snapshot.data.unemployment_rate_pct)
+
+asyncio.run(main())
+```
+
+## Endpoints
+
+| Method | API endpoint | What you get |
+|---|---|---|
+| `client.health()` | `GET /v1/health` | Service status (no quota cost) |
+| `client.whoami()` | `GET /v1/whoami` | Tier + monthly usage (works for API keys or JWTs) |
+| `client.account.api_key()` | `GET /v1/account/api-key` | Your key + tier + monthly usage (JWT-only) |
+| `client.account.rotate_key()` | `POST /v1/account/api-key` | Rotate the key, get new plaintext (JWT-only) |
+| `client.search_datasets(q=...)` | `GET /v1/search-datasets` | Search across all 9 AU sources |
+| `client.list_datasets(source)` | `GET /v1/datasets/{source}` | Enumerate curated datasets for one source |
+| `client.describe(source, id)` | `GET /v1/describe/{source}/{id}` | Schema: dimensions, valid filters, valid values |
+| `client.get_data(source, id, **filters)` | `GET /v1/data/{source}/{id}` | Fetch any dataset with source-specific filters |
+| `client.real_wages(start=...)` | `GET /v1/real-wages` | WPI YoY minus CPI YoY (composed) |
+| `client.economic_dashboard()` | `GET /v1/economic-dashboard` | 5-source headline macro snapshot (composed) |
+
+The full discover → introspect → fetch loop is:
+
+```python
+r = client.search_datasets(q="unemployment rate")  # find dataset
+schema = client.describe("abs", "LF")              # see valid filters
+data = client.get_data("abs", "LF",                # fetch with right filters
+                       measure="unemployment_rate",
+                       region="nsw", start="2024-01")
+```
+
+Every data response is wrapped in the same `ApiResponse` envelope so you
+always know where to find the payload (`.data`), the attribution (`.meta.sources`),
+and the audit trail (`.meta.retrieved_at`, `.meta.stale`).
+
+## Pricing
+
+| Tier | Price | Calls/mo | Notes |
+|---|---|---|---|
+| Free | $0 | 100 | 1y history, attribution required |
+| Analyst | $29 | 10,000 | 10y history, no attribution |
+| Pro | $99 | 100,000 | Webhooks, priority support |
+| Enterprise | custom | unlimited | SLA, white-label, custom queries |
+
+Sign up + get a free key at [ausdata.io](https://ausdata.io).
+
+## Configuration
+
+```python
+from ausdata import Client
+
+# API key resolution order:
+#   1. explicit api_key= argument
+#   2. AUSDATA_API_KEY environment variable
+client = Client(
+    api_key="ak_xxx",
+    base_url="https://api.ausdata.io",   # override for staging
+    timeout=30.0,                         # per-request timeout (seconds)
+    max_retries=3,                        # 5xx + 429 retry budget
+    retry_backoff_factor=2.0,             # exponential delay multiplier
+)
+```
+
+## Errors
+
+```python
+from ausdata import Client
+from ausdata.exceptions import (
+    AusdataError,         # base
+    AuthenticationError,  # 401
+    PermissionError,      # 403, 402 (tier-blocked)
+    RateLimitError,       # 429 with retry_after
+    ValidationError,      # 400
+    UpstreamError,        # 502/503
+    AusdataServerError,   # 5xx fallback
+)
+
+try:
+    result = client.real_wages(start="not-a-quarter")
+except ValidationError as e:
+    print(e.message, "Hint:", e.hint)
+```
+
+Every error carries the API's message plus the actionable `hint` when
+available (e.g. `"Did you mean 2024-Q1?"`).
+
+## Links
+
+- **Docs**: [docs.ausdata.io](https://docs.ausdata.io)
+- **API reference**: [api.ausdata.io/docs](https://api.ausdata.io/docs)
+- **Issues**: [github.com/Bigred97/ausdata-sdk/issues](https://github.com/Bigred97/ausdata-sdk/issues)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

ausdata_sdk-0.2.0/pyproject.toml

@@ -0,0 +1,54 @@
+[project]
+name = "ausdata-sdk"
+version = "0.2.0"
+description = "Python SDK for the Australian public data API. Free tier available at ausdata.io."
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.11"
+authors = [{ name = "Harry Vass" }]
+keywords = ["mcp", "australia", "public-data", "api", "client", "sdk"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27",
+    "pydantic>=2.7",
+]
+
+[project.optional-dependencies]
+pandas = ["pandas>=2.0"]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.23",
+    "pytest-httpx>=0.30",
+    "pandas>=2.0",
+    "ruff>=0.5",
+]
+
+[project.urls]
+Homepage = "https://ausdata.io"
+Documentation = "https://docs.ausdata.io"
+Repository = "https://github.com/Bigred97/ausdata-sdk"
+Issues = "https://github.com/Bigred97/ausdata-sdk/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ausdata"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["E741", "F841", "F401"]

ausdata_sdk-0.2.0/src/ausdata/__init__.py

@@ -0,0 +1,76 @@
+"""Python SDK for the Australian public data API at https://ausdata.io.
+
+Quick start::
+
+    from ausdata import Client
+
+    client = Client(api_key="ak_xxx")     # or set AUSDATA_API_KEY
+    result = client.real_wages(start="2019-Q1", end="2024-Q4")
+    df = result.to_dataframe()
+
+Async equivalent::
+
+    import asyncio
+    from ausdata import AsyncClient
+
+    async def main():
+        async with AsyncClient(api_key="ak_xxx") as client:
+            return await client.real_wages(start="2019-Q1")
+
+    asyncio.run(main())
+"""
+
+from __future__ import annotations
+
+from ._version import __version__
+from .async_client import AsyncClient
+from .client import Client
+from .exceptions import (
+    AusdataError,
+    AusdataServerError,
+    AuthenticationError,
+    PermissionError,
+    RateLimitError,
+    UpstreamError,
+    ValidationError,
+)
+from .models import (
+    AccountResponse,
+    ApiResponse,
+    DatasetSummary,
+    EconomicDashboard,
+    HealthResponse,
+    Links,
+    Meta,
+    RealWageRow,
+    SearchResponse,
+    SourceCitation,
+    WhoamiResponse,
+)
+
+__all__ = [
+    "__version__",
+    # clients
+    "AsyncClient",
+    "Client",
+    # exceptions
+    "AusdataError",
+    "AusdataServerError",
+    "AuthenticationError",
+    "PermissionError",
+    "RateLimitError",
+    "UpstreamError",
+    "ValidationError",
+    # models
+    "AccountResponse",
+    "ApiResponse",
+    "DatasetSummary",
+    "EconomicDashboard",
+    "HealthResponse",
+    "Links",
+    "Meta",
+    "RealWageRow",
+    "SearchResponse",
+    "SourceCitation",
+    "WhoamiResponse",
+]