README- EConfigLineError
- EConfigOptionError
- EOptionConflict
- EUsageError
- TOptions
curl
curl command for MoonX.
command-line
moonx
wasm
Author
Version
0.2.7
License
Apache-2.0
Repository
Last updated
10 hours ago
Downloads
172
#curl
Transfer HTTP and HTTPS data for MoonX.
Version: cli/curl@0.2.7.
moonx cli/curl@0.2.7 [options...] <url>#Supported scope
Send requests, upload files, follow redirects, manage cookies, retry failures and write responses to stdout or files.
Preserves response and cookie-jar octets, including malformed
UTF-8, and follows the fixed Curl 8.22.0 line, folding, NUL, control-byte and
jar-length rules exercised by the HTTP fixtures. HEAD writes admitted raw
header lines and its buffered cleanup tail; an unterminated status line is an
empty reply. A too-long jar line stops loading with status 100 while retaining
earlier rows. Cookie admission remains command-owned.
-K/--config reads supported options in place, including nested files (five
levels), double-quoted escapes and --url. -K - reads stdin. Default discovery
checks CURL_HOME/.curlrc, XDG_CONFIG_HOME/curlrc and HOME/.curlrc; without
XDG_CONFIG_HOME, .config/curlrc fallbacks are considered. A first -q or
--disable skips discovery. A default-file error retains the accepted prefix
and continues with CLI options; an explicit-file error stops before transfer.
Unsupported option names reject. OS account-database and Windows executable/
APPDATA discovery are not implemented by this environment-based profile.
Version 0.2.6: repeated custom request fields retain their
argument order, including an interleaved User-Agent. Final response fields keep
their order, casing and repetition after optional-whitespace normalization.
Interim fields are excluded. Request Content-Length must be singular; framing
and generated-header validation still apply.
The command also validates __Secure- and __Host- cookies before storage
or jar import, after curl path normalization. Receiving and sending Secure
cookies requires HTTPS or
the exact localhost, 127.0.0.1 or ::1 exception; other HTTP origins cannot
replace or delete an overlapping live Secure cookie. Host-only and domain
cookies keep separate replacement identities. Explicit Cookie text is unchanged.
Header cookie names, values and attributes trim ASCII SP/HTAB before these checks.
#Options
| Option | Description |
|---|---|
| -s, --silent | silent mode |
| -S, --show-error | show errors with --silent |
| -f, --fail | fail on HTTP response codes >= 400 |
| -o, --output <file> | write to file instead of stdout |
| -O, --remote-name | use the remote file name |
| -J, --remote-header-name | use Content-Disposition with -O |
| -L, --location | follow redirects |
| --max-redirs <num> | maximum redirects (default 50) |
| -I, --head | show response headers only |
| -H, --header <header> | send custom fields in order, retaining repeats |
| -K, --config <file> | read supported options; - reads stdin |
| -q, --disable | skip default configuration when placed first |
| --url <url> | add a URL, including from a configuration file |
| -u, --user <user:password> | HTTP Basic authentication |
| -b, --cookie <data\|file> | send cookies or load a Netscape jar |
| -c, --cookie-jar <file> | write a Netscape cookie jar |
| -H 'Cookie: ...' | send a separate field after stored jar cookies |
| -X, --request <method> | specify a supported HTTP method |
| -d, --data <data> | HTTP POST data |
| --data-raw <data> | HTTP POST data without @ expansion |
| --data-binary <data> | HTTP POST data without conversion |
| --data-urlencode <data> | URL-encode HTTP POST data |
| -T, --upload-file <file> | stream file as an upload |
| --retry <num> | retry transient failures |
| --retry-delay <seconds> | wait between retries |
| --retry-max-time <secs> | maximum time spent retrying |
| --retry-connrefused | retry connection refused failures |
| --retry-all-errors | retry all transfer errors |
| --connect-timeout <secs> | maximum connection setup time |
| -m, --max-time <seconds> | maximum time for one transfer |
| --idle-timeout <seconds> | extension: inactivity timeout |
| -k, --insecure | allow insecure TLS connections |
| -x, --proxy <url> | use this proxy |
| --noproxy <list> | bypass proxy for matching hosts |
| --remove-on-error | remove opened output after final failure |
| -O -J | creates valid Content-Disposition filenames exclusively for 2xx/3xx. |
| -sS | keeps each failed attempt's error visible even if a later retry succeeds. |
| --help / --version | Show help / package version. |
#Limitations
- Only HTTP/HTTPS and GET, HEAD, POST, PUT, DELETE, CONNECT, OPTIONS, TRACE and PATCH are supported.
- Name: suppresses a generated field; Name; sends an empty field. -H @file reads header lines and -H @- reads stdin. Explicit duplicate fields retain order. Host and Transfer-Encoding remain transport-managed and reject custom values/removal. Header/config files use UTF-8 text; Cookie files use bytes.
- The command uses the complete pinned ICANN/PRIVATE Public Suffix List for response and imported cookies. Accepted exact public-suffix response domains become host-only before prefix checks; file imports retain curl's localhost exception. Stored domain spellings retain their ASCII case; matching, replacement, secure overlay checks and PSL admission fold ASCII case. Jar output adds a leading Domain dot only when absent. Logical rows save newest creation first; replacing a cookie retains its creation position. Named cookie files reload before each URL operand and CLI retry, but not a redirect within a transfer. Response cookies, including pending expired records, take precedence over file imports until cleanup. -c saves after each URL operand, clearing expired records before the next operand; retries do not save between attempts. -c - writes the fixed Curl jar header and rows to stdout after each operand. Stdin is consumed, not cached for replay. Inputs remain unchanged unless also selected as the output jar. Cookie Domain normalization and complete jar grammar and serialization remain unfinished. Earlier coordinates retain their recorded profile.
- The command converts Unicode URL hosts with the pinned Unicode 15 IDNA profile for UTF-8 environment spellings. LC_ALL, then LC_CTYPE, then LANG selects the input encoding. This checks the UTF-8 suffix, not whether the host has installed that locale. Differential acceptance covers the pinned image's installed C and C.UTF-8 profiles; unavailable named locales can differ from fixed Curl's setlocale behavior. C/POSIX rejects non-ASCII hosts; other legacy encodings are not supported. Percent escapes are decoded before conversion. Canonical hosts govern DNS, TLS SNI, Host, credential origins, cookies and NO_PROXY comparisons; exclusion tokens themselves are not IDNA-converted. Full IRI and configuration behavior beyond the supported-option/environment discovery profile remain open.
- Content-encoded responses remain encoded. A redirect cannot rewind consumed stdin uploads.
- Without -f, a complete retryable HTTP response delivers its body before retry selection. Stdout retains that body; a regular output file resets for an accepted retry. An exhausted or declined retry leaves the actual successful transfer status unchanged. Partial-body and write failures retain precedence.
- Partial stdout remains after failure; files remain unless --remove-on-error is selected. -O -J does not overwrite an existing selected name.
#Examples
moonx cli/curl@0.2.7 https://example.com/
moonx cli/curl@0.2.7 -L -o page.html https://example.com/
Apache-2.0
Updated 10 hours ago
172 downloads