docs: acknowledge Rust's existence (#3083)

Co-authored-by: Bryce Mecum <petridish@gmail.com>
Co-authored-by: Daijiro Fukuda <fukuda@clear-code.com>

Author: 3 people

docs/source/driver/installation.rst

@@ -167,3 +167,13 @@ Ruby
 
 Install the appropriate driver package for C/C++. You can use it from
 Ruby.
+
+Rust
+====
+
+Add a dependency on ``adbc_core`` and any driver packages
+(e.g. ``adbc_datafusion``):
+
+.. code-block:: shell
+
+   cargo add adbc_core adbc_datafusion

docs/source/index.rst

@@ -96,6 +96,13 @@ make it more convenient to build analytical applications.
 
             R
 
+         .. button-ref:: rust/quickstart
+            :ref-type: doc
+            :color: secondary
+            :expand:
+
+            Rust
+
       .. grid-item-card::
          :columns: 12 4 4 4
 
@@ -190,7 +197,7 @@ Why ADBC?
 
    .. grid-item-card:: Cross-language
 
-      Work in C/C++, C#, Go, Java, Python, R, Ruby, and more.
+      Work in C/C++, C#, Go, Java, Python, R, Ruby, Rust, and more.
 
    .. grid-item-card:: Full-featured
 
@@ -222,6 +229,7 @@ Why ADBC?
    Java <java/index>
    Python <python/index>
    R <r/index>
+   Rust <rust/index>
 
 .. toctree::
    :maxdepth: 1

docs/source/rust/driver_manager.rst

@@ -0,0 +1,26 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements.  See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership.  The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License.  You may obtain a copy of the License at
+..
+..   http://www.apache.org/licenses/LICENSE-2.0
+..
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied.  See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+==============
+Driver Manager
+==============
+
+The driver manager is a library that implements the ADBC API by delegating to
+dynamically-loaded drivers.  This allows applications to load drivers at
+runtime, and use drivers that aren't necessarily written in Rust.  It is
+currently part of the adbc_core package, though we plan to split it into its
+own package for users who don't want or need FFI.

docs/source/rust/index.rst

@@ -0,0 +1,31 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements.  See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership.  The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License.  You may obtain a copy of the License at
+..
+..   http://www.apache.org/licenses/LICENSE-2.0
+..
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied.  See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+====
+Rust
+====
+
+The ADBC Rust library is a standalone implementation of the ADBC APIs (like
+C/C++, C#, and Go).  The primary crate is `adbc_core
+<https://crates.io/crates/adbc_core>`_.
+
+.. toctree::
+   :maxdepth: 2
+
+   quickstart
+   driver_manager
+   Rust API Reference <https://docs.rs/adbc_core/latest/adbc_core/>

docs/source/rust/quickstart.rst

@@ -0,0 +1,70 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements.  See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership.  The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License.  You may obtain a copy of the License at
+..
+..   http://www.apache.org/licenses/LICENSE-2.0
+..
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied.  See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+==========
+Quickstart
+==========
+
+Here we'll briefly tour using ADBC with the `DataFusion`_ driver.
+
+.. _DataFusion: https://datafusion.apache.org/
+
+Installation
+============
+
+Add a dependency on ``adbc_core`` and ``adbc_datafusion``:
+
+.. code-block:: shell
+
+   cargo add adbc_core adbc_datafusion
+
+Loading DataFusion
+==================
+
+Create a driver instance, then a database handle, and then finally a
+connection.  (This is a bit redundant for something like DataFusion, but the
+intent is that the database handle can hold shared state that multiple
+connections can share.)
+
+.. code-block:: rust
+
+   // These traits must be in scope
+   use adbc_core::{Connection, Database, Driver, Statement};
+
+   let mut driver = adbc_datafusion::DataFusionDriver {};
+   let db = driver.new_database().expect("Failed to create database handle");
+   let mut conn = db.new_connection().expect("Failed to create connection");
+
+Running Queries
+===============
+
+To run queries, we can create a statement and set a query:
+
+.. code-block:: rust
+
+   let mut stmt = conn.new_statement().expect("Failed to create statement");
+   stmt.set_sql_query("SELECT 1").expect("Failed to set SQL query");
+
+We can then execute the query to get an Arrow ``RecordBatchReader``:
+
+.. code-block:: rust
+
+   let reader = stmt.execute().expect("Failed to execute statement");
+   for batch in reader {
+       let batch = batch.expect("Failed to read batch");
+       println!("{:?}", batch);
+   }