blob: 8e2e40200424a9df233b9830622e0e2f190ac7aa [file] [log] [blame]
// 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;
import com.google.devtools.build.lib.skylarkinterface.SkylarkModule;
import com.google.devtools.build.lib.skylarkinterface.SkylarkModuleCategory;
import com.google.devtools.build.lib.syntax.ClassObject;
import com.google.devtools.build.lib.syntax.StarlarkValue;
/** Represents a collection of configuration fragments in Skylark. */
@SkylarkModule(
name = "fragments",
category = SkylarkModuleCategory.BUILTIN,
doc =
"Possible fields are "
+ "<a href=\"android.html\">android</a>, <a href=\"apple.html\">apple</a>, "
+ "<a href=\"cpp.html\">cpp</a>, <a href=\"java.html\">java</a>, "
+ "<a href=\"jvm.html\">jvm</a>, and <a href=\"objc.html\">objc</a>. "
+ "Access a specific fragment by its field name "
+ "ex:</p><code>ctx.fragments.apple</code></p>"
+ "Note that rules have to declare their required fragments in order to access them "
+ "(see <a href=\"../rules.md#fragments\">here</a>).")
public interface FragmentCollectionApi extends ClassObject, StarlarkValue {}