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 bb71755d85 Publish built docs triggered by
51f0833dfeb7d191d1aaf119f7fd83c501d4f6b9
bb71755d85 is described below
commit bb71755d85b7ab220cf0e9d955cea44a2ca16682
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Tue Mar 11 14:58:29 2025 +0000
Publish built docs triggered by 51f0833dfeb7d191d1aaf119f7fd83c501d4f6b9
---
_sources/contributor-guide/testing.md.txt | 12 ++++++++++++
contributor-guide/testing.html | 15 +++++++++++++++
searchindex.js | 2 +-
3 files changed, 28 insertions(+), 1 deletion(-)
diff --git a/_sources/contributor-guide/testing.md.txt
b/_sources/contributor-guide/testing.md.txt
index 2a9f22d22d..2868125c7f 100644
--- a/_sources/contributor-guide/testing.md.txt
+++ b/_sources/contributor-guide/testing.md.txt
@@ -58,6 +58,18 @@ Like similar systems such as
[DuckDB](https://duckdb.org/dev/testing), DataFusio
DataFusion has integrated [sqlite's test
suite](https://sqlite.org/sqllogictest/doc/trunk/about.wiki) as a supplemental
test suite that is run whenever a PR is merged into DataFusion. To run it
manually please refer to the
[README](https://github.com/apache/datafusion/blob/main/datafusion/sqllogictest/README.md#running-tests-sqlite)
file for instructions.
+## Snapshot testing
+
+[Insta](https://github.com/mitsuhiko/insta) is used for snapshot testing.
Snapshots are generated
+and compared on each test run. If the output changes, tests will fail.
+
+To review the changes, you can use Insta CLI:
+
+```shell
+cargo install cargo-insta
+cargo insta review
+```
+
## Extended Tests
In addition to the standard CI test suite that is run on all PRs prior to
merge,
diff --git a/contributor-guide/testing.html b/contributor-guide/testing.html
index d638b30d88..d5f73893e3 100644
--- a/contributor-guide/testing.html
+++ b/contributor-guide/testing.html
@@ -532,6 +532,11 @@
sqllogictests Tests
</a>
</li>
+ <li class="toc-h2 nav-item toc-entry">
+ <a class="reference internal nav-link" href="#snapshot-testing">
+ Snapshot testing
+ </a>
+ </li>
<li class="toc-h2 nav-item toc-entry">
<a class="reference internal nav-link" href="#extended-tests">
Extended Tests
@@ -664,6 +669,16 @@ The <a class="reference external"
href="https://github.com/apache/datafusion/tre
<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>
<p>DataFusion has integrated <a class="reference external"
href="https://sqlite.org/sqllogictest/doc/trunk/about.wiki";>sqlite’s test
suite</a> as a supplemental test suite that is run whenever a PR is merged into
DataFusion. To run it manually please refer to the <a class="reference
external"
href="https://github.com/apache/datafusion/blob/main/datafusion/sqllogictest/README.md#running-tests-sqlite";>README</a>
file for instructions.</p>
</section>
+<section id="snapshot-testing">
+<h2>Snapshot testing<a class="headerlink" href="#snapshot-testing" title="Link
to this heading">¶</a></h2>
+<p><a class="reference external"
href="https://github.com/mitsuhiko/insta";>Insta</a> is used for snapshot
testing. Snapshots are generated
+and compared on each test run. If the output changes, tests will fail.</p>
+<p>To review the changes, you can use Insta CLI:</p>
+<div class="highlight-shell notranslate"><div
class="highlight"><pre><span></span>cargo<span class="w"> </span>install<span
class="w"> </span>cargo-insta
+cargo<span class="w"> </span>insta<span class="w"> </span>review
+</pre></div>
+</div>
+</section>
<section id="extended-tests">
<h2>Extended Tests<a class="headerlink" href="#extended-tests" title="Link to
this heading">¶</a></h2>
<p>In addition to the standard CI test suite that is run on all PRs prior to
merge,
diff --git a/searchindex.js b/searchindex.js
index 6efabe4005..7cfa01cd62 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[52,"op-neq"]],"!~":[[52,"op-re-not-match"]],"!~*":[[52,"op-re-not-match-i"]],"!~~":[[52,"id19"]],"!~~*":[[52,"id20"]],"#":[[52,"op-bit-xor"]],"%":[[52,"op-modulo"]],"&":[[52,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[12,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[52,"op-multiply"]],"+":[[52,"op-plus"]],"-":[[52,"op-minus"]],"/":[[52,"op-divide"]],"2022
Q2":[[10,"q2"]] [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[52,"op-neq"]],"!~":[[52,"op-re-not-match"]],"!~*":[[52,"op-re-not-match-i"]],"!~~":[[52,"id19"]],"!~~*":[[52,"id20"]],"#":[[52,"op-bit-xor"]],"%":[[52,"op-modulo"]],"&":[[52,"op-bit-and"]],"(relation,
name) tuples in logical fields and logical columns are
unique":[[12,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[52,"op-multiply"]],"+":[[52,"op-plus"]],"-":[[52,"op-minus"]],"/":[[52,"op-divide"]],"2022
Q2":[[10,"q2"]] [...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
