src/main/java/com/google/devtools/build/lib/runtime/CommonCommandOptions.java - bazel - Git at Google

 // Copyright 2014 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.runtime;

 import com.google.devtools.build.lib.util.OptionsUtils;
 import com.google.devtools.build.lib.vfs.PathFragment;
 import com.google.devtools.common.options.Converter;
 import com.google.devtools.common.options.Converters;
 import com.google.devtools.common.options.Option;
 import com.google.devtools.common.options.OptionsBase;
 import com.google.devtools.common.options.OptionsParsingException;

 import java.util.List;
 import java.util.Map;
 import java.util.logging.Level;

 /**
  * Options common to all commands.
  */
 public class CommonCommandOptions extends OptionsBase {
   /**
    * A class representing a blazerc option. blazeRc is serial number of the rc
    * file this option came from, option is the name of the option and value is
    * its value (or null if not specified).
    */
   public static class OptionOverride {
     final int blazeRc;
     final String command;
     final String option;

     public OptionOverride(int blazeRc, String command, String option) {
       this.blazeRc = blazeRc;
       this.command = command;
       this.option = option;
     }

     @Override
     public String toString() {
       return String.format("%d:%s=%s", blazeRc, command, option);
     }
   }

   /**
    * Converter for --default_override. The format is:
    * --default_override=blazerc:command=option.
    */
   public static class OptionOverrideConverter implements Converter<OptionOverride> {
     static final String ERROR_MESSAGE = "option overrides must be in form "
       + " rcfile:command=option, where rcfile is a nonzero integer";

     public OptionOverrideConverter() {}

     @Override
     public OptionOverride convert(String input) throws OptionsParsingException {
       int colonPos = input.indexOf(':');
       int assignmentPos = input.indexOf('=');

       if (colonPos < 0) {
         throw new OptionsParsingException(ERROR_MESSAGE);
       }

       if (assignmentPos <= colonPos + 1) {
         throw new OptionsParsingException(ERROR_MESSAGE);
       }

       int blazeRc;
       try {
         blazeRc = Integer.valueOf(input.substring(0, colonPos));
       } catch (NumberFormatException e) {
         throw new OptionsParsingException(ERROR_MESSAGE);
       }

       if (blazeRc < 0) {
         throw new OptionsParsingException(ERROR_MESSAGE);
       }

       String command = input.substring(colonPos + 1, assignmentPos);
       String option = input.substring(assignmentPos + 1);

       return new OptionOverride(blazeRc, command, option);
     }

     @Override
     public String getTypeDescription() {
       return "blazerc option override";
     }
   }


   @Option(name = "config",
           defaultValue = "",
           category = "misc",
           allowMultiple = true,
           help = "Selects additional config sections from the rc files; for every <command>, it "
               + "also pulls in the options from <command>:<config> if such a section exists; "
               + "if the section does not exist, this flag is ignored. "
               + "Note that it is currently only possible to provide these options on the "
               + "command line, not in the rc files. The config sections and flag combinations "
               + "they are equivalent to are located in the tools/*.blazerc config files.")
   public List<String> configs;

   @Option(name = "logging",
           defaultValue = "3", // Level.INFO
           category = "verbosity",
           converter = Converters.LogLevelConverter.class,
           help = "The logging level.")
   public Level verbosity;

   @Option(name = "client_env",
       defaultValue = "",
       category = "hidden",
       converter = Converters.AssignmentConverter.class,
       allowMultiple = true,
       help = "A system-generated parameter which specifies the client's environment")
   public List<Map.Entry<String, String>> clientEnv;

   @Option(name = "ignore_client_env",
       defaultValue = "false",
       category = "hidden",
       help = "If true, ignore the '--client_env' flag, and use the JVM environment instead")
   public boolean ignoreClientEnv;

   @Option(name = "client_cwd",
       defaultValue = "",
       category = "hidden",
       converter = OptionsUtils.PathFragmentConverter.class,
       help = "A system-generated parameter which specifies the client's working directory")
   public PathFragment clientCwd;

   @Option(name = "announce_rc",
       defaultValue = "false",
       category = "verbosity",
       help = "Whether to announce rc options.")
   public boolean announceRcOptions;

   /**
    * These are the actual default overrides.
    * Each value is a pair of (command name, value).
    *
    * For example: "--default_override=build=--cpu=piii"
    */
   @Option(name = "default_override",
       defaultValue = "",
       allowMultiple = true,
       category = "hidden",
       converter = OptionOverrideConverter.class,
       help = "")
   public List<OptionOverride> optionsOverrides;

   /**
    * This is the filename that the Blaze client parsed.
    */
   @Option(name = "rc_source",
       defaultValue = "",
       allowMultiple = true,
       category = "hidden",
       help = "")
   public List<String> rcSource;

   @Option(name = "always_profile_slow_operations",
       defaultValue = "true",
       category = "undocumented",
       help = "Whether profiling slow operations is always turned on")
   public boolean alwaysProfileSlowOperations;

   @Option(name = "profile",
       defaultValue = "null",
       category = "misc",
       converter = OptionsUtils.PathFragmentConverter.class,
       help = "If set, profile Blaze and write data to the specified "
       + "file. Use blaze analyze-profile to analyze the profile.")
   public PathFragment profilePath;

   @Option(name = "record_full_profiler_data",
       defaultValue = "false",
       category = "undocumented",
       help = "By default, Blaze profiler will record only aggregated data for fast but numerous "
           + "events (such as statting the file). If this option is enabled, profiler will record "
           + "each event - resulting in more precise profiling data but LARGE performance "
           + "hit. Option only has effect if --profile used as well.")
   public boolean recordFullProfilerData;

   @Option(name = "memory_profile",
       defaultValue = "null",
       category = "undocumented",
       converter = OptionsUtils.PathFragmentConverter.class,
       help = "If set, write memory usage data to the specified "
           + "file at phase ends.")
   public PathFragment memoryProfilePath;

   @Option(name = "gc_watchdog",
       defaultValue = "false",
       category = "undocumented",
       deprecationWarning = "Ignoring: this option is no longer supported",
       help = "Deprecated.")
   public boolean gcWatchdog;

   @Option(name = "startup_time",
       defaultValue = "0",
       category = "hidden",
       help = "The time in ms the launcher spends before sending the request to the blaze server.")
   public long startupTime;

   @Option(
     name = "extract_data_time",
     defaultValue = "0",
     category = "hidden",
     help = "The time in ms spent on extracting the new blaze version."
   )
   public long extractDataTime;

   @Option(name = "command_wait_time",
       defaultValue = "0",
       category = "hidden",
       help = "The time in ms a command had to wait on a busy Blaze server process.")
   public long waitTime;

   @Option(name = "tool_tag",
       defaultValue = "",
       category = "misc",
       help = "A tool name to attribute this Blaze invocation to.")
   public String toolTag;

   @Option(name = "restart_reason",
       defaultValue = "no_restart",
       category = "hidden",
       help = "The reason for the server restart.")
   public String restartReason;

   @Option(name = "binary_path",
       defaultValue = "",
       category = "hidden",
       help = "The absolute path of the blaze binary.")
   public String binaryPath;

   @Option(name = "experimental_allow_project_files",
       defaultValue = "false",
       category = "hidden",
       help = "Enable processing of +<file> parameters.")
   public boolean allowProjectFiles;

   @Option(name = "block_for_lock",
       defaultValue = "true",
       category = "hidden",
       help = "If set (the default), a command will block if there is another one running. If "
           + "unset, these commands will immediately return with an error.")
   public boolean blockForLock;

 }
	// Copyright 2014 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.runtime;

	import com.google.devtools.build.lib.util.OptionsUtils;
	import com.google.devtools.build.lib.vfs.PathFragment;
	import com.google.devtools.common.options.Converter;
	import com.google.devtools.common.options.Converters;
	import com.google.devtools.common.options.Option;
	import com.google.devtools.common.options.OptionsBase;
	import com.google.devtools.common.options.OptionsParsingException;

	import java.util.List;
	import java.util.Map;
	import java.util.logging.Level;

	/**
	* Options common to all commands.
	*/
	public class CommonCommandOptions extends OptionsBase {
	/**
	* A class representing a blazerc option. blazeRc is serial number of the rc
	* file this option came from, option is the name of the option and value is
	* its value (or null if not specified).
	*/
	public static class OptionOverride {
	final int blazeRc;
	final String command;
	final String option;

	public OptionOverride(int blazeRc, String command, String option) {
	this.blazeRc = blazeRc;
	this.command = command;
	this.option = option;
	}

	@Override
	public String toString() {
	return String.format("%d:%s=%s", blazeRc, command, option);
	}
	}

	/**
	* Converter for --default_override. The format is:
	* --default_override=blazerc:command=option.
	*/
	public static class OptionOverrideConverter implements Converter<OptionOverride> {
	static final String ERROR_MESSAGE = "option overrides must be in form "
	+ " rcfile:command=option, where rcfile is a nonzero integer";

	public OptionOverrideConverter() {}

	@Override
	public OptionOverride convert(String input) throws OptionsParsingException {
	int colonPos = input.indexOf(':');
	int assignmentPos = input.indexOf('=');

	if (colonPos < 0) {
	throw new OptionsParsingException(ERROR_MESSAGE);
	}

	if (assignmentPos <= colonPos + 1) {
	throw new OptionsParsingException(ERROR_MESSAGE);
	}

	int blazeRc;
	try {
	blazeRc = Integer.valueOf(input.substring(0, colonPos));
	} catch (NumberFormatException e) {
	throw new OptionsParsingException(ERROR_MESSAGE);
	}

	if (blazeRc < 0) {
	throw new OptionsParsingException(ERROR_MESSAGE);
	}

	String command = input.substring(colonPos + 1, assignmentPos);
	String option = input.substring(assignmentPos + 1);

	return new OptionOverride(blazeRc, command, option);
	}

	@Override
	public String getTypeDescription() {
	return "blazerc option override";
	}
	}


	@Option(name = "config",
	defaultValue = "",
	category = "misc",
	allowMultiple = true,
	help = "Selects additional config sections from the rc files; for every <command>, it "
	+ "also pulls in the options from <command>:<config> if such a section exists; "
	+ "if the section does not exist, this flag is ignored. "
	+ "Note that it is currently only possible to provide these options on the "
	+ "command line, not in the rc files. The config sections and flag combinations "
	+ "they are equivalent to are located in the tools/*.blazerc config files.")
	public List<String> configs;

	@Option(name = "logging",
	defaultValue = "3", // Level.INFO
	category = "verbosity",
	converter = Converters.LogLevelConverter.class,
	help = "The logging level.")
	public Level verbosity;

	@Option(name = "client_env",
	defaultValue = "",
	category = "hidden",
	converter = Converters.AssignmentConverter.class,
	allowMultiple = true,
	help = "A system-generated parameter which specifies the client's environment")
	public List<Map.Entry<String, String>> clientEnv;

	@Option(name = "ignore_client_env",
	defaultValue = "false",
	category = "hidden",
	help = "If true, ignore the '--client_env' flag, and use the JVM environment instead")
	public boolean ignoreClientEnv;

	@Option(name = "client_cwd",
	defaultValue = "",
	category = "hidden",
	converter = OptionsUtils.PathFragmentConverter.class,
	help = "A system-generated parameter which specifies the client's working directory")
	public PathFragment clientCwd;

	@Option(name = "announce_rc",
	defaultValue = "false",
	category = "verbosity",
	help = "Whether to announce rc options.")
	public boolean announceRcOptions;

	/**
	* These are the actual default overrides.
	* Each value is a pair of (command name, value).
	*
	* For example: "--default_override=build=--cpu=piii"
	*/
	@Option(name = "default_override",
	defaultValue = "",
	allowMultiple = true,
	category = "hidden",
	converter = OptionOverrideConverter.class,
	help = "")
	public List<OptionOverride> optionsOverrides;

	/**
	* This is the filename that the Blaze client parsed.
	*/
	@Option(name = "rc_source",
	defaultValue = "",
	allowMultiple = true,
	category = "hidden",
	help = "")
	public List<String> rcSource;

	@Option(name = "always_profile_slow_operations",
	defaultValue = "true",
	category = "undocumented",
	help = "Whether profiling slow operations is always turned on")
	public boolean alwaysProfileSlowOperations;

	@Option(name = "profile",
	defaultValue = "null",
	category = "misc",
	converter = OptionsUtils.PathFragmentConverter.class,
	help = "If set, profile Blaze and write data to the specified "
	+ "file. Use blaze analyze-profile to analyze the profile.")
	public PathFragment profilePath;

	@Option(name = "record_full_profiler_data",
	defaultValue = "false",
	category = "undocumented",
	help = "By default, Blaze profiler will record only aggregated data for fast but numerous "
	+ "events (such as statting the file). If this option is enabled, profiler will record "
	+ "each event - resulting in more precise profiling data but LARGE performance "
	+ "hit. Option only has effect if --profile used as well.")
	public boolean recordFullProfilerData;

	@Option(name = "memory_profile",
	defaultValue = "null",
	category = "undocumented",
	converter = OptionsUtils.PathFragmentConverter.class,
	help = "If set, write memory usage data to the specified "
	+ "file at phase ends.")
	public PathFragment memoryProfilePath;

	@Option(name = "gc_watchdog",
	defaultValue = "false",
	category = "undocumented",
	deprecationWarning = "Ignoring: this option is no longer supported",
	help = "Deprecated.")
	public boolean gcWatchdog;

	@Option(name = "startup_time",
	defaultValue = "0",
	category = "hidden",
	help = "The time in ms the launcher spends before sending the request to the blaze server.")
	public long startupTime;

	@Option(
	name = "extract_data_time",
	defaultValue = "0",
	category = "hidden",
	help = "The time in ms spent on extracting the new blaze version."
	)
	public long extractDataTime;

	@Option(name = "command_wait_time",
	defaultValue = "0",
	category = "hidden",
	help = "The time in ms a command had to wait on a busy Blaze server process.")
	public long waitTime;

	@Option(name = "tool_tag",
	defaultValue = "",
	category = "misc",
	help = "A tool name to attribute this Blaze invocation to.")
	public String toolTag;

	@Option(name = "restart_reason",
	defaultValue = "no_restart",
	category = "hidden",
	help = "The reason for the server restart.")
	public String restartReason;

	@Option(name = "binary_path",
	defaultValue = "",
	category = "hidden",
	help = "The absolute path of the blaze binary.")
	public String binaryPath;

	@Option(name = "experimental_allow_project_files",
	defaultValue = "false",
	category = "hidden",
	help = "Enable processing of +<file> parameters.")
	public boolean allowProjectFiles;

	@Option(name = "block_for_lock",
	defaultValue = "true",
	category = "hidden",
	help = "If set (the default), a command will block if there is another one running. If "
	+ "unset, these commands will immediately return with an error.")
	public boolean blockForLock;

	}