# shttp

**Repository Path**: menciis/shttp

## Basic Information

- **Project Name**: shttp
- **Description**: 应用于扫描器场景下的http基础库
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-09-14
- **Last Updated**: 2024-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# shttp
## Intro

应用于扫描器场景下的http基础库(https://github.com/xiecat/xhttp tag:v0.1.4)。

1. client

   - 精准的http client配置：目前支持支持19项
   - 多client共享cookie
   - 跳转策略
   - 失败重试
   - 代理
   - tls
   - limiter：qps限制
2. request

   - context
   - trace
   - getbody：获取请求body
   - getRaw：获取请求报文
3. response

   - getLatency：发起请求到收到响应的整个持续时间，可用于判断时间延时场景，如盲注
   - getbody：获取响应body
   - getRaw：获取响应报文
4. requestMiddleware：请求发起之前，对请求的修饰
   - context
   - method 限制策略
   - 启用 trace 
   - 根据配置修改header
   - 根据配置修改cookie
5. responseMiddleware：响应获取后，对响应的处理
   - 读body
   - 响应长度限制策略
6. debug模式：debug模式下将打印请求和响应完整信息
7. 完整的 testhttp server

## Install


## Demo

```go
// 如果要继承cookie，传入cookie jar；否则填nil。
cookieJar, _ := cookiejar.New(&cookiejar.Options{PublicSuffixList: publicsuffix.List})
ctx := context.Background()
client, err := NewDefaultClient(cookieJar)
// 构造请求
hr, _ := http.NewRequest("GET", "<TARGET URL>" , nil)
req := &Request{RawRequest: hr,}

// 发起请求
resp, err := client.Do(ctx, req)
```

## Todo

- errorHook

## Ref

- https://github.com/go-resty/resty
- https://github.com/hashicorp/go-retryablehttp