Connect: Add Dart

Author: amotl

docs/_assets/icon/dart-logo.svg

@@ -0,0 +1,68 @@
+(connect-dart)=
+
+# Dart
+
+:::{div} sd-text-muted
+Connect to CrateDB from Dart applications.
+:::
+
+:::{rubric} About
+:::
+
+[postgres] is a library for connecting to and querying PostgreSQL databases.
+
+:::{rubric} Synopsis
+:::
+
+`pubspec.yaml`
+```yaml
+name: cratedb_demo
+
+dependencies:
+  postgres: '^3.0.0'
+
+environment:
+  sdk: '^3.9.0'
+```
+
+`example.dart`
+```dart
+library;
+
+import 'package:postgres/postgres.dart';
+
+void main() async {
+
+  final conn = await Connection.openFromUrl(
+    'postgresql://crate:crate@localhost:5432/doc?sslmode=disable'
+  );
+
+  final result = await conn.execute("SELECT mountain, region, height FROM sys.summits ORDER BY height DESC LIMIT 3");
+  print(result);
+
+  await conn.close();
+}
+```
+
+:::{include} ../_cratedb.md
+:::
+```shell
+dart --disable-analytics
+dart pub get
+dart example.dart
+```
+
+:::{rubric} CrateDB Cloud
+:::
+
+For connecting to CrateDB Cloud, use the `sslmode=require`
+parameter, and replace username, password, and hostname with values matching
+your environment.
+```dart
+final conn = await Connection.openFromUrl(
+  'postgresql://admin:[email protected]:5432/doc?sslmode=require'
+);
+```
+
+
+[postgres]: https://pub.dev/packages/postgres

docs/connect/dart/index.md

@@ -49,6 +49,20 @@ CrateDB drivers and adapters for supported programming languages, frameworks, an
 :margin: 4 4 0 0
 :padding: 0
 
+::::{grid-item-card} Dart
+:link: connect-dart
+:link-type: ref
+:link-alt: Connect to CrateDB using Dart
+:padding: 3
+:text-align: center
+:class-card: sd-pt-3
+:class-body: sd-fs-1
+:class-title: sd-fs-6
+```{image} /_assets/icon/dart-logo.svg
+:height: 50px
+```
+::::
+
 ::::{grid-item-card} Java
 :link: connect-java
 :link-type: ref
@@ -182,6 +196,7 @@ application
 :maxdepth: 1
 :hidden:
 
+dart/index
 java
 javascript
 php