pcurl: comprehensive Chinese help (examples, env vars, exit codes, curl diffs)
This commit is contained in:
1 parent
99e03c9d14
commit
31a88fc7e3
1 file changed
+83
-31
+83
-31
@@ -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()
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user