bazel

README

Golang Bazel helper package

This directory contains useful utilities for interacting with Bazel from Go.

Currently the bazel package supports:

1. Getting the path for a runfile in a test.

Documentation

Overview

Package bazel provides utilities for interacting with the surrounding Bazel environment.

Index

• Constants
• func NewTmpDir(prefix string) (string, error)
• func Runfile(path string) (string, error)
• func RunfilesPath() (string, error)
• func SetDefaultTestWorkspace(w string)
• func TestTmpDir() string
• func TestWorkspace() (string, error)

Constants

const TEST_SRCDIR = "TEST_SRCDIR"

const TEST_TMPDIR = "TEST_TMPDIR"

const TEST_WORKSPACE = "TEST_WORKSPACE"

Functions

func NewTmpDir

func NewTmpDir(prefix string) (string, error)

NewTmpDir creates a new temporary directory in TestTmpDir().

func Runfile

func Runfile(path string) (string, error)

Runfile returns an absolute path to the specified file in the runfiles directory of the running target. It searches the current working directory, RunfilesPath() directory, and RunfilesPath()/TestWorkspace(). Returns an error if unable to locate RunfilesPath() or if the file does not exist.

func RunfilesPath

func RunfilesPath() (string, error)

RunfilesPath return the path to the run files tree for this test. It returns an error if TEST_SRCDIR does not exist.

func SetDefaultTestWorkspace

func SetDefaultTestWorkspace(w string)

SetDefaultTestWorkspace allows you to set a fake value for the environment variable TEST_WORKSPACE if it is not defined. This is useful when running tests on the command line and not through Bazel.

func TestTmpDir

func TestTmpDir() string

TestTmpDir returns the path the Bazel test temp directory. If TEST_TMPDIR is not defined, it returns the OS default temp dir.

func TestWorkspace

func TestWorkspace() (string, error)

TestWorkspace returns the name of the Bazel workspace for this test. If TEST_WORKSPACE is not defined, it returns an error.