This is an automated email from the ASF dual-hosted git repository.
aw pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/yetus.git
The following commit(s) were added to refs/heads/asf-site by this push:
new c63b459 git sha aa0f2a380002457b544472988cd046b3ae8cd903
c63b459 is described below
commit c63b459ae09af144ab8fdc882c1de422f4846e27
Author: Allen Wittenauer <[email protected]>
AuthorDate: Fri Nov 27 07:50:30 2020 -0800
git sha aa0f2a380002457b544472988cd046b3ae8cd903
---
documentation/in-progress/CHANGELOG | 2 +-
.../in-progress/precommit/advanced/index.html | 27 +++--
.../in-progress/precommit/apidocs/core/index.html | 106 +++++++++++++++--
.../precommit/apidocs/test-patch/index.html | 128 ++++++++++-----------
.../in-progress/precommit/testformats/index.html | 2 +-
.../0.13.0/CHANGELOG.0.13.0/index.html | 42 +++++--
.../0.13.0/RELEASENOTES.0.13.0/index.html | 60 +++++++---
project-reports.html | 4 +-
8 files changed, 259 insertions(+), 112 deletions(-)
diff --git a/documentation/in-progress/CHANGELOG
b/documentation/in-progress/CHANGELOG
index ed1a2b1..3d69726 100644
--- a/documentation/in-progress/CHANGELOG
+++ b/documentation/in-progress/CHANGELOG
@@ -18,5 +18,5 @@
-->
<h1 id="apache-yetus-changelog">Apache Yetus Changelog</h1>
-<h2 id="release-0140-snapshot---2020-11-23">Release 0.14.0-SNAPSHOT -
2020-11-23</h2>
+<h2 id="release-0140-snapshot---2020-11-27">Release 0.14.0-SNAPSHOT -
2020-11-27</h2>
diff --git a/documentation/in-progress/precommit/advanced/index.html
b/documentation/in-progress/precommit/advanced/index.html
index 545c5ad..1f2d597 100644
--- a/documentation/in-progress/precommit/advanced/index.html
+++ b/documentation/in-progress/precommit/advanced/index.html
@@ -136,8 +136,8 @@
</li>
<li><a href="#personalities">Personalities</a>
<ul>
- <li><a href="#configuring-for-other-projects">Configuring for Other
Projects</a></li>
- <li><a href="#global-definitions">Global Definitions</a></li>
+ <li><a href="#global-settings">Global Settings</a></li>
+ <li><a href="#custom-argument-parsing">Custom Argument Parsing</a></li>
<li><a href="#test-determination">Test Determination</a></li>
<li><a href="#module--profile-determination">Module & Profile
Determination</a></li>
<li><a href="#enabling-plug-ins">Enabling Plug-ins</a></li>
@@ -158,7 +158,7 @@
<h1 id="plug-ins">Plug-ins</h1>
-<p>test-patch allows one to add to its basic feature set via plug-ins. There
is a directory called test-patch.d inside the directory where test-patch.sh
lives. Inside this directory one may place some bash shell fragments that, if
setup with proper functions, will allow for test-patch to call it as necessary.
Different plug-ins have specific functions for that particular functionality.
In this document, the common functions available to all/most plug-ins are
covered. Test plugins ar [...]
+<p>test-patch allows one to add to its basic feature set via plug-ins. There
is a directory called plugins.d inside the directory where test-patch.sh lives.
Inside this directory one may place some bash shell fragments that, if setup
with proper functions, will allow for test-patch to call it as necessary.
Different plug-ins have specific functions for that particular functionality.
In this document, the common functions available to all/most plug-ins are
covered. Test plugins are c [...]
<h2 id="common-plug-in-functions">Common Plug-in Functions</h2>
@@ -241,7 +241,7 @@
<p>personality contains bundled personalities for various projects. These
will be imported individually based upon either a project name or if
specifically identified with the <code>--personality</code> flag.</p>
</li>
<li>
- <p>test-patch.d contains all of the optional, bundled plug-ins. These are
imported last and in shell collated order.</p>
+ <p>plugins.d contains all of the optional, bundled plug-ins. These are
imported last and in shell collated order.</p>
</li>
</ul>
@@ -290,24 +290,25 @@
<h1 id="personalities">Personalities</h1>
-<h2 id="configuring-for-other-projects">Configuring for Other Projects</h2>
-
<p>It is impossible for any general framework to be predictive about what
types of special rules any given project may have, especially when it comes to
ordering and Maven profiles. In order to direct test-patch to do the correct
action, a project <code>personality</code> should be added that enacts these
custom rules.</p>
-<p>A personality consists of two functions. One that determines which test
types to run and another that allows a project to dictate ordering rules,
flags, and profiles on a per-module, per-test run.</p>
+<p>A personality consists of one or more functions.</p>
<p>There can be only <strong>one</strong> of each personality function
defined.</p>
-<h2 id="global-definitions">Global Definitions</h2>
+<h2 id="global-settings">Global Settings</h2>
<p>Globals for personalities should be defined in the
<code>personality_globals</code> function. This function is called
<em>after</em> the other plug-ins have been imported. This allows one to
configure any settings for plug-ins that have been imported safely:</p>
<div class="highlight"><pre class="highlight shell"><code><span
class="k">function </span>personality_globals
<span class="o">{</span>
- <span class="nv">PATCH_BRANCH_DEFAULT</span><span class="o">=</span>main
<span class="nv">GITHUB_REPO</span><span class="o">=</span><span
class="s2">"apache/yetus"</span>
+ <span class="nv">PATCH_BRANCH_DEFAULT</span><span class="o">=</span>main
+ <span class="nv">PROJECT_NAME</span><span class="o">=</span><span
class="s2">"yetus"</span>
<span class="o">}</span>
</code></pre></div>
+<h2 id="custom-argument-parsing">Custom Argument Parsing</h2>
+
<p>Additionally, a personality may require some outside help from the user.
The <code>personality_parse_args</code><br />
function is called almost immediately after the personality is loaded and
plug-ins parse arguments.</p>
@@ -316,7 +317,7 @@ function is called almost immediately after the personality
is loaded and plug-i
<span class="nb">echo</span> <span class="s2">"</span><span
class="nv">$*</span><span class="s2">"</span>
<span class="o">}</span>
</code></pre></div>
-<p>It is important to note that this function is called AFTER
personality_globals.</p>
+<p>It is important to note that this function is called AFTER
<code>personality_globals</code>.</p>
<h2 id="test-determination">Test Determination</h2>
@@ -338,6 +339,9 @@ function is called almost immediately after the personality
is loaded and plug-i
</code></pre></div>
<p>The <code>add_test</code> function is used to activate the standard tests.
Additional plug-ins (such as checkstyle), will get queried on their own.</p>
+<p>This function may also be defined as
<code>PROJECT_NAME_personality_file_tests</code>, where
<code>PROJECT_NAME</code> matches the value passed via
<code>--project</code><br />
+or autodetermined by various means. The <code>PROJECT_NAME</code> version
takes precedence over the generic version.</p>
+
<h2 id="module--profile-determination">Module & Profile Determination</h2>
<p>Once the tests are determined, it is now time to pick which <a
href="../glossary#genericoutside-definitions">modules</a> should get used.
That's the job of the <code>personality_modules</code> function.</p>
@@ -383,6 +387,9 @@ function is called almost immediately after the personality
is loaded and plug-i
</code></pre></div>
<p>This function will tell test-patch that when the javadoc test is being run,
do the documentation build at the base of the source repository and make sure
the -DskipTests flag is passed to our build tool.</p>
+<p>This function may also be defined as
<code>PROJECT_NAME_personality_modules</code>, where <code>PROJECT_NAME</code>
matches the value passed via <code>--project</code><br />
+or autodetermined by various means. The <code>PROJECT_NAME</code> version
takes precedence over the generic version.</p>
+
<h2 id="enabling-plug-ins">Enabling Plug-ins</h2>
<p>Personalities can set the base list of plug-ins to enable and disable for
their project via the <code>personality_plugins</code> function. Just call it
with the same pattern as the <code>--plugins</code> command line option:</p>
diff --git a/documentation/in-progress/precommit/apidocs/core/index.html
b/documentation/in-progress/precommit/apidocs/core/index.html
index 586dcbc..375b6b5 100644
--- a/documentation/in-progress/precommit/apidocs/core/index.html
+++ b/documentation/in-progress/precommit/apidocs/core/index.html
@@ -161,8 +161,8 @@
<li><a href="#yetus_debug">yetus_debug</a></li>
<li><a href="#yetus_error">yetus_error</a></li>
<li><a
href="#yetus_find_deepest_directory">yetus_find_deepest_directory</a></li>
- <li><a href="#yetus_run_and_redirect">yetus_run_and_redirect</a></li>
<li><a href="#yetus_get_ctime">yetus_get_ctime</a></li>
+ <li><a href="#yetus_run_and_redirect">yetus_run_and_redirect</a></li>
</ul>
</li>
<li>Public/Evolving/Replaceable
@@ -176,6 +176,8 @@
<li><a
href="#bugsystem_linecomments_trigger">bugsystem_linecomments_trigger</a></li>
<li><a href="#guess_build_tool">guess_build_tool</a></li>
<li><a href="#list_plugins">list_plugins</a></li>
+ <li><a
href="#personality_file_tests_wrapper">personality_file_tests_wrapper</a></li>
+ <li><a
href="#personality_modules_wrapper">personality_modules_wrapper</a></li>
<li><a href="#plugin_usage_output">plugin_usage_output</a></li>
<li><a href="#reaper_add_name">reaper_add_name</a></li>
<li><a href="#yetus_add_header">yetus_add_header</a></li>
@@ -1682,25 +1684,25 @@
</tbody>
</table>
-<h3 id="yetus_run_and_redirect"><code>yetus_run_and_redirect</code></h3>
+<h3 id="yetus_get_ctime"><code>yetus_get_ctime</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight
plaintext"><code>yetus_run_and_redirect filename command [..]
+<div class="highlight"><pre class="highlight plaintext"><code>yetus_get_ctime
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>run the command, sending stdout and stderr to the given filename</p>
+<p>Get the date in ctime format</p>
<ul>
<li>Returns</li>
</ul>
-<p>$?</p>
+<p>ctime</p>
<table class="table table-bordered table-striped">
<thead>
@@ -1725,25 +1727,25 @@
</tbody>
</table>
-<h3 id="yetus_get_ctime"><code>yetus_get_ctime</code></h3>
+<h3 id="yetus_run_and_redirect"><code>yetus_run_and_redirect</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight plaintext"><code>yetus_get_ctime
+<div class="highlight"><pre class="highlight
plaintext"><code>yetus_run_and_redirect filename command [..]
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Get the date in ctime format</p>
+<p>run the command, sending stdout and stderr to the given filename</p>
<ul>
<li>Returns</li>
</ul>
-<p>ctime</p>
+<p>$?</p>
<table class="table table-bordered table-striped">
<thead>
@@ -1985,6 +1987,92 @@
</tbody>
</table>
+<h3
id="personality_file_tests_wrapper"><code>personality_file_tests_wrapper</code></h3>
+
+<ul>
+ <li>Synopsis</li>
+</ul>
+
+<div class="highlight"><pre class="highlight
plaintext"><code>personality_file_tests_wrapper
+</code></pre></div>
+<ul>
+ <li>Description</li>
+</ul>
+
+<p>Pick a personality_file_tests function tests that build support should call
this to make sure they get queued correct by the personality or the build
tool</p>
+
+<ul>
+ <li>Returns</li>
+</ul>
+
+<p>Nothing</p>
+
+<table class="table table-bordered table-striped">
+ <thead>
+ <tr>
+ <th style="text-align: left">Classification</th>
+ <th style="text-align: left">Level</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">Audience</td>
+ <td style="text-align: left">Public</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">Stability</td>
+ <td style="text-align: left">Evolving</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">Replaceable</td>
+ <td style="text-align: left">No</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3
id="personality_modules_wrapper"><code>personality_modules_wrapper</code></h3>
+
+<ul>
+ <li>Synopsis</li>
+</ul>
+
+<div class="highlight"><pre class="highlight
plaintext"><code>personality_modules_wrapper
+</code></pre></div>
+<ul>
+ <li>Description</li>
+</ul>
+
+<p>Pick a personality_modules function tests that build support should call
this to make sure they get queued correct by the personality or the build
tool</p>
+
+<ul>
+ <li>Returns</li>
+</ul>
+
+<p>Nothing</p>
+
+<table class="table table-bordered table-striped">
+ <thead>
+ <tr>
+ <th style="text-align: left">Classification</th>
+ <th style="text-align: left">Level</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td style="text-align: left">Audience</td>
+ <td style="text-align: left">Public</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">Stability</td>
+ <td style="text-align: left">Evolving</td>
+ </tr>
+ <tr>
+ <td style="text-align: left">Replaceable</td>
+ <td style="text-align: left">No</td>
+ </tr>
+ </tbody>
+</table>
+
<h3 id="plugin_usage_output"><code>plugin_usage_output</code></h3>
<ul>
diff --git a/documentation/in-progress/precommit/apidocs/test-patch/index.html
b/documentation/in-progress/precommit/apidocs/test-patch/index.html
index 6612966..844cfb1 100644
--- a/documentation/in-progress/precommit/apidocs/test-patch/index.html
+++ b/documentation/in-progress/precommit/apidocs/test-patch/index.html
@@ -162,6 +162,8 @@
<li><a href="#error_calcdiffs">error_calcdiffs</a></li>
<li><a href="#generic_calcdiff_status">generic_calcdiff_status</a></li>
<li><a href="#generic_logfilter">generic_logfilter</a></li>
+ <li><a href="#generic_post_handler">generic_post_handler</a></li>
+ <li><a href="#generic_postlog_compare">generic_postlog_compare</a></li>
<li><a href="#generic_pre_handler">generic_pre_handler</a></li>
<li><a href="#initialize">initialize</a></li>
<li><a href="#module_post_handler">module_post_handler</a></li>
@@ -173,10 +175,8 @@
<li><a href="#modules_reset">modules_reset</a></li>
<li><a href="#modules_restore">modules_restore</a></li>
<li><a href="#modules_workers">modules_workers</a></li>
- <li><a
href="#personality_enqueue_module">personality_enqueue_module</a></li>
- <li><a href="#generic_post_handler">generic_post_handler</a></li>
- <li><a href="#generic_postlog_compare">generic_postlog_compare</a></li>
<li><a href="#patchfiletests">patchfiletests</a></li>
+ <li><a
href="#personality_enqueue_module">personality_enqueue_module</a></li>
<li><a href="#root_postlog_compare">root_postlog_compare</a></li>
</ul>
</li>
@@ -1545,27 +1545,25 @@
</tbody>
</table>
-<h3 id="generic_pre_handler"><code>generic_pre_handler</code></h3>
+<h3 id="generic_post_handler"><code>generic_post_handler</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight
plaintext"><code>generic_pre_handler testype multijdk
+<div class="highlight"><pre class="highlight
plaintext"><code>generic_post_handler
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Deprecated. Use module_pre_handler instead.</p>
+<p>Deprecated. Use module_post_handler instead.</p>
<ul>
<li>Returns</li>
</ul>
-<p>1 on failure</p>
-
-<p>0 on success</p>
+<p>Nothing</p>
<table class="table table-bordered table-striped">
<thead>
@@ -1590,27 +1588,25 @@
</tbody>
</table>
-<h3 id="initialize"><code>initialize</code></h3>
+<h3 id="generic_postlog_compare"><code>generic_postlog_compare</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight plaintext"><code>initialize $@
+<div class="highlight"><pre class="highlight
plaintext"><code>generic_postlog_compare
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Setup to execute</p>
+<p>Deprecated. Use module_postlog_compare instead.</p>
<ul>
<li>Returns</li>
</ul>
-<p>0 on success</p>
-
-<p>1 on failure</p>
+<p>Nothing</p>
<table class="table table-bordered table-striped">
<thead>
@@ -1635,28 +1631,28 @@
</tbody>
</table>
-<h3 id="module_post_handler"><code>module_post_handler</code></h3>
+<h3 id="generic_pre_handler"><code>generic_pre_handler</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight
plaintext"><code>module_post_handler origlog testtype multijdkmode run commands
+<div class="highlight"><pre class="highlight
plaintext"><code>generic_pre_handler testype multijdk
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Generic post-patch handler</p>
+<p>Deprecated. Use module_pre_handler instead.</p>
<ul>
<li>Returns</li>
</ul>
-<p>0 on success</p>
-
<p>1 on failure</p>
+<p>0 on success</p>
+
<table class="table table-bordered table-striped">
<thead>
<tr>
@@ -1680,19 +1676,19 @@
</tbody>
</table>
-<h3 id="module_postlog_compare"><code>module_postlog_compare</code></h3>
+<h3 id="initialize"><code>initialize</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight
plaintext"><code>module_postlog_compare origlog testtype multijdkmode
+<div class="highlight"><pre class="highlight plaintext"><code>initialize $@
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Module post-patch log handler</p>
+<p>Setup to execute</p>
<ul>
<li>Returns</li>
@@ -1725,28 +1721,28 @@
</tbody>
</table>
-<h3 id="module_pre_handler"><code>module_pre_handler</code></h3>
+<h3 id="module_post_handler"><code>module_post_handler</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight
plaintext"><code>module_pre_handler testype multijdk
+<div class="highlight"><pre class="highlight
plaintext"><code>module_post_handler origlog testtype multijdkmode run commands
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Helper routine for plugins to do a pre-patch run</p>
+<p>Generic post-patch handler</p>
<ul>
<li>Returns</li>
</ul>
-<p>1 on failure</p>
-
<p>0 on success</p>
+<p>1 on failure</p>
+
<table class="table table-bordered table-striped">
<thead>
<tr>
@@ -1770,25 +1766,27 @@
</tbody>
</table>
-<h3 id="module_status"><code>module_status</code></h3>
+<h3 id="module_postlog_compare"><code>module_postlog_compare</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight plaintext"><code>module_status
moduleindex -1-0|0|+1 logvalue message
+<div class="highlight"><pre class="highlight
plaintext"><code>module_postlog_compare origlog testtype multijdkmode
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Add or update a test result. Update requires at least the first two
parameters. WARNING: If the message is updated, then the JDK version is also
calculated to match the current JAVA_HOME.</p>
+<p>Module post-patch log handler</p>
<ul>
<li>Returns</li>
</ul>
-<p>Nothing</p>
+<p>0 on success</p>
+
+<p>1 on failure</p>
<table class="table table-bordered table-striped">
<thead>
@@ -1813,25 +1811,27 @@
</tbody>
</table>
-<h3 id="modules_backup"><code>modules_backup</code></h3>
+<h3 id="module_pre_handler"><code>module_pre_handler</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight plaintext"><code>modules_backup
+<div class="highlight"><pre class="highlight
plaintext"><code>module_pre_handler testype multijdk
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Backup the MODULE globals prior to loop processing</p>
+<p>Helper routine for plugins to do a pre-patch run</p>
<ul>
<li>Returns</li>
</ul>
-<p>Nothing</p>
+<p>1 on failure</p>
+
+<p>0 on success</p>
<table class="table table-bordered table-striped">
<thead>
@@ -1856,19 +1856,19 @@
</tbody>
</table>
-<h3 id="modules_messages"><code>modules_messages</code></h3>
+<h3 id="module_status"><code>module_status</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight plaintext"><code>modules_messages
repostatus testtype summarymode
+<div class="highlight"><pre class="highlight plaintext"><code>module_status
moduleindex -1-0|0|+1 logvalue message
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Utility to print standard module errors</p>
+<p>Add or update a test result. Update requires at least the first two
parameters. WARNING: If the message is updated, then the JDK version is also
calculated to match the current JAVA_HOME.</p>
<ul>
<li>Returns</li>
@@ -1899,19 +1899,19 @@
</tbody>
</table>
-<h3 id="modules_reset"><code>modules_reset</code></h3>
+<h3 id="modules_backup"><code>modules_backup</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight plaintext"><code>modules_reset
+<div class="highlight"><pre class="highlight plaintext"><code>modules_backup
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Reset the test results</p>
+<p>Backup the MODULE globals prior to loop processing</p>
<ul>
<li>Returns</li>
@@ -1942,19 +1942,19 @@
</tbody>
</table>
-<h3 id="modules_restore"><code>modules_restore</code></h3>
+<h3 id="modules_messages"><code>modules_messages</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight plaintext"><code>modules_restore
+<div class="highlight"><pre class="highlight plaintext"><code>modules_messages
repostatus testtype summarymode
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Restore the backup</p>
+<p>Utility to print standard module errors</p>
<ul>
<li>Returns</li>
@@ -1985,19 +1985,19 @@
</tbody>
</table>
-<h3 id="modules_workers"><code>modules_workers</code></h3>
+<h3 id="modules_reset"><code>modules_reset</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight plaintext"><code>modules_workers
repostatus testtype mvncmdline
+<div class="highlight"><pre class="highlight plaintext"><code>modules_reset
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>run the tests for the queued modules</p>
+<p>Reset the test results</p>
<ul>
<li>Returns</li>
@@ -2028,19 +2028,19 @@
</tbody>
</table>
-<h3
id="personality_enqueue_module"><code>personality_enqueue_module</code></h3>
+<h3 id="modules_restore"><code>modules_restore</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight
plaintext"><code>personality_enqueue_module module profiles/flags/etc
+<div class="highlight"><pre class="highlight plaintext"><code>modules_restore
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Build the queue for tests</p>
+<p>Restore the backup</p>
<ul>
<li>Returns</li>
@@ -2071,19 +2071,19 @@
</tbody>
</table>
-<h3 id="generic_post_handler"><code>generic_post_handler</code></h3>
+<h3 id="modules_workers"><code>modules_workers</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight
plaintext"><code>generic_post_handler
+<div class="highlight"><pre class="highlight plaintext"><code>modules_workers
repostatus testtype mvncmdline
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Deprecated. Use module_post_handler instead.</p>
+<p>run the tests for the queued modules</p>
<ul>
<li>Returns</li>
@@ -2114,25 +2114,27 @@
</tbody>
</table>
-<h3 id="generic_postlog_compare"><code>generic_postlog_compare</code></h3>
+<h3 id="patchfiletests"><code>patchfiletests</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight
plaintext"><code>generic_postlog_compare
+<div class="highlight"><pre class="highlight plaintext"><code>patchfiletests
branch|patch
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Deprecated. Use module_postlog_compare instead.</p>
+<p>Execute the patch file test phase. Calls out to to _patchfile</p>
<ul>
<li>Returns</li>
</ul>
-<p>Nothing</p>
+<p>0 on success</p>
+
+<p>1 on failure</p>
<table class="table table-bordered table-striped">
<thead>
@@ -2157,27 +2159,25 @@
</tbody>
</table>
-<h3 id="patchfiletests"><code>patchfiletests</code></h3>
+<h3
id="personality_enqueue_module"><code>personality_enqueue_module</code></h3>
<ul>
<li>Synopsis</li>
</ul>
-<div class="highlight"><pre class="highlight plaintext"><code>patchfiletests
branch|patch
+<div class="highlight"><pre class="highlight
plaintext"><code>personality_enqueue_module module profiles/flags/etc
</code></pre></div>
<ul>
<li>Description</li>
</ul>
-<p>Execute the patch file test phase. Calls out to to _patchfile</p>
+<p>Build the queue for tests</p>
<ul>
<li>Returns</li>
</ul>
-<p>0 on success</p>
-
-<p>1 on failure</p>
+<p>Nothing</p>
<table class="table table-bordered table-striped">
<thead>
diff --git a/documentation/in-progress/precommit/testformats/index.html
b/documentation/in-progress/precommit/testformats/index.html
index aca167b..67855b1 100644
--- a/documentation/in-progress/precommit/testformats/index.html
+++ b/documentation/in-progress/precommit/testformats/index.html
@@ -149,7 +149,7 @@
<h1 id="example">Example</h1>
-<p>For an example of how to write a test-format plugin, you can look at <a
href="https://github.com/apache/yetus/blob/main/precommit/test-patch.d/junit.sh";>junit
plugin</a> bundled in Apache Yetus.</p>
+<p>For an example of how to write a test-format plugin, you can look at <a
href="https://github.com/apache/yetus/blob/main/precommit/plugins.d/junit.sh";>junit
plugin</a> bundled in Apache Yetus.</p>
</div>
diff --git a/downloads/releasenotes/0.13.0/CHANGELOG.0.13.0/index.html
b/downloads/releasenotes/0.13.0/CHANGELOG.0.13.0/index.html
index ed7b218..f8711c3 100644
--- a/downloads/releasenotes/0.13.0/CHANGELOG.0.13.0/index.html
+++ b/downloads/releasenotes/0.13.0/CHANGELOG.0.13.0/index.html
@@ -122,7 +122,7 @@
-->
<h1 id="apache-yetus-changelog">Apache Yetus Changelog</h1>
-<h2 id="release-0130---unreleased-as-of-2020-11-23">Release 0.13.0 -
Unreleased (as of 2020-11-23)</h2>
+<h2 id="release-0130---unreleased-as-of-2020-11-27">Release 0.13.0 -
Unreleased (as of 2020-11-27)</h2>
<h3 id="important-issues">IMPORTANT ISSUES:</h3>
@@ -274,6 +274,14 @@
<td style="text-align: left">Ajay Yadav</td>
<td style="text-align: left">Allen Wittenauer</td>
</tr>
+ <tr>
+ <td style="text-align: left"><a
href="https://issues.apache.org/jira/browse/YETUS-1072";>YETUS-1072</a></td>
+ <td style="text-align: left">Rework personalities and some plug-in
handling</td>
+ <td style="text-align: left">Major</td>
+ <td style="text-align: left">Precommit</td>
+ <td style="text-align: left">Allen Wittenauer</td>
+ <td style="text-align: left">Allen Wittenauer</td>
+ </tr>
</tbody>
</table>
@@ -580,6 +588,14 @@
<td style="text-align: left">Allen Wittenauer</td>
<td style="text-align: left">Allen Wittenauer</td>
</tr>
+ <tr>
+ <td style="text-align: left"><a
href="https://issues.apache.org/jira/browse/YETUS-1092";>YETUS-1092</a></td>
+ <td style="text-align: left">Exit immediately if –personality doesn't
exist</td>
+ <td style="text-align: left">Major</td>
+ <td style="text-align: left">Precommit</td>
+ <td style="text-align: left">Allen Wittenauer</td>
+ <td style="text-align: left">Allen Wittenauer</td>
+ </tr>
</tbody>
</table>
@@ -845,6 +861,14 @@
<td style="text-align: left">Allen Wittenauer</td>
<td style="text-align: left">Allen Wittenauer</td>
</tr>
+ <tr>
+ <td style="text-align: left"><a
href="https://issues.apache.org/jira/browse/YETUS-1089";>YETUS-1089</a></td>
+ <td style="text-align: left">replaceable is not consistently handled</td>
+ <td style="text-align: left">Minor</td>
+ <td style="text-align: left">ShellDocs</td>
+ <td style="text-align: left">Allen Wittenauer</td>
+ <td style="text-align: left">Allen Wittenauer</td>
+ </tr>
</tbody>
</table>
@@ -904,14 +928,6 @@
<td style="text-align: left">Allen Wittenauer</td>
</tr>
<tr>
- <td style="text-align: left"><a
href="https://issues.apache.org/jira/browse/YETUS-1034";>YETUS-1034</a></td>
- <td style="text-align: left">Release 0.13.0</td>
- <td style="text-align: left">Major</td>
- <td style="text-align: left">build</td>
- <td style="text-align: left">Allen Wittenauer</td>
- <td style="text-align: left">Allen Wittenauer</td>
- </tr>
- <tr>
<td style="text-align: left"><a
href="https://issues.apache.org/jira/browse/YETUS-1077";>YETUS-1077</a></td>
<td style="text-align: left">Remove jython completely</td>
<td style="text-align: left">Major</td>
@@ -919,6 +935,14 @@
<td style="text-align: left">Akira Ajisaka</td>
<td style="text-align: left">Akira Ajisaka</td>
</tr>
+ <tr>
+ <td style="text-align: left"><a
href="https://issues.apache.org/jira/browse/YETUS-1034";>YETUS-1034</a></td>
+ <td style="text-align: left">Release 0.13.0</td>
+ <td style="text-align: left">Major</td>
+ <td style="text-align: left">build</td>
+ <td style="text-align: left">Allen Wittenauer</td>
+ <td style="text-align: left">Allen Wittenauer</td>
+ </tr>
</tbody>
</table>
diff --git a/downloads/releasenotes/0.13.0/RELEASENOTES.0.13.0/index.html
b/downloads/releasenotes/0.13.0/RELEASENOTES.0.13.0/index.html
index f3d2c33..02612b3 100644
--- a/downloads/releasenotes/0.13.0/RELEASENOTES.0.13.0/index.html
+++ b/downloads/releasenotes/0.13.0/RELEASENOTES.0.13.0/index.html
@@ -163,16 +163,7 @@
<p>This change moves the default Apache Yetus docker image to a new version of
Ubuntu as well as upgrades many, many bundled components to new releases.
Users utilizing the docker image should upgrade carefully!</p>
<p>Early removal notice:</p>
-
<ul>
- <li>Python 2.x support. It will be removed from:
- <ul>
- <li>Docker image</li>
- <li>precommit</li>
- <li>releasedocmaker</li>
- <li>shelldocs</li>
- </ul>
- </li>
<li>FindBugs support; please migrate to SpotBugs.</li>
</ul>
@@ -269,7 +260,7 @@
</ul>
<!-- markdown -->
-<p>This change replaces the Apache Yetus comment with (GitHub
Status)[https://docs.github.com/en/rest/reference/repos#statuses]
notifications. Note that your GitHub Token requires repo:status write or
better privileges.</p>
+<p>This change replaces the Apache Yetus comment with <a
href="https://docs.github.com/en/rest/reference/repos#statuses";>GitHub
Status</a> notifications. Note that your GitHub Token requires repo:status
write or better privileges.</p>
<hr />
@@ -288,7 +279,7 @@
</ul>
<!-- markdown -->
-<p>The apache/yetus docker image now defaults to running test-patch.</p>
+<p>The apache/yetus docker image now defaults to running
<code>test-patch</code>.</p>
<hr />
@@ -327,12 +318,13 @@
<!-- markdown -->
<p>Users:<br />
-Comments added on a per line basis were only ever shipped with support on
GitHub, only on PRs, and was rarely used due to being very noisy. That
functionality has been removed and replaced with GitHub Checks Annotations when
run under GitHub Actions with support for both branches and PRs. Future/other
changes may re-introduce support for non-GitHub Actions. Any 3rd party plug-ins
that support line-level comments will need to be updated to support the new
API.</p>
+Comments added on a per line basis were only ever shipped with support on
GitHub, only on PRs, and was rarely used due to being very noisy. That
functionality has been removed and replaced with <a
href="https://github.blog/2018-12-14-introducing-check-runs-and-annotations/";>GitHub
Checks Annotations</a> when run under <a
href="https://github.com/features/actions";>GitHub Actions</a> with support for
both branches and PRs. Any 3rd party plug-ins that support line-level
comments will nee [...]
<p>Developers:<br />
With GitHub Checks Annotations being the preferred way on GitHub for CI
systems to make individual notes, the API requirements and surrounding support
structure for line comments have also changed:</p>
<ul>
+ <li>File names MUST be relative to <code>BASEDIR</code>.</li>
<li>The unidiff line calculations (<code>compute_unidiff</code>) has been
removed. This should greatly increase performance for large patches.</li>
<li>Relatedly, <code>GITUNIDIFFLINES</code> has been removed from the global
variables.</li>
<li><code>(bugsystem)_linecoments</code> and related functions should now
expect and pass a column parameter. Log files should be in typical
file:line[:column]:text format, where the missing column or 0 or "" will be
used for no column/whole file.</li>
@@ -539,7 +531,7 @@ With GitHub Checks Annotations being the preferred way on
GitHub for CI systems
</ul>
<!-- markdown -->
-<p>The website now has links to all of the changelogs and releasenotes of
every Apache Yetus release!</p>
+<p>The website now has <a
href="https://yetus.apache.org/downloads/releasenotes/";>links to all of the
changelogs and release notes</a> of every Apache Yetus release!</p>
<hr />
@@ -558,7 +550,7 @@ With GitHub Checks Annotations being the preferred way on
GitHub for CI systems
</ul>
<!-- markdown -->
-<p>The jython versions of releasedocmaker and shelldocs have been removed.
The releasedocmaker and shelldocs features of yetus-maven-plugin have been
removed.</p>
+<p>The jython versions of <code>releasedocmaker</code> and
<code>shelldocs</code> have been removed. The <code>releasedocmaker</code> and
<code>shelldocs</code> features of <code>yetus-maven-plugin</code> have been
removed.</p>
<hr />
@@ -577,7 +569,7 @@ With GitHub Checks Annotations being the preferred way on
GitHub for CI systems
</ul>
<!-- markdown -->
-<p>The Docker image now as the Apache Creadur RAT jar. This change should
allow for the <code>asflicense</code> plug-in for <code>test-patch</code> to
work out of the box.</p>
+<p>The Docker image now has the Apache Creadur RAT jar included. This change
should allow for the <code>asflicense</code> plug-in for
<code>test-patch</code> to work out of the box.</p>
<hr />
@@ -673,7 +665,7 @@ With GitHub Checks Annotations being the preferred way on
GitHub for CI systems
</ul>
<!-- markdown -->
-<p>Codespell is now supported to provide spell checking for source trees.</p>
+<p><a href="https://github.com/codespell-project/codespell";>Codespell</a> is
now supported to provide spell checking for source trees.</p>
<hr />
@@ -695,6 +687,42 @@ With GitHub Checks Annotations being the preferred way on
GitHub for CI systems
<p><a href="https://buildkite.com";>Buildkite</a> is now supported as a
robot.</p>
+<hr />
+
+<ul>
+ <li>
+ <table class="table table-bordered table-striped">
+ <tbody>
+ <tr>
+ <td><a
href="https://issues.apache.org/jira/browse/YETUS-1072";>YETUS-1072</a></td>
+ <td><em>Major</em></td>
+ <td><strong>Rework personalities and some plug-in
handling</strong></td>
+ </tr>
+ </tbody>
+ </table>
+ </li>
+</ul>
+
+<!-- markdown -->
+
+<p>Users:</p>
+<ul>
+ <li>Precommit's bundled personalities have been removed as they are all out
of date.</li>
+ <li>Personalities will be loaded from <code>.yetus/personality.sh</code> by
default.</li>
+ <li>User-plugins will be loaded from<code>.yetus/plugins.d</code> by
default.</li>
+ <li>The <code>test-patch.d</code> directory has been renamed to
<code>plugins.</code></li>
+ <li><code>--project</code> can no longer be used to load a personality from
a plugin directory.</li>
+</ul>
+
+<p>Developers:</p>
+<ul>
+ <li>BASEDIR is now absolute'd sooner.</li>
+ <li>PERSONALITY and USER_PLUGIN_DIR will almost always have a value now.</li>
+ <li>PERSONALITY is now guaranteed to load after plugins.</li>
+ <li><code>personality_modules</code> and <code>personality_file_tests</code>
are no longer defined by default. Instead, plugins, core code, etc,
(basically, anything not a personality) should call
<code>personality_modules_wrapper</code> and
<code>personality_file_tests_wrapper</code>. These functions will be redirect
to the correct function.</li>
+ <li>PROJECT_NAME_* is now honored for loading many of the
personality-specific functions.</li>
+</ul>
+
</div>
diff --git a/project-reports.html b/project-reports.html
index 9fa343a..e1b7c86 100644
--- a/project-reports.html
+++ b/project-reports.html
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
-<!-- Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-site-plugin:3.7.1:CategorySummaryDocumentRenderer
at 2020-11-23 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.8.1 from
org.apache.maven.plugins:maven-site-plugin:3.7.1:CategorySummaryDocumentRenderer
at 2020-11-27 -->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -24,7 +24,7 @@ Apache Yetus Project
</div>
<div id="breadcrumbs">
<div class="xleft">
- <span id="publishDate">Last Published: 2020-11-23</span>
+ <span id="publishDate">Last Published: 2020-11-27</span>
| <span id="projectVersion">Version: 0.14.0-SNAPSHOT</span>
</div>
<div class="xright"><a href="./" title="Apache Yetus Project">Apache
Yetus Project</a> </div>
