1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
// 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.analysis;
import com.google.common.base.Objects;
import com.google.common.base.Verify;
import com.google.common.collect.ImmutableList;
import com.google.devtools.build.lib.actions.ActionKeyContext;
import com.google.devtools.build.lib.analysis.config.BuildConfiguration;
import com.google.devtools.build.lib.analysis.configuredtargets.RuleConfiguredTarget;
import com.google.devtools.build.lib.cmdline.Label;
import com.google.devtools.build.lib.collect.nestedset.NestedSet;
import com.google.devtools.build.lib.packages.PackageSpecification.PackageGroupContents;
import com.google.devtools.build.lib.packages.Target;
import com.google.devtools.build.lib.skyframe.BuildConfigurationValue;
import com.google.devtools.build.lib.skyframe.ConfiguredTargetAndData;
import java.util.List;
import java.util.Set;
import javax.annotation.Nullable;
/**
* A helper class for building {@link ConfiguredTarget} instances, in particular for non-rule ones.
* For {@link RuleConfiguredTarget} instances, use {@link RuleContext} instead,
* which is a subclass of this class.
*
* <p>The class is intended to be sub-classed by RuleContext, in order to share the code. However,
* it's not intended for sub-classing beyond that, and the constructor is intentionally package
* private to enforce that.
*/
public class TargetContext {
private final AnalysisEnvironment env;
private final Target target;
private final BuildConfiguration configuration;
/**
* This list only contains prerequisites that are not declared in rule attributes, with the
* exception of visibility (i.e., visibility is represented here, even though it is a rule
* attribute in case of a rule). Rule attributes are handled by the {@link RuleContext} subclass.
*/
private final List<ConfiguredTargetAndData> directPrerequisites;
private final NestedSet<PackageGroupContents> visibility;
/**
* The constructor is intentionally package private.
*
* <p>directPrerequisites is expected to be ordered.
*/
TargetContext(
AnalysisEnvironment env,
Target target,
BuildConfiguration configuration,
Set<ConfiguredTargetAndData> directPrerequisites,
NestedSet<PackageGroupContents> visibility) {
this.env = env;
this.target = target;
this.configuration = configuration;
this.directPrerequisites = ImmutableList.copyOf(directPrerequisites);
this.visibility = visibility;
}
public AnalysisEnvironment getAnalysisEnvironment() {
return env;
}
public ActionKeyContext getActionKeyContext() {
return env.getActionKeyContext();
}
public Target getTarget() {
return target;
}
public Label getLabel() {
return target.getLabel();
}
/**
* Returns the configuration for this target. This may return null if the target is supposed to be
* configuration-independent (like an input file, or a visibility rule). However, this is
* guaranteed to be non-null for rules and for output files.
*/
@Nullable
public BuildConfiguration getConfiguration() {
return configuration;
}
public BuildConfigurationValue.Key getConfigurationKey() {
return BuildConfigurationValue.key(configuration);
}
public NestedSet<PackageGroupContents> getVisibility() {
return visibility;
}
/**
* Returns the prerequisite with the given label and configuration. Throws a RuntimeException if
* no such prerequisite exists.
*/
TransitiveInfoCollection findDirectPrerequisite(Label label, BuildConfiguration config) {
return Verify.verifyNotNull(maybeFindDirectPrerequisite(label, config),
"Could not find prerequisite %s in the expected configuration", label);
}
/**
* Returns the prerequisite with the given label and configuration, or null if no such
* prerequisite exists.
*/
public TransitiveInfoCollection maybeFindDirectPrerequisite(Label label,
BuildConfiguration config) {
for (ConfiguredTargetAndData prerequisite : directPrerequisites) {
if (prerequisite.getTarget().getLabel().equals(label)
&& (Objects.equal(prerequisite.getConfiguration(), config))) {
return prerequisite.getConfiguredTarget();
}
}
return null;
}
}
|
