操作

Nightly · 9.1 · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1
在规则分析期间创建的操作。

此对象是为测试目的而显示的，并且可以从 Actions 提供程序获取。通常，无需在规则的实现函数中访问 Action 对象或其字段。您可能需要查看“规则”页面，了解有关如何在定义自定义规则时使用操作的一般讨论，或者查看用于创建操作的 API 参考文档。

此对象的某些字段仅适用于某些类型的操作。不适用的字段设置为 None。

成员

args

sequence Action.args

包含操作实参相关信息的冻结 Args 对象列表。这些对象包含准确的实参信息，包括涉及展开的操作输出目录的实参。不过，在分析阶段，Args 对象不可读。如需了解在分析阶段提供的准确性较低的实参，请参阅 argv。

请注意，某些类型的操作尚不支持公开此字段。对于此类操作类型，此字段为 None。 可能会返回 None。

argv

sequence Action.argv

对于由 ctx.actions.run() 或 ctx.actions.run_shell() 创建的操作，这是要执行的命令行实参的不可变列表。请注意，对于 Shell 操作，前两个实参将是 Shell 路径和 "-c"。 可能会返回 None。

content

string Action.content

对于由 ctx.actions.write() 或 ctx.actions.expand_template() 创建的操作，这是要写入的文件的内容（如果可以在分析阶段计算这些内容）。如果内容在执行阶段之前无法确定（例如，当需要展开 Args 对象中的目录时），则该值为 None。 可能会返回 None。

env

dict Action.env

此操作的“固定”环境变量。这仅包括操作定义明确设置的环境设置，因此会省略仅在执行环境中预设的设置。

inputs

depset Action.inputs

此操作的输入文件集。

mnemonic

string Action.mnemonic

此操作的助记符。

outputs

depset Action.outputs

此操作的输出文件集。

substitutions

dict Action.substitutions

对于由 ctx.actions.expand_template() 创建的操作，这是一个包含替换映射的不可变字典。 可能会返回 None。