Skip to content

Latest commit

 

History

History
222 lines (189 loc) · 12.5 KB

message-codes-network.md

File metadata and controls

222 lines (189 loc) · 12.5 KB
SPDX-FileCopyrightText 2026-present Arthit Suriyawongkul
SPDX-FileType DOCUMENTATION
SPDX-License-Identifier CC0-1.0

Message codes: Network

See also: Message codes (the index of every code) and Messages and codes (the line grammar, what a code guarantees and when to trust one).

Trust a code only when the line is one of the lines below, a value in place of each <name>, after at most one prefix: the index lists the prefixes and the values.

Codes

Code Level Means Since
download-network-failed ERROR, WARNING A request to a remote source failed. PyPI or Hugging Face: an HTTP status other than 404 (a 401 or 403 for a private or gated repository read without access), a refused or reset connection, a name that did not resolve, or an answer cut short. Git: git could not reach the repository (a name that did not resolve, a refused, reset or timed-out connection, a TLS failure, an HTTP 5xx answer); a git failure with any other cause carries no code. 0.24.0
download-timeout ERROR, WARNING A request to PyPI, to the host that serves a file or to the Hugging Face Hub, or the git calls that fetch a repository, did not finish within the time Pitloom allows. 0.24.0
offline-unusable ERROR, WARNING Offline mode is on and the target must be fetched: a Git URL, a PyPI URL or a Hugging Face repository. Offline mode is --offline, the offline key of --config, or offline=True; for a file of a Hugging Face repository also huggingface_hub's own HF_HUB_OFFLINE. 0.24.0
query-no-effect INFO The PyPI URL given holds a query or a fragment (a tab of the page), which names no project or release. 0.24.0
url-moved INFO PyPI, or the host serving a file, redirected a request to another URL on a host Pitloom reads PyPI from (a renamed project, a normalised name). 0.24.0
url-moved/hf-endpoint INFO huggingface_hub's HF_ENDPOINT names a Hub other than https://huggingface.co (a mirror, a private Hub). 0.24.0
url-unsafe ERROR, WARNING Pitloom would have to send a request somewhere it does not: a redirect to a URL that is not https or not on a host it reads PyPI or a Hugging Face file from, more redirects than it follows, or a file whose download URL PyPI gives on another host. 0.24.0
url-unsafe/hf-endpoint WARNING huggingface_hub's HF_ENDPOINT names a Hub that is not an https URL, or one holding user information, a query or a fragment. The Hugging Face token must not be sent over plain http. 0.24.0
url-unsafe/host-spelling ERROR A Git URL's host holds a non-ASCII character (a full-width or ideographic dot, a full-width letter, an international name not in its xn-- form) or a percent-encoding. git (through curl) maps it to another host than the URL's text names, past every check that reads that text (a PyPI host is never cloned). Or it holds a character no host name holds (=, !, ;, white space, a leading - or .), the shape of an option or a setting smuggled into git's command line, or is a name in brackets ([v1.x]), which would lose them and name a DNS host. An IPv6 zone id ([fe80::1%25eth0]) is refused too. 0.24.0

download-network-failed

  • Level: ERROR, WARNING. As an ERROR, the command stops for that input and writes nothing for it (exit 1).

  • Means: A request to a remote source failed. PyPI or Hugging Face: an HTTP status other than 404 (a 401 or 403 for a private or gated repository read without access), a refused or reset connection, a name that did not resolve, or an answer cut short. Git: git could not reach the repository (a name that did not resolve, a refused, reset or timed-out connection, a TLS failure, an HTTP 5xx answer); a git failure with any other cause carries no code.

  • SBOM effect: not-written: no SBOM is written for the input.

  • Pitloom did: Wrote no SBOM (the error: pypi.download-failed, git.clone-failed); for a Hugging Face file, left that file out and read the rest (the warning).

  • Tell the user: the request failed, with the reason the line gives. They check the network and run again; for a private or gated Hugging Face repository (HTTP 401 or 403) they sign in with an account that has access (HF_TOKEN, or 'hf auth login'). Do not retry in a loop or sign in for them; ask first, and with nobody to ask, report it only.

  • Lines:

    ERROR: URL=<url>: <failure>; not read [download-network-failed]
    ERROR: git <command> failed: <error>; nothing fetched [download-network-failed]
    WARNING: URL=<url>: <failure>; <outcome> [download-network-failed]
    

download-timeout

  • Level: ERROR, WARNING. As an ERROR, the command stops for that input and writes nothing for it (exit 1).

  • Means: A request to PyPI, to the host that serves a file or to the Hugging Face Hub, or the git calls that fetch a repository, did not finish within the time Pitloom allows.

  • SBOM effect: not-written: no SBOM is written for the input.

  • Pitloom did: Stopped the request and wrote no SBOM (the error: pypi.download-timeout, git.timeout); for a Hugging Face file, left that file out and read the rest (the warning).

  • Tell the user: the request timed out. They check the network and run again, or fetch the file or repository themselves and run Pitloom on the local copy. Do not retry in a loop; ask first, and with nobody to ask, report it only.

  • Lines:

    ERROR: URL=<url>: no complete answer within <seconds> seconds; not read [download-timeout]
    ERROR: git <command> did not finish within <seconds> seconds; stopped [download-timeout]
    WARNING: URL=<url>: no complete answer within <seconds> seconds; <outcome> [download-timeout]
    

offline-unusable

  • Level: ERROR, WARNING. As an ERROR, the command stops for that input and writes nothing for it (exit 1).

  • Means: Offline mode is on and the target must be fetched: a Git URL, a PyPI URL or a Hugging Face repository. Offline mode is --offline, the offline key of --config, or offline=True; for a file of a Hugging Face repository also huggingface_hub's own HF_HUB_OFFLINE.

  • SBOM effect: not-written: no SBOM is written for the input.

  • Pitloom did: Fetched nothing and wrote no SBOM (the error: git.offline, pypi.offline, huggingface.offline); for a Hugging Face file under HF_HUB_OFFLINE, left that file out and read the rest (the warning).

  • Tell the user: the target must be fetched and offline mode forbids it. They run again without offline mode (no --offline, offline = false in the config, HF_HUB_OFFLINE unset), or fetch the repository or file themselves and run Pitloom on the local copy. Do not turn offline mode off for them; ask first, and with nobody to ask, report it only.

  • Lines:

    ERROR: URL=<url>: network access is forbidden (offline mode); nothing fetched [offline-unusable]
    WARNING: URL=<url>: network access is forbidden (offline mode); <outcome> [offline-unusable]
    

query-no-effect

  • Level: INFO.

  • Means: The PyPI URL given holds a query or a fragment (a tab of the page), which names no project or release.

  • SBOM effect: none: the SBOM states what the input holds.

  • Pitloom did: Read the URL without them.

  • Nothing to do: nothing to do: the project and release are read from the path.

  • Lines:

    INFO: URL=<url>: the query and fragment have no effect; cut [query-no-effect]
    

url-moved

  • Level: INFO.

  • Means: PyPI, or the host serving a file, redirected a request to another URL on a host Pitloom reads PyPI from (a renamed project, a normalised name).

  • SBOM effect: none: the SBOM states what the input holds.

  • Pitloom did: Checked the target and followed it.

  • Nothing to do: nothing to do: the line names where the answer came from.

  • Lines:

    INFO: URL=<url>: redirects to <target>; followed [url-moved]
    

url-moved/hf-endpoint

  • Level: INFO.

  • Means: huggingface_hub's HF_ENDPOINT names a Hub other than https://huggingface.co (a mirror, a private Hub).

  • SBOM effect: none: the SBOM states what the input holds.

  • Pitloom did: Fetched the Hugging Face files from it, the token sent to it only.

  • Nothing to do: nothing to do: the line names where the files came from.

  • Lines:

    INFO: URL=<url>: the Hub HF_ENDPOINT names; Hugging Face files are fetched from it [url-moved/hf-endpoint]
    

url-unsafe

  • Level: ERROR, WARNING. As an ERROR, the command stops for that input and writes nothing for it (exit 1).

  • Means: Pitloom would have to send a request somewhere it does not: a redirect to a URL that is not https or not on a host it reads PyPI or a Hugging Face file from, more redirects than it follows, or a file whose download URL PyPI gives on another host.

  • SBOM effect: not-written: no SBOM is written for the input.

  • Pitloom did: Did not follow the redirect or fetch the file, and wrote no SBOM (the error); for a Hugging Face file, left that file out and read the rest (the warning).

  • Tell the user: which URL was not followed and why, as the line says. A mirror or proxy that redirects is not supported; they may download the file themselves and run Pitloom on it. Do not fetch the target for them; ask first, and with nobody to ask, report it only.

  • Lines:

    ERROR: URL=<url>: redirects to <target>; not followed (<why>) [url-unsafe]
    ERROR: URL=<url>: more than <number> redirects; not followed [url-unsafe]
    ERROR: FILE=<file>: download URL <target> is not on <hosts>; not fetched [url-unsafe]
    WARNING: URL=<url>: redirects to <target>; not followed (<why>); <outcome> [url-unsafe]
    WARNING: URL=<url>: more than <number> redirects; <outcome> [url-unsafe]
    

url-unsafe/hf-endpoint

  • Level: WARNING.

  • Means: huggingface_hub's HF_ENDPOINT names a Hub that is not an https URL, or one holding user information, a query or a fragment. The Hugging Face token must not be sent over plain http.

  • SBOM effect: thinner: the SBOM says less than reading the input would.

  • Pitloom did: Sent no request to the Hub (huggingface_hub would send the token to the same endpoint): no file of the Hugging Face repository (config.json, the card, a licence file), no model_info(), dataset_info() or file listing. The model keeps its id and Hub URL only; the SBOM lacks everything else the Hub states.

  • Tell the user: HF_ENDPOINT is not used, and why, as the line says. They set it to an https URL without credentials, or unset it for https://huggingface.co, and run again. Do not change it for them; ask first, and with nobody to ask, report it only.

  • Lines:

    WARNING: URL=<url>: HF_ENDPOINT not used (<why>); nothing asked of the Hub [url-unsafe/hf-endpoint]
    

url-unsafe/host-spelling

  • Level: ERROR. As an ERROR, the command stops for that input and writes nothing for it (exit 1).

  • Means: A Git URL's host holds a non-ASCII character (a full-width or ideographic dot, a full-width letter, an international name not in its xn-- form) or a percent-encoding. git (through curl) maps it to another host than the URL's text names, past every check that reads that text (a PyPI host is never cloned). Or it holds a character no host name holds (=, !, ;, white space, a leading - or .), the shape of an option or a setting smuggled into git's command line, or is a name in brackets ([v1.x]), which would lose them and name a DNS host. An IPv6 zone id ([fe80::1%25eth0]) is refused too.

  • SBOM effect: not-written: no SBOM is written for the input.

  • Pitloom did: Started no git process, fetched nothing and wrote no SBOM (git.url-invalid).

  • Tell the user: the host must be written as it is resolved. They write it in ASCII, an international domain name in its xn-- (punycode) form, and run again. Do not rewrite the URL for them; ask first, and with nobody to ask, report it only.

  • Lines:

    ERROR: URL=<url>: the host is not plain ASCII, is percent-encoded or holds a character no host name holds (=, !, white space, a leading -), which git would resolve to a host the URL does not spell or read as an option; write it in ASCII (an international name in its xn-- form); nothing fetched [url-unsafe/host-spelling]