Metadata-Version: 2.4
Name: hnterminal-sdk
Version: 0.0.1
Summary: Python SDK for the HNTerminal project — a high-information-density Hacker News reader with an intelligence layer.
Project-URL: Homepage, https://github.com/pghqdev/HNTerminal
Project-URL: Repository, https://github.com/pghqdev/HNTerminal
Project-URL: Issues, https://github.com/pghqdev/HNTerminal/issues
Author-email: pghqdev <242389565+pghqdev@users.noreply.github.com>
License-Expression: MIT
License-File: LICENSE
Keywords: hacker-news,hn,hnterminal,reader,sdk,terminal
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# hnterminal-sdk

> Python SDK for [HNTerminal](https://github.com/pghqdev/HNTerminal) — a high-information-density Hacker News reader.

This is the **minimal early release (v0.0.1)**. It fetches public Hacker News
data with zero dependencies (stdlib only). Computed signals (velocity, heat,
controversy) from the HNTerminal intelligence layer land in later releases.

Looking for the terminal client? `npx hnterminal`.

## Install

```sh
pip install hnterminal-sdk
```

Requires Python 3.9+.

## Usage

```python
import hnterminal_sdk as hn

for story in hn.stories("top", limit=10):
    print(story["score"], story["title"])

hn.stories("show")        # Show HN
hn.item(8863)             # one item by id
hn.user("pg")             # user profile
```

Sections: `top` (default), `new`, `best`, `ask`, `show`, `job`.

## License

MIT
