Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.aspect.build/llms.txt

Use this file to discover all available pages before exploring further.

Documentation for @bazel_lib@v3.2.0 — View source
A rule that copies a file to another place. native.genrule() is sometimes used to copy files (often wishing to rename them). The copy_file rule does this with a simpler interface than genrule. This rule uses a hermetic uutils/coreutils cp binary, no shell is required. This fork of bazel-skylib’s copy_file adds DirectoryPathInfo support and allows multiple copy_file rules in the same package.

​
Function: copy_file

Copies a file or directory to another location. native.genrule() is sometimes used to copy files (often wishing to rename them). The ‘copy_file’ rule does this with a simpler interface than genrule. This rule uses a hermetic uutils/coreutils cp binary, no shell is required. If using this rule with source directories, it is recommended that you use the --host_jvm_args=-DBAZEL_TRACK_SOURCE_DIRECTORIES=1 startup option so that changes to files within source directories are detected. See https://github.com/bazelbuild/bazel/commit/c64421bc35214f0414e4f4226cc953e8c55fa0d2 for more context.

​
Parameters

​
name
name
required
Name of the rule.
​
src
name
required
A Label. The file to make a copy of. (Can also be the label of a rule that generates a file.)
​
out
name
required
Path of the output file, relative to this package.
​
is_executable
name
default:"False"
A boolean. Whether to make the output file executable. When True, the rule’s output can be executed using bazel run and can be in the srcs of binary and test rules that require executable sources. WARNING: If allow_symlink is True, src must also be executable.
​
allow_symlink
name
default:"False"
A boolean. Whether to allow symlinking instead of copying. When False, the output is always a hard copy. When True, the output can be a symlink, but there is no guarantee that a symlink is created (i.e., at the time of writing, we don’t create symlinks on Windows). Set this to True if you need fast copying and your tools can handle symlinks (which most UNIX tools can).
​
kwargs
string_list
further keyword arguments, e.g. visibility

​
Function: copy_file_action

Factory function that creates an action to copy a file from src to dst. If src is a TreeArtifact, dir_path must be specified as the path within the TreeArtifact to the file to copy. This helper is used by copy_file. It is exposed as a public API so it can be used within other rule implementations. To use copy_file_action in your own rules, you need to include the toolchains it uses in your rule definition. For example: 
load("@bazel_lib//lib:copy_file.bzl", "COPY_FILE_TOOLCHAINS")

my_rule = rule(
    ...,
    toolchains = COPY_FILE_TOOLCHAINS,
)
Additionally, you must ensure that the coreutils toolchain is has been registered in your WORKSPACE if you are not using bzlmod: 
load("@bazel_lib//lib:repositories.bzl", "register_coreutils_toolchains")

register_coreutils_toolchains()

​
Parameters

​
ctx
name
required
The rule context.
​
src
name
required
The source file to copy or TreeArtifact to copy a single file out of.
​
dst
name
required
The destination file.
​
dir_path
name
default:"None"
If src is a TreeArtifact, the path within the TreeArtifact to the file to copy.