Metadata-Version: 2.4
Name: zt-zlp-cli
Version: 0.1.0
Summary: ZLP CLI
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: playwright>=1.40.0
Requires-Dist: requests>=2.31.0
Requires-Dist: click>=8.1.0
Requires-Dist: pyyaml>=6.0

# zt-zlp-cli

ZLP 日志管理平台 命令行工具，用于登录并查询实例、库、表结构与 SQL 结果。

## 环境要求

- Python `>=3.10`
- 可用浏览器（首次登录会自动打开）

## 安装

### 开发安装（源码）

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

### 打包发布

```bash
python -m pip install --upgrade build twine
python -m build
twine upload dist/*
```

## 快速开始

### 1) 登录并缓存 Cookie

首次运行会打开浏览器，请完成登录。成功后会缓存 Cookie 到本地。

```bash
zt-zlp-cli login
```

### 2) 获取系统列表

```bash
zt-zlp-cli discover systems
```

### 3) 获取服务列表

```bash
zt-zlp-cli discover services --system LMS --log-type json
```

### 4) 获取表结构
```bash
zt-zlp-cli discover fields \
  --log-type json \
  --system LMS \
  --service fbu-lms-tracking-outgoing-pro-json \
  --start-time "2026-04-14 20:18:22" \
  --end-time "2026-04-14 20:33:22" \
  --query-statement ""
```

### 5) 日志搜索

```bash
zt-zlp-cli discover logs \
  --system LMS \
  --service fbu-lms-labelservice-pro-json \
  --log-type json \
  --custom-sql "select topic,ClientIp,PrintMethod from \$table limit 10" \
  --query-statement "SiteName = 'CN'" \
  --start-time "2026-04-12 00:00:00" \
  --end-time "2026-04-14 23:59:59"
```

## 全局参数
- `-o, --output`：输出格式，支持：
  - `json`（默认）
  - `human`（表格）

示例：

```bash
zt-zlp-cli -o human sql instances
```

## 配置说明

默认配置目录：`~/.zt-zlp-cli`
- Cookie 缓存：`~/.zt-zlp-cli/cookies.json`
- 配置文件：`~/.zt-zlp-cli/config.yaml`

## 环境变量（可选）

支持通过环境变量自动填充登录页账号密码（如 SSO 页面字段可用）：

- `ZT_SSO_USERNAME`
- `ZT_SSO_PASSWORD`

未设置时可在浏览器中手动完成登录。
