| Copyright | (c) Duncan Coutts 2008 |
|---|---|
| License | BSD-like |
| Maintainer | duncan@community.haskell.org |
| Stability | provisional |
| Portability | portable |
| Safe Haskell | None |
| Language | Haskell2010 |
Distribution.Client.IndexUtils
Description
Extra utils related to the package indexes.
Synopsis
- getIndexFileAge :: Repo -> IO Double
- getInstalledPackages :: Verbosity -> Compiler -> PackageDBStack -> ProgramDb -> IO InstalledPackageIndex
- indexBaseName :: Repo -> FilePath
- getInstalledPackagesMonitorFiles :: Verbosity -> Compiler -> PackageDBStack -> ProgramDb -> Platform -> IO [FilePath]
- getSourcePackages :: Verbosity -> RepoContext -> IO SourcePackageDb
- getSourcePackagesMonitorFiles :: [Repo] -> [FilePath]
- data TotalIndexState
- getSourcePackagesAtIndexState :: Verbosity -> RepoContext -> Maybe TotalIndexState -> Maybe ActiveRepos -> IO (SourcePackageDb, TotalIndexState, ActiveRepos)
- data ActiveRepos
- data Index
- data RepoIndexState
- = IndexStateHead
- | IndexStateTime !Timestamp
- data PackageEntry
- = NormalPackage PackageId GenericPackageDescription ByteString BlockNo
- | BuildTreeRef BuildTreeRefType PackageId GenericPackageDescription FilePath BlockNo
- parsePackageIndex :: Verbosity -> ByteString -> [IO (Maybe PackageOrDep)]
- updateRepoIndexCache :: Verbosity -> Index -> IO ()
- updatePackageIndexCacheFile :: Verbosity -> Index -> IO ()
- writeIndexTimestamp :: Index -> RepoIndexState -> IO ()
- currentIndexTimestamp :: Verbosity -> RepoContext -> Repo -> IO Timestamp
- data BuildTreeRefType
- refTypeFromTypeCode :: TypeCode -> BuildTreeRefType
- typeCodeFromRefType :: BuildTreeRefType -> TypeCode
Documentation
getIndexFileAge :: Repo -> IO Double Source #
Return the age of the index file in days (as a Double).
getInstalledPackages :: Verbosity -> Compiler -> PackageDBStack -> ProgramDb -> IO InstalledPackageIndex Source #
Reduced-verbosity version of getInstalledPackages
indexBaseName :: Repo -> FilePath Source #
Get filename base (i.e. without file extension) for index-related files
Secure cabal repositories use a new extended & incremental
01-index.tar. In order to avoid issues resulting from clobbering
new/old-style index data, we save them locally to different names.
Example: Use indexBaseName repo . "tar.gz" to compute the FilePath of the
00-index.tar.gz/01-index.tar.gz file.
getInstalledPackagesMonitorFiles :: Verbosity -> Compiler -> PackageDBStack -> ProgramDb -> Platform -> IO [FilePath] #
getSourcePackages :: Verbosity -> RepoContext -> IO SourcePackageDb Source #
Read a repository index from disk, from the local files specified by
a list of Repos.
All the SourcePackages are marked as having come from the appropriate
Repo.
This is a higher level wrapper used internally in cabal-install.
getSourcePackagesMonitorFiles :: [Repo] -> [FilePath] Source #
A set of files (or directories) that can be monitored to detect when there might have been a change in the source packages.
data TotalIndexState Source #
Index state of multiple repositories
Instances
| Eq TotalIndexState Source # | |
Defined in Distribution.Client.IndexUtils.IndexState Methods (==) :: TotalIndexState -> TotalIndexState -> Bool # (/=) :: TotalIndexState -> TotalIndexState -> Bool # | |
| Show TotalIndexState Source # | |
Defined in Distribution.Client.IndexUtils.IndexState Methods showsPrec :: Int -> TotalIndexState -> ShowS # show :: TotalIndexState -> String # showList :: [TotalIndexState] -> ShowS # | |
| Generic TotalIndexState Source # | |
Defined in Distribution.Client.IndexUtils.IndexState Associated Types type Rep TotalIndexState :: Type -> Type # Methods from :: TotalIndexState -> Rep TotalIndexState x # to :: Rep TotalIndexState x -> TotalIndexState # | |
| Binary TotalIndexState Source # | |
Defined in Distribution.Client.IndexUtils.IndexState Methods put :: TotalIndexState -> Put # get :: Get TotalIndexState # putList :: [TotalIndexState] -> Put # | |
| NFData TotalIndexState Source # | |
Defined in Distribution.Client.IndexUtils.IndexState Methods rnf :: TotalIndexState -> () # | |
| Structured TotalIndexState Source # | |
Defined in Distribution.Client.IndexUtils.IndexState | |
| Parsec TotalIndexState Source # |
|
Defined in Distribution.Client.IndexUtils.IndexState Methods parsec :: CabalParsing m => m TotalIndexState | |
| Pretty TotalIndexState Source # | |
Defined in Distribution.Client.IndexUtils.IndexState Methods pretty :: TotalIndexState -> Doc prettyVersioned :: CabalSpecVersion -> TotalIndexState -> Doc | |
| type Rep TotalIndexState Source # | |
Defined in Distribution.Client.IndexUtils.IndexState type Rep TotalIndexState = D1 ('MetaData "TotalIndexState" "Distribution.Client.IndexUtils.IndexState" "hackport-0.7.2.1-1OygFJYGTmY8Q1y3r3WxcM-hackport-external-libs-cabal-install" 'False) (C1 ('MetaCons "TIS" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 RepoIndexState) :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Map RepoName RepoIndexState)))) | |
getSourcePackagesAtIndexState :: Verbosity -> RepoContext -> Maybe TotalIndexState -> Maybe ActiveRepos -> IO (SourcePackageDb, TotalIndexState, ActiveRepos) Source #
Variant of getSourcePackages which allows getting the source
packages at a particular IndexState.
Current choices are either the latest (aka HEAD), or the index as it was at a particular time.
Returns also the total index where repositories' RepoIndexState's are not HEAD. This is used in v2-freeze.
data ActiveRepos Source #
Ordered list of active repositories.
Instances
| Eq ActiveRepos Source # | |
Defined in Distribution.Client.IndexUtils.ActiveRepos | |
| Show ActiveRepos Source # | |
Defined in Distribution.Client.IndexUtils.ActiveRepos Methods showsPrec :: Int -> ActiveRepos -> ShowS # show :: ActiveRepos -> String # showList :: [ActiveRepos] -> ShowS # | |
| Generic ActiveRepos Source # | |
Defined in Distribution.Client.IndexUtils.ActiveRepos Associated Types type Rep ActiveRepos :: Type -> Type # | |
| Binary ActiveRepos Source # | |
Defined in Distribution.Client.IndexUtils.ActiveRepos | |
| NFData ActiveRepos Source # | |
Defined in Distribution.Client.IndexUtils.ActiveRepos Methods rnf :: ActiveRepos -> () # | |
| Structured ActiveRepos Source # | |
Defined in Distribution.Client.IndexUtils.ActiveRepos | |
| Parsec ActiveRepos Source # | Note: empty string is not valid
|
Defined in Distribution.Client.IndexUtils.ActiveRepos Methods parsec :: CabalParsing m => m ActiveRepos | |
| Pretty ActiveRepos Source # | |
Defined in Distribution.Client.IndexUtils.ActiveRepos | |
| type Rep ActiveRepos Source # | |
Defined in Distribution.Client.IndexUtils.ActiveRepos | |
Which index do we mean?
Constructors
| RepoIndex RepoContext Repo | The main index for the specified repository |
| SandboxIndex FilePath | A sandbox-local repository Argument is the location of the index file |
data RepoIndexState Source #
Specification of the state of a specific repo package index
Constructors
| IndexStateHead | Use all available entries |
| IndexStateTime !Timestamp | Use all entries that existed at the specified time |
Instances
data PackageEntry Source #
An index entry is either a normal package, or a local build tree reference.
Constructors
| NormalPackage PackageId GenericPackageDescription ByteString BlockNo | |
| BuildTreeRef BuildTreeRefType PackageId GenericPackageDescription FilePath BlockNo |
Instances
| Package PackageEntry Source # | |
Defined in Distribution.Client.IndexUtils Methods packageId :: PackageEntry -> PackageIdentifier | |
parsePackageIndex :: Verbosity -> ByteString -> [IO (Maybe PackageOrDep)] Source #
Read 00-index.tar.gz and extract .cabal and preferred-versions files
We read the index using read, which gives us a lazily constructed
TarEntries. We translate it to a list of entries using tarEntriesList,
which preserves the lazy nature of TarEntries, and finally concatMap a
function over this to translate it to a list of IO actions returning
PackageOrDeps. We can use lazySequence to turn this into a list of
PackageOrDeps, still maintaining the lazy nature of the original tar read.
updateRepoIndexCache :: Verbosity -> Index -> IO () Source #
It is not necessary to call this, as the cache will be updated when the index is read normally. However you can do the work earlier if you like.
updatePackageIndexCacheFile :: Verbosity -> Index -> IO () Source #
writeIndexTimestamp :: Index -> RepoIndexState -> IO () Source #
Write the IndexState to the filesystem
currentIndexTimestamp :: Verbosity -> RepoContext -> Repo -> IO Timestamp Source #
Read out the "current" index timestamp, i.e., what timestamp you would use to revert to this version
data BuildTreeRefType Source #
A build tree reference is either a link or a snapshot.
Constructors
| SnapshotRef | |
| LinkRef |