beam-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [beam-site] 01/01: Prepare repository for deployment.
Date Fri, 29 Sep 2017 20:11:24 GMT
This is an automated email from the ASF dual-hosted git repository.

mergebot-role pushed a commit to branch asf-site
in repository

commit 42cecc89499e18e96f1c8310d2147912f7b7b364
Author: Mergebot <>
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 @@
   <li><a href="#testing-types" id="markdown-toc-testing-types">Testing Types</a>
-      <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>
@@ -466,6 +469,36 @@ importance of testing, Beam has a robust set of unit tests, as well as
 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 
+<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
+<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
+<p>will run the <code class="highlighter-rouge">MapElementsTest.testMapBasic()</code>
+<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
 <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
"" <>.

View raw message