2
0
Fork 0
mirror of https://github.com/bazelbuild/rules_cc synced 2024-12-03 02:53:18 +00:00
rules_cc/cc/toolchains/tool.bzl
Googler 916074ec32 BEGIN_PUBLIC
Implement cc_tool
END_PUBLIC

PiperOrigin-RevId: 609307150
Change-Id: I2e135a59e06a56ca8ec071254d340ac4b984b234
2024-02-22 03:06:06 -08:00

101 lines
3.1 KiB
Python

# Copyright 2023 The Bazel Authors. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Implementation of cc_tool"""
load("//cc/toolchains/impl:collect.bzl", "collect_data", "collect_provider")
load(
":cc_toolchain_info.bzl",
"FeatureConstraintInfo",
"ToolInfo",
)
def _cc_tool_impl(ctx):
exe = ctx.executable.executable
runfiles = collect_data(ctx, ctx.attr.data + [ctx.attr.executable])
tool = ToolInfo(
label = ctx.label,
exe = exe,
runfiles = runfiles,
requires_any_of = tuple(collect_provider(
ctx.attr.requires_any_of,
FeatureConstraintInfo,
)),
execution_requirements = tuple(ctx.attr.execution_requirements),
)
link = ctx.actions.declare_file(ctx.label.name)
ctx.actions.symlink(
output = link,
target_file = ctx.executable.executable,
is_executable = True,
)
return [
tool,
# This isn't required, but now we can do "bazel run <tool>", which can
# be very helpful when debugging toolchains.
DefaultInfo(
files = depset([link]),
runfiles = runfiles,
executable = link,
),
]
cc_tool = rule(
implementation = _cc_tool_impl,
# @unsorted-dict-items
attrs = {
"executable": attr.label(
allow_files = True,
executable = True,
cfg = "exec",
doc = """The underlying binary that this tool represents.
Usually just a single prebuilt (eg. @sysroot//:bin/clang), but may be any
executable label.
""",
),
"data": attr.label_list(
allow_files = True,
doc = "Additional files that are required for this tool to run.",
),
"execution_requirements": attr.string_list(
doc = "A list of strings that provide hints for execution environment compatibility (e.g. `requires-mac`).",
),
"requires_any_of": attr.label_list(
providers = [FeatureConstraintInfo],
doc = """This will be enabled when any of the constraints are met.
If omitted, this tool will be enabled unconditionally.
""",
),
},
provides = [ToolInfo],
doc = """Declares a tool that can be bound to action configs.
A tool is a binary with extra metadata for the action config rule to consume
(eg. execution_requirements).
Example:
```
cc_tool(
name = "clang_tool",
executable = "@llvm_toolchain//:bin/clang",
# Suppose clang needs libc to run.
data = ["@llvm_toolchain//:lib/x86_64-linux-gnu/libc.so.6"]
)
```
""",
executable = True,
)