Package com.google.devtools.build.lib.runtime.proto

Class InvocationPolicyOuterClass.SetValue

    • Method Detail

      • newInstance

        protected java.lang.Object newInstance​(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused)
        Overrides:
        newInstance in class com.google.protobuf.GeneratedMessageV3

      • getUnknownFields

        public final com.google.protobuf.UnknownFieldSet getUnknownFields()
        Specified by:
        getUnknownFields in interface com.google.protobuf.MessageOrBuilder
        Overrides:
        getUnknownFields in class com.google.protobuf.GeneratedMessageV3

      • getDescriptor

        public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

      • internalGetFieldAccessorTable

        protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
        Specified by:
        internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3

      • getFlagValueList

        public com.google.protobuf.ProtocolStringList getFlagValueList()
         Use this value for the specified flag, overriding any default or user-set
 value (unless append is set to true for repeatable flags).
 This field is repeated for repeatable flags. It is an error to set
 multiple values for a flag that is not actually a repeatable flag.
 This requires at least 1 value, if even the empty string.
 If the flag allows multiple values, all of its values are replaced with the
 value or values from the policy (i.e., no diffing or merging is performed),
 unless the append field (see below) is set to true.
 Note that some flags are tricky. For example, some flags look like boolean
 flags, but are actually Void expansion flags that expand into other flags.
 The Bazel flag parser will accept "--void_flag=false", but because
 the flag is Void, the "=false" is ignored. It can get even trickier, like
 "--novoid_flag" which is also an expansion flag with the type Void whose
 name is explicitly "novoid_flag" and which expands into other flags that
 are the opposite of "--void_flag". For expansion flags, it's best to
 explicitly override the flags they expand into.
 Other flags may be differently tricky: A flag could have a converter that
 converts some string to a list of values, but that flag may not itself have
 allowMultiple set to true.
 An example is "--test_tag_filters": this flag sets its converter to
 CommaSeparatedOptionListConverter, but does not set allowMultiple to true.
 So "--test_tag_filters=foo,bar" results in ["foo", "bar"], however
 "--test_tag_filters=foo --test_tag_filters=bar" results in just ["bar"]
 since the 2nd value overrides the 1st.
 Similarly, "--test_tag_filters=foo,bar --test_tag_filters=baz,qux" results
 in ["baz", "qux"]. For flags like these, the policy should specify
 "foo,bar" instead of separately specifying "foo" and "bar" so that the
 converter is appropriately invoked.
 Note that the opposite is not necessarily
 true: for a flag that specifies allowMultiple=true, "--flag=foo,bar"
 may fail to parse or result in an unexpected value.
        repeated string flag_value = 1;
        Specified by:
        getFlagValueList in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Returns:
        A list containing the flagValue.

      • getFlagValueCount

        public int getFlagValueCount()
         Use this value for the specified flag, overriding any default or user-set
 value (unless append is set to true for repeatable flags).
 This field is repeated for repeatable flags. It is an error to set
 multiple values for a flag that is not actually a repeatable flag.
 This requires at least 1 value, if even the empty string.
 If the flag allows multiple values, all of its values are replaced with the
 value or values from the policy (i.e., no diffing or merging is performed),
 unless the append field (see below) is set to true.
 Note that some flags are tricky. For example, some flags look like boolean
 flags, but are actually Void expansion flags that expand into other flags.
 The Bazel flag parser will accept "--void_flag=false", but because
 the flag is Void, the "=false" is ignored. It can get even trickier, like
 "--novoid_flag" which is also an expansion flag with the type Void whose
 name is explicitly "novoid_flag" and which expands into other flags that
 are the opposite of "--void_flag". For expansion flags, it's best to
 explicitly override the flags they expand into.
 Other flags may be differently tricky: A flag could have a converter that
 converts some string to a list of values, but that flag may not itself have
 allowMultiple set to true.
 An example is "--test_tag_filters": this flag sets its converter to
 CommaSeparatedOptionListConverter, but does not set allowMultiple to true.
 So "--test_tag_filters=foo,bar" results in ["foo", "bar"], however
 "--test_tag_filters=foo --test_tag_filters=bar" results in just ["bar"]
 since the 2nd value overrides the 1st.
 Similarly, "--test_tag_filters=foo,bar --test_tag_filters=baz,qux" results
 in ["baz", "qux"]. For flags like these, the policy should specify
 "foo,bar" instead of separately specifying "foo" and "bar" so that the
 converter is appropriately invoked.
 Note that the opposite is not necessarily
 true: for a flag that specifies allowMultiple=true, "--flag=foo,bar"
 may fail to parse or result in an unexpected value.
        repeated string flag_value = 1;
        Specified by:
        getFlagValueCount in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Returns:
        The count of flagValue.

      • getFlagValue

        public java.lang.String getFlagValue​(int index)
         Use this value for the specified flag, overriding any default or user-set
 value (unless append is set to true for repeatable flags).
 This field is repeated for repeatable flags. It is an error to set
 multiple values for a flag that is not actually a repeatable flag.
 This requires at least 1 value, if even the empty string.
 If the flag allows multiple values, all of its values are replaced with the
 value or values from the policy (i.e., no diffing or merging is performed),
 unless the append field (see below) is set to true.
 Note that some flags are tricky. For example, some flags look like boolean
 flags, but are actually Void expansion flags that expand into other flags.
 The Bazel flag parser will accept "--void_flag=false", but because
 the flag is Void, the "=false" is ignored. It can get even trickier, like
 "--novoid_flag" which is also an expansion flag with the type Void whose
 name is explicitly "novoid_flag" and which expands into other flags that
 are the opposite of "--void_flag". For expansion flags, it's best to
 explicitly override the flags they expand into.
 Other flags may be differently tricky: A flag could have a converter that
 converts some string to a list of values, but that flag may not itself have
 allowMultiple set to true.
 An example is "--test_tag_filters": this flag sets its converter to
 CommaSeparatedOptionListConverter, but does not set allowMultiple to true.
 So "--test_tag_filters=foo,bar" results in ["foo", "bar"], however
 "--test_tag_filters=foo --test_tag_filters=bar" results in just ["bar"]
 since the 2nd value overrides the 1st.
 Similarly, "--test_tag_filters=foo,bar --test_tag_filters=baz,qux" results
 in ["baz", "qux"]. For flags like these, the policy should specify
 "foo,bar" instead of separately specifying "foo" and "bar" so that the
 converter is appropriately invoked.
 Note that the opposite is not necessarily
 true: for a flag that specifies allowMultiple=true, "--flag=foo,bar"
 may fail to parse or result in an unexpected value.
        repeated string flag_value = 1;
        Specified by:
        getFlagValue in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Parameters:
        index - The index of the element to return.
        Returns:
        The flagValue at the given index.

      • getFlagValueBytes

        public com.google.protobuf.ByteString getFlagValueBytes​(int index)
         Use this value for the specified flag, overriding any default or user-set
 value (unless append is set to true for repeatable flags).
 This field is repeated for repeatable flags. It is an error to set
 multiple values for a flag that is not actually a repeatable flag.
 This requires at least 1 value, if even the empty string.
 If the flag allows multiple values, all of its values are replaced with the
 value or values from the policy (i.e., no diffing or merging is performed),
 unless the append field (see below) is set to true.
 Note that some flags are tricky. For example, some flags look like boolean
 flags, but are actually Void expansion flags that expand into other flags.
 The Bazel flag parser will accept "--void_flag=false", but because
 the flag is Void, the "=false" is ignored. It can get even trickier, like
 "--novoid_flag" which is also an expansion flag with the type Void whose
 name is explicitly "novoid_flag" and which expands into other flags that
 are the opposite of "--void_flag". For expansion flags, it's best to
 explicitly override the flags they expand into.
 Other flags may be differently tricky: A flag could have a converter that
 converts some string to a list of values, but that flag may not itself have
 allowMultiple set to true.
 An example is "--test_tag_filters": this flag sets its converter to
 CommaSeparatedOptionListConverter, but does not set allowMultiple to true.
 So "--test_tag_filters=foo,bar" results in ["foo", "bar"], however
 "--test_tag_filters=foo --test_tag_filters=bar" results in just ["bar"]
 since the 2nd value overrides the 1st.
 Similarly, "--test_tag_filters=foo,bar --test_tag_filters=baz,qux" results
 in ["baz", "qux"]. For flags like these, the policy should specify
 "foo,bar" instead of separately specifying "foo" and "bar" so that the
 converter is appropriately invoked.
 Note that the opposite is not necessarily
 true: for a flag that specifies allowMultiple=true, "--flag=foo,bar"
 may fail to parse or result in an unexpected value.
        repeated string flag_value = 1;
        Specified by:
        getFlagValueBytes in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Parameters:
        index - The index of the value to return.
        Returns:
        The bytes of the flagValue at the given index.

      • hasOverridable

        public boolean hasOverridable()
         Whether to allow this policy to be overridden by user-specified values.
 When set, if the user specified a value for this flag, use the value
 from the user, otherwise use the value specified in this policy.
 This value is redundant to behavior -- please keep it in sync with it.
        optional bool overridable = 2;
        Specified by:
        hasOverridable in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Returns:
        Whether the overridable field is set.

      • getOverridable

        public boolean getOverridable()
         Whether to allow this policy to be overridden by user-specified values.
 When set, if the user specified a value for this flag, use the value
 from the user, otherwise use the value specified in this policy.
 This value is redundant to behavior -- please keep it in sync with it.
        optional bool overridable = 2;
        Specified by:
        getOverridable in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Returns:
        The overridable.

      • hasAppend

        public boolean hasAppend()
         If true, and if the flag named in the policy is a repeatable flag, then
 the values listed in flag_value do not replace all the user-set or default
 values of the flag, but instead append to them. If the flag is not
 repeatable, then this has no effect.
 This value is redundant to behavior -- please keep it in sync with it.
        optional bool append = 3;
        Specified by:
        hasAppend in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Returns:
        Whether the append field is set.

      • getAppend

        public boolean getAppend()
         If true, and if the flag named in the policy is a repeatable flag, then
 the values listed in flag_value do not replace all the user-set or default
 values of the flag, but instead append to them. If the flag is not
 repeatable, then this has no effect.
 This value is redundant to behavior -- please keep it in sync with it.
        optional bool append = 3;
        Specified by:
        getAppend in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Returns:
        The append.

      • hasBehavior

        public boolean hasBehavior()
         Defines how invocation policy should interact with user settings for the
 same flag.
 For the time being, it coexists with overridable and append with duplicate
 semantics.Please fill both of the values as we migrate to use behavior
 only.
 TODO(b/186167747): Deprecate and remove append and overridable flag in
 favor of this one.
        optional .blaze.invocation_policy.SetValue.Behavior behavior = 4;
        Specified by:
        hasBehavior in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Returns:
        Whether the behavior field is set.

      • getBehavior

        public InvocationPolicyOuterClass.SetValue.Behavior getBehavior()
         Defines how invocation policy should interact with user settings for the
 same flag.
 For the time being, it coexists with overridable and append with duplicate
 semantics.Please fill both of the values as we migrate to use behavior
 only.
 TODO(b/186167747): Deprecate and remove append and overridable flag in
 favor of this one.
        optional .blaze.invocation_policy.SetValue.Behavior behavior = 4;
        Specified by:
        getBehavior in interface InvocationPolicyOuterClass.SetValueOrBuilder
        Returns:
        The behavior.

      • isInitialized

        public final boolean isInitialized()
        Specified by:
        isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
        Overrides:
        isInitialized in class com.google.protobuf.GeneratedMessageV3

      • writeTo

        public void writeTo​(com.google.protobuf.CodedOutputStream output)
             throws java.io.IOException
        Specified by:
        writeTo in interface com.google.protobuf.MessageLite
        Overrides:
        writeTo in class com.google.protobuf.GeneratedMessageV3
        Throws:
        java.io.IOException

      • getSerializedSize

        public int getSerializedSize()
        Specified by:
        getSerializedSize in interface com.google.protobuf.MessageLite
        Overrides:
        getSerializedSize in class com.google.protobuf.GeneratedMessageV3

      • equals

        public boolean equals​(java.lang.Object obj)
        Specified by:
        equals in interface com.google.protobuf.Message
        Overrides:
        equals in class com.google.protobuf.AbstractMessage

      • hashCode

        public int hashCode()
        Specified by:
        hashCode in interface com.google.protobuf.Message
        Overrides:
        hashCode in class com.google.protobuf.AbstractMessage

      • parseFrom

        public static InvocationPolicyOuterClass.SetValue parseFrom​(java.nio.ByteBuffer data)
                                                     throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static InvocationPolicyOuterClass.SetValue parseFrom​(java.nio.ByteBuffer data,
                                                            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                                     throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static InvocationPolicyOuterClass.SetValue parseFrom​(com.google.protobuf.ByteString data)
                                                     throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static InvocationPolicyOuterClass.SetValue parseFrom​(com.google.protobuf.ByteString data,
                                                            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                                     throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static InvocationPolicyOuterClass.SetValue parseFrom​(byte[] data)
                                                     throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static InvocationPolicyOuterClass.SetValue parseFrom​(byte[] data,
                                                            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                                     throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static InvocationPolicyOuterClass.SetValue parseFrom​(java.io.InputStream input,
                                                            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                                     throws java.io.IOException
        Throws:
        java.io.IOException

      • parseDelimitedFrom

        public static InvocationPolicyOuterClass.SetValue parseDelimitedFrom​(java.io.InputStream input)
                                                              throws java.io.IOException
        Throws:
        java.io.IOException

      • parseDelimitedFrom

        public static InvocationPolicyOuterClass.SetValue parseDelimitedFrom​(java.io.InputStream input,
                                                                     com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                                              throws java.io.IOException
        Throws:
        java.io.IOException

      • parseFrom

        public static InvocationPolicyOuterClass.SetValue parseFrom​(com.google.protobuf.CodedInputStream input)
                                                     throws java.io.IOException
        Throws:
        java.io.IOException

      • parseFrom

        public static InvocationPolicyOuterClass.SetValue parseFrom​(com.google.protobuf.CodedInputStream input,
                                                            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                                     throws java.io.IOException
        Throws:
        java.io.IOException

      • newBuilderForType

        public InvocationPolicyOuterClass.SetValue.Builder newBuilderForType()
        Specified by:
        newBuilderForType in interface com.google.protobuf.Message
        Specified by:
        newBuilderForType in interface com.google.protobuf.MessageLite

      • newBuilderForType

        protected InvocationPolicyOuterClass.SetValue.Builder newBuilderForType​(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)
        Specified by:
        newBuilderForType in class com.google.protobuf.GeneratedMessageV3

      • getParserForType

        public com.google.protobuf.Parser<InvocationPolicyOuterClass.SetValue> getParserForType()
        Specified by:
        getParserForType in interface com.google.protobuf.Message
        Specified by:
        getParserForType in interface com.google.protobuf.MessageLite
        Overrides:
        getParserForType in class com.google.protobuf.GeneratedMessageV3

      • getDefaultInstanceForType

        public InvocationPolicyOuterClass.SetValue getDefaultInstanceForType()
        Specified by:
        getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
        Specified by:
        getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder