Safe Haskell	None
Language	Haskell2010

Nix.Thunk

Synopsis

data ThunkSource
- = ThunkSource_GitHub GitHubSource
- | ThunkSource_Git GitSource
data GitHubSource = GitHubSource {
- _gitHubSource_owner :: Name Owner
- _gitHubSource_repo :: Name Repo
- _gitHubSource_branch :: Maybe (Name Branch)
- _gitHubSource_private :: Bool
}
data ThunkRev = ThunkRev {
- _thunkRev_commit :: Ref SHA1
- _thunkRev_nixSha256 :: NixSha256
}
getLatestRev :: MonadNixThunk m => ThunkSource -> m ThunkRev
gitCloneForThunkUnpack :: MonadNixThunk m => GitSource -> Ref hash -> FilePath -> m ()
thunkSourceToGitSource :: ThunkSource -> GitSource
data ThunkPtr = ThunkPtr {
- _thunkPtr_rev :: ThunkRev
- _thunkPtr_source :: ThunkSource
}
data ThunkData
- = ThunkData_Packed ThunkSpec ThunkPtr
- | ThunkData_Checkout
readThunk :: MonadNixThunk m => FilePath -> m (Either ReadThunkError ThunkData)
data CheckClean
- = CheckClean_FullCheck
- | CheckClean_NotIgnored
- | CheckClean_NoCheck
getThunkPtr :: forall m. MonadNixThunk m => CheckClean -> FilePath -> Maybe Bool -> m ThunkPtr
packThunk :: MonadNixThunk m => ThunkPackConfig -> FilePath -> m ThunkPtr
createThunk :: MonadNixThunk m => FilePath -> Either ThunkSpec ThunkPtr -> m ()
createThunk' :: MonadNixThunk m => ThunkCreateConfig -> m ()
data ThunkPackConfig = ThunkPackConfig {
- _thunkPackConfig_force :: Bool
- _thunkPackConfig_config :: ThunkConfig
}
newtype ThunkConfig = ThunkConfig {
- _thunkConfig_private :: Maybe Bool
}
updateThunkToLatest :: MonadNixThunk m => ThunkUpdateConfig -> FilePath -> m ()
updateThunk :: MonadNixThunk m => FilePath -> (FilePath -> m a) -> m a
data ThunkUpdateConfig = ThunkUpdateConfig {
- _thunkUpdateConfig_branch :: Maybe String
- _thunkUpdateConfig_config :: ThunkConfig
}
unpackThunk :: MonadNixThunk m => FilePath -> m ()
data ThunkSpec = ThunkSpec {
- _thunkSpec_name :: !Text
- _thunkSpec_files :: !(Map FilePath ThunkFileSpec)
}
data ThunkFileSpec
- = ThunkFileSpec_Ptr (ByteString -> Either String ThunkPtr)
- | ThunkFileSpec_FileMatches Text
- | ThunkFileSpec_CheckoutIndicator
- | ThunkFileSpec_AttrCache
data NixThunkError
nixBuildAttrWithCache :: (MonadLog Output m, HasCliConfig NixThunkError m, MonadIO m, MonadMask m, MonadError NixThunkError m, MonadFail m) => FilePath -> String -> m FilePath
attrCacheFileName :: FilePath
prettyNixThunkError :: NixThunkError -> Text
data ThunkCreateSource
- = ThunkCreateSource_Absolute GitUri
- | ThunkCreateSource_Relative FilePath
data ThunkCreateConfig = ThunkCreateConfig {
- _thunkCreateConfig_uri :: ThunkCreateSource
- _thunkCreateConfig_branch :: Maybe (Name Branch)
- _thunkCreateConfig_rev :: Maybe (Ref SHA1)
- _thunkCreateConfig_config :: ThunkConfig
- _thunkCreateConfig_destination :: Maybe FilePath
}
parseGitUri :: Text -> Maybe GitUri
newtype GitUri = GitUri {
- unGitUri :: URI
}
uriThunkPtr :: MonadNixThunk m => GitUri -> Maybe Bool -> Maybe Text -> Maybe Text -> m ThunkPtr
newtype Ref hash = Ref {
- unRef :: Digest hash
}
refFromHexString :: HashAlgorithm hash => String -> Ref hash

Documentation

data ThunkSource Source #

A location from which a thunk's data can be retrieved

Constructors

ThunkSource_GitHub GitHubSource	A source specialized for GitHub
ThunkSource_Git GitSource	A plain repo source

Instances

Instances details

Eq ThunkSource Source #
Instance details Defined in Nix.Thunk.Internal Methods (==) :: ThunkSource -> ThunkSource -> Bool Source # (/=) :: ThunkSource -> ThunkSource -> Bool Source #
Ord ThunkSource Source #
Instance details Defined in Nix.Thunk.Internal Methods compare :: ThunkSource -> ThunkSource -> Ordering Source # (<) :: ThunkSource -> ThunkSource -> Bool Source # (<=) :: ThunkSource -> ThunkSource -> Bool Source # (>) :: ThunkSource -> ThunkSource -> Bool Source # (>=) :: ThunkSource -> ThunkSource -> Bool Source # max :: ThunkSource -> ThunkSource -> ThunkSource Source # min :: ThunkSource -> ThunkSource -> ThunkSource Source #
Show ThunkSource Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> ThunkSource -> ShowS Source # show :: ThunkSource -> String Source # showList :: [ThunkSource] -> ShowS Source #

data GitHubSource Source #

Constructors

GitHubSource
Fields _gitHubSource_owner :: Name Owner _gitHubSource_repo :: Name Repo _gitHubSource_branch :: Maybe (Name Branch) _gitHubSource_private :: Bool

Instances

Instances details

Eq GitHubSource Source #
Instance details Defined in Nix.Thunk.Internal Methods (==) :: GitHubSource -> GitHubSource -> Bool Source # (/=) :: GitHubSource -> GitHubSource -> Bool Source #
Ord GitHubSource Source #
Instance details Defined in Nix.Thunk.Internal Methods compare :: GitHubSource -> GitHubSource -> Ordering Source # (<) :: GitHubSource -> GitHubSource -> Bool Source # (<=) :: GitHubSource -> GitHubSource -> Bool Source # (>) :: GitHubSource -> GitHubSource -> Bool Source # (>=) :: GitHubSource -> GitHubSource -> Bool Source # max :: GitHubSource -> GitHubSource -> GitHubSource Source # min :: GitHubSource -> GitHubSource -> GitHubSource Source #
Show GitHubSource Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> GitHubSource -> ShowS Source # show :: GitHubSource -> String Source # showList :: [GitHubSource] -> ShowS Source #

data ThunkRev Source #

A specific revision of data; it may be available from multiple sources

Constructors

ThunkRev
Fields _thunkRev_commit :: Ref SHA1 _thunkRev_nixSha256 :: NixSha256

Instances

Instances details

Eq ThunkRev Source #
Instance details Defined in Nix.Thunk.Internal Methods (==) :: ThunkRev -> ThunkRev -> Bool Source # (/=) :: ThunkRev -> ThunkRev -> Bool Source #
Ord ThunkRev Source #
Instance details Defined in Nix.Thunk.Internal Methods compare :: ThunkRev -> ThunkRev -> Ordering Source # (<) :: ThunkRev -> ThunkRev -> Bool Source # (<=) :: ThunkRev -> ThunkRev -> Bool Source # (>) :: ThunkRev -> ThunkRev -> Bool Source # (>=) :: ThunkRev -> ThunkRev -> Bool Source # max :: ThunkRev -> ThunkRev -> ThunkRev Source # min :: ThunkRev -> ThunkRev -> ThunkRev Source #
Show ThunkRev Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> ThunkRev -> ShowS Source # show :: ThunkRev -> String Source # showList :: [ThunkRev] -> ShowS Source #

getLatestRev :: MonadNixThunk m => ThunkSource -> m ThunkRev Source #

Get the latest revision available from the given source

gitCloneForThunkUnpack Source #

Arguments

:: MonadNixThunk m
=> GitSource	Git source to use
-> Ref hash	Commit hash to reset to
-> FilePath	Directory to clone into
-> m ()

thunkSourceToGitSource :: ThunkSource -> GitSource Source #

data ThunkPtr Source #

A reference to the exact data that a thunk should translate into

Constructors

ThunkPtr
Fields _thunkPtr_rev :: ThunkRev _thunkPtr_source :: ThunkSource

Instances

Instances details

Eq ThunkPtr Source #
Instance details Defined in Nix.Thunk.Internal Methods (==) :: ThunkPtr -> ThunkPtr -> Bool Source # (/=) :: ThunkPtr -> ThunkPtr -> Bool Source #
Ord ThunkPtr Source #
Instance details Defined in Nix.Thunk.Internal Methods compare :: ThunkPtr -> ThunkPtr -> Ordering Source # (<) :: ThunkPtr -> ThunkPtr -> Bool Source # (<=) :: ThunkPtr -> ThunkPtr -> Bool Source # (>) :: ThunkPtr -> ThunkPtr -> Bool Source # (>=) :: ThunkPtr -> ThunkPtr -> Bool Source # max :: ThunkPtr -> ThunkPtr -> ThunkPtr Source # min :: ThunkPtr -> ThunkPtr -> ThunkPtr Source #
Show ThunkPtr Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> ThunkPtr -> ShowS Source # show :: ThunkPtr -> String Source # showList :: [ThunkPtr] -> ShowS Source #

data ThunkData Source #

Constructors

ThunkData_Packed ThunkSpec ThunkPtr	Packed thunk
ThunkData_Checkout	Checked out thunk that was unpacked from this pointer

readThunk :: MonadNixThunk m => FilePath -> m (Either ReadThunkError ThunkData) Source #

Read a packed or unpacked thunk based on predefined thunk specifications.

data CheckClean Source #

Constructors

CheckClean_FullCheck	Check that the repo is clean, including .gitignored files
CheckClean_NotIgnored	Check that the repo is clean, not including .gitignored files
CheckClean_NoCheck	Don't check that the repo is clean

getThunkPtr :: forall m. MonadNixThunk m => CheckClean -> FilePath -> Maybe Bool -> m ThunkPtr Source #

packThunk :: MonadNixThunk m => ThunkPackConfig -> FilePath -> m ThunkPtr Source #

createThunk :: MonadNixThunk m => FilePath -> Either ThunkSpec ThunkPtr -> m () Source #

createThunk' :: MonadNixThunk m => ThunkCreateConfig -> m () Source #

data ThunkPackConfig Source #

Constructors

ThunkPackConfig
Fields _thunkPackConfig_force :: Bool _thunkPackConfig_config :: ThunkConfig

Instances

Instances details

Show ThunkPackConfig Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> ThunkPackConfig -> ShowS Source # show :: ThunkPackConfig -> String Source # showList :: [ThunkPackConfig] -> ShowS Source #

newtype ThunkConfig Source #

Constructors

ThunkConfig
Fields _thunkConfig_private :: Maybe Bool

Instances

Instances details

Show ThunkConfig Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> ThunkConfig -> ShowS Source # show :: ThunkConfig -> String Source # showList :: [ThunkConfig] -> ShowS Source #

updateThunkToLatest :: MonadNixThunk m => ThunkUpdateConfig -> FilePath -> m () Source #

updateThunk :: MonadNixThunk m => FilePath -> (FilePath -> m a) -> m a Source #

Safely update thunk using a custom action

A temporary working space is used to do any update. When the custom action successfully completes, the resulting (packed) thunk is copied back to the original location.

data ThunkUpdateConfig Source #

Constructors

ThunkUpdateConfig
Fields _thunkUpdateConfig_branch :: Maybe String _thunkUpdateConfig_config :: ThunkConfig

Instances

Instances details

Show ThunkUpdateConfig Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> ThunkUpdateConfig -> ShowS Source # show :: ThunkUpdateConfig -> String Source # showList :: [ThunkUpdateConfig] -> ShowS Source #

unpackThunk :: MonadNixThunk m => FilePath -> m () Source #

data ThunkSpec Source #

Specification for how a set of files in a thunk version work.

Constructors

ThunkSpec
Fields _thunkSpec_name :: !Text _thunkSpec_files :: !(Map FilePath ThunkFileSpec)

data ThunkFileSpec Source #

Specification for how a file in a thunk version works.

Constructors

ThunkFileSpec_Ptr (ByteString -> Either String ThunkPtr)	This file specifies `ThunkPtr` data
ThunkFileSpec_FileMatches Text	This file must match the given content exactly
ThunkFileSpec_CheckoutIndicator	Existence of this directory indicates that the thunk is unpacked
ThunkFileSpec_AttrCache	This directory is an attribute cache

data NixThunkError Source #

Instances

Instances details

AsProcessFailure NixThunkError Source #
Instance details Defined in Nix.Thunk.Internal Methods asProcessFailure :: Prism' NixThunkError ProcessFailure Source #
AsUnstructuredError NixThunkError Source #
Instance details Defined in Nix.Thunk.Internal Methods asUnstructuredError :: Prism' NixThunkError Text Source #

nixBuildAttrWithCache Source #

Arguments

:: (MonadLog Output m, HasCliConfig NixThunkError m, MonadIO m, MonadMask m, MonadError NixThunkError m, MonadFail m)
=> FilePath	Path to directory containing Thunk
-> String	Attribute to build
-> m FilePath	Symlink to cached or built nix output

Build a nix attribute, and cache the result if possible

attrCacheFileName :: FilePath Source #

prettyNixThunkError :: NixThunkError -> Text Source #

data ThunkCreateSource Source #

The source to be used for creating thunks.

Constructors

ThunkCreateSource_Absolute GitUri	Create a thunk from an absolute reference to a Git repository: URIs like `file://`, `https://`, `ssh://` etc.
ThunkCreateSource_Relative FilePath	Create a thunk from a local folder. If the folder exists, then it is made absolute using the current working directory and treated as a `file://` URL.

Instances

Instances details

Show ThunkCreateSource Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> ThunkCreateSource -> ShowS Source # show :: ThunkCreateSource -> String Source # showList :: [ThunkCreateSource] -> ShowS Source #

data ThunkCreateConfig Source #

Constructors

ThunkCreateConfig
Fields _thunkCreateConfig_uri :: ThunkCreateSource _thunkCreateConfig_branch :: Maybe (Name Branch) _thunkCreateConfig_rev :: Maybe (Ref SHA1) _thunkCreateConfig_config :: ThunkConfig _thunkCreateConfig_destination :: Maybe FilePath

Instances

Instances details

Show ThunkCreateConfig Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> ThunkCreateConfig -> ShowS Source # show :: ThunkCreateConfig -> String Source # showList :: [ThunkCreateConfig] -> ShowS Source #

parseGitUri :: Text -> Maybe GitUri Source #

newtype GitUri Source #

Constructors

GitUri
Fields unGitUri :: URI

Instances

Instances details

Eq GitUri Source #
Instance details Defined in Nix.Thunk.Internal Methods (==) :: GitUri -> GitUri -> Bool Source # (/=) :: GitUri -> GitUri -> Bool Source #
Ord GitUri Source #
Instance details Defined in Nix.Thunk.Internal Methods compare :: GitUri -> GitUri -> Ordering Source # (<) :: GitUri -> GitUri -> Bool Source # (<=) :: GitUri -> GitUri -> Bool Source # (>) :: GitUri -> GitUri -> Bool Source # (>=) :: GitUri -> GitUri -> Bool Source # max :: GitUri -> GitUri -> GitUri Source # min :: GitUri -> GitUri -> GitUri Source #
Show GitUri Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> GitUri -> ShowS Source # show :: GitUri -> String Source # showList :: [GitUri] -> ShowS Source #

uriThunkPtr :: MonadNixThunk m => GitUri -> Maybe Bool -> Maybe Text -> Maybe Text -> m ThunkPtr Source #

Convert a URI to a thunk

If the URL is a github URL, we try to just download an archive for performance. If that doesn't work (e.g. authentication issue), we fall back on just doing things the normal way for git repos in general, and save it as a regular git thunk.

newtype Ref hash Source #

Represent a git reference (SHA1)

Constructors

Ref
Fields unRef :: Digest hash

Instances

Instances details

Eq (Ref hash) Source #
Instance details Defined in Nix.Thunk.Internal Methods (==) :: Ref hash -> Ref hash -> Bool Source # (/=) :: Ref hash -> Ref hash -> Bool Source #
Ord (Ref hash) Source #
Instance details Defined in Nix.Thunk.Internal Methods compare :: Ref hash -> Ref hash -> Ordering Source # (<) :: Ref hash -> Ref hash -> Bool Source # (<=) :: Ref hash -> Ref hash -> Bool Source # (>) :: Ref hash -> Ref hash -> Bool Source # (>=) :: Ref hash -> Ref hash -> Bool Source # max :: Ref hash -> Ref hash -> Ref hash Source # min :: Ref hash -> Ref hash -> Ref hash Source #
Show (Ref hash) Source #
Instance details Defined in Nix.Thunk.Internal Methods showsPrec :: Int -> Ref hash -> ShowS Source # show :: Ref hash -> String Source # showList :: [Ref hash] -> ShowS Source #

refFromHexString :: HashAlgorithm hash => String -> Ref hash Source #