From 66da037300a32e1031d4606dd910ca370ba3eebf Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 12 Jul 2024 07:23:04 -0400 Subject: [PATCH 1/2] Minor: Add note about SQLLancer fuzz testing to docs --- docs/source/contributor-guide/testing.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/source/contributor-guide/testing.md b/docs/source/contributor-guide/testing.md index 018cc6233c46..f78f118deb3a 100644 --- a/docs/source/contributor-guide/testing.md +++ b/docs/source/contributor-guide/testing.md @@ -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,19 @@ 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 From d57e0780e7fd500da6b6aca1f314ec645e70e27e Mon Sep 17 00:00:00 2001 From: Andrew Lamb Date: Fri, 12 Jul 2024 07:29:38 -0400 Subject: [PATCH 2/2] prettier --- docs/source/contributor-guide/testing.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/source/contributor-guide/testing.md b/docs/source/contributor-guide/testing.md index f78f118deb3a..0f4461ab2c2c 100644 --- a/docs/source/contributor-guide/testing.md +++ b/docs/source/contributor-guide/testing.md @@ -57,10 +57,9 @@ 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 +[sqlancer]: https://github.com/sqlancer/sqlancer [datafusion-sqllancer]: https://github.com/datafusion-contrib/datafusion-sqllancer -[@2010YOUY01]: https://github.com/2010YOUY01 - +[@2010youy01]: https://github.com/2010YOUY01 ## Documentation Examples