Driver/Swift: Add dedicated page

Author: amotl

docs/conf.py

@@ -86,6 +86,8 @@
     r"https://aiven.io/",
     # HTTPSConnectionPool(host='qz.surister.dev', port=443): Read timed out. (read timeout=15)
     r"https://qz.surister.dev/",
+    # 403 Client Error: Forbidden
+    r"https://swiftpackageindex.com/",
 ]
 
 linkcheck_anchors_ignore_for_url += [

docs/connect/index.md

@@ -113,6 +113,18 @@ CrateDB drivers and adapters for supported programming languages, frameworks, an
 
 ::::
 
+::::{grid-item-card} Swift
+:link: connect-swift
+:link-type: ref
+:link-alt: Connect to CrateDB using Swift
+:padding: 3
+:text-align: center
+:class-card: sd-pt-3
+:class-body: sd-fs-1
+:class-title: sd-fs-6
+{fab}`swift`
+::::
+
 :::::
 
 
@@ -187,6 +199,7 @@ javascript
 php
 python
 ruby
+swift
 natural
 All drivers <drivers>
 ```

docs/connect/swift.md

@@ -0,0 +1,88 @@
+(connect-swift)=
+
+# Swift
+
+:::{include} /_include/links.md
+:::
+
+:::{div} sd-text-muted
+Connect to CrateDB from Swift applications.
+:::
+
+:::{rubric} About
+:::
+
+[postgres-kit] is a non-blocking, event-driven Swift client for PostgreSQL.
+
+:::{rubric} Synopsis
+:::
+
+`Package.swift`
+```swift
+// swift-tools-version: 5.7
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "CrateDbDemo",
+    dependencies: [
+        .package(url: "https://github.com/vapor/postgres-kit.git", "2.0.0"..<"3.0.0")
+    ],
+    targets: [
+        .executableTarget(
+            name: "CrateDbDemo",
+            dependencies: [.product(name: "PostgresKit", package: "postgres-kit")],
+            path: "Sources"
+            ),
+    ]
+)
+```
+`Sources/main.swift`
+```swift
+import PostgresKit
+
+let configuration = try SQLPostgresConfiguration(url: "postgresql://crate:crate@localhost:5432/doc?tlsmode=disable")
+let source = PostgresConnectionSource(sqlConfiguration: configuration)
+let pool = EventLoopGroupConnectionPool(
+    source: source,
+    maxConnectionsPerEventLoop: 2,
+    on: MultiThreadedEventLoopGroup.singleton
+)
+defer { pool.shutdown() }
+
+let db = pool.database(logger: .init(label: "test")).sql()
+let rows = try await db.raw("SELECT * FROM sys.summits ORDER BY height DESC LIMIT 3;").all().get()
+
+struct Record: Codable {
+    var mountain: String
+    var region: String
+    var height: Int
+}
+
+for row in rows {
+    let record = try row.decode(model: Record.self)
+    print("\(record.mountain): \(record.height)")
+}
+```
+
+Start CrateDB using Docker or Podman, then compile and invoke example program.
+```shell
+docker run --rm --publish=5432:5432 crate -Cdiscovery.type=single-node
+```
+```shell
+swift run
+```
+
+:::{rubric} CrateDB Cloud
+:::
+
+For connecting to CrateDB Cloud, use the `tlsmode=require` parameter,
+and replace username, password, and hostname with values matching
+your environment.
+```swift
+let configuration = try SQLPostgresConfiguration(url: "postgresql://admin:[email protected]:5432/doc?tlsmode=require")
+```
+
+
+[postgres-kit]: https://swiftpackageindex.com/vapor/postgres-kit