Skip to main content

Module network

Module network 

Source
Expand description

Network-backed package registry client.

Implements the registry protocol defined in spec §19.5:

GET /packages/{name}                   → { versions, latest }
GET /packages/{name}/{version}         → { manifest, checksum, download_url }
GET /packages/{name}/{version}/download → tarball bytes

Tarballs are cached under cache_dir after SHA-256 verification. A PackageRegistry can be passed as a fallback for offline use or private overrides.

Structs§

FetchedPackage
Result of NetworkRegistry::fetch_package.
ManifestData
Manifest fragment served by the registry for a specific version.
NetworkRegistry
A network-backed registry that fetches metadata and tarballs over HTTPS.
RegistriesSection
The [registries] section of an bock.project file.
VersionMetaResponse
Response body for GET /packages/{name}/{version}.
VersionsResponse
Response body for GET /packages/{name}.

Constants§

AUTH_TOKEN_ENV
Environment variable that supplies a Bearer auth token for private registries.

Functions§

default_registry_url
Resolve the effective default registry URL for a project.
normalize_checksum
Strip any sha256: prefix and lowercase the remaining hex for storage.
parse_registries
Parse just the [registries] section out of an bock.project TOML string.
sha256_hex
Compute the hex-encoded SHA-256 digest of data.
verify_checksum
Verify a byte buffer against a SHA-256 checksum.