@@ -18,8 +18,8 @@ minor, then feel free to make them without discussion.
18
18
19
19
Want to contribute but not sure of what? Here are a few suggestions:
20
20
1 . Add a new tutorial. Located in [ ` docs/tutorials/ ` ] ( docs/tutorials ) ,
21
- these are a great way to familiarize yourself and others with TF-Addons. See
22
- [ the guidelines] ( docs/tutorials/README.md ) for more information on how to add
21
+ these are a great way to familiarize yourself and others with TF-Addons. See
22
+ [ the guidelines] ( docs/tutorials/README.md ) for more information on how to add
23
23
examples.
24
24
2 . Solve an [ existing issue] ( https://github.com/tensorflow/addons/issues ) .
25
25
These range from low-level software bugs to higher-level design problems.
@@ -63,11 +63,12 @@ automatically, don't forget to use it before pushing your code.
63
63
Please see our [ Style Guide] ( STYLE_GUIDE.md ) for more details.
64
64
65
65
## Code Testing
66
- #### CI Testing
67
- Nightly CI tests are ran and results can be found on the central README. To
66
+ ### CI Testing
67
+ Nightly CI tests are ran and results can be found on the central README. To
68
68
subscribe for alerts please join the [ addons-testing mailing list] ( https://groups.google.com/a/tensorflow.org/forum/#!forum/addons-testing ) .
69
69
70
- #### Locally Testing CPU
70
+ ### Locally Testing CPU
71
+ Run all tests in docker:
71
72
72
73
``` bash
73
74
bash tools/run_docker.sh -c ' make unit-test'
@@ -78,14 +79,24 @@ or run manually:
78
79
``` bash
79
80
docker run --rm -it -v ${PWD} :/addons -w /addons gcr.io/tensorflow-testing/nosla-ubuntu16.04-manylinux2010 /bin/bash
80
81
./configure.sh # Links project with TensorFlow dependency
82
+ ```
83
+
84
+ Run selected tests:
81
85
86
+ ``` bash
82
87
bazel test -c opt -k \
83
88
--test_timeout 300,450,1200,3600 \
84
89
--test_output=all \
85
- //tensorflow_addons/...
90
+ //tensorflow_addons/< test_selection >
86
91
```
87
92
88
- #### Locally Testing GPU
93
+ ` <test_selection> ` can be ` ... ` for all tests or ` <package>:<py_test_name> ` for individual tests.
94
+ ` <package> ` can be any package name like ` metrics ` for example.
95
+ ` <py_test_name> ` can be any test name given by the ` BUILD ` file or ` * ` for all tests of the given package.
96
+
97
+ ### Locally Testing GPU
98
+ Run all tests in docker:
99
+
89
100
``` bash
90
101
bash tools/run_docker.sh -d gpu -c ' make gpu-unit-test'
91
102
```
@@ -96,15 +107,23 @@ or run manually:
96
107
docker run --runtime=nvidia --rm -it -v ${PWD} :/addons -w /addons gcr.io/tensorflow-testing/nosla-cuda10.1-cudnn7-ubuntu16.04-manylinux2010 /bin/bash
97
108
export TF_NEED_CUDA=1
98
109
./configure.sh # Links project with TensorFlow dependency
110
+ ```
111
+
112
+ Run selected tests:
99
113
114
+ ``` bash
100
115
bazel test -c opt -k \
101
116
--test_timeout 300,450,1200,3600 \
102
117
--crosstool_top=//build_deps/toolchains/gcc7_manylinux2010-nvcc-cuda10.1:toolchain \
103
118
--test_output=all \
104
119
--jobs=1 \
105
- //tensorflow_addons/...
120
+ //tensorflow_addons/< test_selection >
106
121
```
107
122
123
+ ` <test_selection> ` can be ` ... ` for all tests or ` <package>:<py_test_name> ` for individual tests.
124
+ ` <package> ` can be any package name like ` metrics ` for example.
125
+ ` <py_test_name> ` can be any test name given by the ` BUILD ` file or ` * ` for all tests of the given package.
126
+
108
127
## Code Reviews
109
128
110
129
All submissions, including submissions by project members, require review. We
0 commit comments