sqlx-pool-registry 0.3.0

Lightweight SQLx PostgreSQL connection pool routing for primary/replica separation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# Changelog

All notable changes to `sqlx-pool-registry` are documented in this file.

This project was forked from [`sqlx-pool-router` 0.2.0](https://crates.io/crates/sqlx-pool-router/0.2.0) at commit [`bd5dd8a`](https://github.com/doublewordai/sqlx-pool-router/commit/bd5dd8a049697dfab92fe88a6febb82af96c4800). The upstream changelog is intentionally not duplicated here; entries below cover changes made in this crate after the fork.

## [0.3.0](https://github.com/anton-dutov/sqlx-pool-registry/compare/sqlx-pool-registry-v0.2.1...sqlx-pool-registry-v0.3.0) (2026-07-14)


### ⚠ BREAKING CHANGES

* add generic PoolProvider trait with sqlx-tracing support

### Features

* add generic PoolProvider trait with sqlx-tracing support ([bfb9553](https://github.com/anton-dutov/sqlx-pool-registry/commit/bfb95536267570975e38e37c7c81a370220d9b3b))
* initial release of sqlx-pool-router ([e7100c1](https://github.com/anton-dutov/sqlx-pool-registry/commit/e7100c18a076a4a67dff34dd23c19a7552b90a57))

## [0.3.0]

### Changed

- Raised the minimum supported Rust version (MSRV) to 1.94.
- Made `DbPools: Deref<Target = PgPool>` an opt-in legacy API behind the
  `with-deref` feature. It always returns the primary pool, bypasses read
  routing, and will be removed in the next major version. Use `read()` or
  `write()` for database queries.

## [0.2.1]

### Added

- Added optional named-pool support through the `with-named-pools` feature.
- Added the generic `PoolRegistry<P>` API with exact-name lookup, replacement, iteration, collection conversion, and the `UnknownPool` error type.
- Added mutually exclusive SQLx 0.8 and SQLx 0.9 compatibility features. SQLx 0.8 remains enabled by default, while SQLx 0.9 is opt-in.
- Re-exported the selected SQLx version as `sqlx_pool_registry::sqlx` so public API types and consumer queries use the same SQLx version.
- Added `DbPools::primary()` and `DbPools::replica()` topology accessors. The replica accessor returns only an explicitly configured replica and does not fall back to the primary pool.

### Changed

- Renamed the fork from `sqlx-pool-router` to `sqlx-pool-registry` and updated package, repository, documentation, and example references.
- Split the implementation into focused modules for pool routing, providers, named registries, and test pools without changing the core routing model.
- Clarified that `read()` and `write()` express routing intent rather than providing compile-time query restrictions.
- Clarified that `TestDbPools` uses PostgreSQL's read-only default to help find ordinary routing mistakes and is not a security boundary.
- Configured docs.rs to document named pools with the default SQLx 0.8 backend without enabling the mutually exclusive SQLx features together.

### Testing

- Added offline coverage for pool topology, fallback routing, closing, named registry behavior, generic providers, and both supported SQLx versions.
- Separated PostgreSQL-dependent tests from the default offline test suite.
- Expanded CI and release validation to build, lint, test, and check examples for SQLx 0.8 and SQLx 0.9 independently.