fix(deps): update module github.com/xo/dburl to v0.30.0

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
github.com/xo/dburl	v0.26.1 → v0.30.0

---

Release Notes

xo/dburl (github.com/xo/dburl)

v0.30.0: dburl v0.30.0

Compare Source

One new field on Scheme, so a consumer can tell which database product a
scheme's driver connects to.

Added

Dialect string

Dialect is the Driver of the scheme that is canonical for the database
product. A canonical scheme names itself, so a consumer reads the field
without a conditional.

A product reached by more than one Go driver has a scheme per driver, because
each Driver is a name a caller passes to sql.Open and neither should
override the other. Four pairs exist:

pgx            -> postgres
moderncsqlite  -> sqlite3
godror         -> oracle
mymysql        -> mysql

Before this, a consumer mapping URL.Driver to a product found nothing for
the first of each pair, because pgx, moderncsqlite, godror and mymysql
are driver names and not product names.

This is not the wire compatible relation, which Override already carries.
cockroachdb and redshift are different products that speak PostgreSQL.
pgx and postgres are one product reached two ways. A wire compatible
scheme takes the Dialect of what it speaks, so its Dialect and Override
agree.

Ten schemes have a Dialect that differs from their Driver: the four pairs
above and the six wire compatible schemes.

Notes

The relation is not derivable from the other fields, which is why it needed
one of its own. Matching Desc by prefix finds pgx and mymysql and misses
moderncsqlite and godror, whose descriptions are "ModernC SQLite3" and
"GO DRiver for ORacle" and contain neither product name.

file has no Dialect, as it has no Desc. It resolves a path on disk and
has no product behind it.

TestSchemeMetadata requires a non-empty Dialect, that it names a
registered scheme, that the named scheme is canonical, and that a wire
compatible scheme agrees with its Override.

Parse and Open are unchanged. Callers that do not read the metadata see no
difference.

Full Changelog: xo/dburl@v0.29.0...v0.30.0

v0.29.0: dburl v0.29.0

Compare Source

New metadata on Scheme, so the registry describes itself, and a gen.go
that regenerates the README from it.

Why

usql generated the driver table in both projects' READMEs, through a
filesystem path that read this repository's working tree rather than a tagged
version. That path already mixed two versions once. The registry knew which
schemes exist but could not describe them, and any other consumer had to read
usql's source for the same facts.

Added

Scheme gains six fields:

Desc        string      // "Apache Hive"
Home        string      // database home page
DriverURL   string      // Go driver home page
GoPackage   string      // driver import path, including the major version
RequiresCGO bool
Deployment  Deployment  // Embedded, Server, Hosted; a bitmask

GoPackage is the import path and not the module path. The two differ: for
pgx the module is github.com/jackc/pgx/v5 and the import path that registers
the driver is github.com/jackc/pgx/v5/stdlib.

gen.go regenerates the driver table and LICENSE. It carries
//go:build ignore, so it is not part of the package, and it imports the
standard library and dburl and nothing else. Run it with go run gen.go.

Changed

The driver table gains two footnote markers. § marks a database with no
server, and ¶ marks one offered only as a service. ¶ appears only when a
database has no edition anyone can run, so CockroachDB does not carry it.

The Scheme / Tag column now holds this registry's scheme names rather than
usql's build tags, so DynamoDB reads godynamo and Netezza reads nzgo.

Row order is a forced cosmetic list in gen.go, followed by everything else
alphabetically, with a blank row between. It is not a build tag or a group,
and nothing outside gen.go reads it.

The Presto and Trino section is removed from the README. It described driver
behaviour that belongs in the generator doc comments, and it had gone stale.

Notes

The 51 scheme entries are now named-field literals rather than positional.
Scheme has six string fields, and positional literals with six same-typed
slots make a transposition a silent bug rather than a compile error. The
conversion was proved behaviour preserving by dumping every scheme's six
original fields and a live DSN before and after, and diffing.

Home is the one field that is not a relocation from usql. The values were
sourced by asking two models the same list separately and comparing, and they
are not machine verified. Three schemes have a blank Home, which the
field permits.

Parse and Open are unchanged. Callers that do not read the metadata see no
difference.

Full Changelog: xo/dburl@v0.28.1...v0.29.0

v0.28.1: dburl v0.28.1

Compare Source

Two breaking changes, and a fix for a panic that v0.28.0 introduced.

Do not use v0.28.0

v0.28.0 carried the Hive driver switch without an auth default. gohive/v2
does not treat a missing auth as unspecified. Its connect path is a chain
over the accepted values, and an empty string reaches
panic("Unrecognized auth"), so the DSN that release emits takes the calling
process down rather than failing to connect. v0.28.1 fixes it. Go straight to
v0.28.1.

Breaking: the three Presto TLS aliases are removed

prs://, prestos:// and prestodbs:// no longer parse.

prestodb/presto-go-client/v2 selects TLS from ssl_ca, ssl_cert,
ssl_key and ssl_skip_verify, and never from the scheme, so a trailing s
had nothing to map onto. Use the plain scheme with one of those options, which
also moves the default port to 8443:

presto://host/catalog?ssl_ca=/path/ca.pem

presto keeps the pr and prestodb aliases. v0.27.0 made the three aliases
fail while leaving them registered, which left them advertised in usql's
driver table. Removing them finishes that.

Breaking: Hive moved to a new driver and its DSN changed shape

sqlflow.org/gohive is unmaintained and has been removed from usql. It also
accepted bind parameters and discarded them, and could not represent NULL: a
null string and an empty string both arrived as a valid empty string. The
scheme now targets github.com/beltran/gohive/v2, which rejects any DSN that
does not start with hive://.

before   hive://host/mydb   ->   host:10000/mydb
after    hive://host/mydb   ->   hive://host:10000/mydb?auth=NONE

The hive, hi and hive2 aliases all still work, and all normalize to
hive://, because the driver rejects the alias too.

The database name now defaults to default. An empty path returns
database name is required from this driver rather than defaulting.

Fixed: the Hive DSN cannot emit a value that panics

GenHive supplies auth=NONE when the caller has not, and passes any other
value through untouched. An empty value counts as not supplied, because
?auth= and a bare ?auth both parse to the empty string that panics.

NONE is a protocol selection and not a decision to skip authentication.
NONE, LDAP and CUSTOM all build a SASL PLAIN transport carrying the
username and password, so against a server expecting Kerberos it fails
negotiation rather than connecting unauthenticated.

transport gets no default, although it is also a mode selector that panics
on an unknown value. The driver supplies a working default for it and does not
for auth.

Added

GenHive is exported. Nothing else changes for callers of Parse or Open.

docs/SCHEME.md gains a step for databases held in a file, covering
RegisterFileType and the rule that the header decides when the file exists
and the extension decides when it does not.

Full Changelog: xo/dburl@v0.27.1...v0.28.1

v0.28.0

Compare Source

v0.27.1: dburl v0.27.1

Compare Source

Full Changelog: xo/dburl@v0.27.0...v0.27.1

v0.27.0

Compare Source

---

Configuration

📅 Schedule: (in timezone America/New_York)

• Branch creation
  • "after 10pm every weekday,before 5am every weekday,every weekend"
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 66.92%. Comparing base (fb76c27) to head (00d1e00).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #6602   +/-   ##
=======================================
  Coverage   66.92%   66.92%           
=======================================
  Files         169      169           
  Lines       14191    14191           
=======================================
  Hits         9498     9498           
  Misses       3971     3971           
  Partials      722      722           

Flag	Coverage Δ
unittests	66.92% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.