Bazel.Runfiles

This module enables finding data dependencies ("runfiles") of Haskell binaries at runtime.

For more information, see: https://github.com/bazelbuild/bazel/issues/4460

Documentation

data Runfiles

Reference to Bazel runfiles, runfiles root or manifest file.

Instances

Show Runfiles

Defined in Bazel.Runfiles

Methods

showsPrec :: Int -> Runfiles -> ShowS

show :: Runfiles -> String

showList :: [Runfiles] -> ShowS

create :: HasCallStack => IO Runfiles

Locate the runfiles directory or manifest for the current binary.

This behaves according to the specification in: https://docs.google.com/document/d/e/2PACX-1vSDIrFnFvEYhKsCMdGdD40wZRBX3m3aZ5HhVj4CtHPmiXKDCxioTUbYsDydjKtFDAzER5eg7OjJWs3V/pub

rlocation :: Runfiles -> FilePath -> FilePath

Construct a path to a data dependency within the given runfiles.

For example: rlocation "myworkspace/mypackage/myfile.txt"

env :: Runfiles -> [(String, String)]

Set environmental variables for locating the given runfiles directory.

Note that Bazel will set these automatically when it runs tests (bazel test). However, it will not automatically set them during "bazel run"; thus, non-test binaries should set the environment manually for processes that they call.