postgres_rustls
postgres_rustls is a library that adds TLS support to tokio-postgres
using tokio-rustls.
Minimum Supported Rust Version (MSRV)
This will frequently be updated to be the same as stable. Specifically, any time stable is updated and that update has "useful" features or compilation no longer succeeds (e.g., due to new compiler lints), then MSRV will be updated.
MSRV changes will correspond to a SemVer patch version bump pre-1.0.0; otherwise a minor version bump.
SemVer Policy
- All on-by-default features of this library are covered by SemVer
- MSRV is considered exempt from SemVer as noted above
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE)
- MIT license (LICENSE-MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Before any PR is sent, cargo clippy and cargo t should be run for each possible combination of "features"
using stable Rust. One easy way to achieve this is by building ci and invoking it with no commands in the
postgres_rustls directory or sub-directories. You can fetch ci via git clone https://git.philomathiclife.com/repos/ci,
and it can be built with cargo build --release. Additionally,
RUSTDOCFLAGS="--cfg docsrs" cargo +nightly doc --all-features should be run to ensure documentation can be built.
Note that when running cargo t you will need to make sure PostgreSQL is set up properly. You will likely need
to modify some of the test data like username to run the tests.
Status
This package is actively maintained and will conform to the
latest version of tokio-postgres.
The crate is only tested on x86_64-unknown-linux-gnu and x86_64-unknown-openbsd targets, but it should work
on most platforms.