com.facebook.buck.core.starlark.rule.attr.impl

Class UnconfiguredOptionalDepAttribute

java.lang.Object

com.facebook.buck.core.starlark.rule.attr.Attribute<Optional<UnconfiguredBuildTarget>>

com.facebook.buck.core.starlark.rule.attr.impl.UnconfiguredOptionalDepAttribute

All Implemented Interfaces:

AttributeHolder, com.google.devtools.build.lib.skylarkinterface.SkylarkPrintable, com.google.devtools.build.lib.skylarkinterface.SkylarkValue

public abstract class UnconfiguredOptionalDepAttribute
extends Attribute<Optional<UnconfiguredBuildTarget>>

Represents a list of targets. Currently used only for default_target_platform.

Constructor Summary

Constructors

Constructor and Description
UnconfiguredOptionalDepAttribute()

Method Summary

Modifier and Type	Method and Description
abstract boolean	getAllowEmpty() Whether or not the list can be empty
abstract String	getDoc() The docstring to use for this attribute
abstract boolean	getMandatory() Whether this attribute is mandatory or not
PostCoercionTransform<RuleAnalysisContext,List<SkylarkDependency>>	getPostCoercionTransform()
abstract Optional<String>	getPreCoercionDefaultValue() The default value to use if no value is provided.
TypeCoercer<?,Optional<UnconfiguredBuildTarget>>	getTypeCoercer() The type coercer to use to convert raw values from the parser into something usable internally.
static UnconfiguredOptionalDepAttribute	of(Optional<String> preCoercionDefaultValue, String doc, boolean mandatory, boolean allowEmpty)
void	repr(com.google.devtools.build.lib.skylarkinterface.SkylarkPrinter printer)
void	validateCoercedValue(Optional<UnconfiguredBuildTarget> paths) Validates values post-coercion to ensure other properties besides 'type' are valid

Methods inherited from class com.facebook.buck.core.starlark.rule.attr.Attribute

getAttribute, getGenericType, getValue, validateProvidersPresent, validateValueInList

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.google.devtools.build.lib.skylarkinterface.SkylarkValue

isHashable, isImmutable

Methods inherited from interface com.google.devtools.build.lib.skylarkinterface.SkylarkPrintable

debugPrint, str

Constructor Detail

UnconfiguredOptionalDepAttribute

public UnconfiguredOptionalDepAttribute()

Method Detail

getPreCoercionDefaultValue

public abstract Optional<String> getPreCoercionDefaultValue()

Description copied from class: Attribute

The default value to use if no value is provided.

This will be validated against Attribute.getTypeCoercer(), so may return a value whose type does not match CoercedType (e.g. a list of strings, rather than a list of SourcePath)

Specified by:

getPreCoercionDefaultValue in class Attribute<Optional<UnconfiguredBuildTarget>>

getDoc

public abstract String getDoc()

Description copied from class: Attribute

The docstring to use for this attribute

Specified by:

getDoc in class Attribute<Optional<UnconfiguredBuildTarget>>

getMandatory

public abstract boolean getMandatory()

Description copied from class: Attribute

Whether this attribute is mandatory or not

Specified by:

getMandatory in class Attribute<Optional<UnconfiguredBuildTarget>>

getAllowEmpty

public abstract boolean getAllowEmpty()

Whether or not the list can be empty

repr

public void repr(com.google.devtools.build.lib.skylarkinterface.SkylarkPrinter printer)

getTypeCoercer

public TypeCoercer<?,Optional<UnconfiguredBuildTarget>> getTypeCoercer()

Description copied from class: Attribute

The type coercer to use to convert raw values from the parser into something usable internally. This coercer also performs validation

Specified by:

getTypeCoercer in class Attribute<Optional<UnconfiguredBuildTarget>>

validateCoercedValue

public void validateCoercedValue(Optional<UnconfiguredBuildTarget> paths)
                          throws CoerceFailedException

Description copied from class: Attribute

Validates values post-coercion to ensure other properties besides 'type' are valid

Overrides:

validateCoercedValue in class Attribute<Optional<UnconfiguredBuildTarget>>

Parameters:

paths - The value to check

Throws:

CoerceFailedException - if the value is invalid (e.g. not in a list of pre-approved values)

getPostCoercionTransform

public PostCoercionTransform<RuleAnalysisContext,List<SkylarkDependency>> getPostCoercionTransform()

Overrides:

getPostCoercionTransform in class Attribute<Optional<UnconfiguredBuildTarget>>

Returns:

a method that transforms a coerced value into something more useful to users, taking into account the rule's dependencies

of

public static UnconfiguredOptionalDepAttribute of(Optional<String> preCoercionDefaultValue,
                                                  String doc,
                                                  boolean mandatory,
                                                  boolean allowEmpty)