C++: Implements Skylark cc_common.compile()/link().

Working towards #4570.

RELNOTES:none
PiperOrigin-RevId: 205274676

2 files changed, 231 insertions, 2 deletions

diff --git a/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/cpp/BazelCcModuleApi.java b/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/cpp/BazelCcModuleApi.java
new file mode 100644
index 0000000000..0238e0c7ab
--- /dev/null
+++ b/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/cpp/BazelCcModuleApi.java
@@ -0,0 +1,204 @@
+// Copyright 2018 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.
+
+package com.google.devtools.build.lib.skylarkbuildapi.cpp;
+
+import com.google.devtools.build.lib.actions.Artifact;
+import com.google.devtools.build.lib.analysis.skylark.SkylarkRuleContext;
+import com.google.devtools.build.lib.skylarkbuildapi.SkylarkRuleContextApi;
+import com.google.devtools.build.lib.skylarkinterface.Param;
+import com.google.devtools.build.lib.skylarkinterface.ParamType;
+import com.google.devtools.build.lib.skylarkinterface.SkylarkCallable;
+import com.google.devtools.build.lib.skylarkinterface.SkylarkModule;
+import com.google.devtools.build.lib.syntax.EvalException;
+import com.google.devtools.build.lib.syntax.Runtime.NoneType;
+import com.google.devtools.build.lib.syntax.SkylarkList;
+import com.google.devtools.build.lib.syntax.SkylarkNestedSet;
+
+/** Utilites related to C++ support. */
+@SkylarkModule(
+    name = "cc_common",
+    doc = "Utilities for C++ compilation, linking, and command line generation.")
+// TODO(b/111365281): Add experimental field once it's available.
+public interface BazelCcModuleApi<
+        CcToolchainProviderT extends CcToolchainProviderApi,
+        FeatureConfigurationT extends FeatureConfigurationApi,
+        CompilationInfoT extends CompilationInfoApi,
+        CcCompilationInfoT extends CcCompilationInfoApi,
+        CcCompilationOutputsT extends CcCompilationOutputsApi,
+        LinkingInfoT extends LinkingInfoApi,
+        CcLinkingInfoT extends CcLinkingInfoApi,
+        CcToolchainVariablesT extends CcToolchainVariablesApi,
+        LibraryToLinkT extends LibraryToLinkApi,
+        CcLinkParamsT extends CcLinkParamsApi,
+        CcSkylarkInfoT extends CcSkylarkInfoApi>
+    extends CcModuleApi<
+        CcToolchainProviderT,
+        FeatureConfigurationT,
+        CcToolchainVariablesT,
+        LibraryToLinkT,
+        CcLinkParamsT,
+        CcSkylarkInfoT> {
+
+  @SkylarkCallable(
+      name = "compile",
+      documented = false,
+      parameters = {
+        @Param(
+            name = "ctx",
+            positional = false,
+            named = true,
+            type = SkylarkRuleContextApi.class,
+            doc = "The rule context."),
+        @Param(
+            name = "feature_configuration",
+            doc = "Feature configuration to be queried.",
+            positional = false,
+            named = true,
+            type = FeatureConfigurationApi.class),
+        @Param(
+            name = "cc_toolchain",
+            doc = "C++ toolchain provider to be used.",
+            positional = false,
+            named = true,
+            type = CcToolchainProviderApi.class),
+        @Param(
+            name = "srcs",
+            doc = "The list of source files to be compiled, see cc_library.srcs",
+            positional = false,
+            named = true,
+            defaultValue = "[]",
+            type = SkylarkList.class),
+        @Param(
+            name = "hdrs",
+            doc = "The list of public headers to be provided to dependents, see cc_library.hdrs",
+            positional = false,
+            named = true,
+            defaultValue = "[]",
+            type = SkylarkList.class),
+        @Param(
+            name = "includes",
+            doc = "Include directories",
+            positional = false,
+            named = true,
+            noneable = true,
+            defaultValue = "[]",
+            allowedTypes = {
+              @ParamType(type = SkylarkNestedSet.class),
+              @ParamType(type = SkylarkList.class)
+            }),
+        @Param(
+            name = "copts",
+            doc = "Additional list of compiler options.",
+            positional = false,
+            named = true,
+            noneable = true,
+            defaultValue = "None",
+            allowedTypes = {
+              @ParamType(type = SkylarkNestedSet.class),
+              @ParamType(type = NoneType.class)
+            }),
+        @Param(
+            name = "cc_compilation_infos",
+            doc = "cc_compilation_info instances affecting compilation, e.g. from dependencies",
+            positional = false,
+            named = true,
+            defaultValue = "[]",
+            type = SkylarkList.class)
+      })
+  CompilationInfoT compile(
+      SkylarkRuleContext skylarkRuleContext,
+      FeatureConfigurationT skylarkFeatureConfiguration,
+      CcToolchainProviderT skylarkCcToolchainProvider,
+      SkylarkList<Artifact> sources,
+      SkylarkList<Artifact> headers,
+      Object skylarkIncludes,
+      Object skylarkCopts,
+      SkylarkList<CcCompilationInfoT> ccCompilationInfos)
+      throws EvalException;
+
+  @SkylarkCallable(
+      name = "link",
+      documented = false,
+      parameters = {
+        @Param(
+            name = "ctx",
+            positional = false,
+            named = true,
+            type = SkylarkRuleContextApi.class,
+            doc = "The rule context."),
+        @Param(
+            name = "feature_configuration",
+            doc = "Feature configuration to be queried.",
+            positional = false,
+            named = true,
+            type = FeatureConfigurationApi.class),
+        @Param(
+            name = "cc_toolchain",
+            doc = "C++ toolchain provider to be used.",
+            positional = false,
+            named = true,
+            type = CcToolchainProviderApi.class),
+        @Param(
+            name = "cc_compilation_outputs",
+            doc = "List of object files to be linked.",
+            positional = false,
+            named = true,
+            defaultValue = "[]",
+            type = CcCompilationOutputsApi.class),
+        @Param(
+            name = "linkopts",
+            doc = "Additional list of linker options.",
+            positional = false,
+            named = true,
+            defaultValue = "[]",
+            noneable = true,
+            allowedTypes = {
+              @ParamType(type = SkylarkList.class),
+              @ParamType(type = SkylarkNestedSet.class)
+            }),
+        @Param(
+            name = "dynamic_library",
+            doc = "Dynamic library artifact.",
+            positional = false,
+            named = true,
+            defaultValue = "None",
+            noneable = true,
+            allowedTypes = {@ParamType(type = NoneType.class), @ParamType(type = Artifact.class)}),
+        @Param(
+            name = "cc_linking_infos",
+            doc = "cc_linking_info instances affecting linking, e.g. from dependencies",
+            positional = false,
+            named = true,
+            noneable = true,
+            defaultValue = "[]",
+            type = SkylarkList.class),
+        @Param(
+            name = "neverlink",
+            doc = "True if this should never be linked against other libraries.",
+            positional = false,
+            named = true,
+            defaultValue = "False"),
+      })
+  LinkingInfoT link(
+      SkylarkRuleContext skylarkRuleContext,
+      FeatureConfigurationT skylarkFeatureConfiguration,
+      CcToolchainProviderT skylarkCcToolchainProvider,
+      CcCompilationOutputsT ccCompilationOutputs,
+      Object skylarkLinkopts,
+      Object dynamicLibrary,
+      SkylarkList<CcLinkingInfoT> skylarkCcLinkingInfos,
+      boolean neverLink)
+      throws InterruptedException, EvalException;
+}
diff --git a/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/cpp/CcBootstrap.java b/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/cpp/CcBootstrap.java
index 4286d3dbe2..02be5be14f 100644
--- a/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/cpp/CcBootstrap.java
+++ b/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/cpp/CcBootstrap.java
@@ -22,9 +22,34 @@ import com.google.devtools.build.lib.skylarkbuildapi.Bootstrap;
  */
 public class CcBootstrap implements Bootstrap {
 
-  private final CcModuleApi ccModule;
+  private final BazelCcModuleApi<
+          ? extends CcToolchainProviderApi,
+          ? extends FeatureConfigurationApi,
+          ? extends CompilationInfoApi,
+          ? extends CcCompilationInfoApi,
+          ? extends CcCompilationOutputsApi,
+          ? extends LinkingInfoApi,
+          ? extends CcLinkingInfoApi,
+          ? extends CcToolchainVariablesApi,
+          ? extends LibraryToLinkApi,
+          ? extends CcLinkParamsApi,
+          ? extends CcSkylarkInfoApi>
+      ccModule;
 
-  public CcBootstrap(CcModuleApi ccModule) {
+  public CcBootstrap(
+      BazelCcModuleApi<
+              ? extends CcToolchainProviderApi,
+              ? extends FeatureConfigurationApi,
+              ? extends CompilationInfoApi,
+              ? extends CcCompilationInfoApi,
+              ? extends CcCompilationOutputsApi,
+              ? extends LinkingInfoApi,
+              ? extends CcLinkingInfoApi,
+              ? extends CcToolchainVariablesApi,
+              ? extends LibraryToLinkApi,
+              ? extends CcLinkParamsApi,
+              ? extends CcSkylarkInfoApi>
+          ccModule) {
     this.ccModule = ccModule;
   }