Skip to content

README: choosing drivers, threads or vibe.d - #183

Merged
buggins merged 1 commit into
masterfrom
docs/choosing-drivers
Nov 12, 2026
Merged

buggins merged 1 commit into
masterfrom
docs/choosing-drivers

Conversation

@buggins

@buggins buggins commented Nov 12, 2026

Copy link
Copy Markdown
Owner

Closes #182

Adds a Choosing drivers section before the sample code:

  • how to pick a configuration (subConfigurations), that full is the default and a build has exactly one ddbc configuration (native and old drivers can't be mixed);
  • a table of the configurations with their drivers, version identifiers and C libraries;
  • a table of URL schemes and the driver each one selects (from extractDriverNameFromURL);
  • Threads or vibe.d (fiber mode): vibe.d support comes from depending on vibe-core (no ddbc configuration); the native drivers choose per connection (inside a vibe.d task or not) and can be forced with io=phobos|vibe (ClickHouse, SQL Server) or io_mode=phobos|vibe (PostgreSQL, Oracle); mysql-native uses vibe.d sockets whenever vibe-core is in the build; libpq, ODBC and SQLite always block. Points to examples/pgnative_vibe.

The native PostgreSQL section links to the new subsection. Documentation only.

🤖 Generated with Claude Code

A Choosing drivers section: the configurations with their drivers,
version identifiers and C libraries, that full is the default and a
build has exactly one configuration, which URL schemes go to which
driver; and how thread or vibe.d (fiber) mode is chosen: depend on
vibe-core, the native drivers choose per connection (io / io_mode
force one), mysql-native uses vibe.d sockets when vibe-core is in the
build, libpq, ODBC and SQLite always block.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@buggins
buggins merged commit 39f9f0b into master Nov 12, 2026
100 checks passed
@buggins
buggins deleted the docs/choosing-drivers branch November 12, 2026 12:07
This was referenced Nov 12, 2026
buggins added a commit that referenced this pull request Nov 12, 2026
Configuration full-native (#185, #186), README Choosing drivers (#182,
#183), and the native drivers on clickhoused 0.9.2, postgresql-native
0.6.1, oracle-native 0.4.1, mssql-native 0.3.1 and dbwire 0.9.6
(#178-#181). The dependency snippets now say ~>0.13.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

README: how to choose drivers (configurations) and thread or vibe.d mode

1 participant