diff options
Diffstat (limited to 'tests/core/runfiles/README.rst')
-rw-r--r-- | tests/core/runfiles/README.rst | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/tests/core/runfiles/README.rst b/tests/core/runfiles/README.rst new file mode 100644 index 00000000..ec357826 --- /dev/null +++ b/tests/core/runfiles/README.rst @@ -0,0 +1,23 @@ +Runfiles functionality +===================== + +runfiles_tests +-------------- + +Checks that functions in ``//go/tools/bazel:go_default_library`` that +provide access to runfiles behave correctly. In particular, this checks: + +* ``Runfile`` works for regular files. +* ``FindBinary`` works for binaries. +* ``ListRunfiles`` lists all expected files. +* These functions work for runfiles in the local workspace and for files in + external repositories (``@runfiles_remote_test`` is a ``local_repository`` + that points to a subdirectory here). +* These functions work in tests invoked with ``bazel test`` and + binaries invoked with ``bazel run``. +* These functions work on Windows and other platforms. Bazel doesn't + create a symlink tree for runfiles on Windows since symbolic links + can't be created without administrative privilege by default. + +TODO: Verify binary behavior in CI. The ``local_bin`` and ``remote_bin`` +targets verify behavior for binaries, but they are not tests. |