README- EUsageError
- TOptions
curl
curl command for MoonX.
command-line
moonx
wasm
Author
Version
0.2.6
License
Apache-2.0
Repository
Last updated
4 days ago
Downloads
173
#curl
Transfer HTTP and HTTPS data for MoonX.
moonx cli/curl@0.2.6 [options...] <url>#Supported scope
Send requests, upload files, follow redirects, manage cookies, retry failures and write responses to stdout or files.
Unreleased workspace correction: 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 published coordinate is unchanged.
The workspace 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 |
| -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.
- Header removal, semicolon empty-field syntax and header files are not yet supported; Host and Transfer-Encoding remain transport-managed.
- The workspace 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. Published coordinates retain their recorded profile.
- The unpublished workspace 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 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.6 https://example.com/
moonx cli/curl@0.2.6 -L -o page.html https://example.com/
Apache-2.0
Updated 4 days ago
173 downloads