Skip to content

Latest commit

 

History

History
218 lines (208 loc) · 20.8 KB

message-codes.md

File metadata and controls

218 lines (208 loc) · 20.8 KB
Created 2026-10-30
Last-Modified 2026-11-15
SPDX-FileCopyrightText 2026-present Arthit Suriyawongkul
SPDX-FileType DOCUMENTATION
SPDX-License-Identifier CC0-1.0

Message codes

See also: Messages and codes for the line grammar, what a code guarantees and when to trust one.

Every catalogued message, by code, as Pitloom's catalogue (pitloom.messages) states it: what it means, what Pitloom did and what to do about it. This page indexes the codes; each code's section is on the page its link names, one page per topic. The pages are generated from the catalogue, so they say what this version prints.

Codes

A catalogued line reads LEVEL: text [code]. Trust the code only when the text is one of the code's lines on its page (the table links it), a value in place of each <name>, after at most one prefix from the table of prefixes.

Code Level Since
card-malformed WARNING 0.23.0
config-unsafe INFO 0.23.4
config-unsafe/build-code WARNING 0.23.4
credentials-unsafe WARNING 0.25.0
credentials-unsafe/accepted WARNING 0.25.0
credentials-unsafe/git-line-break WARNING 0.25.0
credentials-unsafe/git-userinfo ERROR 0.25.0
credentials-unsafe/http-clear WARNING 0.25.0
credentials-unsafe/refused ERROR 0.25.0
credentials-unsafe/registry ERROR, WARNING 0.25.0
credentials-unsafe/written WARNING 0.25.0
digest-invalid ERROR 0.24.0
dir-unlistable ERROR, WARNING 0.22.0
download-network-failed ERROR, WARNING 0.24.0
download-timeout ERROR, WARNING 0.24.0
field-not-recordable INFO 0.23.0
file-ambiguous INFO 0.24.0
file-unreadable ERROR, WARNING 0.22.0
file-unreadable/not-utf8 ERROR, WARNING 0.22.0
file-unreadable/outside-project WARNING 0.22.0
file-unreadable/outside-repository WARNING 0.23.4
file-unwritable ERROR, WARNING 0.25.0
hf-url-invalid ERROR 0.25.0
hyperparameter-conflict WARNING 0.22.0
index-path-no-effect WARNING 0.25.0
input-not-found ERROR, WARNING 0.23.4
input-not-found/fragment WARNING 0.25.0
json-malformed ERROR, WARNING 0.23.0
lfs-pointer ERROR, WARNING 0.22.0
lfs-pointer-malformed ERROR, WARNING 0.22.0
lfs-pointer/shipped WARNING 0.22.0
library-missing ERROR, WARNING 0.22.0
library-unusable ERROR, WARNING 0.23.0
license-relationship-invalid ERROR, WARNING 0.24.0
model-ambiguous ERROR, INFO 0.23.4
model-ambiguous/over-cap ERROR 0.23.4
model-field-conflict WARNING 0.23.0
model-field-unreadable WARNING 0.23.0
model-unreadable WARNING 0.22.0
model-wrong-format ERROR, WARNING 0.22.0
offline-unusable ERROR, WARNING 0.24.0
option-conflict ERROR 0.25.0
option-invalid ERROR 0.25.0
option-missing ERROR 0.25.0
option-no-effect WARNING, INFO 0.25.0
over-cap ERROR, WARNING 0.22.0
parameter-count-invalid WARNING 0.22.0
project-not-found ERROR 0.23.4
project-not-found/model-files ERROR 0.23.4
project-or-model-not-found ERROR 0.23.4
pypi-response-invalid ERROR, WARNING 0.24.0
pypi-url-invalid ERROR 0.24.0
pypi-url-unusable ERROR 0.24.0
query-no-effect INFO 0.24.0
reader-unsafe INFO 0.22.0
reader-unsafe/remote INFO 0.23.4
registry-conflict WARNING 0.25.0
registry-conflict/concurrent WARNING 0.25.0
registry-conflict/file-set WARNING 0.25.0
registry-conflict/held INFO 0.25.0
registry-conflict/spelling WARNING 0.25.0
registry-conflict/type WARNING 0.25.0
registry-entry-missing WARNING 0.25.0
registry-file-missing WARNING 0.25.0
registry-hash-conflict WARNING, INFO 0.25.0
registry-hash-conflict/gate INFO 0.25.0
registry-hash-missing WARNING, INFO 0.25.0
registry-identity-missing INFO 0.25.0
registry-key-ambiguous WARNING, INFO 0.25.0
registry-key-moved INFO 0.25.0
registry-malformed ERROR, WARNING 0.25.0
registry-path-key-unusable WARNING, INFO 0.25.0
registry-unknown-key ERROR, WARNING 0.25.0
registry-unusable ERROR, WARNING 0.25.0
registry-wrong-format ERROR, WARNING 0.25.0
release-file-not-found ERROR 0.24.0
release-file-not-found/compatible-wheel ERROR 0.24.0
release-file-not-found/sdist ERROR 0.24.0
release-not-found ERROR 0.24.0
release-unpinned INFO 0.24.0
release-unpinned/prerelease INFO 0.24.0
release-unpinned/yanked INFO 0.24.0
release-unusable INFO 0.24.0
sbom-invalid ERROR, WARNING 0.25.0
sbom-wrong-format ERROR 0.25.0
target-ambiguous INFO 0.23.4
target-wrong-format ERROR 0.25.0
temp-dir-unusable ERROR, WARNING 0.24.0
text-malformed WARNING 0.23.0
text-malformed/registry ERROR, WARNING 0.25.0
url-moved INFO 0.24.0
url-moved/hf-endpoint INFO 0.24.0
url-unsafe ERROR, WARNING 0.24.0
url-unsafe/hf-endpoint WARNING 0.24.0
url-unsafe/host-spelling ERROR 0.24.0
usage-unparseable WARNING 0.22.1
usage-unparseable/mention INFO 0.22.1
usage-unusable WARNING 0.22.1

A line may start with one prefix before its text:

Prefix Level Printed by
loom <subcommand>: <text> ERROR the command line, each subcommand
loom: <text> ERROR the command line, before a subcommand is known
Pitloom build hook: <text> ERROR the Hatchling build hook
FORMAT=<format> FILE=<file>: <text> ERROR, WARNING a model scan, before a model reader's own line
Value What it is
<answered> the project name PyPI answered for, as its answer gives it; in quotes, escaped, when it holds a control character
<arity> how many values argparse expected after the option (one argument, 2 arguments, at least one argument)
<card> the kind of card: model card, dataset card, Hugging Face dataset card
<claimant> the other element, key or spelling that wants the same id or holds it (a path, a name, name@version), as given, a URL's credentials masked; in quotes, escaped, when it holds a control character
<command> the git command that was stopped or failed (clone, fetch)
<count> the number of files in brackets, (N files), after a space when there are two or more; else nothing
<declared> the SHA-256 a source declares, in hex
<dir> a directory as Pitloom names it; in quotes, escaped, when it holds a control character
<element> the SBOM element that holds the value (for a fingerprint that matches nothing, the SBOM's SpdxDocument), by its spdxId, a URL's credentials masked; in quotes, escaped, when it holds a control character
<kind> what the element is: dataset, dataset package, entity, file, model
'<type>' an element type as the ID registry file names it, in quotes ('software_File'), escaped when it holds a control character
<elements> G7 elements, comma-separated, each with where its value is written (model-architecture (written in ai_typeOfModel)) or (not recorded)
<entities> names or keys, comma-separated, each as given, a URL's credentials masked; in quotes, escaped, when it holds a control character
<entity> an element's name or ID registry key (a path, a dataset or model name, name@version), as given, a URL's credentials masked; in quotes, escaped, when it holds a control character
<entry> an archive member or a metadata key, as the file names it; in quotes, escaped, when it holds a control character
<error> what the reader or the file system reported, on one line; in quotes, escaped, when it holds a control character
<failure> what the operating system reported (Permission denied), never the path it names, or what the decoder or reader reported; on one line, in quotes, escaped, when it holds a control character
<field> the project setting that lists the file (project.readme, tool.setuptools.dynamic.dependencies, setup.cfg metadata.long_description); in quotes, escaped, when it holds a control character
<fields> the model fields not recorded, or recorded weaker, comma-separated, each with a note in brackets when it has one (type_of_model, properties.tags (kept as raw string))
<file> a file as Pitloom names it (its path, or a remote document's URL or Hub dataset id); in quotes, escaped, when it holds a control character
<files> file names, comma-separated, and N more after the last one shown; a name in quotes, escaped, when it holds a control character
<fingerprint> sha256: and the first hex digits of the SHA-256 of the value as the SBOM writes it: what --accept-url-credential takes
<format> the model format (gguf)
<formats> model formats, comma-separated (gguf, onnx)
<given-namespace> the namespace a command line or caller gives, a URL's credentials masked; in quotes, escaped, when it holds a control character
<hosts> the hosts Pitloom fetches PyPI files from, comma-separated (files.pythonhosted.org)
<input> what the path was named as: config file, fragments directory, ID registry file, PATH, project directory, project path, pyproject.toml, SBOM file, sdist archive, setup.cfg, setup.py, wheel file
<key> the key naming the input: FILE, DIR, FIELD (a metadata field or table), DATASET, MARKER or REQUIREMENT
<key-reason> why the element is keyed by its name, or files by their path as read: not found, outside the project root, not a regular file, used only by a model with no file, not found: declare paths relative to the registry root (id import --project-dir) or run id import from the directory the script ran in, the project is outside the registry's root, their path is outside the registry's root, their path leads outside the archive's project
<limit> the cap, in its unit
<sha256> the SHA-256 of the bytes read, in hex
<module> the Python module Pitloom imports for the step (h5py)
<name> the input as Pitloom names it (a path, a field, a dataset, the start of a requirement); in quotes, escaped, when it holds a control character
<namespace> a document namespace IRI, as an ID registry file or an SBOM states it, a URL's credentials masked; in quotes, escaped, when it holds a control character
<why> why a text cannot be a document namespace: must not contain '#', is not an absolute IRI (a scheme is needed, as in https://example.org/ns), has a character an IRI cannot hold, holds user information, a secret query value or an access token, or a query nested or encoded too deeply to read
<number> a whole number: a count, or a length in characters
<oid> the SHA-256 the pointer states, in hex
<option> a command-line option as the command names it (--allow-build, -o/--output, --pretty/--no-pretty), a positional argument as argparse names it (command), or a library parameter (project_metadata)
<other> the option given before, which the one named first cannot be given with, as argparse names it (--pretty)
<outcome> what Pitloom kept, and what it did not read or record
<part> the part of a Keras or HDF5 model that was not read: a root attribute (model_config) or a key path in a config (training_config.optimizer, layers[0].config)
'<path>' a path in quotes
<pointer> the field of the element that holds the value, as an RFC 6901 JSON pointer into it (/software_downloadLocation, /externalRef/0/locator/0); for a statement Pitloom writes, on into it (/statement/metadata/<key>, /statement/fields/<field>/note), or into the comment's provenance line (/comment/<field>/note), a part no JSON pointer resolves on the element; in quotes, escaped, when it holds a control character
<cap> the cap's name; a setting's name when a setting sets it (max-model-extract-bytes)
<x.y> the Python version Pitloom runs on, as 3.10: the grammar a file was read as
<reason> what the bound check found: a count the file cannot hold, a malformed ZIP central directory, or a GGUF version or ZIP archive it cannot check
<refusal> argparse's reason for refusing the value, on one line (invalid choice: ...); never a missing value (expected ...) or a conflict (not allowed with ...); in quotes, escaped, when it holds a control character
<what> what of an element the ID registry cannot hold: key, name, project_root, sha256, spdxId, type name
<requirement> Pitloom with the extra that installs the library (pitloom[gguf]); pitloom[ai] installs every model reader
'<root>' the directory a path is checked against (--project-dir, a project root), in quotes like the path beside it
<seconds> the time allowed, in whole seconds
<setting> a [tool.pitloom] setting as the file names it (accept-url-credentials, url-credentials)
<settings> the build settings left out, comma-separated, as the file names them (tool.hatch.metadata.hooks, tool.setuptools.cmdclass, metadata.version)
<size> a size in bytes (1 byte, N bytes)
<source> what declared a digest (the PyPI JSON API)
<spdx-id> an element's spdxId, as held or read, a URL's credentials masked; in quotes, escaped, when it holds a control character
<table> the configuration table: [tool.pitloom] or [tool:pitloom]
<target> a URL a redirect or a file points to, as given; in quotes, escaped, when it holds a control character
<unit> what the cap counts, singular (byte, entry, level)
<url> a URL as given (a PyPI page URL, a request URL, or huggingface_hub's HF_ENDPOINT); in quotes, escaped, when it holds a control character
<use> what the file was read or written for, or the directory listed for: for dataset hashing, for dependency pins, for file discovery, for file scanning, for ID registry indexing, for the input check, for license files, for the Croissant document, for the dataset card, for the Hugging Face dataset card, for the ID registry, for the model card, for the model hash, for the PyPI release metadata, for the SBOM, for the script hash, for usage scanning
<value> the value as the file states it (a tensor dimension: its Python repr, cut to 40 characters); in quotes, escaped, when it holds a control character
<version> a release version as the URL or PyPI gives it; in quotes, escaped, when it holds a control character
<when> the case the option has no effect in, or cannot be used in (without --allow-build, for a remote repository (...), when embedding multiple wheels)
<why> why a redirect or an HF_ENDPOINT was refused, a file skipped, or a release yanked (no reason given when PyPI gives none); on one line, in quotes, escaped, when it holds a control character
<subcommand> the loom command that failed (generate, fragment validate)