Add execution_requirements to ctx.actions.write

Since Bazel's only `FileWriteStrategy` doesn't execute a spawn, this can currently only affect the path mapping behavior of the action when supplying `Args` as content. This will make it possible to opt C++ rules into path mapping without any command line flags beyond `--experimental_output_paths=strip` in future PRs.

Work towards bazelbuild#27732
Work towards bazelbuild#27591

Closes bazelbuild#28335.

PiperOrigin-RevId: 859069420
Change-Id: I73db26fb1f37303f49931ab19cd12575536607fb

Author: fmeum

src/main/java/com/google/devtools/build/lib/analysis/starlark/StarlarkActionFactory.java

@@ -358,7 +358,12 @@ public void symlink(
   }
 
   @Override
-  public void write(FileApi output, Object content, Boolean isExecutable, Object mnemonicUnchecked)
+  public void write(
+      FileApi output,
+      Object content,
+      Boolean isExecutable,
+      Object mnemonicUnchecked,
+      Object executionRequirementsUnchecked)
       throws EvalException, InterruptedException {
     context.checkMutable("actions.write");
     RuleContext ruleContext = getRuleContext();
@@ -371,6 +376,11 @@ public void write(FileApi output, Object content, Boolean isExecutable, Object m
           FileWriteAction.create(
               ruleContext, (Artifact) output, (String) content, isExecutable, mnemonic);
     } else if (content instanceof Args args) {
+      var unmodifiedExecutionRequirements =
+          TargetUtils.getFilteredExecutionInfo(
+              executionRequirementsUnchecked,
+              ruleContext.getRule(),
+              getSemantics().getBool(BuildLanguageOptions.INCOMPATIBLE_ALLOW_TAGS_PROPAGATION));
       action =
           new ParameterFileWriteAction(
               ruleContext.getActionOwner(),
@@ -380,7 +390,9 @@ public void write(FileApi output, Object content, Boolean isExecutable, Object m
               args.getParameterFileType(),
               isExecutable,
               mnemonic,
-              ruleContext.getConfiguration().modifiedExecutionInfo(ImmutableMap.of(), mnemonic),
+              ruleContext
+                  .getConfiguration()
+                  .modifiedExecutionInfo(unmodifiedExecutionRequirements, mnemonic),
               PathMappers.getOutputPathsMode(ruleContext.getConfiguration()));
     } else {
       throw new AssertionError("Unexpected type: " + content.getClass().getSimpleName());

src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkActionFactoryApi.java

@@ -373,8 +373,26 @@ void symlink(
             named = true,
             positional = false,
             doc = "A one-word description of the action, for example, CppCompile or GoLink."),
+        @Param(
+            name = "execution_requirements",
+            allowedTypes = {
+              @ParamType(type = Dict.class),
+              @ParamType(type = NoneType.class),
+            },
+            defaultValue = "None",
+            named = true,
+            positional = false,
+            doc =
+                "Information for scheduling the action. See "
+                    + "<a href=\"${link common-definitions#common.tags}\">tags</a> "
+                    + "for useful keys."),
       })
-  void write(FileApi output, Object content, Boolean isExecutable, Object mnemonicUnchecked)
+  void write(
+      FileApi output,
+      Object content,
+      Boolean isExecutable,
+      Object mnemonicUnchecked,
+      Object executionRequirementsUnchecked)
       throws EvalException, InterruptedException;
 
   @StarlarkMethod(

src/test/java/com/google/devtools/build/lib/starlark/StarlarkRuleContextTest.java

@@ -30,6 +30,7 @@
 import com.google.common.collect.ImmutableMap;
 import com.google.common.collect.ImmutableSet;
 import com.google.common.collect.Iterables;
+import com.google.devtools.build.lib.actions.Action;
 import com.google.devtools.build.lib.actions.ActionAnalysisMetadata;
 import com.google.devtools.build.lib.actions.Artifact;
 import com.google.devtools.build.lib.actions.CommandLine;
@@ -3129,6 +3130,33 @@ public void testFileWriteActionInterfaceWithArgsAndCustomMnemonic() throws Excep
     assertThat(contentUnchecked).isEqualTo("foo123\n");
   }
 
+  @Test
+  public void testFileWriteActionInterfaceWithArgsAndSupportsPathMapping() throws Exception {
+    useConfiguration("--experimental_output_paths=strip");
+    scratch.file(
+        "test/rules.bzl",
+        getSimpleUnderTestDefinition(
+            "args = ctx.actions.args()",
+            "args.add('foo123')",
+            "ctx.actions.write(output=out, content=args,"
+                + " execution_requirements={'supports-path-mapping': ''})"),
+        testingRuleDefinition);
+    scratch.file("test/BUILD", simpleBuildDefinition);
+    StarlarkRuleContext ruleContext = createRuleContext("//test:testing");
+    setRuleContext(ruleContext);
+    ev.update("file", ev.eval("ruleContext.attr.dep[DefaultInfo].files.to_list()[0]"));
+    var action = (Action) ev.eval("ruleContext.attr.dep[Actions].by_file[file]");
+    ev.update("action", action);
+
+    assertThat(ev.eval("type(action)")).isEqualTo("Action");
+    assertThat(action.getExecutionInfo()).containsEntry("supports-path-mapping", "");
+
+    Object contentUnchecked = ev.eval("action.content");
+    assertThat(contentUnchecked).isInstanceOf(String.class);
+    // Args content ends the file with a newline
+    assertThat(contentUnchecked).isEqualTo("foo123\n");
+  }
+
   @Test
   public void testFileWriteActionInterfaceWithArgsContainingTreeArtifact() throws Exception {
     scratch.file(