Metadata-Version: 2.4
Name: himalaya-wrapper
Version: 0.1.0
Summary: A lightweight Python wrapper for the Himalaya mail client CLI.
Author-email: Finn Emmerson <finne014@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/FinnE145/himalaya-wrapper
Project-URL: Bug Reports, https://github.com/FinnE145/himalaya-wrapper/issues
Project-URL: Source Code, https://github.com/FinnE145/himalaya-wrapper
Keywords: himalaya,email,cli,mail
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Topic :: Communications :: Email
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Himalaya Wrapper

A lightweight, zero-dependency Python wrapper for the Himalaya mail client CLI.

## Installation

```bash
pip install -e .
```

## Usage

```python
from himalaya_wrapper import HimalayaClient

client = HimalayaClient(
    unread_cmd="himalaya envelope list --folder INBOX --output json --query unread",
    read_cmd="himalaya message read --folder INBOX {id} --output json",
    mark_read_cmd="himalaya flag add --folder INBOX {id} seen",
)

envelopes = client.list_unread_envelopes()
```

## Publish

```bash
python -m build
python -m twine upload dist/*
```

## TestPyPI Release Candidate Flow

Push a release-candidate tag to trigger the TestPyPI workflow:

```bash
git tag v0.1.0-rc1
git push origin v0.1.0-rc1
```

This runs `.github/workflows/publish-testpypi.yml` and publishes to TestPyPI.
