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

Class SourceAttribute

java.lang.Object

com.facebook.buck.core.starlark.rule.attr.Attribute<SourcePath>

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

All Implemented Interfaces:

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

public abstract class SourceAttribute
extends Attribute<SourcePath>

Represents a single source file, whether on disk or another build target

Using this attribute will automatically add source files that are build targets as dependencies.

Constructor Summary

Constructors

Constructor and Description
SourceAttribute()

Method Summary

Modifier and Type	Method and Description
abstract String	getDoc() The docstring to use for this attribute
abstract boolean	getMandatory() Whether this attribute is mandatory or not
PostCoercionTransform<RuleAnalysisContext,Artifact>	getPostCoercionTransform()
abstract Object	getPreCoercionDefaultValue() The default value to use if no value is provided.
TypeCoercer<?,SourcePath>	getTypeCoercer() The type coercer to use to convert raw values from the parser into something usable internally.
static SourceAttribute	of(Object preCoercionDefaultValue, String doc, boolean mandatory)
void	repr(com.google.devtools.build.lib.skylarkinterface.SkylarkPrinter printer)

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

getAttribute, getGenericType, getValue, validateCoercedValue, 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

SourceAttribute

public SourceAttribute()

Method Detail

getPreCoercionDefaultValue

public abstract Object 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<SourcePath>

getDoc

public abstract String getDoc()

Description copied from class: Attribute

The docstring to use for this attribute

Specified by:

getDoc in class Attribute<SourcePath>

getMandatory

public abstract boolean getMandatory()

Description copied from class: Attribute

Whether this attribute is mandatory or not

Specified by:

getMandatory in class Attribute<SourcePath>

repr

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

getTypeCoercer

public TypeCoercer<?,SourcePath> 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<SourcePath>

getPostCoercionTransform

public PostCoercionTransform<RuleAnalysisContext,Artifact> getPostCoercionTransform()

Overrides:

getPostCoercionTransform in class Attribute<SourcePath>

Returns:

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

of

public static SourceAttribute of(Object preCoercionDefaultValue,
                                 String doc,
                                 boolean mandatory)