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.

The rule uses a Bash command on Linux/macOS/non-Windows, and a cmd.exe command on Windows (no Bash is required).

This fork of bazel-skylib's copy_file adds directory support.

Macros and Functions

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 Bash command on Linux/macOS/non-Windows, and a cmd.exe command on Windows (no Bash 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.

Example usage (generated)

load("@aspect_bazel_lib//lib:copy_file.bzl", "copy_file")

copy_file(
    # Name of the rule.
    name = "",
    # A Label
    src = "",
    # Path of the output file, relative to this package.
    out = "",
)

name

Name of the rule.

src

A Label. The file or directory to make a copy of. (Can also be the label of a rule that generates a file or directory.)

out

Path of the output file, relative to this package.

is_directory

treat the source file as a directory Workaround for https://github.com/bazelbuild/bazel/issues/12954

is_executable

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.

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

further keyword arguments, e.g. visibility