Distribution.Nixpkgs.Fetch

Documentation

data Source

A source is a location from which we can fetch, such as a HTTP URL, a GIT URL, ....

Constructors

Source

Fields

• sourceUrl :: String

  URL to fetch from.

• sourceRevision :: String

  Revision to use. For protocols where this doesn't make sense (such as HTTP), this should be the empty string.

• sourceHash :: Hash

  The expected hash of the source, if available.

• sourceCabalDir :: String

  Directory where Cabal file is found.

Instances

Eq Source

Methods

(==) :: Source -> Source -> Bool

(/=) :: Source -> Source -> Bool

Ord Source

Methods

compare :: Source -> Source -> Ordering

(<) :: Source -> Source -> Bool

(<=) :: Source -> Source -> Bool

(>) :: Source -> Source -> Bool

(>=) :: Source -> Source -> Bool

max :: Source -> Source -> Source

min :: Source -> Source -> Source

Show Source

Methods

showsPrec :: Int -> Source -> ShowS

show :: Source -> String

showList :: [Source] -> ShowS

Generic Source

Associated Types

type Rep Source :: * -> *

Methods

from :: Source -> Rep Source x

to :: Rep Source x -> Source

NFData Source

Methods

rnf :: Source -> ()

type Rep Source

type Rep Source = D1 (MetaData "Source" "Distribution.Nixpkgs.Fetch" "cabal2nix-2.6-28e05ROz5sRHNTiF408asF" False) (C1 (MetaCons "Source" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "sourceUrl") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String)) (S1 (MetaSel (Just Symbol "sourceRevision") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String))) ((:*:) (S1 (MetaSel (Just Symbol "sourceHash") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 Hash)) (S1 (MetaSel (Just Symbol "sourceCabalDir") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String)))))

data Hash

Constructors

Certain String

Guess String

UnknownHash

Instances

Eq Hash

Methods

(==) :: Hash -> Hash -> Bool

(/=) :: Hash -> Hash -> Bool

Ord Hash

Methods

compare :: Hash -> Hash -> Ordering

(<) :: Hash -> Hash -> Bool

(<=) :: Hash -> Hash -> Bool

(>) :: Hash -> Hash -> Bool

(>=) :: Hash -> Hash -> Bool

max :: Hash -> Hash -> Hash

min :: Hash -> Hash -> Hash

Show Hash

Methods

showsPrec :: Int -> Hash -> ShowS

show :: Hash -> String

showList :: [Hash] -> ShowS

Generic Hash

Associated Types

type Rep Hash :: * -> *

Methods

from :: Hash -> Rep Hash x

to :: Rep Hash x -> Hash

NFData Hash

Methods

rnf :: Hash -> ()

type Rep Hash

type Rep Hash = D1 (MetaData "Hash" "Distribution.Nixpkgs.Fetch" "cabal2nix-2.6-28e05ROz5sRHNTiF408asF" False) ((:+:) (C1 (MetaCons "Certain" PrefixI False) (S1 (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String))) ((:+:) (C1 (MetaCons "Guess" PrefixI False) (S1 (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String))) (C1 (MetaCons "UnknownHash" PrefixI False) U1)))

data DerivationSource

A source for a derivation. It always needs a hash and also has a protocol attached to it (url, git, svn, ...). A DerivationSource also always has it's revision fully resolved (not relative revisions like master, HEAD, etc).

Constructors

DerivationSource

Fields

• derivKind :: String

  The kind of the source. The name of the build-support fetch derivation should be fetchkind.

• derivUrl :: String

  URL to fetch from.

• derivRevision :: String

  Revision to use. Leave empty if the fetcher doesn't support revisions.

• derivHash :: String

  The hash of the source.

Instances

Eq DerivationSource

Methods

(==) :: DerivationSource -> DerivationSource -> Bool

(/=) :: DerivationSource -> DerivationSource -> Bool

Ord DerivationSource

Methods

compare :: DerivationSource -> DerivationSource -> Ordering

(<) :: DerivationSource -> DerivationSource -> Bool

(<=) :: DerivationSource -> DerivationSource -> Bool

(>) :: DerivationSource -> DerivationSource -> Bool

(>=) :: DerivationSource -> DerivationSource -> Bool

max :: DerivationSource -> DerivationSource -> DerivationSource

min :: DerivationSource -> DerivationSource -> DerivationSource

Show DerivationSource

Methods

showsPrec :: Int -> DerivationSource -> ShowS

show :: DerivationSource -> String

showList :: [DerivationSource] -> ShowS

Generic DerivationSource

Associated Types

type Rep DerivationSource :: * -> *

Methods

from :: DerivationSource -> Rep DerivationSource x

to :: Rep DerivationSource x -> DerivationSource

NFData DerivationSource

Methods

rnf :: DerivationSource -> ()

FromJSON DerivationSource

Methods

parseJSON :: Value -> Parser DerivationSource

parseJSONList :: Value -> Parser [DerivationSource]

type Rep DerivationSource

type Rep DerivationSource = D1 (MetaData "DerivationSource" "Distribution.Nixpkgs.Fetch" "cabal2nix-2.6-28e05ROz5sRHNTiF408asF" False) (C1 (MetaCons "DerivationSource" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "derivKind") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String)) (S1 (MetaSel (Just Symbol "derivUrl") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String))) ((:*:) (S1 (MetaSel (Just Symbol "derivRevision") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String)) (S1 (MetaSel (Just Symbol "derivHash") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String)))))

fromDerivationSource :: DerivationSource -> Source

fetch

Arguments

:: (String -> MaybeT IO a)

This function is passed the output path name as an argument. It should return Nothing if the file doesn't match the expected format. This is required, because we cannot always check if a download succeeded otherwise.

-> Source

The source to fetch from.

-> IO (Maybe (DerivationSource, a))

The derivation source and the result of the processing function. Returns Nothing if the download failed.

Fetch a source, trying any of the various nix-prefetch-* scripts.

fetchWith :: (Bool, String, [String]) -> Source -> MaybeT IO (DerivationSource, FilePath)

Like fetch, but allows to specify which script to use.