Enum tvix_glue::fetchers::Fetch

pub enum Fetch {
    URL {
        url: Url,
        exp_hash: Option<NixHash>,
    },
    Tarball {
        url: Url,
        exp_nar_sha256: Option<[u8; 32]>,
    },
    NAR {
        url: Url,
        hash: NixHash,
    },
    Executable {
        url: Url,
        hash: NixHash,
    },
    Git(),
}

Representing options for doing a fetch.

Variants

URL

Fetch a literal file from the given URL, with an optional expected hash.

Fields

url: Url

The URL to fetch from.

exp_hash: Option<NixHash>

The expected hash of the file.

Tarball

Fetch a tarball from the given URL and unpack. The file must be a tape archive (.tar), optionally compressed with gzip, bzip2 or xz. The top-level path component of the files in the tarball is removed, so it is best if the tarball contains a single directory at top level. Optionally, a sha256 digest can be provided to verify the unpacked contents against.

Fields

url: Url

The URL to fetch from.

exp_nar_sha256: Option<[u8; 32]>

The expected hash of the contents, as NAR.

NAR

Fetch a NAR file from the given URL and unpack. The file can optionally be compressed.

Fields

url: Url

The URL to fetch from.

hash: NixHash

The expected hash of the NAR representation. This unfortunately supports more than sha256.

Executable

Fetches a file at a URL, makes it the store path root node, but executable. Used by <nix/fetchurl.nix>, with executable = true;. The expected hash is over the NAR representation, but can be not SHA256:

(import <nix/fetchurl.nix> { url = "https://cache.nixos.org/nar/0r8nqa1klm5v17ifc6z96m9wywxkjvgbnqq9pmy0sgqj53wj3n12.nar.xz"; hash = "sha1-NKNeU1csW5YJ4lCeWH3Z/apppNU="; executable = true; })

Fields

url: Url

The URL to fetch from.

hash: NixHash

The expected hash of the NAR representation. This unfortunately supports more than sha256.

Git()

TODO

Implementations

impl Fetch

pub fn store_path<'a>( &self, name: &'a str, ) -> Result<Option<StorePathRef<'a>>, BuildStorePathError>

If the Fetch contains an expected hash upfront, returns the resulting store path. This doesn’t do any fetching.

Trait Implementations

impl Clone for Fetch

fn clone(&self) -> Fetch

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Fetch

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Fetch

fn eq(&self, other: &Fetch) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Fetch

impl StructuralPartialEq for Fetch