Stack.Dot

Documentation

dot :: HasEnvConfig env => DotOpts -> RIO env ()

Visualize the project's dependencies as a graphviz graph

listDependencies :: HasEnvConfig env => ListDepsOpts -> RIO env ()

data DotOpts

Options record for stack dot

Constructors

DotOpts

Fields

• dotIncludeExternal :: !Bool

  Include external dependencies

• dotIncludeBase :: !Bool

  Include dependencies on base

• dotDependencyDepth :: !(Maybe Int)

  Limit the depth of dependency resolution to (Just n) or continue until fixpoint

• dotPrune :: !(Set String)

  Package names to prune from the graph

• dotTargets :: [Text]

  stack TARGETs to trace dependencies for

• dotFlags :: !(Map (Maybe PackageName) (Map FlagName Bool))

  Flags to apply when calculating dependencies

• dotTestTargets :: Bool

  Like the "--test" flag for build, affects the meaning of dotTargets.

• dotBenchTargets :: Bool

  Like the "--bench" flag for build, affects the meaning of dotTargets.

data DotPayload

Information about a package in the dependency graph, when available.

Constructors

DotPayload

Fields

• payloadVersion :: Maybe Version

  The package version.

• payloadLicense :: Maybe License

  The license the package was released under.

Instances

Eq DotPayload

Methods

(==) :: DotPayload -> DotPayload -> Bool

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

Show DotPayload

Methods

showsPrec :: Int -> DotPayload -> ShowS

show :: DotPayload -> String

showList :: [DotPayload] -> ShowS

data ListDepsOpts

Constructors

ListDepsOpts

Fields

• listDepsDotOpts :: !DotOpts

  The normal dot options.

• listDepsSep :: !Text

  Separator between the package name and details.

• listDepsLicense :: !Bool

  Print dependency licenses instead of versions.

resolveDependencies :: (Applicative m, Monad m) => Maybe Int -> Map PackageName (Set PackageName, DotPayload) -> (PackageName -> m (Set PackageName, DotPayload)) -> m (Map PackageName (Set PackageName, DotPayload))

Resolve the dependency graph up to (Just depth) or until fixpoint is reached

printGraph

Arguments

:: (Applicative m, MonadIO m)

=> DotOpts

-> Set PackageName

all locals

-> Map PackageName (Set PackageName, DotPayload)

-> m ()

Print a graphviz graph of the edges in the Map and highlight the given local packages

pruneGraph :: (Foldable f, Foldable g, Eq a) => f PackageName -> g String -> Map PackageName (Set PackageName, a) -> Map PackageName (Set PackageName, a)

pruneGraph dontPrune toPrune graph prunes all packages in graph with a name in toPrune and removes resulting orphans unless they are in dontPrune