pcurl: comprehensive Chinese help (examples, env vars, exit codes, curl diffs)

This commit is contained in:
vex1023 committed 2026-10-01 10:56:11 +08:00
1 parent 99e03c9d14
commit 31a88fc7e3
1 file changed
+83 -31
+83 -31
View File
@@ -1,32 +1,89 @@
#!/usr/bin/env python3 #!/usr/bin/env python3
"""pcurl — curl-like client backed by primp (rnet core, browser TLS/JA3 fingerprint). """pcurl — curl 风格命令行,primp 内核(浏览器 TLS/JA3 指纹)
Drop-in replacement for the common curl use cases. Anything not recognized 用法:
falls back to real curl (with --no-fingerprint passthrough disabled). pcurl [选项] <URL>
Usage: 描述:
pcurl [options] <url> pcurl 是 curl 的常用子集平替,底层用 primp(rnet 内核)发送请求,
Options (curl-compatible subset): 默认模拟 Chrome 的 TLS/JA3 指纹与 User-Agent,用于访问有反爬
-X, --method <M> HTTP method (default GET; POST auto with -d) (TLS 指纹检测)的站点。常规管道用法与 curl 一致:
-d, --data <data> request body (repeatable, joined with &) 响应体写 stdout,状态信息写 stderr,因此 `pcurl url | jq` 无需 -s。
--data-raw <data> same as -d (@file NOT supported)
-H, --header <h> extra header "Name: value" (repeatable) 常用示例:
-F, --form <f> multipart field "k=v" or "k=@file" pcurl https://api.github.com/zen # GET(Chrome 指纹)
-o, --output <file> write body to file (- = stdout) pcurl -s https://httpbin.org/get # -s 静默(不打印状态行)
-L, --location follow redirects pcurl -si https://example.com # -i 输出含响应头
-k, --insecure accept invalid certs pcurl -o page.html https://example.com # 响应体落盘
-s, --silent suppress status line pcurl -L https://example.com/redirect # 跟随重定向(最多 10 跳)
-i, --include include response headers in output pcurl -X POST https://httpbin.org/post -d 'a=1&b=2' # 表单(自动带 urlencoded CT)
-I, --head HEAD request pcurl -d 'a=1' -d 'b=2' URL # 多个 -d 用 & 拼接
-j, --json shorthand: -H content-type:application/json -d @- pcurl -H 'Authorization: Bearer xxx' URL # 自定义请求头(可重复)
--impersonate <p> primp profile (chrome_146 default; primp 2.x also: chrome_145, firefox, safari, edge) echo '{"k":"v"}' | pcurl -j https://httpbin.org/post # JSON 快捷(读 stdin)
--proxy <url> proxy for this request (default: $PRIMP_PATCH_PROXY/$HTTPS_PROXY) pcurl -j -d '{"k":"v"}' URL # JSON 快捷(直接给数据)
--max-time <sec> total timeout pcurl -F 'file=@photo.jpg' -F 'caption=hi' URL # multipart 上传
--compressed accepted for curl compat (primp always handles) pcurl -I https://example.com # HEAD 请求
--no-fingerprint plain HTTP (no TLS impersonation) pcurl -k https://self-signed.badssl.com/ # 忽略证书错误
-v, --verbose print request summary to stderr pcurl --max-time 10 --proxy http://127.0.0.1:7890 URL
-h, --help this help pcurl --impersonate firefox URL # 换指纹档位
Exit codes follow curl: 0 ok, 6 host resolve, 7 connect, 22 --fail, 28 timeout. pcurl --no-fingerprint URL # 关闭 TLS 伪装(普通客户端)
pcurl -f https://httpbin.org/status/404 # 4xx/5xx 时 exit 22,不输出 body
选项 (curl 兼容子集):
请求:
-X, --method <M> HTTP 方法(默认 GET;有 -d/-F 时自动 POST)
-d, --data <data> 请求体;可重复,多个值用 & 拼接;自动附加
Content-Type: application/x-www-form-urlencoded
(除非显式用 -H 指定过 Content-Type)
--data-raw <data> 同 -d(不支持 @file 语法)
-H, --header <h> 请求头 "Name: value"(可重复)
-F, --form <f> multipart 字段 "k=v" 或 "k=@file"(可重复)
-j, --json JSON 快捷:自动加 Content-Type: application/json,
数据来自 -d 或 stdin;合法 JSON 时结构化发送
-I, --head 发 HEAD 请求
-e (无) 不支持,请用 -H 'Referer: ...'
响应控制:
-o, --output <file> 响应体写入文件(- 表示 stdout,默认)
-i, --include 输出中包含响应头(HTTP/1.1 200 风格)
-s, --silent 不向 stderr 打印状态行
-f, --fail 状态码 >= 400 时不输出 body 且 exit 22
-L, --location 跟随 3xx 重定向(最多 10 跳)
--compressed 兼容 curl 而已——primp 始终自动处理压缩
连接与安全:
-k, --insecure 跳过 TLS 证书校验
--proxy <url> 本请求使用的代理;默认取环境变量
$PRIMP_PATCH_PROXY,其次 $HTTPS_PROXY
-m, --max-time <sec> 总超时秒数(默认 30)
--impersonate <p> TLS 指纹档位。primp 2.x 可用:
chrome_146(默认)/ chrome_145 / firefox /
safari / edge;也可用环境变量 $PCURL_IMPERSONATE
--no-fingerprint 不做 TLS 伪装(使用客户端原生指纹)
其他:
-v, --verbose 在 stderr 打印请求摘要
-h, --help 本帮助
环境变量:
PRIMP_PATCH_PROXY 默认代理(如 http://127.0.0.1:7890)
HTTPS_PROXY 次选默认代理
PCURL_IMPERSONATE 默认指纹档位(--impersonate 可覆盖)
退出码(对齐 curl):
0 成功(含 4xx/5xx,除非 --fail)
2 用法错误(未知选项、缺 URL 等)
6 域名解析失败
7 连接失败
22 --fail 时收到 4xx/5xx
28 超时
与 curl 的差异:
* 只支持单个 URL
* 不支持 -w/--write-out、--resolve、-u(Basic 认证请用 -H
'Authorization: Basic ...')、cookie 文件(-b/-c)、@file 请求体
* 遇到不认识的选项会明确报错(退出码 2),不会静默转发给真 curl
* -d 自动附加 form-urlencoded 头(与 curl 一致),但 JSON 场景请用 -j
""" """
import sys, os, json as _json import sys, os, json as _json
@@ -185,13 +242,8 @@ def main():
outf.write(content) outf.write(content)
if args['output'] not in (None, '-'): if args['output'] not in (None, '-'):
outf.close() outf.close()
# like curl -o: also support -w style? keep simple
sys.exit(0 if status < 400 else (22 if args['fail'] else 0)) sys.exit(0 if status < 400 else (22 if args['fail'] else 0))
if __name__ == '__main__':
main()
def cli(): def cli():
main() main()