src/main/java/com/google/devtools/build/lib/pkgcache/LoadingOptions.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.pkgcache;

import com.google.devtools.build.lib.packages.TestSize;
import com.google.devtools.build.lib.packages.TestTimeout;
import com.google.devtools.common.options.Converters.CommaSeparatedOptionListConverter;
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.OptionMetadataTag;
import com.google.devtools.common.options.OptionsBase;
import com.google.devtools.common.options.OptionsClass;
import java.util.List;
import java.util.Set;

/** Options that affect how command-line target patterns are resolved to individual targets. */
@OptionsClass
public abstract class LoadingOptions extends OptionsBase {
  @Option(
      name = "build_tests_only",
      defaultValue = "false",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.UNKNOWN},
      help =
          "If specified, only *_test and test_suite rules will be built and other targets specified"
              + " on the command line will be ignored. By default everything that was requested"
              + " will be built.")
  public abstract boolean getBuildTestsOnly();

  @Option(
      name = "compile_one_dependency",
      defaultValue = "false",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.UNKNOWN},
      help =
          "Compile a single dependency of the argument files. This is useful for syntax checking"
              + " source files in IDEs, for example, by rebuilding a single target that depends on"
              + " the source file to detect errors as early as possible in the edit/build/test"
              + " cycle. This argument affects the way all non-flag arguments are interpreted;"
              + " instead of being targets to build they are source filenames.  For each source"
              + " filename an arbitrary target that depends on it will be built.")
  public abstract boolean getCompileOneDependency();

  @Option(
      name = "build_tag_filters",
      converter = CommaSeparatedOptionListConverter.class,
      defaultValue = "",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.UNKNOWN},
      help =
          "Specifies a comma-separated list of tags. Each tag can be optionally preceded with '-'"
              + " to specify excluded tags. Only those targets will be built that contain at least"
              + " one included tag and do not contain any excluded tags. This option does not"
              + " affect the set of tests executed with the 'test' command; those are be governed"
              + " by the test filtering options, for example '--test_tag_filters'")
  public abstract List<String> getBuildTagFilterList();

  @Option(
      name = "test_tag_filters",
      converter = CommaSeparatedOptionListConverter.class,
      defaultValue = "",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.UNKNOWN},
      help =
          "Specifies a comma-separated list of test tags. Each tag can be optionally "
              + "preceded with '-' to specify excluded tags. Only those test targets will be "
              + "found that contain at least one included tag and do not contain any excluded "
              + "tags. This option affects --build_tests_only behavior and the test command.")
  public abstract List<String> getTestTagFilterList();

  public abstract void setTestTagFilterList(List<String> value);

  @Option(
      name = "test_size_filters",
      converter = TestSize.TestSizeFilterConverter.class,
      defaultValue = "",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.UNKNOWN},
      help =
          "Specifies a comma-separated list of test sizes. Each size can be optionally "
              + "preceded with '-' to specify excluded sizes. Only those test targets will be "
              + "found that contain at least one included size and do not contain any excluded "
              + "sizes. This option affects --build_tests_only behavior and the test command.")
  public abstract Set<TestSize> getTestSizeFilterSet();

  public abstract void setTestSizeFilterSet(Set<TestSize> value);

  @Option(
      name = "test_timeout_filters",
      converter = TestTimeout.TestTimeoutFilterConverter.class,
      defaultValue = "",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.UNKNOWN},
      help =
          "Specifies a comma-separated list of test timeouts. Each timeout can be "
              + "optionally preceded with '-' to specify excluded timeouts. Only those test "
              + "targets will be found that contain at least one included timeout and do not "
              + "contain any excluded timeouts. This option affects --build_tests_only behavior "
              + "and the test command.")
  public abstract Set<TestTimeout> getTestTimeoutFilterSet();

  public abstract void setTestTimeoutFilterSet(Set<TestTimeout> value);

  @Option(
      name = "test_lang_filters",
      converter = CommaSeparatedOptionListConverter.class,
      defaultValue = "",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.UNKNOWN},
      help =
          "Specifies a comma-separated list of test languages. Each language can be "
              + "optionally preceded with '-' to specify excluded languages. Only those "
              + "test targets will be found that are written in the specified languages. "
              + "The name used for each language should be the same as the language prefix in the "
              + "*_test rule, e.g. one of 'cc', 'java', 'py', etc. "
              + "This option affects --build_tests_only behavior and the test command.")
  public abstract List<String> getTestLangFilterList();

  public abstract void setTestLangFilterList(List<String> value);

  @Option(
      name = "build_manual_tests",
      defaultValue = "false",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.UNKNOWN},
      help =
          "Forces targets tagged 'manual' to be built. Despite the flag name, this option applies "
              + "to all targets (both test and non-test targets) matching the pattern. Targets "
              + "tagged 'manual' are excluded from processing by default; this option forces them "
              + "to be built (tests are built but not executed).")
  public abstract boolean getBuildManualTests();

  @Deprecated
  @Option(
      name = "experimental_skyframe_target_pattern_evaluator",
      defaultValue = "true",
      documentationCategory = OptionDocumentationCategory.UNDOCUMENTED,
      effectTags = {OptionEffectTag.UNKNOWN},
      metadataTags = {OptionMetadataTag.DEPRECATED},
      help =
          "Use the Skyframe-based target pattern evaluator; implies "
              + "--experimental_interleave_loading_and_analysis.")
  public abstract boolean getUseSkyframeTargetPatternEvaluator();

  @Option(
      name = "expand_test_suites",
      defaultValue = "true",
      documentationCategory = OptionDocumentationCategory.UNCATEGORIZED,
      effectTags = {OptionEffectTag.LOADING_AND_ANALYSIS},
      help =
          "Expand test_suite targets into their constituent tests before analysis. When this flag"
              + " is turned on (the default), negative target patterns will apply to the tests"
              + " belonging to the test suite, otherwise they will not. Turning off this flag is"
              + " useful when top-level aspects are applied at command line: then they can analyze"
              + " test_suite targets.")
  public abstract boolean getExpandTestSuites();
}