docs: generate driver status from README badges

lidavidm · lidavidm · commit 7e902ca42e9b · 2025-05-29T17:08:32.000+09:00
diff --git a/c/driver/bigquery/README.md b/c/driver/bigquery/README.md
@@ -19,6 +19,15 @@
 
 # ADBC BigQuery Driver
 
+![Vendor: Google BigQuery](https://img.shields.io/badge/vendor-sqlite-blue?style=flat-square)
+![Implementation: Go](https://img.shields.io/badge/language-Go-violet?style=flat-square)
+![Status: Experimental](https://img.shields.io/badge/status-experimental-red?style=flat-square)
+
+[![conda-forge: adbc-driver-bigquery](https://img.shields.io/conda/vn/conda-forge/adbc-driver-bigquery?label=conda-forge%3A%20adbc-driver-bigquery&style=flat-square)](https://anaconda.org/conda-forge/adbc-driver-bigquery)
+[![conda-forge: libadbc-driver-bigquery](https://img.shields.io/conda/vn/conda-forge/libadbc-driver-bigquery?label=conda-forge%3A%20libadbc-driver-bigquery&style=flat-square)](https://anaconda.org/conda-forge/libadbc-driver-bigquery)
+[![PyPI: adbc-driver-bigquery](https://img.shields.io/pypi/v/adbc-driver-bigquery?style=flat-square)](https://pypi.org/project/adbc-driver-bigquery/)
+[![R: adbcbigquery](https://img.shields.io/github/r-package/v/apache/arrow-adbc?filename=r%2Fadbcbigquery%2FDESCRIPTION&style=flat-square)](https://github.com/apache/arrow-adbc/tree/main/r/adbcbigquery)
+
 This driver provides an interface to
 [BigQuery](https://cloud.google.com/bigquery) using ADBC.
 
diff --git a/c/driver/flightsql/README.md b/c/driver/flightsql/README.md
@@ -0,0 +1,36 @@
+<!---
+  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.
+-->
+
+# ADBC Arrow Flight SQL Driver
+
+![Vendor: Apache Arrow Flight SQL](https://img.shields.io/badge/vendor-Arrow%20Flight%20SQL-blue?style=flat-square)
+![Implementation: Go](https://img.shields.io/badge/language-Go-violet?style=flat-square)
+![Status: Stable](https://img.shields.io/badge/status-stable-green?style=flat-square)
+
+[![conda-forge: adbc-driver-flightsql](https://img.shields.io/conda/vn/conda-forge/adbc-driver-flightsql?label=conda-forge%3A%20adbc-driver-flightsql&style=flat-square)](https://anaconda.org/conda-forge/adbc-driver-flightsql)
+[![conda-forge: libadbc-driver-flightsql](https://img.shields.io/conda/vn/conda-forge/libadbc-driver-flightsql?label=conda-forge%3A%20libadbc-driver-flightsql&style=flat-square)](https://anaconda.org/conda-forge/libadbc-driver-flightsql)
+[![PyPI: adbc-driver-flightsql](https://img.shields.io/pypi/v/adbc-driver-flightsql?style=flat-square)](https://pypi.org/project/adbc-driver-flightsql/)
+[![R: adbcflightsql](https://img.shields.io/github/r-package/v/apache/arrow-adbc?filename=r%2Fadbcflightsql%2FDESCRIPTION&style=flat-square)](https://github.com/apache/arrow-adbc/tree/main/r/adbcflightsql)
+
+This driver provides an interface to databases supporting
+[Apache Arrow Flight SQL](https://arrow.apache.org/docs/format/FlightSql.html) using ADBC.
+
+## Building
+
+See [CONTRIBUTING.md](../../../CONTRIBUTING.md) for details.
diff --git a/c/driver/postgresql/README.md b/c/driver/postgresql/README.md
@@ -19,8 +19,17 @@
 
 # ADBC PostgreSQL Driver
 
+![Vendor: PostgreSQL](https://img.shields.io/badge/vendor-PostgreSQL-blue?style=flat-square)
+![Implementation: C/C++](https://img.shields.io/badge/implementation-C%2FC%2B%2B-violet?style=flat-square)
+![Status: Stable](https://img.shields.io/badge/status-stable-green?style=flat-square)
+
+[![conda-forge: adbc-driver-postgresql](https://img.shields.io/conda/vn/conda-forge/adbc-driver-postgresql?label=conda-forge%3A%20adbc-driver-postgresql&style=flat-square)](https://anaconda.org/conda-forge/adbc-driver-postgresql)
+[![conda-forge: libadbc-driver-postgresql](https://img.shields.io/conda/vn/conda-forge/libadbc-driver-postgresql?label=conda-forge%3A%20libadbc-driver-postgresql&style=flat-square)](https://anaconda.org/conda-forge/libadbc-driver-postgresql)
+[![CRAN: adbcpostgresql](https://img.shields.io/cran/v/adbcpostgresql?style=flat-square)](https://cran.r-project.org/web/packages/adbcpostgresql/index.html)
+[![PyPI: adbc-driver-postgresql](https://img.shields.io/pypi/v/adbc-driver-postgresql?style=flat-square)](https://pypi.org/project/adbc-driver-postgresql/)
+
 This implements an ADBC driver that wraps [libpq][libpq], the client
-library for PostgreSQL.  This is still a work in progress.
+library for PostgreSQL.
 
 This project owes credit to 0x0L's [pgeon][pgeon] for the overall
 approach.
diff --git a/c/driver/snowflake/README.md b/c/driver/snowflake/README.md
@@ -19,6 +19,17 @@
 
 # ADBC Snowflake Driver
 
+![Vendor: Snowflake](https://img.shields.io/badge/vendor-Snowflake-blue?style=flat-square)
+![Implementation: Go](https://img.shields.io/badge/implementation-Go-violet?style=flat-square)
+![Status: Stable](https://img.shields.io/badge/status-stable-green?style=flat-square)
+
+[![conda-forge: adbc-driver-snowflake](https://img.shields.io/conda/vn/conda-forge/adbc-driver-snowflake?label=conda-forge%3A%20adbc-driver-snowflake&style=flat-square)](https://anaconda.org/conda-forge/adbc-driver-snowflake)
+[![conda-forge: libadbc-driver-snowflake](https://img.shields.io/conda/vn/conda-forge/libadbc-driver-snowflake?label=conda-forge%3A%20libadbc-driver-snowflake&style=flat-square)](https://anaconda.org/conda-forge/libadbc-driver-snowflake)
+[![crates.io: adbc_snowflake](https://img.shields.io/crates/v/adbc_snowflake?style=flat-square)](https://crates.io/crates/adbc_snowflake)
+[![NuGet: Apache.Arrow.Adbc.Drivers.Interop.Snowflake](https://img.shields.io/nuget/v/Apache.Arrow.Adbc.Drivers.Interop.Snowflake)](https://www.nuget.org/packages/Apache.Arrow.Adbc.Drivers.Interop.Snowflake)
+[![PyPI: adbc-driver-snowflake](https://img.shields.io/pypi/v/adbc-driver-snowflake?style=flat-square)](https://pypi.org/project/adbc-driver-snowflake/)
+[![R: adbcsnowflake](https://img.shields.io/github/r-package/v/apache/arrow-adbc?filename=r%2Fadbcsnowflake%2FDESCRIPTION&style=flat-square)](https://github.com/apache/arrow-adbc/tree/main/r/adbcsnowflake)
+
 This driver provides an interface to
 [Snowflake](https://www.snowflake.com/) using ADBC.
 
diff --git a/c/driver/sqlite/README.md b/c/driver/sqlite/README.md
@@ -19,6 +19,15 @@
 
 # ADBC SQLite Driver
 
+![Vendor: SQLite](https://img.shields.io/badge/vendor-SQLite-blue?style=flat-square)
+![Implementation: C/C++](https://img.shields.io/badge/implementation-C%2FC%2B%2B-violet?style=flat-square)
+![Status: Stable](https://img.shields.io/badge/status-stable-green?style=flat-square)
+
+[![conda-forge: adbc-driver-sqlite](https://img.shields.io/conda/vn/conda-forge/adbc-driver-sqlite?label=conda-forge%3A%20adbc-driver-sqlite&style=flat-square)](https://anaconda.org/conda-forge/adbc-driver-sqlite)
+[![conda-forge: libadbc-driver-sqlite](https://img.shields.io/conda/vn/conda-forge/libadbc-driver-sqlite?label=conda-forge%3A%20libadbc-driver-sqlite&style=flat-square)](https://anaconda.org/conda-forge/libadbc-driver-sqlite)
+[![CRAN: adbcsqlite](https://img.shields.io/cran/v/adbcsqlite?style=flat-square)](https://cran.r-project.org/web/packages/adbcsqlite/index.html)
+[![PyPI: adbc-driver-sqlite](https://img.shields.io/pypi/v/adbc-driver-sqlite?style=flat-square)](https://pypi.org/project/adbc-driver-sqlite/)
+
 This driver provides an interface to
 [SQLite](https://sqlite.org/index.html) using ADBC.
 
diff --git a/csharp/src/Drivers/Apache/Hive2/README.md b/csharp/src/Drivers/Apache/Hive2/README.md
@@ -19,6 +19,10 @@
 
 # Hive Driver
 
+![Vendor: Apache Hive](https://img.shields.io/badge/vendor-Apache%20Hive-blue?style=flat-square)
+![Implementation: C#](https://img.shields.io/badge/language-C%23-violet?style=flat-square)
+![Status: Experimental](https://img.shields.io/badge/status-experimental-red?style=flat-square)
+
 ## Database and Connection Properties
 
 Properties should be passed in the call to `HiveServer2Driver.Open`,
diff --git a/csharp/src/Drivers/Apache/Impala/README.md b/csharp/src/Drivers/Apache/Impala/README.md
@@ -19,6 +19,10 @@
 
 # Impala Driver
 
+![Vendor: Apache Impala](https://img.shields.io/badge/vendor-Apache%20Impala-blue?style=flat-square)
+![Implementation: C#](https://img.shields.io/badge/language-C%23-violet?style=flat-square)
+![Status: Experimental](https://img.shields.io/badge/status-experimental-red?style=flat-square)
+
 ## Database and Connection Properties
 
 Properties should be passed in the call to `ImpalaDriver.Open`,
diff --git a/csharp/src/Drivers/Apache/Spark/README.md b/csharp/src/Drivers/Apache/Spark/README.md
@@ -19,6 +19,10 @@
 
 # Spark Driver
 
+![Vendor: Apache Spark](https://img.shields.io/badge/vendor-Apache%20Spark-blue?style=flat-square)
+![Implementation: C#](https://img.shields.io/badge/language-C%23-violet?style=flat-square)
+![Status: Experimental](https://img.shields.io/badge/status-experimental-red?style=flat-square)
+
 ## Database and Connection Properties
 
 Properties should be passed in the call to `SparkDriver.Open`,
diff --git a/csharp/src/Drivers/BigQuery/readme.md b/csharp/src/Drivers/BigQuery/readme.md
@@ -18,6 +18,13 @@
 -->
 
 # BigQuery
+
+![Vendor: Google BigQuery](https://img.shields.io/badge/vendor-Google%20BigQuery-blue?style=flat-square)
+![Implementation: C#](https://img.shields.io/badge/language-C%23-violet?style=flat-square)
+![Status: Beta](https://img.shields.io/badge/status-beta-yellow?style=flat-square)
+
+[![NuGet: Apache.Arrow.Adbc.Drivers.BigQuery](https://img.shields.io/nuget/v/Apache.Arrow.Adbc.Drivers.BigQuery)](https://www.nuget.org/packages/Apache.Arrow.Adbc.Drivers.BigQuery)
+
 The BigQuery ADBC driver wraps a [BigQueryClient](https://cloud.google.com/dotnet/docs/reference/Google.Cloud.BigQuery.V2/latest/Google.Cloud.BigQuery.V2.BigQueryClient) object for working with [Google BigQuery](https://cloud.google.com/bigquery/) data.
 
 # Supported Features
diff --git a/csharp/src/Drivers/Databricks/readme.md b/csharp/src/Drivers/Databricks/readme.md
@@ -19,6 +19,10 @@
 
 # Databricks
 
+![Vendor: Databricks](https://img.shields.io/badge/vendor-Databricks-blue?style=flat-square)
+![Implementation: C#](https://img.shields.io/badge/language-C%23-violet?style=flat-square)
+![Status: Experimental](https://img.shields.io/badge/status-experimental-red?style=flat-square)
+
 The Databricks ADBC driver is built on top of the Spark ADBC driver and inherits many of it's [properties](../Apache/Spark/readme.md).
 
 The Databricks ADBC driver supports the following authentication methods:
diff --git a/csharp/src/Drivers/FlightSql/README.md b/csharp/src/Drivers/FlightSql/README.md
@@ -0,0 +1,28 @@
+<!--
+
+ 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.
+
+-->
+
+# Arrow Flight SQL
+
+![Vendor: Apache Arrow Flight SQL](https://img.shields.io/badge/vendor-Arrow%20Flight%20SQL-blue?style=flat-square)
+![Implementation: C#](https://img.shields.io/badge/language-C%23-violet?style=flat-square)
+![Status: Beta](https://img.shields.io/badge/status-beta-yellow?style=flat-square)
+
+[![NuGet: Apache.Arrow.Adbc.Drivers.FlightSql](https://img.shields.io/nuget/v/Apache.Arrow.Adbc.Drivers.FlightSql)](https://www.nuget.org/packages/Apache.Arrow.Adbc.Drivers.FlightSql)
+
+This driver provides an interface to databases supporting [Apache Arrow Flight SQL](https://arrow.apache.org/docs/format/FlightSql.html) using ADBC.
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -40,6 +40,8 @@
 
 exclude_patterns = []
 extensions = [
+    # misc directives
+    "adbc_misc",
     # recipe directive
     "sphinx_recipe",
     # generic directives to enable intersphinx for java
diff --git a/docs/source/driver/postgresql.rst b/docs/source/driver/postgresql.rst
@@ -19,7 +19,7 @@
 PostgreSQL Driver
 =================
 
-**Available for:** C/C++, GLib/Ruby, Go, Python, R
+.. adbc_driver_status:: ../../../c/driver/postgresql/README.md
 
 The PostgreSQL driver provides access to any database that supports
 the PostgreSQL wire format.  It wraps `libpq`_, the client library for
diff --git a/docs/source/driver/status.rst b/docs/source/driver/status.rst
@@ -37,78 +37,28 @@ Implementation Status
    Drivers that support C/C++ can also be used from C#, GLib, Go, Python, R,
    Ruby, and Rust, regardless of their implementation language.
 
-.. list-table::
-   :header-rows: 1
-
-   * - Driver
-     - Supported Languages
-     - Implementation Language
-     - Status
-
-   * - Apache DataFusion
-     - Rust
-     - Rust
-     - Experimental
-
-   * - BigQuery (C#)
-     - C#
-     - C#
-     - Experimental
-
-   * - BigQuery (Go)
-     - C/C++
-     - Go
-     - Experimental
-
-   * - DuckDB [#duckdb]_
-     - C/C++
-     - C++
-     - Stable
-
-   * - Flight SQL (Go)
-     - C/C++, C# [#wrapper]_
-     - Go
-     - Stable
-
-   * - Flight SQL (Java)
-     - Java
-     - Java
-     - Experimental
-
-   * - JDBC Adapter
-     - Java
-     - Java
-     - Experimental
-
-   * - PostgreSQL
-     - C/C++
-     - C++
-     - Stable
-
-   * - SQLite
-     - C/C++
-     - C
-     - Stable
-
-   * - Snowflake
-     - C/C++, Rust [#wrapper]_
-     - Go
-     - Stable
-
-   * - Thrift protocol-based [#thrift]_
-     - C#
-     - C#
-     - Experimental
+.. adbc_driver_status_table::
+
+   ../../../c/driver/bigquery/README.md
+   ../../../csharp/src/Drivers/Apache/Hive2/README.md
+   ../../../csharp/src/Drivers/Apache/Impala/README.md
+   ../../../csharp/src/Drivers/Apache/Spark/README.md
+   ../../../csharp/src/Drivers/BigQuery/readme.md
+   ../../../csharp/src/Drivers/Databricks/readme.md
+   ../../../csharp/src/Drivers/FlightSql/README.md
+   ../../../java/driver/flight-sql/README.md
+   ../../../rust/driver/datafusion/README.md
+   ./duckdb => ../../../c/integration/duckdb/README.md [#duckdb]
+   ./flight_sql => ../../../c/driver/flightsql/README.md
+   ./jdbc => ../../../java/driver/jdbc/README.md
+   ./postgresql => ../../../c/driver/postgresql/README.md
+   ./snowflake => ../../../c/driver/snowflake/README.md
+   ./sqlite => ../../../c/driver/sqlite/README.md
 
 .. [#duckdb] DuckDB is developed and provided by a third party.  See the
              `DuckDB documentation
              <https://duckdb.org/docs/stable/clients/adbc.html>`_ for details.
 
-.. [#thrift] Supports Apache Hive/Impala/Spark.
-
-.. [#wrapper] Listed separately because a wrapper package is provided that
-              combines the driver and the bindings for you.
-
 Feature Support
 ===============
 
diff --git a/docs/source/ext/adbc_misc.py b/docs/source/ext/adbc_misc.py
diff --git a/java/driver/flight-sql/README.md b/java/driver/flight-sql/README.md
diff --git a/java/driver/jdbc/README.md b/java/driver/jdbc/README.md
diff --git a/ruby/README.md b/ruby/README.md
diff --git a/rust/driver/datafusion/README.md b/rust/driver/datafusion/README.md
