feat(httpc): go-hua/httpurl 迁入并更名 httpc(HTTP 客户端)

- 原包名 httpurl 看不出是客户端, 更名 httpc; GET/POST/PUT/DELETE/代理/
  Digest 认证, 函数签名不变, 附测试、例程与 README
This commit is contained in:
2026-09-20 12:25:36 +08:00
parent caa65209ac
commit a8577b7b3b
5 changed files with 547 additions and 0 deletions
+41
View File
@@ -0,0 +1,41 @@
# httpc
轻量 HTTP 客户端:GET/POST/PUT/DELETE 快捷方法(自定义 Header、可选代理)、
Digest 认证请求。
> 迁移自 go-hua/httpurl 并更名:原包名 `httpurl` 看不出是客户端,更名 `httpc`
> (http client)。函数签名不变。
## 用法
```go
import "git.zeroonesoft.cn/golib/zogo/httpc"
body, err := httpc.Get("https://api.example.com/v1/info", nil)
body, err := httpc.Post("https://api.example.com/v1/add", []byte(`{"id":1}`),
map[string]string{"Content-Type": "application/json"})
body, err := httpc.GetProxy(url, nil, "http://127.0.0.1:8080") // 走代理
body, err := httpc.Put(url, payload, nil)
body, err := httpc.Delete(url, nil, nil)
// Digest 认证
resp, err := httpc.DigestAuthRequest(&httpc.RequestArg{
Url: url,
Method: "GET",
Username: "admin",
Password: "pass",
})
```
完整可运行例程:[examples/httpc/main.go](../examples/httpc/main.go)
## 返回与错误
- 2xx 返回响应体字节集;非 2xx 返回包含状态码的错误。
- `Get/Post/Put/Delete` 的 `header` 参数传 `nil` 表示不附加自定义头。
## 注意
- `DigestAuthRequest` 只处理 RFC 2617 Digest 流程(qop=auth);Basic/Bearer
请直接在 header 里带 Authorization。
- 需要 JSON 自动绑定/泛型封装时配合服务端包 `zogo/httpx` 之外的客户端封装自行扩展。