// Copyright 2014 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.analysis.config; import com.google.common.collect.ImmutableList; import com.google.common.collect.ImmutableMap; import com.google.common.collect.Multimap; import com.google.devtools.build.lib.cmdline.Label; import com.google.devtools.build.lib.cmdline.LabelSyntaxException; import com.google.devtools.build.lib.packages.Attribute.SplitTransition; import com.google.devtools.common.options.Options; import com.google.devtools.common.options.OptionsBase; import java.io.Serializable; import java.util.List; import java.util.Map; import java.util.Set; /** * Command-line build options for a Blaze module. */ public abstract class FragmentOptions extends OptionsBase implements Cloneable, Serializable { /** * Adds all labels defined by the options to a multimap. See {@code BuildOptions.getAllLabels()}. * *
There should generally be no code duplication between this code and DefaultsPackage. Either
* the labels are loaded unconditionally using this method, or they are added as magic labels
* using the tools/defaults package, but not both.
*
* @param labelMap a mutable multimap to which the labels of this fragment should be added
*/
public void addAllLabels(Multimap The set of keys returned by this function should be constant, however, the values are
* allowed to change depending on the value of the options.
*/
@SuppressWarnings("unused")
public Map The return value should be a list of strings, which are merged into the BUILD files of the
* defaults package.
*
* WARNING; this method should only be used when absolutely necessary. Always
* prefer {@code getDefaultsLabels()} to this.
*/
public ImmutableList