Metadata-Version: 2.4
Name: htmlrun-cli
Version: 0.1.0
Summary: HTMLRun CLI — 把单文件 HTML 发布成可分享的在线链接
License: MIT
Project-URL: Homepage, https://html.run
Keywords: html,publish,cli,htmlrun
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.12
Requires-Dist: requests>=2.31
Requires-Dist: beautifulsoup4>=4.12
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"

# HTMLRun CLI

把本地 HTML 文件发布到 HTMLRun，生成可分享的在线链接。

## 安装

```bash
pip install htmlrun-cli
```

## 使用

先在 https://html.run/web/tokens 创建 publish token：

```bash
htmlrun login --token h_xxxxxxxx
htmlrun publish report.html
```

再次发布同一路径文件会追加新版本，并保持原链接不变。

## 命令

| 命令 | 说明 |
|------|------|
| `htmlrun login --token h_xxx [--base-url URL]` | 保存 token 和服务地址 |
| `htmlrun logout` | 清除本地 token |
| `htmlrun whoami` | 查看当前服务地址与 token 状态 |
| `htmlrun publish FILE [-m 备注] [--new] [--no-inline]` | 发布 HTML 文件 |

## 环境变量

| 变量 | 作用 |
|------|------|
| `HTMLRUN_TOKEN` | publish token |
| `HTMLRUN_BASE_URL` | 服务地址，默认 `https://html.run` |
| `HTMLRUN_CONFIG_DIR` | 配置目录，默认 `~/.htmlrun` |

## 开发发布

```bash
pip install -e ".[dev]"
python -m build
python -m twine upload dist/*
```
