xref: /aosp_15_r20/external/bazelbuild-rules_python/python/private/py_cc_toolchain_macro.bzl (revision 60517a1edbc8ecf509223e9af94a7adec7d736b8)
1# Copyright 2023 The Bazel Authors. All rights reserved.
2#
3# Licensed under the Apache License, Version 2.0 (the "License");
4# you may not use this file except in compliance with the License.
5# You may obtain a copy of the License at
6#
7#     http://www.apache.org/licenses/LICENSE-2.0
8#
9# Unless required by applicable law or agreed to in writing, software
10# distributed under the License is distributed on an "AS IS" BASIS,
11# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12# See the License for the specific language governing permissions and
13# limitations under the License.
14
15"""Fronting macro for the py_cc_toolchain rule."""
16
17load(":py_cc_toolchain_rule.bzl", _py_cc_toolchain = "py_cc_toolchain")
18load(":util.bzl", "add_tag")
19
20# A fronting macro is used because macros have user-observable behavior;
21# using one from the onset avoids introducing those changes in the future.
22def py_cc_toolchain(**kwargs):
23    """Creates a py_cc_toolchain target.
24
25    This is a macro around the {rule}`py_cc_toolchain` rule.
26
27    Args:
28        **kwargs: Keyword args to pass onto underlying {rule}`py_cc_toolchain` rule.
29    """
30
31    #  This tag is added to easily identify usages through other macros.
32    add_tag(kwargs, "@rules_python//python:py_cc_toolchain")
33    _py_cc_toolchain(**kwargs)
34