Metadata-Version: 2.4
Name: lyriktrip-lyra-python-sdk
Version: 0.1.2
Summary: Typed Python SDK for the LyrikTrip DataPipe domain-api.
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: httpx<1.0,>=0.28
Requires-Dist: pydantic<3.0,>=2.10

# lyra-python-sdk

Typed Python SDK for the LyrikTrip Lyra/DataPipe domain API.

PyPI distribution name: `lyriktrip-lyra-python-sdk`.
Python import package: `lyra`.

## Install from proxied GitHub source archive

```bash
pip install "lyriktrip-lyra-python-sdk @ https://proxy.cbotomo.com/https://github.com/Lyrik-AI/lyra-python-sdk/archive/refs/tags/v0.1.2.zip"
```

## Release rule

Every public SDK behavior, exported model, client namespace, dependency, or installation-doc change must:

1. Bump `[project].version` in `pyproject.toml`.
2. Create and push the matching `vX.Y.Z` git tag.
3. Let `.github/workflows/publish-pypi.yml` publish the same version to PyPI as `lyriktrip-lyra-python-sdk`.
4. Verify both the proxied GitHub archive and PyPI release after the workflow succeeds:

```bash
scripts/check-release.sh 0.1.2
```

Detailed release steps live in `docs/release-checklist.md`.

## Development

```bash
uv run --project . pytest tests -q
```

Python import name stays short and stable:

```python
from lyra import AsyncLyraClient
```

`client.route_v2.concierge(route_page_id)` returns the single public concierge chosen by DataPipe route-page bindings. The current public contract does not expose the full concierge binding list.
