src/test/java/com/google/devtools/build/lib/worker/ExampleWorkerOptions.java

// Copyright 2015 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.worker;

import com.google.devtools.common.options.Option;
import com.google.devtools.common.options.OptionDocumentationCategory;
import com.google.devtools.common.options.OptionEffectTag;
import com.google.devtools.common.options.OptionsBase;

/**
 * Options for the example worker itself.
 */
public class ExampleWorkerOptions extends OptionsBase {

  /**
   * Options for the example worker concerning single units of work.
   */
  public static class ExampleWorkOptions extends OptionsBase {
    @Option(
      name = "output_file",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.NO_OP},
      defaultValue = "",
      help = "Write the output to a file instead of stdout."
    )
    public String outputFile;

    @Option(
      name = "uppercase",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.NO_OP},
      defaultValue = "false",
      help = "Uppercase the input."
    )
    public boolean uppercase;

    @Option(
      name = "write_uuid",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.NO_OP},
      defaultValue = "false",
      help = "Writes a UUID into the output."
    )
    public boolean writeUUID;

    @Option(
      name = "write_counter",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.NO_OP},
      defaultValue = "false",
      help = "Writes a counter that increases with each work unit processed into the output."
    )
    public boolean writeCounter;

    @Option(
      name = "print_inputs",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.NO_OP},
      defaultValue = "false",
      help = "Writes a list of input files and their digests."
    )
    public boolean printInputs;

    @Option(
      name = "print_env",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.NO_OP},
      defaultValue = "false",
      help = "Prints a list of all environment variables."
    )
    public boolean printEnv;
  }

  @Option(
    name = "persistent_worker",
    documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
    effectTags = {OptionEffectTag.NO_OP},
    defaultValue = "false"
  )
  public boolean persistentWorker;

  @Option(
    name = "exit_after",
    documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
    effectTags = {OptionEffectTag.NO_OP},
    defaultValue = "0",
    help = "The worker exits after processing this many work units (default: disabled)."
  )
  public int exitAfter;

  @Option(
    name = "poison_after",
    documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
    effectTags = {OptionEffectTag.NO_OP},
    defaultValue = "0",
    help =
        "Poisons the worker after processing this many work units, so that it returns a "
            + "corrupt response instead of a response protobuf from then on (default: disabled)."
  )
  public int poisonAfter;

  @Option(
    name = "hard_poison",
    documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
    effectTags = {OptionEffectTag.NO_OP},
    defaultValue = "false",
    help = "Instead of writing an error message to stdout, write it to stderr and terminate."
  )
  public boolean hardPoison;
}