// 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.packages; import com.google.devtools.build.lib.concurrent.ThreadSafety.Immutable; import com.google.devtools.build.lib.events.Location; import com.google.devtools.build.lib.packages.NativeProvider.NativeKey; import com.google.devtools.build.lib.skylarkinterface.SkylarkPrinter; import com.google.devtools.build.lib.syntax.EvalException; import javax.annotation.Nullable; /** * Base class for declared providers {@see Provider} defined in native code. * *
Every subclass of {@link BuiltinProvider} corresponds to a single declared * provider. This is enforced by final {@link #equals(Object)} and {@link #hashCode()}. * *
Implementations of native declared providers should subclass this class, and define a method
* in the subclass definition to create instances of its corresponding Info object. The method
* should be annotated with {@link SkylarkCallable} with {@link SkylarkCallable#selfCall} set to
* true, and with {@link SkylarkConstructor} for the info type it constructs.
*/
@Immutable
public abstract class BuiltinProvider