Stack.Storage

Work with SQLite database used for caches.

Documentation

initStorage

Arguments

:: HasLogFunc env

=> Path Abs File

storage file

-> (Storage -> RIO env a)

-> RIO env a

Initialize the database.

withStorage :: (HasConfig env, HasLogFunc env) => ReaderT SqlBackend (RIO env) a -> RIO env a

Run an action in a database transaction

type ConfigCacheKey = Unique ConfigCacheParent

Key used to retrieve configuration or flag cache

configCacheKey :: Path Abs Dir -> ConfigCacheType -> ConfigCacheKey

Build key used to retrieve configuration or flag cache

loadConfigCache :: (HasConfig env, HasLogFunc env) => ConfigCacheKey -> RIO env (Maybe ConfigCache)

Load ConfigCache from the database.

saveConfigCache :: (HasConfig env, HasLogFunc env) => ConfigCacheKey -> ConfigCache -> RIO env ()

Insert or update ConfigCache to the database.

deactiveConfigCache :: HasConfig env => ConfigCacheKey -> RIO env ()

Mark ConfigCache as inactive in the database. We use a flag instead of deleting the records since, in most cases, the same cache will be written again within in a few seconds (after `cabal configure`), so this avoids unnecessary database churn.

type PrecompiledCacheKey = Unique PrecompiledCacheParent

Key used to retrieve the precompiled cache

precompiledCacheKey :: Path Rel Dir -> ActualCompiler -> Version -> Text -> ByteString -> Bool -> PrecompiledCacheKey

Build key used to retrieve the precompiled cache

loadPrecompiledCache :: (HasConfig env, HasLogFunc env) => PrecompiledCacheKey -> RIO env (Maybe (PrecompiledCache Rel))

Load PrecompiledCache from the database.

savePrecompiledCache :: (HasConfig env, HasLogFunc env) => PrecompiledCacheKey -> PrecompiledCache Rel -> RIO env ()

Insert or update PrecompiledCache to the database.

loadDockerImageExeCache :: (HasConfig env, HasLogFunc env) => Text -> Path Abs File -> UTCTime -> RIO env (Maybe Bool)

Get the record of whether an executable is compatible with a Docker image

saveDockerImageExeCache :: (HasConfig env, HasLogFunc env) => Text -> Path Abs File -> UTCTime -> Bool -> RIO env ()

Sest the record of whether an executable is compatible with a Docker image

loadCompilerPaths

Arguments

:: HasConfig env

=> Path Abs File

compiler executable

-> CompilerBuild

-> Bool

sandboxed?

-> RIO env (Maybe CompilerPaths)

Load compiler information, if available, and confirm that the referenced files are unchanged. May throw exceptions!

saveCompilerPaths :: HasConfig env => CompilerPaths -> RIO env ()

Save compiler information. May throw exceptions!

upgradeChecksSince :: HasConfig env => UTCTime -> RIO env Int

How many upgrade checks have occurred since the given timestamp?

logUpgradeCheck :: HasConfig env => UTCTime -> RIO env ()

Log in the database that an upgrade check occurred at the given time.