This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/datafusion.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 439d79db16 Publish built docs triggered by
13ddbaf2f7220c26f443d097697d1380e63f6206
439d79db16 is described below
commit 439d79db169ecb22ec41c87e946decfe2dc2193b
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Fri Jul 12 14:54:31 2024 +0000
Publish built docs triggered by 13ddbaf2f7220c26f443d097697d1380e63f6206
---
_sources/contributor-guide/testing.md.txt | 14 +++++++++++++-
contributor-guide/testing.html | 26 ++++++++++++++++++--------
searchindex.js | 2 +-
3 files changed, 32 insertions(+), 10 deletions(-)
diff --git a/_sources/contributor-guide/testing.md.txt
b/_sources/contributor-guide/testing.md.txt
index 018cc6233c..0f4461ab2c 100644
--- a/_sources/contributor-guide/testing.md.txt
+++ b/_sources/contributor-guide/testing.md.txt
@@ -39,7 +39,7 @@ DataFusion's SQL implementation is tested using
[sqllogictest](https://github.co
Like similar systems such as [DuckDB](https://duckdb.org/dev/testing),
DataFusion has chosen to trade off a slightly higher barrier to contribution
for longer term maintainability.
-### Rust Integration Tests
+## Rust Integration Tests
There are several tests of the public interface of the DataFusion library in
the
[tests](https://github.com/apache/datafusion/tree/main/datafusion/core/tests)
directory.
@@ -49,6 +49,18 @@ You can run these tests individually using `cargo` as normal
command such as
cargo test -p datafusion --test parquet_exec
```
+## SQL "Fuzz" testing
+
+DataFusion uses the [SQLancer] for "fuzz" testing: it generates random SQL
+queries and execute them against DataFusion to find bugs.
+
+The code is in the [datafusion-sqllancer] repository, and we welcome further
+contributions. Kudos to [@2010YOUY01] for the initial implementation.
+
+[sqlancer]: https://github.com/sqlancer/sqlancer
+[datafusion-sqllancer]:
https://github.com/datafusion-contrib/datafusion-sqllancer
+[@2010youy01]: https://github.com/2010YOUY01
+
## Documentation Examples
We use Rust [doctest] to verify examples from the documentation are correct and
diff --git a/contributor-guide/testing.html b/contributor-guide/testing.html
index a37395482e..27968d863d 100644
--- a/contributor-guide/testing.html
+++ b/contributor-guide/testing.html
@@ -487,13 +487,16 @@
<a class="reference internal nav-link" href="#sqllogictests-tests">
sqllogictests Tests
</a>
- <ul class="nav section-nav flex-column">
- <li class="toc-h3 nav-item toc-entry">
- <a class="reference internal nav-link" href="#rust-integration-tests">
- Rust Integration Tests
- </a>
- </li>
- </ul>
+ </li>
+ <li class="toc-h2 nav-item toc-entry">
+ <a class="reference internal nav-link" href="#rust-integration-tests">
+ Rust Integration Tests
+ </a>
+ </li>
+ <li class="toc-h2 nav-item toc-entry">
+ <a class="reference internal nav-link" href="#sql-fuzz-testing">
+ SQL “Fuzz” testing
+ </a>
</li>
<li class="toc-h2 nav-item toc-entry">
<a class="reference internal nav-link" href="#documentation-examples">
@@ -602,14 +605,21 @@ and tries to follow the Rust standard <a class="reference
external" href="https:
<p>DataFusion’s SQL implementation is tested using <a class="reference
external"
href="https://github.com/apache/datafusion/tree/main/datafusion/sqllogictest";>sqllogictest</a>
which are run like any other Rust test using <code class="docutils literal
notranslate"><span class="pre">cargo</span> <span class="pre">test</span> <span
class="pre">--test</span> <span class="pre">sqllogictests</span></code>.</p>
<p><code class="docutils literal notranslate"><span
class="pre">sqllogictests</span></code> tests may be less convenient for new
contributors who are familiar with writing <code class="docutils literal
notranslate"><span class="pre">.rs</span></code> tests as they require learning
another tool. However, <code class="docutils literal notranslate"><span
class="pre">sqllogictest</span></code> based tests are much easier to develop
and maintain as they 1) do not require a slow recompile/link [...]
<p>Like similar systems such as <a class="reference external"
href="https://duckdb.org/dev/testing";>DuckDB</a>, DataFusion has chosen to
trade off a slightly higher barrier to contribution for longer term
maintainability.</p>
+</section>
<section id="rust-integration-tests">
-<h3>Rust Integration Tests<a class="headerlink" href="#rust-integration-tests"
title="Link to this heading">¶</a></h3>
+<h2>Rust Integration Tests<a class="headerlink" href="#rust-integration-tests"
title="Link to this heading">¶</a></h2>
<p>There are several tests of the public interface of the DataFusion library
in the <a class="reference external"
href="https://github.com/apache/datafusion/tree/main/datafusion/core/tests";>tests</a>
directory.</p>
<p>You can run these tests individually using <code class="docutils literal
notranslate"><span class="pre">cargo</span></code> as normal command such as</p>
<div class="highlight-shell notranslate"><div
class="highlight"><pre><span></span>cargo<span class="w"> </span><span
class="nb">test</span><span class="w"> </span>-p<span class="w">
</span>datafusion<span class="w"> </span>--test<span class="w">
</span>parquet_exec
</pre></div>
</div>
</section>
+<section id="sql-fuzz-testing">
+<h2>SQL “Fuzz” testing<a class="headerlink" href="#sql-fuzz-testing"
title="Link to this heading">¶</a></h2>
+<p>DataFusion uses the <a class="reference external"
href="https://github.com/sqlancer/sqlancer";>SQLancer</a> for “fuzz” testing: it
generates random SQL
+queries and execute them against DataFusion to find bugs.</p>
+<p>The code is in the <a class="reference external"
href="https://github.com/datafusion-contrib/datafusion-sqllancer";>datafusion-sqllancer</a>
repository, and we welcome further
+contributions. Kudos to <a class="reference external"
href="https://github.com/2010YOUY01";>@2010YOUY01</a> for the initial
implementation.</p>
</section>
<section id="documentation-examples">
<h2>Documentation Examples<a class="headerlink" href="#documentation-examples"
title="Link to this heading">¶</a></h2>
diff --git a/searchindex.js b/searchindex.js
index 46366fa90f..b9af350f0c 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles": {"!=": [[44, "op-neq"]], "!~": [[44,
"op-re-not-match"]], "!~*": [[44, "op-re-not-match-i"]], "!~~": [[44, "id18"]],
"!~~*": [[44, "id19"]], "#": [[44, "op-bit-xor"]], "%": [[44, "op-modulo"]],
"&": [[44, "op-bit-and"]], "(relation, name) tuples in logical fields and
logical columns are unique": [[10,
"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]], "*":
[[44, "op-multiply"]], "+": [[44, "op-plus"]], "-": [[44, "op-minus"]], "/": [[
[...]
\ No newline at end of file
+Search.setIndex({"alltitles": {"!=": [[44, "op-neq"]], "!~": [[44,
"op-re-not-match"]], "!~*": [[44, "op-re-not-match-i"]], "!~~": [[44, "id18"]],
"!~~*": [[44, "id19"]], "#": [[44, "op-bit-xor"]], "%": [[44, "op-modulo"]],
"&": [[44, "op-bit-and"]], "(relation, name) tuples in logical fields and
logical columns are unique": [[10,
"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]], "*":
[[44, "op-multiply"]], "+": [[44, "op-plus"]], "-": [[44, "op-minus"]], "/": [[
[...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
