# SseNimHttpClient

**Repository Path**: startvibecoding/SseNimHttpClient

## Basic Information

- **Project Name**: SseNimHttpClient
- **Description**: 纯 Nim 实现的 SSE HTTP 客户端，从零构建 TCP + TLS，零第三方依赖。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-06
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SseNimHttpClient

纯 Nim 实现的 SSE HTTP 客户端，从零构建 TCP + TLS，零第三方依赖。

## 特性

- **零第三方依赖** — 仅用 Nim 标准库
- **从零构建** — 基于 `net.Socket` 实现 TCP/TLS，手动解析 HTTP/1.1
- **HTTPS 支持** — 通过标准库 `net` 的 SSL 上下文，支持证书验证开关
- **SSE 流式传输** — 增量式 Server-Sent Events 解析器
- **jQuery 风格链式 API** — `client("url").get().then(...).catch(...)`
- **Sync + Async 双模式** — 同步阻塞与异步非阻塞 API，均支持 HTTPS
- **应用层超时控制** — 连接、发送、接收均有独立超时

## 安装

```bash
nimble install
```

## 快速开始

```nim
import sse_nim_http_client

# 同步 GET
let res = client("https://api.example.com/data").get()
res.then(proc (r: Response) =
  echo r.status   # 200
  echo r.text()   # body text
).catch(proc (e: ref Exception) =
  echo e.msg
)

# 链式 POST JSON
client("https://api.example.com/users")
  .header("Authorization", "Bearer xxx")
  .post("""{"name":"nim"}""", "application/json")
  .then(proc (r: Response) =
    echo r.json()["id"]
  )

# SSE 流式监听
client("https://api.example.com/events")
  .sse(proc (ev: SseEvent) =
    echo ev.event, ": ", ev.data
  )
```

## 异步 HTTPS

```nim
import std/asyncdispatch
import sse_nim_http_client

proc main() {.async.} =
  let res = await client("https://api.example.com/data")
    .timeout(5000)
    .getAsync()
  echo res.status
  echo res.text()

waitFor main()
```

## 超时控制

```nim
# 同步：连接、发送、接收均受 timeout 控制
client("https://api.example.com/data")
  .timeout(5000)   # 5 秒超时
  .get()

# 异步：同样支持
await client("https://api.example.com/data")
  .timeout(5000)
  .getAsync()
```

## 跳过证书验证（调试）

```nim
client("https://self-signed.local")
  .insecure()      # 跳过 HTTPS 证书验证
  .get()
```

## 文件结构

```
src/
├── sse_nim_http_client.nim    # 主入口 / jQuery 风格 API
├── core/
│   ├── url.nim                # URL 解析
│   ├── connection.nim         # TCP 连接（含超时）
│   └── request.nim            # HTTP 请求构建
├── protocols/
│   └── http11.nim             # HTTP/1.1 响应解析（含 chunked）
├── streaming/
│   └── sse.nim                # SSE 增量解析
└── ssl/
    └── openssl.nim            # TLS/SSL 封装
```

## 编译

```bash
# 需要 -d:ssl 启用 HTTPS 支持
nim c -d:ssl your_app.nim
```

## 测试

```bash
nimble test
```

## 许可证

MIT