//python/cc:py_cc_toolchain_info.bzl
Provider for C/C++ information from the toolchain.
See also
Custom toolchains for how to define custom toolchains.
py_cc_toolchainrule for defining the toolchain.
- providerPyCcToolchainInfo
C/C++ information about the Python runtime.
- PyCcToolchainInfo.<init>(headers,headers_abi3,libs,python_version)
- PyCcToolchainInfo.headers:struct
Information about the header files, struct with fields:
providers_map: a dict of string to provider instances. The key should bea fully qualified name (e.g.
@rules_foo//bar:baz.bzl#MyInfo) of theprovider to uniquely identify its type.The following keys are always present:
CcInfo: the CcInfo provider instance for the headers.
DefaultInfo: the DefaultInfo provider instance for the headers.
A map is used to allow additional providers from the originating headerstarget (typically a
cc_library) to be propagated to consumers (directlyexposing a Target object can cause memory issues and is an anti-pattern).When consuming this map, it’s suggested to use
providers_map.values()toreturn all providers; or copy the map and filter out or replace keys asappropriate. Note that any keys beginning with_(underscore) areconsidered private and should be forward along as-is (this better allowse.g.:current_py_cc_headersto act as the underlying headers target itrepresents).
- PyCcToolchainInfo.headers_abi3:struct|None
If available, information about ABI3 (stable ABI) header files, struct withfields:
providers_map: a dict of string to provider instances. The key should bea fully qualified name (e.g.
@rules_foo//bar:baz.bzl#MyInfo) of theprovider to uniquely identify its type.The following keys are always present:
CcInfo: the CcInfo provider instance for the headers.
DefaultInfo: the DefaultInfo provider instance for the headers.
A map is used to allow additional providers from the originating headerstarget (typically a
cc_library) to be propagated to consumers (directlyexposing a Target object can cause memory issues and is an anti-pattern).When consuming this map, it’s suggested to use
providers_map.values()toreturn all providers; or copy the map and filter out or replace keys asappropriate. Note that any keys beginning with_(underscore) areconsidered private and should be forward along as-is (this better allowse.g.:current_py_cc_headersto act as the underlying headers target itrepresents).
Added in version 1.7.0:The
features.headers_abi3attribute can be used to detect if thisattribute is available or not.
- PyCcToolchainInfo.libs:struct|None
If available, information about C libraries, struct with fields:
providers_map: A dict of string to provider instances. The key should bea fully qualified name (e.g.
@rules_foo//bar:baz.bzl#MyInfo) of theprovider to uniquely identify its type.The following keys are always present:
CcInfo: the CcInfo provider instance for the libraries.
DefaultInfo: the DefaultInfo provider instance for the headers.
A map is used to allow additional providers from the originating librariestarget (typically a
cc_library) to be propagated to consumers (directlyexposing a Target object can cause memory issues and is an anti-pattern).When consuming this map, it’s suggested to use
providers_map.values()toreturn all providers; or copy the map and filter out or replace keys asappropriate. Note that any keys beginning with_(underscore) areconsidered private and should be forward along as-is (this better allowse.g.:current_py_cc_headersto act as the underlying headers target itrepresents).