86 lines
2.4 KiB
Markdown
86 lines
2.4 KiB
Markdown
---
|
|
markup: occlusion
|
|
title: lib/net
|
|
description: English HTTP(S) wrappers. Optional headers / content_type via host aliases.
|
|
---
|
|
|
|
English HTTP(S) wrappers. Optional headers / content_type via host aliases.
|
|
|
|
## http_get
|
|
+ `url`
|
|
+ `headers`=None
|
|
|
|
HTTPS supported. Optional named arg `headers=` (map). Responses are capped at 8 MiB before decoding, so an upstream cannot exhaust the interpreter's memory.
|
|
|
|
*> host_http_get url=`url` headers=`headers`*
|
|
|
|
## http_post
|
|
+ `url`
|
|
+ `body`
|
|
+ `content_type`=None
|
|
+ `headers`=None
|
|
|
|
Default content type is JSON. Optional `content_type=` / `headers=` (map).
|
|
|
|
*> host_http_post url=`url` body=`body` content_type=`content_type` headers=`headers`*
|
|
|
|
## http_post_sse
|
|
+ `url`
|
|
+ `body`
|
|
+ `content_type`=None
|
|
+ `headers`=None
|
|
+ `echo`=False
|
|
|
|
POST and consume OpenAI-compatible SSE. Returns `{status, events}` where `events` is a list of `{type, …}` maps (`delta` / `done` / `error`). Optional `echo=True` prints delta text to stdout as chunks arrive.
|
|
|
|
*> host_http_post_sse url=`url` body=`body` content_type=`content_type` headers=`headers` echo=`echo`*
|
|
|
|
## openai_sse_parse
|
|
+ `text`
|
|
+ `echo`=False
|
|
|
|
Offline: parse an OpenAI chat SSE body into the same event list (no network).
|
|
|
|
*> host_openai_sse_parse text=`text` echo=`echo`*
|
|
|
|
## http_request
|
|
+ `method`
|
|
+ `url`
|
|
+ `body`=None
|
|
+ `content_type`=None
|
|
+ `headers`=None
|
|
|
|
Optional `body=` / `content_type=` / `headers=`.
|
|
|
|
*> host_http_request method=`method` url=`url` body=`body` content_type=`content_type` headers=`headers`*
|
|
|
|
## url_encode
|
|
+ `text`
|
|
|
|
Percent-encode a URL segment. Spaces become `%20` (not form/query `+`), so literal `+` remains unambiguous in paths.
|
|
|
|
*> host_url_encode text=`text`*
|
|
|
|
## cookie_parse
|
|
+ `text`
|
|
+ `is_response`=False
|
|
|
|
Parse a `Cookie` request header (default) or one or more `Set-Cookie` response headers (`is_response=True`) into a list of `{name, value, path, domain, expires, max_age, secure, http_only, same_site}`.
|
|
|
|
*> host_cookie_parse text=`text` is_response=`is_response`*
|
|
|
|
## multipart_parse
|
|
+ `body`
|
|
+ `boundary`
|
|
|
|
Parse a `multipart/form-data` request body (given its `boundary`) into a list of `{name, filename?, content_type?, value}` parts.
|
|
|
|
*> host_multipart_parse body=`body` boundary=`boundary`*
|
|
|
|
## markdown_parse
|
|
+ `text`
|
|
|
|
Parse Markdown / GFM into HTML (pure transform, no network I/O).
|
|
|
|
*> host_markdown_parse text=`text`*
|