| SPDX-FileCopyrightText | 2026-present Arthit Suriyawongkul |
|---|---|
| SPDX-FileType | DOCUMENTATION |
| SPDX-License-Identifier | CC0-1.0 |
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.
| 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 |
-
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]
-
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]
-
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]
-
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]
-
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]
-
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]
-
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]
-
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]
-
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]