Driver: Add page about Swift

[amotl]

About

What the title says.

Preview

https://cratedb-guide--413.org.readthedocs.build/connect/swift/

[coderabbitai]

Warning

Rate limit exceeded

@amotl has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 11 minutes and 28 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Walkthrough

Adds Swift driver documentation and site navigation: a new docs/connect/swift.md page, a Swift driver grid-item-card and "swift" toctree entry in docs/connect/index.md, and a link-check ignore pattern for https://swiftpackageindex.com/ in docs/conf.py.

Changes

Cohort / File(s)	Summary
Connect index & driver grid docs/connect/index.md	Adds a Swift grid-item-card under "Drivers by language", inserts "swift" into the "All drivers" toctree/list, and sets card attributes (link, alt text, padding, text alignment, styling) consistent with existing cards.
Swift driver page docs/connect/swift.md	Adds a new page describing how to connect to CrateDB from Swift using PostgresKit: Package.swift dependency snippet, EventLoopGroupConnectionPool setup, example main.swift with raw SQL query and Codable model decoding, Docker/Podman run commands, CrateDB Cloud tlsmode example, and a reference link.
Docs config docs/conf.py	Appends r"https://swiftpackageindex.com/" to linkcheck_ignore with a comment noting 403 Client Error: Forbidden.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  participant Dev as Developer
  participant App as Swift App
  participant Pool as EventLoopGroupConnectionPool
  participant DB as CrateDB (Postgres protocol)

  Dev->>App: add PostgresKit dependency (Package.swift)
  Dev->>App: create PostgresConfiguration
  Dev->>Pool: initialize EventLoopGroupConnectionPool(configuration)
  App->>Pool: execute raw SQL (async)
  Pool->>DB: open connection / send query
  DB-->>Pool: return rows
  Pool-->>App: deliver rows via future/callback

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• Connect: Improve index page #231 — Modifies docs/connect/index.md driver cards/layout; likely overlaps with adding the Swift card.
• Connect: Migrate pages from crate-clients-tools, to be retired soon #221 — Work on the connect section and driver pages; directly related to adding a new driver entry/page.
• Connect: Reorganize and clean up section #361 — Edits connect documentation structure and drivers listing; relevant to toctree/cards changes.

Suggested reviewers

• kneth
• surister

Poem

🐰 I hopped to the docs with PostgresKit bright,
A Swift little card and an example that’s light.
Pools hum, queries dance, rows come in a stream,
Crates open wide — swift code in a dream. 🥕

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description Check	❓ Inconclusive	The PR description states "What the title says" and provides a preview link to the Swift driver documentation page. While this description is related to the changeset (which adds Swift driver documentation), it relies entirely on referencing the PR title and uses non-descriptive language. The phrase "What the title says" does not independently convey meaningful information about what is being changed, and the description provides minimal detail beyond the preview link, making it difficult to understand the scope and nature of the changes from the description alone.	Consider enhancing the PR description to include specific details about the changes, such as "Adds Swift driver documentation including setup instructions, usage examples with PostgresKit, and CrateDB connection details" or similar language that explicitly describes what is being added or modified. This would make the intent of the PR immediately clear without requiring readers to reference the title or build preview.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The pull request title "Driver: Add page about Swift" directly and clearly summarizes the main change in the changeset. The PR adds a new Swift driver documentation page (docs/connect/swift.md), updates the Connect page index to include a Swift driver card (docs/connect/index.md), and makes a configuration update to ignore a URL in link checking (docs/conf.py). The title is concise, specific, and clearly conveys the primary objective without vague or generic language.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch swift

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[kneth]

Let's discuss https://github.com/crate/tech-content/issues/124#issuecomment-3485676563 before merging