Metadata-Version: 2.4
Name: hsk-sentences-audio
Version: 1.0.0
Summary: Python loader for 4,354 HSK 3.0 graded Chinese sentences with pinyin, glosses, grammar tags, and dual-speed audio URLs.
Author: hsk-sentences-audio contributors
License: MIT (code); CC-BY-SA-4.0 (packaged dataset)
Project-URL: Homepage, https://github.com/no7z/hsk-sentences-audio
Project-URL: Repository, https://github.com/no7z/hsk-sentences-audio
Keywords: hsk,chinese,mandarin,pinyin,language-learning,dataset
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Classifier: Topic :: Education
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# hsk-sentences-audio

Dependency-free Python loader for 4,354 HSK 3.0 graded Chinese sentences.

```python
from hsk_sentences_audio import audio_url, iter_sentences, load_sentences

print(len(load_sentences()))
card = next(iter_sentences(level=2, topic="food"))
print(card["chinese"], audio_url(card, speed="slow"))
```

The wheel contains the 6.1 MB JSON dataset, not the 169 MB audio collection.
Audio URLs default to the repository's hosted `dist/` assets; pass `base_url`
to use your own CDN.

Code is MIT. The packaged dataset is CC-BY-SA-4.0; retain attribution when
redistributing it. Full provenance is in the repository's `ATTRIBUTION.md`.
