beam-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mergebot-r...@apache.org
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 https://gitbox.apache.org/repos/asf/beam-site.git

commit 42cecc89499e18e96f1c8310d2147912f7b7b364
Author: Mergebot <mergebot@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" <commits@beam.apache.org>.

Mime
View raw message