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
|
// Copyright 2015 Google Inc. 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.bazel.rules.python;
import static com.google.devtools.build.lib.packages.Attribute.attr;
import static com.google.devtools.build.lib.packages.BuildType.TRISTATE;
import static com.google.devtools.build.lib.syntax.Type.BOOLEAN;
import com.google.devtools.build.lib.analysis.BaseRuleClasses;
import com.google.devtools.build.lib.analysis.RuleDefinition;
import com.google.devtools.build.lib.analysis.RuleDefinitionEnvironment;
import com.google.devtools.build.lib.bazel.rules.python.BazelPyRuleClasses.PyBinaryBaseRule;
import com.google.devtools.build.lib.packages.RuleClass;
import com.google.devtools.build.lib.packages.RuleClass.Builder.RuleClassType;
import com.google.devtools.build.lib.packages.TriState;
import com.google.devtools.build.lib.rules.python.PythonConfiguration;
/**
* Rule definition for the py_test rule.
*/
public final class BazelPyTestRule implements RuleDefinition {
@Override
public RuleClass build(RuleClass.Builder builder, RuleDefinitionEnvironment env) {
return builder
.requiresConfigurationFragments(PythonConfiguration.class, BazelPythonConfiguration.class)
.override(attr("testonly", BOOLEAN).value(true)
.nonconfigurable("policy decision: should be consistent across configurations"))
/* <!-- #BLAZE_RULE(py_test).ATTRIBUTE(stamp) -->
${SYNOPSIS}
See the section on <a href="#py_binary_args">py_binary()</a> arguments, except
that the stamp argument is set to 0 by default for tests.
<!-- #END_BLAZE_RULE.ATTRIBUTE --> */
.override(attr("stamp", TRISTATE).value(TriState.NO))
.build();
}
@Override
public Metadata getMetadata() {
return RuleDefinition.Metadata.builder()
.name("py_test")
.type(RuleClassType.TEST)
.ancestors(PyBinaryBaseRule.class, BaseRuleClasses.TestBaseRule.class)
.factoryClass(BazelPyTest.class)
.build();
}
}
/*<!-- #BLAZE_RULE (NAME = py_test, TYPE = TEST, FAMILY = Python) -->
${ATTRIBUTE_SIGNATURE}
<p>
A <code>py_test()</code> rule compiles a test. A test is a binary wrapper
around some test code.</p>
${ATTRIBUTE_DEFINITION}
<h4 id="py_test_examples">Examples</h4>
<p>
<pre class="code">
py_test(
name = "runtest_test",
srcs = ["runtest_test.py"],
deps = [
"//path/to/a/py/library",
],
)
</pre>
<p>It's also possible to specify a main module:</p>
<pre class="code">
py_binary(
name = "foo",
srcs = [
"bar.py",
"baz.py",
],
main = "bar.py",
)
</pre>
<!-- #END_BLAZE_RULE -->*/
|