// Copyright 2017 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.actions; import com.google.common.base.Preconditions; import com.google.common.collect.ImmutableMap; import com.google.common.collect.ImmutableSet; import com.google.devtools.build.lib.util.Fingerprint; import java.util.Map; import java.util.Set; import java.util.TreeMap; import java.util.TreeSet; /** * Environment variables for build or test actions. * *
The action environment consists of two parts. *
Inherited environment variables must be declared in the Action interface
* (see {@link Action#getClientEnvironmentVariables}), so that the dependency on the client
* environment is known to the execution framework for correct incremental builds.
*/
public final class ActionEnvironment {
/**
* Splits the given map into a map of variables with a fixed value, and a set of variables that
* should be inherited, the latter of which are identified by having a {@code null} value in the
* given map. Returns these two parts as a new {@link ActionEnvironment} instance.
*/
public static ActionEnvironment split(Map We pass in a map to mutate to avoid creating and merging intermediate maps.
*/
public void resolve(Map