mirror of
https://github.com/launchbadge/sqlx.git
synced 2025-12-30 13:20:59 +00:00
5b8bb3b28b
* Add a "sqlite-unbundled" feature that dynamically links to system libsqlite3.so library * update README abouot the newly-added `sqlite-unbundled` feature * Update README.md to make it clear with bulleted list Co-authored-by: Austin Bonander <austin.bonander@gmail.com> * more cfg feature updates Co-authored-by: Austin Bonander <austin.bonander@gmail.com> * update documentation in sqlx-sqlx/src/lib.rs too and also mention possible build time increasement. * cargo fmt * Add "sqlite-unbundled" feature to sqlx-cli * Add sqlite-unbundled to gituhb actions tests * cfg(feature = "sqlite") => cfg(any(feature = "sqlite", feature = "sqlite-unbundled")) * fix * CI: make sqlite-unbundled tests workaround required-features by duplicating the relevant test section * use an internal "_sqlite" feature to do the conditional compilation --------- Co-authored-by: Austin Bonander <austin.bonander@gmail.com>
83 lines
2.3 KiB
Rust
83 lines
2.3 KiB
Rust
//! Support crate for SQLx's proc macros.
|
|
//!
|
|
//! ### Note: Semver Exempt API
|
|
//! The API of this crate is not meant for general use and does *not* follow Semantic Versioning.
|
|
//! The only crate that follows Semantic Versioning in the project is the `sqlx` crate itself.
|
|
//! If you are building a custom SQLx driver, you should pin an exact version of this and
|
|
//! `sqlx-core` to avoid breakages:
|
|
//!
|
|
//! ```toml
|
|
//! sqlx-core = "=0.6.2"
|
|
//! sqlx-macros-core = "=0.6.2"
|
|
//! ```
|
|
//!
|
|
//! And then make releases in lockstep with `sqlx-core`. We recommend all driver crates, in-tree
|
|
//! or otherwise, use the same version numbers as `sqlx-core` to avoid confusion.
|
|
|
|
#![cfg_attr(
|
|
any(sqlx_macros_unstable, procmacro2_semver_exempt),
|
|
feature(track_path)
|
|
)]
|
|
|
|
#[cfg(feature = "macros")]
|
|
use crate::query::QueryDriver;
|
|
|
|
pub type Error = Box<dyn std::error::Error>;
|
|
|
|
pub type Result<T> = std::result::Result<T, Error>;
|
|
|
|
mod common;
|
|
mod database;
|
|
|
|
#[cfg(feature = "derive")]
|
|
pub mod derives;
|
|
#[cfg(feature = "macros")]
|
|
pub mod query;
|
|
|
|
#[cfg(feature = "macros")]
|
|
// The compiler gives misleading help messages about `#[cfg(test)]` when this is just named `test`.
|
|
pub mod test_attr;
|
|
|
|
#[cfg(feature = "migrate")]
|
|
pub mod migrate;
|
|
|
|
#[cfg(feature = "macros")]
|
|
pub const FOSS_DRIVERS: &[QueryDriver] = &[
|
|
#[cfg(feature = "mysql")]
|
|
QueryDriver::new::<sqlx_mysql::MySql>(),
|
|
#[cfg(feature = "postgres")]
|
|
QueryDriver::new::<sqlx_postgres::Postgres>(),
|
|
#[cfg(feature = "_sqlite")]
|
|
QueryDriver::new::<sqlx_sqlite::Sqlite>(),
|
|
];
|
|
|
|
pub fn block_on<F>(f: F) -> F::Output
|
|
where
|
|
F: std::future::Future,
|
|
{
|
|
#[cfg(feature = "_rt-tokio")]
|
|
{
|
|
use once_cell::sync::Lazy;
|
|
use tokio::runtime::{self, Runtime};
|
|
|
|
// We need a single, persistent Tokio runtime since we're caching connections,
|
|
// otherwise we'll get "IO driver has terminated" errors.
|
|
static TOKIO_RT: Lazy<Runtime> = Lazy::new(|| {
|
|
runtime::Builder::new_current_thread()
|
|
.enable_all()
|
|
.build()
|
|
.expect("failed to start Tokio runtime")
|
|
});
|
|
|
|
TOKIO_RT.block_on(f)
|
|
}
|
|
|
|
#[cfg(all(feature = "_rt-async-std", not(feature = "tokio")))]
|
|
{
|
|
async_std::task::block_on(f)
|
|
}
|
|
|
|
#[cfg(not(any(feature = "_rt-async-std", feature = "tokio")))]
|
|
sqlx_core::rt::missing_rt(f)
|
|
}
|