You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beam.apache.org by me...@apache.org on 2017/09/29 20:11:23 UTC
[beam-site] branch asf-site updated (8a5d78f -> 42cecc8)
This is an automated email from the ASF dual-hosted git repository.
mergebot-role pushed a change to branch asf-site
in repository https://gitbox.apache.org/repos/asf/beam-site.git.
from 8a5d78f Prepare repository for deployment.
add 77c5c4a [BEAM-2335] Document how to run NeedsRunner tests.
add 7b67e83 fixup! [BEAM-2335] Document how to run NeedsRunner tests.
add 574ba81 This closes #284
new 42cecc8 Prepare repository for deployment.
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
content/contribute/testing/index.html | 35 ++++++++++++++++++++++++++++++++++-
src/contribute/testing.md | 31 +++++++++++++++++++++++++++++++
2 files changed, 65 insertions(+), 1 deletion(-)
--
To stop receiving notification emails like this one, please contact
['"commits@beam.apache.org" <co...@beam.apache.org>'].
[beam-site] 01/01: Prepare repository for deployment.
Posted by me...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mergebot-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/beam-site.git
commit 42cecc89499e18e96f1c8310d2147912f7b7b364
Author: Mergebot <me...@apache.org>
AuthorDate: Fri Sep 29 20:11:21 2017 +0000
Prepare repository for deployment.
---
content/contribute/testing/index.html | 35 ++++++++++++++++++++++++++++++++++-
1 file changed, 34 insertions(+), 1 deletion(-)
diff --git a/content/contribute/testing/index.html b/content/contribute/testing/index.html
index 1038dc1..b6be34c 100644
--- a/content/contribute/testing/index.html
+++ b/content/contribute/testing/index.html
@@ -159,7 +159,10 @@
</ul>
</li>
<li><a href="#testing-types" id="markdown-toc-testing-types">Testing Types</a> <ul>
- <li><a href="#unit" id="markdown-toc-unit">Unit</a></li>
+ <li><a href="#unit" id="markdown-toc-unit">Unit</a> <ul>
+ <li><a href="#how-to-run-needsrunner-tests" id="markdown-toc-how-to-run-needsrunner-tests">How to run NeedsRunner tests</a></li>
+ </ul>
+ </li>
<li><a href="#validatesrunner" id="markdown-toc-validatesrunner">ValidatesRunner</a></li>
<li><a href="#e2e" id="markdown-toc-e2e">E2E</a></li>
</ul>
@@ -466,6 +469,36 @@ importance of testing, Beam has a robust set of unit tests, as well as testing
coverage measurement tools, which protect the codebase from simple to moderate
breakages. Beam Java unit tests are written in JUnit.</p>
+<h4 id="how-to-run-needsrunner-tests">How to run NeedsRunner tests</h4>
+
+<p>NeedsRunner is a category of tests that require a Beam runner. A subset of these
+tests cannot be executed while building their corresponding modules because all
+runners depend on these modules (e.g. <code class="highlighter-rouge">sdks/java/core</code>) to be built. To break
+the circular dependency, these tests are executed after the Direct Runner is
+built.</p>
+
+<p>To run this subset of the NeedsRunner tests (requires Maven 3.3.1+):</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>$ mvn -pl runners/direct-java -am install -DskipTests
+$ mvn -pl runners/direct-java surefire:test@validates-runner-tests
+</code></pre>
+</div>
+
+<p>To run a single NeedsRunner test use the <code class="highlighter-rouge">test</code> property, e.g.</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>$ mvn -pl runners/direct-java surefire:test@validates-runner-tests -Dtest=MapElementsTest#testMapBasic
+</code></pre>
+</div>
+
+<p>will run the <code class="highlighter-rouge">MapElementsTest.testMapBasic()</code> test.</p>
+
+<p>NeedsRunner tests in modules that are not required to build runners (e.g.
+<code class="highlighter-rouge">sdks/java/io/jdbc</code>) can be executed with the <code class="highlighter-rouge">mvn test</code> command:</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>mvn -pl sdks/java/io/jdbc test -Dgroups=org.apache.beam.sdk.testing.NeedsRunner
+</code></pre>
+</div>
+
<h3 id="validatesrunner">ValidatesRunner</h3>
<p>ValidatesRunner tests contain components of both component and end-to-end
--
To stop receiving notification emails like this one, please contact
"commits@beam.apache.org" <co...@beam.apache.org>.