From 279cbe9389b02de963adc8a8fa91c9347fd9aa73 Mon Sep 17 00:00:00 2001 From: worldmozara Date: Fri, 9 Oct 2026 19:46:09 +0800 Subject: [PATCH] core/tools: document fetch's 0-based body offset --- src/plyngent/tools/net/fetch.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/plyngent/tools/net/fetch.py b/src/plyngent/tools/net/fetch.py index 666b6a2..d00ec2b 100644 --- a/src/plyngent/tools/net/fetch.py +++ b/src/plyngent/tools/net/fetch.py @@ -80,6 +80,10 @@ async def fetch( """HTTP request (GET/POST/PUT/DELETE); return status, metadata, and truncated body. Use for public docs/APIs or (after human policy allow) local/LAN servers. + ``offset`` skips that many leading characters of the body (0-based), for + paging through a body larger than ``max_chars``; a body truncated by + ``max_chars`` keeps its remainder in memory instead, resumable via its + ``truncate_token`` without another request. ``user_agent`` sets User-Agent when provided and takes precedence over a User-Agent entry in ``headers``. A headers-only User-Agent is kept as-is. When both omit UA, a small default is used.